Holarch

Guide · Interfaces

Document de contrôle d'interface (ICD) : ce qu'il contient et comment le tenir à jour

Écouter ce guide (audio en anglais) 20 min

Un document de contrôle d'interface consigne ce qui franchit la frontière entre deux parties d'un système, et engage les équipes des deux côtés sur la même définition. Ce guide explique ce que contient un ICD, qui en est responsable, comment trouver les interfaces au départ et comment garder le document cohérent avec la conception au fil de ses évolutions, avec un exemple détaillé de deux sous-systèmes d'un petit satellite d'observation de la Terre.

Sur cette page
  1. Ce qu'est un document de contrôle d'interface
  2. Qui est responsable d'un ICD
  3. Ce que contient un ICD
    1. Les données et la synchronisation méritent le plus de détails
    2. Vérifier l'interface elle-même
  4. Trouver les interfaces dans l'architecture
  5. Garder l'ICD lié au modèle
  6. Maîtrise des modifications d'interface
  7. Erreurs courantes
  8. Exemple détaillé : du C&DH aux communications sur un CubeSat
    1. Trouver les échanges
    2. Les liaisons et ce qu'elles transportent
    3. Le diagramme d'interface
    4. L'ICD généré
    5. Ce que montre l'exemple
  9. L'essayer dans Holarch
  10. Pour aller plus loin

Ce qu'est un document de contrôle d'interface

La plupart des problèmes d'intégration ne se trouvent pas à l'intérieur d'un sous-système ; ils se situent à la jonction entre deux d'entre eux. Une équipe suppose que le connecteur a un détrompage dans un sens, l'autre suppose l'inverse. Un côté envoie un message d'état toutes les 100 ms, le délai d'attente de l'autre est de 80 ms. Un document de contrôle d'interface existe pour rendre cette jonction explicite : il énonce, en un seul endroit sur lequel les deux côtés se sont accordés, ce qui passe entre eux et dans quelles conditions.

Un ICD décrit une interface de l'extérieur. Il ne dit pas comment chaque côté est construit, seulement ce que chaque côté doit présenter à la frontière : le connecteur et ses broches, la tension et le courant, la structure et la cadence des messages, les points de fixation, l'environnement auquel l'interface doit résister. Chaque équipe conçoit ensuite son propre côté en conséquence.

Trois noms de documents voisins sont souvent confondus :

DocumentRépond àContenu type
Spécification des exigences d'interface (IRS)Que doit faire l'interface ?Des exigences sur une ou plusieurs interfaces, rédigées sous forme d'énoncés « shall » vérifiables avant que la conception soit arrêtée.
Description de conception d'interface (IDD)Comment un côté la met-il en œuvre ?La conception d'une interface telle que réalisée par une partie, souvent un article logiciel ou matériel, avec assez de détails pour la construire et la tester.
Document de contrôle d'interface (ICD)Sur quoi les deux côtés se sont-ils accordés ?La définition maîtrisée, approuvée conjointement, de l'interface entre deux parties précises, placée sous maîtrise des modifications.

Les programmes les combinent différemment. Certains intègrent les exigences dans l'ICD ; d'autres rédigent tôt une IRS, puis un ICD une fois la conception mûrie. Ce qui compte, c'est que les exigences et la définition convenue soient toutes deux consignées, et que l'une d'elles soit clairement celle qui fait foi.

Qui est responsable d'un ICD

Un ICD a deux parties, parfois plus, et un seul responsable. Les parties sont les organisations ou les équipes responsables de chaque côté : deux équipes de sous-système, un maître d'œuvre et un fournisseur, une équipe véhicule et une équipe charge utile. Le responsable est la personne ou le groupe qui tient le document, relance les points ouverts et conduit l'approbation. Sur les grands programmes, c'est un groupe de travail de contrôle des interfaces (ICWG) : des représentants de chaque côté plus l'ingénieur système responsable de l'intégration, qui se réunissent à une cadence régulière.

