Réponse rapide
Documenter les interfaces d’une architecture logicielle robotique permet de savoir quelles données circulent, avec quelles unités, fréquences, délais, garanties, versions et permissions. Cela évite conversions implicites, messages anciens et dépendances cachées, et rend intégration, test, diagnostic et remplacement possibles. Une interface inclut aussi erreurs et comportements d’absence.
Spécifier message et contrat
Nom, type, unité, intervalle, timestamp, qualité, taille, ordre, perte, reprise et identité du producteur sont définis. Les effets d’une commande, son idempotence et son échéance sont explicites. Compatibilité ascendante et évolution sont prévues.
Vérifier contrat au runtime
Le robot contrôle version, âge, plage, fréquence et cohérence avant usage. Tests de contrat, simulation et matériel dans la boucle couvrent valeurs limites et messages inconnus. Les erreurs sont visibles et attribuables.
Ne pas documenter seulement le nom du topic ou de la fonction
Un nom ne précise ni unité ni garantie ni autorité. Ambiguïté conduit à des erreurs silencieuses difficiles à diagnostiquer. Le contrat doit être lisible par équipes et outils de validation.
Sources et références
- [1] Artificial intelligence and robotics — NIST