Что такое документ управления интерфейсом?

Документ управления интерфейсом (ICD) представляет собой формализованное описание методов и структур, участвующих в предоставлении входных данных и получении выходных данных от конкретной системы. Система, которая описывается документом управления интерфейсом, может быть библиотекой программного обеспечения или частью аппаратного обеспечения. Документ не должен следовать какому-либо одному формату, но может представлять собой набор абзацев, диаграмм или даже просто технические чертежи аппаратного обеспечения интерфейса. При обращении конкретно к программному обеспечению документ управления интерфейсом может напоминать и абстрагировать программный интерфейс (API), который описывает общедоступные методы или функции, которые могут использоваться для ввода информации в библиотеку, а также описывает вывод, который будет получен. Документ управления интерфейсом обычно описывает, как интегрировать систему в большую систему или подключить ее к параллельной системе; он не описывает какую-либо внутреннюю работу системы, которая может быть изложена в отдельном типе документа.

Цель документа управления интерфейсом состоит в том, чтобы предоставить разработчикам аппаратного или программного обеспечения некоторую документацию, которая может использоваться при создании системы или программного обеспечения, которое будет передавать данные в систему и из системы, описываемой ICD. Обычно это означает определение точных функций или аппаратных компонентов таким образом, чтобы их сигнатуры были известны, и давались допуски параметров для использования. В разработке программного обеспечения это может означать знание имени конкретной функции, типа переменных, принимаемых в качестве параметров, и, возможно, какие функциональные ограничения накладываются на передаваемые значения. Для части аппаратного обеспечения эта информация может включать информацию о функциях управления контактами последовательного разъема, любых используемых аппаратных прерываниях и скорости работы устройства.

Одна вещь, которую документ управления интерфейсом конкретно не описывает, это то, как система переводит ввод в вывод или как вывод производится в целом. Это позволяет разработчикам принимать узко сфокусированное представление о системе при создании интерфейса, но также требует, чтобы разработчики системы, которые подробно описывают ICD, строго придерживались рекомендаций, изложенных в самом документе. Удобство для авторов документа управления интерфейсом и разработчиков системы состоит в том, что внутренняя реализация системы не описана в документе и, таким образом, может быть свободно изменена без воздействия на внешнюю разработку интерфейсов, основанную на ICD.

В некоторых ситуациях документ управления интерфейсом может допускать тестирование систем без фактического использования завершенного интерфейса. Это может быть сделано путем моделирования различных типов выходных данных, которые система может генерировать, как описано в ICD, и затем передачи этих выходных данных через разработанный извне интерфейс. Системы, которые заинтересованы только в обработке одной стороны системы, например, в случае аппаратного обеспечения, такого как устройство отображения, могут обеспечивать работу интерфейса в соответствии со спецификациями, не требуя реального ввода.