¿Qué es un documento de control de interfaz?
Un documento de control de interfaz (ICD) es una descripción formal de los métodos y estructuras involucradas en proporcionar entrada y recibir salida de un sistema específico. El sistema descrito por el documento de control de interfaz puede ser una biblioteca de software o una pieza de hardware. El documento no tiene que seguir ningún formato único, pero puede ser una colección de párrafos, gráficos o incluso solo dibujos técnicos del hardware de la interfaz. Cuando se refiere específicamente al software, un documento de control de interfaz puede parecerse a la interfaz de programación (API) abstracta, que describe los métodos o funciones públicas que pueden usarse para ingresar información en la biblioteca y también describe la salida que resultará. Un documento de control de interfaz generalmente describe cómo integrar el sistema en un sistema más grande o conectarlo a un sistema paralelo; No describe ninguno de los funcionamientos internos del sistema, que podría explicarse en un tipo de documento separado.
El propósito de un documento de control de interfaz es proporcionar a los desarrolladores de hardware o software alguna documentación que se pueda utilizar al crear un sistema o software que transfiera datos hacia y desde el sistema que el ICD está describiendo. Esto generalmente significa definir funciones exactas o componentes de hardware de una manera que se conocen sus firmas y se dan las tolerancias de los parámetros para su uso. En la ingeniería de software, esto puede significar conocer el nombre de una función particular, qué tipo de variables se aceptan como parámetros y, posiblemente, qué límites funcionales se colocan en los valores que se pasan. Para una pieza de hardware, esta información puede incluir las funciones de los pines de un control de conector en serie, cualquier interrupción de hardware que se use y la velocidad de trabajo del dispositivo.
Una cosa que un documento de control de interfaz no describe específicamente es cómo el sistema traduce la entrada into Salida, o cómo se produce la salida, en general. Esto permite a los desarrolladores tener una visión estrechamente enfocada del sistema al crear una interfaz, pero también requiere que los desarrolladores del sistema que los detalles de ICD se adhieran estrictamente a las pautas que se explican en el documento en sí. Una conveniencia para los escritores de un documento de control de interfaz y los desarrolladores del sistema es que la implementación interna del sistema no se describe en el documento y, por lo tanto, puede cambiarse libremente sin afectar el desarrollo externo de las interfaces que depende de la ICD.
En algunas situaciones, un documento de control de interfaz puede permitir la prueba de sistemas sin tener que usar una interfaz completa. Esto se puede hacer simulando los diversos tipos de salida que un sistema puede generar como se describe en la DAI, y luego pasando esa salida a través de la interfaz desarrollada externamente. Sistemas que solo están interesados en manejar un lado del sistema, como elLa salida, en el caso de hardware, como un dispositivo de visualización, puede garantizar que la interfaz funcione dentro de las especificaciones sin requerir la entrada del mundo real.