¿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 que intervienen en el suministro de entrada y la salida de un sistema específico. El sistema que se describe en 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 una interfaz de programación abstracta (API), que describe los métodos o funciones públicas que pueden usarse para ingresar información en la biblioteca y también describe el resultado 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ían 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 cierta documentación que se pueda utilizar al crear un sistema o software que transfiera datos hacia y desde el sistema que describe el ICD. Esto generalmente significa definir funciones exactas o componentes de hardware de manera que se conozcan sus firmas y se den las tolerancias de los parámetros para su uso. En ingeniería de software, esto puede significar conocer el nombre de una función en 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 qué funciones controlan los pines de un conector en serie, las interrupciones de hardware que se utilizan y la velocidad de funcionamiento del dispositivo.
Una cosa que un documento de control de interfaz no describe específicamente es cómo el sistema traduce la entrada en salida, o cómo se produce la salida, en general. Esto permite a los desarrolladores tener una visión del sistema estrechamente enfocada al crear una interfaz, pero también requiere que los desarrolladores del sistema que detalla el ICD cumplan estrictamente con las pautas detalladas en el documento mismo. Una conveniencia para los escritores de un documento de control de interfaz y para los desarrolladores del sistema es que la implementación interna del sistema no se describe en el documento y, por lo tanto, se puede cambiar libremente sin afectar el desarrollo externo de interfaces que dependen del 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 el ICD, y luego pasando esa salida a través de la interfaz desarrollada externamente. Los sistemas que solo están interesados en manejar un lado del sistema, como la salida, en el caso de hardware como un dispositivo de visualización, pueden garantizar que la interfaz funcione dentro de las especificaciones sin requerir una entrada del mundo real.