Co je dokument řízení rozhraní?
Dokument řízení rozhraní (ICD) je formalizovaný popis metod a struktur zapojených do poskytování vstupu a přijímání výstupu z konkrétního systému. Systém, který je popsán v dokumentu pro ovládání rozhraní, může být softwarová knihovna nebo kus hardwaru. Dokument nemusí sledovat žádný jednotný formát, ale může to být sbírka odstavců, grafů nebo dokonce jen technické výkresy hardwaru rozhraní. Když se odkazuje konkrétně na software, dokument ovládání rozhraní se může podobat a abstraktní programovací rozhraní (API), které popisuje veřejné metody nebo funkce, které lze použít k zadávání informací do knihovny, a také popisuje výstup, který bude výsledkem. Dokument řízení rozhraní obecně popisuje, jak integrovat systém do většího systému nebo jej připojit k paralelnímu systému; nepopisuje žádné vnitřní fungování systému, které by mohly být uvedeny v samostatném typu dokumentu.
Účelem dokumentu pro řízení rozhraní je poskytnout vývojářům hardwaru nebo softwaru určitou dokumentaci, která může být použita při vytváření systému nebo softwaru, který bude přenášet data do a ze systému, který popisuje ICD. To obvykle znamená definování přesných funkcí nebo hardwarových komponent tak, aby byly známy jejich podpisy a aby byly uvedeny tolerance parametrů pro použití. V softwarovém inženýrství to může znamenat znát název konkrétní funkce, jaký typ proměnných je přijímán jako parametry a případně, jaké funkční limity jsou umístěny na předávané hodnoty. U hardwaru mohou tyto informace zahrnovat, jaké funkce ovládají kolíky sériového konektoru, jakákoli použitá hardwarová přerušení a pracovní rychlost zařízení.
Jedna věc, kterou dokument o řízení rozhraní výslovně nepopisuje, je to, jak systém převádí vstup na výstup nebo jak je výstup produkován obecně. To umožňuje vývojářům při vytváření rozhraní zaujmout úzce zaměřený pohled na systém, ale také to vyžaduje, aby vývojáři systému, o nichž se podrobnosti o ICD shodují, přísně dodržovali pokyny uvedené v samotném dokumentu. Výhodou pro autory dokumentu pro řízení rozhraní a pro vývojáře systému je to, že interní implementace systému není v dokumentu popsána, a proto může být volně měněna bez ovlivnění vnějšího vývoje rozhraní spoléhajících se na ICD.
V některých situacích může dokument kontroly rozhraní umožňovat testování systémů, aniž by ve skutečnosti musel používat dokončené rozhraní. Toho lze dosáhnout simulací různých typů výstupů, které může systém generovat, jak je popsáno v ICD, a pak předáním tohoto výstupu externě vyvinutým rozhraním. Systémy, které mají zájem pouze o manipulaci s jednou stranou systému - jako je výstup, v případě hardwaru, jako je zobrazovací zařízení - mohou zajistit, že rozhraní funguje v rámci specifikací, aniž by vyžadovalo vstup v reálném světě.