Qu'est-ce qu'un document de contrôle d'interface?
Un document de contrôle d'interface (ICD) est une description formalisée des méthodes et des structures impliquées dans la fourniture des entrées et des sorties d'un système spécifique. Le système décrit par le document de contrôle d'interface peut être une bibliothèque de logiciels ou un composant matériel. Le document ne doit pas nécessairement suivre un seul format, mais peut être un ensemble de paragraphes, de graphiques ou même de dessins techniques du matériel d'interface. Lorsqu'il se réfère spécifiquement à un logiciel, un document de contrôle d'interface peut ressembler à une interface de programmation abstraite (API), décrivant les méthodes ou fonctions publiques pouvant être utilisées pour entrer des informations dans la bibliothèque et décrivant également le résultat obtenu. Un document de contrôle d'interface décrit généralement comment intégrer le système dans un système plus grand ou le connecter à un système parallèle; il ne décrit aucun des fonctionnements internes du système, qui pourraient être décrits dans un type de document séparé.
Le document de contrôle d'interface a pour objectif de fournir aux développeurs de matériel ou de logiciel une documentation pouvant être utilisée lors de la création d'un système ou d'un logiciel destiné à transférer des données vers et à partir du système décrit par le DCI. Cela signifie généralement que vous définissez des fonctions exactes ou des composants matériels de manière à connaître leurs signatures et à indiquer les tolérances des paramètres à utiliser. En génie logiciel, cela peut vouloir dire connaître le nom d’une fonction particulière, quels types de variables sont acceptés en tant que paramètres et, éventuellement, quelles limites fonctionnelles sont placées sur les valeurs transmises. Pour un élément matériel, ces informations peuvent inclure les fonctions des broches d’un contrôle de connecteur série, les interruptions matérielles utilisées et la vitesse de travail du périphérique.
Une chose qu'un document de contrôle d'interface ne décrit pas spécifiquement est la manière dont le système convertit l'entrée en sortie, ou la manière dont la sortie est produite, en général. Cela permet aux développeurs d'avoir une vision étroite du système lors de la création d'une interface, mais cela nécessite également que les développeurs du système, dont les détails ICD se conforment, se conforment strictement aux directives énoncées dans le document lui-même. Pour les rédacteurs d'un document de contrôle d'interface et les développeurs du système, il est pratique que l'implémentation interne du système ne soit pas décrite dans le document et puisse donc être modifiée librement sans affecter le développement extérieur d'interfaces reposant sur le DAI.
Dans certaines situations, un document de contrôle d'interface peut permettre de tester des systèmes sans avoir à utiliser une interface complète. Cela peut être fait en simulant les différents types de sortie qu'un système peut générer, comme décrit dans le DAI, puis en transmettant cette sortie via l'interface développée en externe. Les systèmes qui ne souhaitent gérer qu'un seul côté du système, tels que la sortie, dans le cas d'un matériel tel qu'un périphérique d'affichage, peuvent garantir que l'interface fonctionne conformément aux spécifications sans nécessiter une entrée réelle.