Guía · Interfaces
Documento de control de interfaces (ICD): qué contiene y cómo mantenerlo al día
Escuchar esta guía (audio en inglés) 20 min
Un documento de control de interfaces registra lo que cruza el límite entre dos partes de un sistema y obliga a los equipos de ambos lados a una misma definición. Esta guía trata qué contiene un ICD, quién es su responsable, cómo encontrar las interfaces en primer lugar y cómo mantener el documento coherente con el diseño a medida que cambia, con un ejemplo resuelto de dos subsistemas de un pequeño satélite de observación de la Tierra.
En esta página
- Qué es un documento de control de interfaces
- Quién es el responsable de un ICD
- Qué contiene un ICD
- Encontrar las interfaces en la arquitectura
- Mantener el ICD vinculado al modelo
- Control de cambios de interfaces
- Modos de fallo habituales
- Ejemplo resuelto: de C&DH a Communications en un CubeSat
- Pruébelo en Holarch
- Siguientes pasos
Qué es un documento de control de interfaces
La mayoría de los problemas de integración no están dentro de un subsistema; están en la junta entre dos de ellos. Un equipo supone que el conector tiene la guía en un sentido; el otro equipo supone lo contrario. Un lado envía un mensaje de estado cada 100 ms; el tiempo de espera del otro lado es de 80 ms. Un documento de control de interfaces existe para hacer explícita esa junta: indica, en un único lugar que ambos lados han acordado, qué pasa entre ellos y en qué condiciones.
Un ICD describe una interfaz desde fuera. No dice cómo está construido ninguno de los dos lados, solo lo que cada lado debe presentar en el límite: el conector y sus pines, la tensión y la corriente, el formato y los tiempos de los mensajes, los puntos de montaje, el entorno que debe soportar la interfaz. Después, cada equipo diseña su propio lado para que coincida.
Se confunden a menudo tres nombres de documentos relacionados:
| Documento | Responde a | Contenido típico |
|---|---|---|
| Especificación de requisitos de interfaz (IRS) | ¿Qué debe hacer la interfaz? | Requisitos sobre una o varias interfaces, redactados como enunciados «shall» verificables antes de que el diseño esté decidido. |
| Descripción del diseño de interfaz (IDD) | ¿Cómo la implementa un lado? | El diseño de una interfaz tal como la construye una de las partes, a menudo un elemento de software o hardware, con detalle suficiente para construirla y probarla. |
| Documento de control de interfaces (ICD) | ¿Qué han acordado ambos lados? | La definición controlada y aprobada conjuntamente de la interfaz entre dos partes concretas, sometida a control de cambios. |
Los programas combinan estos documentos de distintas formas. Algunos incluyen los requisitos en el ICD; otros redactan pronto una IRS y después un ICD cuando el diseño madura. Lo importante es que tanto los requisitos como la definición acordada queden registrados, y que uno de ellos sea claramente el que manda.
Quién es el responsable de un ICD
Un ICD tiene dos partes, a veces más, y un único responsable. Las partes son las organizaciones o equipos responsables de cada lado: dos equipos de subsistema, un contratista principal y un proveedor, un equipo del vehículo y un equipo de la carga útil. El responsable es la persona o el grupo que mantiene el documento, persigue los elementos abiertos y dirige la aprobación. En programas grandes es un grupo de trabajo de control de interfaces (ICWG): representantes de cada lado más el ingeniero de sistemas responsable de la integración, que se reúnen con una periodicidad regular.
Unas pocas reglas de responsabilidad evitan la mayoría de las disputas:
- Un responsable por interfaz, nombrado en el documento. «El equipo de sistemas» no es un responsable; una persona responsable con nombre, sí.
- Ambas partes aprueban. Un ICD firmado por un solo lado es una lista de deseos, no un documento de control.
- El nivel que integra es el responsable de las interfaces entre sus hijos. La interfaz entre dos subsistemas pertenece al nivel de sistema, porque ninguno de los dos subsistemas puede resolverla por sí solo.
- Las interfaces externas, con equipos o sistemas ajenos al programa, son responsabilidad del lado del programa y se acuerdan con la parte externa, que puede tener su propio documento con prioridad.
Qué contiene un ICD
El índice exacto depende del dominio y de las normas del programa, pero un ICD completo cubre el mismo terreno. Deje una sección con «no aplicable» en lugar de eliminarla, para que un revisor vea que se tuvo en cuenta.
| Sección | Qué registra |
|---|---|
| Identificación y partes | Número y nombre de la interfaz, las dos partes, el responsable, el estado del documento y las aprobaciones. |
| Visión general de la interfaz | Un diagrama de los dos lados y de cada enlace entre ellos, y un breve enunciado de la finalidad de la interfaz. |
| Lista de interfaces | Cada enlace individual (mazo de cables, bus, línea, tubería, montaje) con su propio número, sus extremos y su estado. |
| Mecánica y física | Puntos de montaje y patrones de tornillos, envolventes y zonas de exclusión, propiedades de masa en la interfaz, alineación, tipos y ubicaciones de conectores. |
| Eléctrica | Asignación de pines, rangos de tensión y corriente, calidad de la alimentación, puesta a tierra y conexión equipotencial, apantallamiento, aislamiento, niveles de señal. |
| Datos y protocolo | Protocolos y capas físicas, definiciones de mensajes con nombres de campo, tipos, rangos, unidades y escalado, identificadores, gestión de errores. |
| Tiempos | Frecuencias y periodos de los mensajes, presupuestos de latencia, secuencias de arranque y activación, tiempos de espera y lo que hace cada lado cuando vence uno. |
| Fluidos, térmica y óptica | Caudales, presiones y temperaturas en el límite, calor transferido a través de él, trayectorias ópticas y campos de visión, cuando correspondan. |
| Ambiental | Condiciones de vibración, choque, temperatura, humedad, estanqueidad y compatibilidad electromagnética que la interfaz debe soportar. |
| Requisitos de interfaz | Los requisitos que debe satisfacer la interfaz, cada uno trazado a su requisito padre. |
| Verificación | Cómo se verifica cada requisito en la interfaz (prueba, análisis, inspección, demostración), a qué nivel y con qué equipos. |
| Elementos abiertos | Cada TBD (valor aún no determinado) y TBR (valor propuesto pero aún no confirmado), cada uno con un responsable y una fecha de cierre. |
| Historial de cambios | Cada revisión con su solicitud de cambio, lo que cambió y quién lo aprobó. |
Los datos y los tiempos merecen el mayor detalle
Las interfaces mecánicas y eléctricas suelen comprobarse físicamente pronto, en las pruebas de ajuste y en el primer encendido. Las discrepancias de datos y de tiempos sobreviven mucho más, a menudo hasta la integración del sistema, porque cada lado prueba frente a su propio simulador, construido a partir de su propia lectura del documento. Para cada mensaje, anote el identificador, el periodo y su tolerancia, el tipo, el rango, las unidades y el escalado de cada campo, el orden de bytes y lo que hace el receptor cuando el mensaje llega tarde, falta o está fuera de rango. Una definición de mensaje que dice «corriente de batería» sin unidades, convenio de signo (carga o descarga positiva) ni resolución todavía no está controlada.
Verificar la propia interfaz
Los requisitos de interfaz se verifican como cualquier otro requisito (la guía de la matriz de verificación de requisitos trata los métodos, los niveles y las evidencias), pero la evidencia tiene una forma especial: necesita a ambos lados. Una prueba de compatibilidad entre las unidades reales, o entre una unidad real y un emulador validado de la otra, tiene más peso que dos pruebas separadas frente a dos lecturas privadas del ICD. Planifique esas pruebas en el ICD para que los equipos y el calendario existan cuando se necesiten.
Encontrar las interfaces en la arquitectura
Un ICD solo puede controlar las interfaces que alguien ha encontrado. La forma fiable de encontrarlas es a partir de la arquitectura, no de memoria.
- Empiece por las funciones. Descomponga la misión en funciones con sus entradas y salidas (la guía de análisis funcional muestra cómo). Un diagrama N² coloca las funciones (o los subsistemas) en la diagonal; la celda de la fila A, columna B, contiene lo que A envía a B. Cada celda rellena fuera de la diagonal es un intercambio que necesita un camino. Los grupos de celdas rellenas muestran qué funciones van juntas; una fila o columna muy ocupada señala una función de la que dependen muchas otras.
- Asigne las funciones a componentes. Una vez que cada función la realiza una pieza física, cada intercambio entre funciones de piezas distintas se convierte en un intercambio que cruza el límite de una pieza. La guía de arquitectura de sistemas muestra cómo se hace y se comprueba esa asignación.
- Dé a cada intercambio que cruza un camino físico. Un mazo de cables, un bus, un radioenlace, una tubería o una unión mecánica. Un intercambio sin camino es un hueco en el diseño; un camino que no transporta nada es innecesario o todavía no se entiende.
- Dibuje el diagrama de interfaces. Para cada par de partes, muestre ambos lados, sus piezas internas en el límite y cada enlace con lo que transporta. Esto se convierte en la figura de visión general del ICD.
Numere las interfaces a medida que las encuentre. El ejemplo resuelto de más abajo numera sus enlaces de IF-01 a IF-25 y da un decimal a un enlace dentro de una interfaz mayor (IF-14.1 dentro de IF-14). Los números permiten citar las interfaces en requisitos, procedimientos de prueba y solicitudes de cambio, y mantienen estable la lista de interfaces cuando cambian los nombres.
Mantener el ICD vinculado al modelo
Un ICD escrito como archivo independiente de procesador de textos empieza a alejarse del diseño el mismo día en que se aprueba. Se reasigna un pin en el plano del mazo de cables, cambia el periodo de un mensaje en el software, se añade una señal nueva por un requisito tardío, y el ICD se actualiza semanas después o nunca. Entonces los revisores comparan documentos entre sí en lugar de compararlos con el diseño.
La ingeniería de sistemas basada en modelos le da la vuelta a esto. Cada interfaz es un elemento del modelo del sistema, conectado a sus dos extremos, a los elementos que transporta y a los requisitos que la rigen. El ICD es un informe generado a partir de esos elementos. Así:
- El mismo enlace aparece con los mismos valores en el ICD, el diagrama de interfaces, la traza de requisitos y la matriz de verificación, porque todos leen una única definición.
- Un cambio en la frecuencia de un mensaje o en un conector aparece en el siguiente ICD generado, y el historial de cambios sale del propio registro del modelo.
- Las comprobaciones se ejecutan sobre el modelo: un intercambio entre dos piezas sin enlace que lo transporte, un enlace con un solo extremo, un enlace cuya carga supera su capacidad, un enlace sin responsable ni estado.
- Los requisitos de una interfaz se trazan a ella, de modo que las secciones de requisitos y de verificación del ICD siguen completas (véase la guía de trazabilidad de requisitos para los tipos de vínculo y las comprobaciones de huecos).
No todo va en atributos del modelo. Los planos detallados de conectores, los diagramas de tiempos y los catálogos largos de mensajes pueden quedarse en documentos adjuntos o referenciados. El modelo sigue conteniendo la interfaz, su estado, su responsable y la referencia, de modo que el ICD generado apunta a la revisión correcta.
Control de cambios de interfaces
La definición de una interfaz madura por etapas, y la etapa decide cómo se gestiona un cambio. Un esquema sencillo de cuatro etapas sirve para la mayoría de los programas:
| Estado | Significado | Cómo se hace un cambio |
|---|---|---|
| Borrador | La primera definición de un lado. | El responsable la edita libremente. |
| Propuesta | Ofrecida a la otra parte para su revisión. | Los cambios se discuten en el grupo de trabajo y se registran. |
| Acordada | Ambas partes la aceptan; los diseños pueden avanzar sobre ella. | Un cambio necesita el consentimiento de ambas partes y una declaración de impacto para cada lado. |
| En línea base | Forma parte de una línea base de configuración aprobada. | Una solicitud de cambio formal, evaluada y aprobada por el comité de cambios, con una nueva edición del ICD. |
Un ritmo habitual es tener las interfaces en borrador para la revisión de requisitos del sistema, acordadas antes de la revisión preliminar del diseño y en línea base antes de la revisión crítica del diseño. Sea cual sea el ritmo, una solicitud de cambio sobre una interfaz en línea base debe indicar el motivo, los enlaces y elementos afectados, el impacto en el diseño, el coste y el plazo de cada parte, los requisitos y la verificación afectados, y la aplicabilidad: a partir de qué compilación o número de serie se aplica el cambio. Cómo encontrar y dimensionar esos efectos se muestra paso a paso en la guía de análisis de impacto de cambios.
Haga el seguimiento de los TBD y TBR como una lista que debe reducirse. Una interfaz que sigue llena de elementos abiertos en la revisión crítica del diseño es un riesgo para el calendario, diga lo que diga su estado.
Modos de fallo habituales
- Interfaces que nadie encontró. Un intercambio entre funciones nunca recibió un camino físico, o se dejó fuera una interfaz externa (equipos de tierra, equipos de prueba, el operador). Construya la lista de interfaces a partir de la arquitectura, no de la lista de mazos de cables.
- Documentos de un solo lado. Un equipo redacta el ICD, el otro nunca lo acepta formalmente, y el desacuerdo aflora en la integración. Exija ambas aprobaciones antes del estado Acordada.
- Unidades y convenios que faltan. Un valor sin unidades, convenio de signo, orden de bytes o escalado invita a dos lecturas distintas. Trate cada uno como un defecto en la revisión.
- Carga no comparada con la capacidad. Cada mensaje cabe, pero juntos superan el bus; cada carga cabe en el mazo de cables, pero juntas superan su capacidad nominal. Sume las cargas de cada enlace y compárelas con su capacidad, con margen. En el modelo de ejemplo de más abajo, IF-05 Payload Interface transporta una franja de imagen de 480 Mbps más un plan de comandos de 0,02 Mbps por un enlace de 400 Mbps: 480,02 de 400 Mbps, un 120 %, que el modelo marca antes de la integración en lugar de descubrirse en el banco de pruebas.
- Tiempos implícitos. Se dan las frecuencias, pero no las tolerancias ni el comportamiento ante tiempos de espera. Registre ambos y lo que hace cada lado cuando el otro se retrasa.
- Copias obsoletas. El ICD, el plano del mazo de cables y la tabla de mensajes del software tienen cada uno su propia versión. Genérelos a partir de una única fuente o, al menos, indique cuál manda.
- Elementos abiertos sin responsable. Un TBR sin persona ni fecha sigue abierto. Dé a cada uno ambas cosas.
- Verificación planificada demasiado tarde. Las pruebas de interfaz necesitan el hardware de ambos lados o emuladores validados. Planifíquelas cuando se acuerde el ICD, no cuando lleguen las unidades.
Ejemplo resuelto: de C&DH a Communications en un CubeSat
El ejemplo es EO-1, un CubeSat 6U de observación de la Tierra que toma imágenes de tierras de cultivo desde una órbita heliosíncrona de 500 km; la guía del proyecto de ejemplo de MBSE recorre el modelo completo. Aquí tomamos una junta dentro de la nave: entre 1.4 C&DH (mando y tratamiento de datos, un ordenador de vuelo con 64 GB de almacenamiento para la carga útil) y 1.5 Communications (el 1.5.1 UHF Transceiver para los comandos y el 1.5.2 S-band Transmitter para los datos de la carga útil). Equipos distintos construyen los dos lados, y cada comando que ejecuta el satélite y cada imagen que envía a tierra cruzan este límite.
Encontrar los intercambios
La pasada nominal de captura de imágenes del modelo, OPS Run Nominal Imaging Pass, se descompone en doce funciones, de OPS.1 a OPS.12, y once de ellas están asignadas al Asset que las realiza. Su diagrama N² las coloca en la diagonal y los elementos que intercambian, en las celdas:
Dos celdas cruzan el límite entre C&DH y Communications:
- Fila OPS.2 Receive Imaging Plan (realizada por el UHF Transceiver), columna OPS.3 Load Command Schedule (realizada por C&DH): Command Packets, los paquetes de comandos decodificados que llegan de la radio.
- Fila OPS.7 Encode and Store Image (C&DH), columna OPS.8 Transmit Image Data (el S-band Transmitter): Downlink Frames, datos de imagen comprimidos y empaquetados.
Un tercer intercambio no aparece en esta pasada porque viene de la lógica de modos de la nave: la acción de entrada del C&DH Enable S-band Transmitter envía un Transmitter Enable Command a F9 Transmit Payload Data, realizada por el S-band Transmitter. Una lista de interfaces construida a partir de un solo escenario lo habría omitido; por eso las funciones se asignan a los Assets en todo el modelo antes de enumerar las interfaces.
Los enlaces y lo que transportan
La demostración ya da a cada intercambio un camino físico. Para formar con ellos una interfaz controlada, añadimos un único elemento al proyecto de demostración: un conduit padre, IF-26 C&DH to Communications Interface, conectado a ambos subsistemas, con estado Acordada, responsable Comms Lead y los dos enlaces existentes como hijos. Todo lo demás es la demostración tal como se distribuye.
| Enlace | Extremos | Medio y conector | Transporta | Capacidad | Estado |
|---|---|---|---|---|---|
| IF-07 Radio Command Interface | UHF Transceiver → C&DH | UART, 115,2 kbaudios; J3 (Micro-D 9) | Command Packets, 0,0096 Mbps (9,6 kbps) | 0,1 Mbps | En línea base |
| IF-08 Payload Data Interface | C&DH → S-band Transmitter | SpaceWire; J4 (Micro-D 9) | Downlink Frames, 10 Mbps; Transmitter Enable Command, sin frecuencia definida | 100 Mbps | Acordada |
Cada enlace se traza al requisito que lo motiva: IF-07 satisface 5.2 UHF Command Uplink («The UHF transceiver shall receive ground commands at 9.6 kbps»), e IF-08 satisface 5.1 S-band Downlink Rate («The S-band transmitter shall downlink payload data at 10 Mbps»).
El diagrama de interfaces
El diagrama de control de interfaces muestra las dos partes como bandas, la interfaz padre en el centro, cada enlace como una barra con su estado, su capacidad y sus elementos, y una línea desde cada enlace hasta la pieza que conecta:
La banda de C&DH no contiene piezas porque el modelo trata el ordenador de vuelo como una sola unidad: ambos enlaces terminan en el propio C&DH. En el lado de Communications, cada enlace termina en una radio distinta, que es justo lo que necesita saber el equipo del mazo de cables.
El ICD generado
El ICD se exporta a partir de los mismos elementos como documento de Word. Su primera página contiene el registro de interfaces y un resumen de estado; después, cada conduit tiene su propia sección con los extremos, el conector y los pines, el medio, los elementos transportados con su sentido y su frecuencia, los requisitos vinculados y la comprobación de capacidad.
Descargar el ICD: ICD de EO-1 para la interfaz entre C&DH y Communications (.docx), el documento completo de tres páginas tal como lo exportó Holarch, sin la fecha de exportación. Solo contiene los datos ficticios de la demostración EO-1.
Lo que muestra el ejemplo
- El registro es el orden del día del grupo de trabajo. IF-07 está en línea base, así que un cambio en ella pasa por una solicitud de cambio. IF-08 está acordada: un cambio sigue necesitando al equipo de C&DH y al de Communications. Ninguna tiene TBD ni TBR abiertos, así que esta interfaz está lista para pasar a línea base en su conjunto.
- Compruebe la capacidad frente a lo que el medio da realmente. IF-07 transporta 9,6 kbps sobre una capacidad registrada de 0,1 Mbps, que el documento indica como un 10 %. Una UART a 115,2 kbaudios con un bit de inicio y uno de parada por byte transfiere 115.200 × 8 / 10 = 92.160 bit/s de datos, así que la capacidad real es de unos 92 kbps y la carga es aproximadamente un 10,4 % de ella. El margen es amplio en cualquier caso, pero la cifra registrada redondea al alza; en un enlace más cargado, ese redondeo ocultaría un problema.
- Un enlace puede estar bien mientras su sistema falla. IF-08 lleva 10 Mbps de tramas sobre un enlace SpaceWire de 100 Mbps, un 10 % de su capacidad. La restricción está una interfaz más abajo: IF-12 S-band Downlink lleva 9,6 Mbps sobre un radioenlace de 10 Mbps, un 96 %. Un flujo de tramas más rápido pasaría IF-08 sin problemas y fallaría en la antena, así que una revisión del ICD mira la cadena, no un solo enlace.
- Un elemento sin frecuencia no se comprueba. El Transmitter Enable Command no tiene velocidad de datos, así que la comprobación de capacidad lo deja fuera. Es mínimo, pero un valor vacío es un elemento abierto: dele una frecuencia, o un TBD con responsable.
- La interfaz padre no tiene capacidad propia. Agrupa los elementos de sus enlaces (aquí, tres) y da al par de partes un documento, un responsable y un estado; las comprobaciones de carga se ejecutan en cada enlace.
- Un cambio es trazable. Si la misión pasa a una descarga más rápida, la frecuencia de Downlink Frames cambia en un solo lugar, las comprobaciones de IF-08 e IF-12 se vuelven a ejecutar, y el requisito 5.1, trazado a IF-08, indica qué hay que volver a verificar.
Pruébelo en Holarch
- Cree la demostración con Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → CubeSat (ingeniería de sistemas guiada).
- Abra Interfaces → Diagramas N² y abra el diagrama N² de la acción OPS Run Nominal Imaging Pass para ver los intercambios entre sus funciones.
- Abra Interfaces → ICD, haga clic en + Nuevo diagrama y elija C&DH como Asset padre izquierdo y Communications como derecho.
- Arrastre los conduits existentes IF-07 Radio Command Interface e IF-08 Payload Data Interface desde la paleta al recuadro central. Sus elementos y conexiones vienen con ellos.
- Seleccione un enlace para revisar sus atributos Interface Status, Owner, TBD/TBR, Capacity y Units, y sus requisitos vinculados.
- Haga clic en Exportar documento ICD para obtener el documento de Word, o en Exportar ICD (CSV) para obtener una tabla.
Interfaces → Registro de interfaces enumera todas las interfaces del proyecto con su estado y su comprobación de capacidad; en la demostración muestra IF-05 por encima de su capacidad. Las instrucciones paso a paso están en generar un documento de control de interfaces; las interfaces en línea base cambian mediante solicitudes de cambio.
Siguientes pasos
- Interfaces en Holarch: el registro de interfaces, las comprobaciones de capacidad y los ICD a partir del modelo.
- Documentación de Interfaces: conduits, elementos, el diagrama de control de interfaces y los diagramas N² y de E/S físicas.
- Documentación de Solicitudes de cambio: control de la configuración para elementos en línea base.
- ¿Qué es MBSE?: por qué los ingenieros mantienen el sistema en un modelo.