Quelques règles de responsabilité évitent la plupart des litiges :

  • Un responsable par interface, nommé dans le document. « L'équipe système » n'est pas un responsable ; un responsable nommé l'est.
  • Les deux parties approuvent. Un ICD signé par un seul côté est une liste de souhaits, pas un document de contrôle.
  • Le niveau intégrateur est responsable des interfaces entre ses enfants. L'interface entre deux sous-systèmes appartient au niveau système, car aucun des deux sous-systèmes ne peut la régler seul.
  • Les interfaces externes, vers des équipements ou des systèmes extérieurs au programme, relèvent du côté programme et sont convenues avec la partie externe, qui peut avoir son propre document prévalant sur celui-ci.

Ce que contient un ICD

Le plan exact dépend du domaine et des normes du programme, mais un ICD complet couvre le même terrain. Laissez une section avec « sans objet » plutôt que de la supprimer, pour qu'un relecteur voie qu'elle a été examinée.

SectionCe qu'elle consigne
Identification et partiesNuméro et nom de l'interface, les deux parties, le responsable, le statut du document et les approbations.
Vue d'ensemble de l'interfaceUn diagramme des deux côtés et de chaque liaison entre eux, et un court énoncé de la finalité de l'interface.
Liste des interfacesChaque liaison individuelle (harnais, bus, ligne, conduite, fixation) avec son propre numéro, ses extrémités et son statut.
Mécanique et physiquePoints de fixation et gabarits de perçage, enveloppes et zones d'exclusion, propriétés de masse à l'interface, alignement, types et emplacements des connecteurs.
ÉlectriqueAffectation des broches, plages de tension et de courant, qualité de l'alimentation, mise à la masse et métallisation, blindage, isolement, niveaux de signal.
Données et protocoleProtocoles et couches physiques, définitions des messages avec noms de champs, types, plages, unités et mises à l'échelle, identifiants, gestion des erreurs.
SynchronisationCadences et périodes des messages, budgets de latence, séquences de démarrage et de réveil, délais d'attente et ce que fait chaque côté quand l'un expire.
Fluides, thermique et optiqueDébits, pressions et températures à la frontière, chaleur transférée à travers elle, chemins optiques et champs de vue, le cas échéant.
EnvironnementConditions de vibration, de choc, de température, d'humidité, de pénétration et de compatibilité électromagnétique auxquelles l'interface doit résister.
Exigences d'interfaceLes exigences que l'interface doit satisfaire, chacune tracée jusqu'à son exigence parent.
VérificationComment chaque exigence est vérifiée à l'interface (test, analyse, inspection, démonstration), à quel niveau et avec quel équipement.
Points ouvertsChaque TBD (valeur non encore déterminée) et TBR (valeur proposée mais non encore confirmée), chacun avec un responsable et une date de clôture.
Historique des modificationsChaque révision avec sa demande de modification, ce qui a changé et qui l'a approuvée.

Les données et la synchronisation méritent le plus de détails

Les interfaces mécaniques et électriques sont en général contrôlées physiquement tôt, lors des essais d'ajustement et de la première mise sous tension. Les incohérences de données et de synchronisation survivent bien plus longtemps, souvent jusqu'à l'intégration système, car chaque côté teste contre son propre simulateur, construit à partir de sa propre lecture du document. Pour chaque message, consignez l'identifiant, la période et sa tolérance, le type, la plage, les unités et la mise à l'échelle de chaque champ, l'ordre des octets, et ce que fait le récepteur quand le message est en retard, absent ou hors plage. Une définition de message qui dit « courant batterie » sans unités, sans convention de signe (charge ou décharge positive) ni résolution n'est pas encore maîtrisée.

Vérifier l'interface elle-même

Les exigences d'interface sont vérifiées comme toute autre exigence (le guide de la matrice de vérification des exigences traite des méthodes, des niveaux et des preuves), mais la preuve a une forme particulière : elle a besoin des deux côtés. Un essai de compatibilité entre les unités réelles, ou entre une unité réelle et un émulateur validé de l'autre, est plus probant que deux essais séparés contre deux lectures privées de l'ICD. Planifiez ces essais dans l'ICD pour que l'équipement et le calendrier existent quand on en a besoin.

