O que é um documento de controle de interface?

Um documento de controle de interface (CID) é uma descrição formalizada dos métodos e estruturas envolvidas no fornecimento de entrada e recebimento de saída de um sistema específico. O sistema descrito pelo documento de controle da interface pode ser uma biblioteca de software ou um hardware. O documento não precisa seguir nenhum formato, mas pode ser uma coleção de parágrafos, gráficos ou mesmo apenas desenhos técnicos do hardware da interface. Ao se referir especificamente ao software, um documento de controle de interface pode se parecer e a interface de programação abstrata (API), que descreve os métodos ou funções públicas que podem ser usadas para inserir informações na biblioteca e também descreve a saída que resultará. Um documento de controle de interface geralmente descreve como integrar o sistema em um sistema maior ou conectá -lo a um sistema paralelo; Ele não descreve nenhum dos funcionamentos internos do sistema, que pode ser explicitado em um tipo separado de documento.

O objetivo de um documento de controle de interface é fornecer aos desenvolvedores de hardware ou software alguma documentação que possa ser usada ao criar um sistema ou software que transferirá dados para e para o sistema que o CDI está descrevendo. Isso geralmente significa definir funções exatas ou componentes de hardware de uma maneira que suas assinaturas são conhecidas e as tolerâncias dos parâmetros para uso são fornecidos. Na engenharia de software, isso pode significar saber o nome de uma função específica, que tipo de variáveis ​​são aceitas como parâmetros e, possivelmente, que limites funcionais são colocados nos valores que são passados. Para um hardware, essas informações podem incluir quais funções os pinos de um controle de conector serial, qualquer interrupção de hardware que é usada e a velocidade de trabalho do dispositivo.

Uma coisa que um documento de controle de interface não descreve especificamente é como o sistema traduz a entradao Saída, ou como a saída é produzida, em geral. Isso permite que os desenvolvedores tenham uma visão estreitamente focada do sistema ao criar uma interface, mas também exige que os desenvolvedores do sistema os detalhes do CDI cumpram estritamente as diretrizes explicadas no próprio documento. Uma conveniência para os escritores de um documento de controle de interface e os desenvolvedores do sistema é que a implementação interna do sistema não é descrita no documento e, portanto, pode ser alterada livremente sem afetar o desenvolvimento externo de interfaces que dependem da ICD.

Em algumas situações, um documento de controle de interface pode permitir o teste de sistemas sem realmente ter que usar uma interface concluída. Isso pode ser feito simulando os vários tipos de saída que um sistema pode gerar conforme descrito no CDI e depois passando essa saída através da interface desenvolvida externamente. Sistemas que só estão interessados ​​em lidar com um lado do sistema - como oSaída, no caso de hardware, como um dispositivo de exibição-pode garantir que a interface funcione dentro das especificações sem exigir a entrada do mundo real.