Trouver les interfaces dans l'architecture

Un ICD ne peut maîtriser que les interfaces que quelqu'un a trouvées. La façon fiable de les trouver passe par l'architecture, pas par la mémoire.

  1. Partir des fonctions. Décomposez la mission en fonctions avec leurs entrées et leurs sorties (le guide de l'analyse fonctionnelle montre comment). Un diagramme N² place les fonctions (ou les sous-systèmes) sur la diagonale ; la cellule en ligne A, colonne B contient ce que A envoie à B. Chaque cellule remplie hors diagonale est un échange qui a besoin d'un chemin. Les groupes de cellules remplies montrent quelles fonctions vont ensemble ; une ligne ou une colonne chargée signale une fonction dont beaucoup d'autres dépendent.
  2. Allouer les fonctions aux composants. Une fois que chaque fonction est réalisée par une pièce physique, chaque échange entre fonctions de pièces différentes devient un échange qui franchit une frontière entre pièces. Le guide de l'architecture système montre comment cette allocation est faite et contrôlée.
  3. Donner un chemin physique à chaque échange qui franchit une frontière. Un harnais, un bus, une liaison radio, une conduite ou un assemblage mécanique. Un échange sans chemin est une lacune de la conception ; un chemin qui ne transporte rien est soit inutile, soit pas encore compris.
  4. Dessiner le diagramme d'interface. Pour chaque paire de parties, montrez les deux côtés, leurs pièces internes à la frontière et chaque liaison avec ce qu'elle transporte. Cela devient la figure de vue d'ensemble de l'ICD.

Numérotez les interfaces au fur et à mesure que vous les trouvez. L'exemple détaillé ci-dessous numérote ses liaisons de IF-01 à IF-25 et donne une décimale à une liaison à l'intérieur d'une interface plus grande (IF-14.1 dans IF-14). Les numéros permettent de citer les interfaces dans les exigences, les procédures de test et les demandes de modification, et gardent une liste d'interfaces stable quand les noms changent.

Garder l'ICD lié au modèle

Un ICD rédigé comme un fichier de traitement de texte autonome commence à s'écarter de la conception le jour de son approbation. Une broche est réaffectée dans le plan du harnais, une période de message change dans le logiciel, un nouveau signal est ajouté pour une exigence tardive, et l'ICD est mis à jour des semaines plus tard, ou jamais. Les relecteurs comparent alors des documents entre eux au lieu de les comparer à la conception.

L'ingénierie système basée sur les modèles inverse la situation. Chaque interface est un élément du modèle système, relié à ses deux extrémités, aux items qu'elle transporte et aux exigences qui la régissent. L'ICD est un rapport généré à partir de ces éléments. Dès lors :

  • La même liaison apparaît avec les mêmes valeurs dans l'ICD, le diagramme d'interface, la traçabilité des exigences et la matrice de vérification, car tous lisent une seule définition.
  • Une modification d'une cadence de message ou d'un connecteur apparaît dans le prochain ICD généré, et l'historique des modifications provient de l'enregistrement propre au modèle.
  • Des contrôles s'exécutent sur le modèle : un échange entre deux pièces sans liaison pour le transporter, une liaison avec une seule extrémité, une liaison dont la charge dépasse la capacité, une liaison sans responsable ni statut.
  • Les exigences portant sur une interface y sont tracées, si bien que les sections exigences et vérification de l'ICD restent complètes (voir le guide de la traçabilité des exigences pour les types de liens et les contrôles de lacunes).

Tout n'a pas sa place dans les attributs du modèle. Les plans de connecteurs détaillés, les chronogrammes et les longs catalogues de messages peuvent rester dans des documents joints ou référencés. Le modèle contient tout de même l'interface, son statut, son responsable et la référence, si bien que l'ICD généré pointe vers la bonne révision.

Maîtrise des modifications d'interface

La définition d'une interface mûrit par étapes, et l'étape détermine la façon dont une modification est traitée. Un schéma simple en quatre étapes convient à la plupart des programmes :

StatutSignificationComment une modification est faite
BrouillonLa première définition d'un côté.Le responsable la modifie librement.
ProposéeSoumise à l'autre partie pour revue.Les modifications sont discutées au sein du groupe de travail et consignées.
ConvenueLes deux parties l'acceptent ; les conceptions peuvent s'appuyer dessus.Une modification nécessite le consentement des deux parties et une déclaration d'impact pour chaque côté.
Figée en référenceFait partie d'une référence de configuration approuvée.Une demande de modification formelle, évaluée et approuvée par le comité de modification, avec réédition de l'ICD.

Une cadence courante consiste à rédiger les interfaces avant la revue des exigences système, à les convenir avant la revue de conception préliminaire et à les figer en référence avant la revue critique de conception. Quelle que soit la cadence, une demande de modification portant sur une interface figée en référence doit indiquer la raison, les liaisons et les items concernés, l'impact sur la conception, les coûts et le calendrier de chaque partie, les exigences et la vérification touchées, et l'applicabilité : à partir de quelle version ou de quel numéro de série la modification s'applique. Comment trouver et dimensionner ces effets est montré pas à pas dans le guide de l'analyse d'impact des modifications.

Suivez les TBD et les TBR comme une liste qui doit diminuer. Une interface encore pleine de points ouverts à la revue critique de conception est un risque pour le calendrier, quel que soit son statut.

Erreurs courantes

  • Des interfaces que personne n'a trouvées. Un échange entre fonctions n'a jamais reçu de chemin physique, ou une interface externe (équipement sol, équipement de test, opérateur) a été oubliée. Construisez la liste des interfaces à partir de l'architecture, pas à partir de la liste des harnais.
  • Des documents unilatéraux. Une équipe rédige l'ICD, l'autre ne donne jamais son accord formel, et le désaccord apparaît à l'intégration. Exigez les deux approbations avant le statut Convenue.
  • Des unités et des conventions manquantes. Une valeur sans unités, convention de signe, ordre des octets ou mise à l'échelle invite à deux lectures différentes. Traitez chacune comme un défaut lors de la revue.
  • Une charge non comparée à la capacité. Chaque message tient, mais ensemble ils dépassent le bus ; chaque charge tient dans le harnais, mais ensemble elles dépassent sa valeur nominale. Additionnez les charges sur chaque liaison et comparez avec sa capacité, avec une marge. Dans le modèle d'exemple ci-dessous, IF-05 Payload Interface transporte une bande d'image de 480 Mbit/s plus un plan de commandes de 0,02 Mbit/s sur une liaison de 400 Mbit/s : 480,02 sur 400 Mbit/s, soit 120 %, signalé par le modèle avant l'intégration plutôt que découvert sur le banc.
  • Une synchronisation laissée implicite. Les cadences sont données, mais pas les tolérances ni le comportement à l'expiration des délais. Consignez les deux, ainsi que ce que fait chaque côté quand l'autre est en retard.
  • Des copies périmées. L'ICD, le plan du harnais et la table des messages du logiciel ont chacun leur propre version. Générez à partir d'une seule source, ou au moins indiquez laquelle fait foi.
  • Des points ouverts sans responsable. Un TBR sans personne ni date reste ouvert. Donnez-lui les deux.
  • Une vérification planifiée trop tard. Les essais d'interface nécessitent le matériel des deux côtés ou des émulateurs validés. Planifiez-les quand l'ICD est convenu, pas quand les unités arrivent.

Exemple détaillé : du C&DH aux communications sur un CubeSat

L'exemple est EO-1, un CubeSat 6U d'observation de la Terre qui photographie des terres agricoles depuis une orbite héliosynchrone à 500 km ; le guide de l'exemple de projet MBSE parcourt l'ensemble du modèle. Nous prenons ici une jonction à l'intérieur du satellite : entre 1.4 C&DH (commande et traitement des données, un ordinateur de bord avec 64 Go de stockage de charge utile) et 1.5 Communications (le 1.5.1 UHF Transceiver pour les commandes et le 1.5.2 S-band Transmitter pour les données de charge utile). Des équipes différentes construisent les deux côtés, et chaque commande que le satellite exécute et chaque image qu'il envoie au sol franchit cette frontière.

Trouver les échanges

Le passage d'imagerie nominal du modèle, OPS Run Nominal Imaging Pass, est décomposé en douze fonctions, OPS.1 à OPS.12, et onze d'entre elles sont allouées à l'asset qui les réalise. Son diagramme N² les place sur la diagonale et les items qu'elles échangent dans les cellules :

Deux cellules franchissent la frontière entre le C&DH et les communications :

  • Ligne OPS.2 Receive Imaging Plan (réalisée par l'UHF Transceiver), colonne OPS.3 Load Command Schedule (réalisée par le C&DH) : Command Packets, les paquets de commande décodés provenant de la radio.
  • Ligne OPS.7 Encode and Store Image (C&DH), colonne OPS.8 Transmit Image Data (le S-band Transmitter) : Downlink Frames, des données d'image compressées et mises en paquets.

Un troisième échange n'apparaît pas dans ce passage, car il provient de la logique de modes du satellite : l'action d'entrée du C&DH Enable S-band Transmitter envoie une Transmitter Enable Command à F9 Transmit Payload Data, réalisée par le S-band Transmitter. Une liste d'interfaces construite à partir d'un seul scénario l'aurait manqué ; c'est pourquoi les fonctions sont allouées aux assets sur l'ensemble du modèle avant que les interfaces soient listées.

La démonstration donne déjà un chemin physique à chaque échange. Pour en faire une seule interface maîtrisée, nous avons ajouté un unique élément au projet de démonstration : un conduit parent, IF-26 C&DH to Communications Interface, relié aux deux sous-systèmes, au statut Agreed, dont le Comms Lead est responsable, avec les deux liaisons existantes comme enfants. Tout le reste ci-dessous est la démonstration telle qu'elle est livrée.

LiaisonExtrémitésSupport et connecteurTransporteCapacitéStatut
IF-07 Radio Command InterfaceUHF Transceiver → C&DHUART, 115,2 kbauds ; J3 (Micro-D 9)Command Packets, 0,0096 Mbit/s (9,6 kbit/s)0,1 Mbit/sFigée en référence
IF-08 Payload Data InterfaceC&DH → S-band TransmitterSpaceWire ; J4 (Micro-D 9)Downlink Frames, 10 Mbit/s ; Transmitter Enable Command, sans débit défini100 Mbit/sConvenue

Chaque liaison est tracée jusqu'à l'exigence qui la motive : IF-07 satisfait 5.2 UHF Command Uplink (« The UHF transceiver shall receive ground commands at 9.6 kbps »), et IF-08 satisfait 5.1 S-band Downlink Rate (« The S-band transmitter shall downlink payload data at 10 Mbps »).

Le diagramme d'interface

Le diagramme de contrôle des interfaces montre les deux parties sous forme de bandes, l'interface parent au milieu, chaque liaison sous forme de barre avec son statut, sa capacité et ses items, et un trait reliant chaque liaison à la pièce qu'elle connecte :

La bande du C&DH ne contient aucune pièce, car le modèle traite l'ordinateur de bord comme une seule unité : les deux liaisons aboutissent sur le C&DH lui-même. Côté communications, chaque liaison aboutit sur une radio différente, ce qui est exactement ce que l'équipe harnais a besoin de savoir.

L'ICD généré

L'ICD est exporté à partir des mêmes éléments sous forme de document Word. Sa première page contient le registre des interfaces et une synthèse des statuts ; chaque conduit a ensuite sa propre section avec les extrémités, le connecteur et les broches, le support, les items transportés avec leur sens et leur débit, les exigences liées et le contrôle de capacité.

Télécharger l'ICD : ICD d'EO-1 pour l'interface entre le C&DH et les communications (.docx), le document complet de trois pages tel que Holarch l'a exporté, sans la date d'export. Il ne contient que les données fictives de la démonstration EO-1.

Ce que montre l'exemple

  • Le registre est l'ordre du jour du groupe de travail. IF-07 est figée en référence ; une modification passe donc par une demande de modification. IF-08 est convenue : une modification nécessite toujours l'équipe C&DH et l'équipe communications. Aucune n'a de TBD ou de TBR ouvert ; cette interface est donc prête à être figée en référence dans son ensemble.
  • Comparer la capacité avec ce que le support fournit réellement. IF-07 transporte 9,6 kbit/s sur une capacité enregistrée de 0,1 Mbit/s, ce que le document indique comme 10 %. Un UART à 115,2 kbauds avec un bit de start et un bit de stop par octet transfère 115 200 × 8 / 10 = 92 160 bit/s de données ; la capacité réelle est donc d'environ 92 kbit/s et la charge d'environ 10,4 % de celle-ci. La marge est grande dans les deux cas, mais le chiffre enregistré arrondit vers le haut ; sur une liaison plus chargée, cet arrondi cacherait un problème.
  • Une liaison peut passer alors que son système échoue. IF-08 fait circuler 10 Mbit/s de trames sur une liaison SpaceWire de 100 Mbit/s, soit 10 % de la capacité. La contrainte se situe une interface plus loin : IF-12 S-band Downlink transporte 9,6 Mbit/s sur une liaison radio de 10 Mbit/s, soit 96 %. Un flux de trames plus rapide passerait facilement IF-08 et échouerait à l'antenne ; une revue d'ICD examine donc la chaîne, pas une seule liaison.
  • Un item sans débit n'est pas contrôlé. La Transmitter Enable Command n'a pas de débit de données, le contrôle de capacité l'ignore donc. Elle est minuscule, mais une valeur vide est un point ouvert : donnez-lui un débit, ou un TBD avec un responsable.
  • L'interface parent n'a pas de capacité propre. Elle regroupe les items de ses liaisons (trois ici) et donne à la paire de parties un document, un responsable et un statut ; les contrôles de charge s'exécutent sur chaque liaison.
  • Une modification est traçable. Si la mission passe à une transmission plus rapide, le débit de Downlink Frames change à un seul endroit, les contrôles sur IF-08 et IF-12 se relancent, et l'exigence 5.1, tracée vers IF-08, indique ce qu'il faut revérifier.

L'essayer dans Holarch

  1. Créez la démonstration avec Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée).
  2. Ouvrez Interfaces → Diagrammes N² et ouvrez le diagramme N² de l'action OPS Run Nominal Imaging Pass pour voir les échanges entre ses fonctions.
  3. Ouvrez Interfaces → ICD, cliquez sur + Nouveau diagramme et choisissez C&DH comme asset parent de gauche et Communications comme asset parent de droite.
  4. Faites glisser les conduits existants IF-07 Radio Command Interface et IF-08 Payload Data Interface de la palette vers la boîte centrale. Leurs items et leurs connexions les accompagnent.
  5. Sélectionnez une liaison pour examiner son Statut d'interface, son Responsable, ses TBD/TBR, sa Capacité et ses Unités, ainsi que ses exigences liées.
  6. Cliquez sur Exporter le document ICD pour le document Word, ou sur Exporter l'ICD (CSV) pour un tableau.

Interfaces → Registre des interfaces liste chaque interface du projet avec son statut et son contrôle de capacité ; dans la démonstration, il montre IF-05 en dépassement de capacité. Les instructions pas à pas se trouvent dans produire un document de contrôle d'interface ; les interfaces figées en référence changent par des demandes de modification.

Pour aller plus loin