Co to jest dokument kontroli interfejsu?

Dokument kontroli interfejsu (ICD) to sformalizowany opis metod i struktur zaangażowanych w dostarczanie danych wejściowych i odbierania wyjściowych z określonego systemu.System opisany przez dokument sterowania interfejsu może być biblioteką oprogramowania lub sprzętem.Dokument nie musi przestrzegać żadnego formatu, ale może być zbiorem akapitów, wykresów, a nawet tylko technicznych rysunków sprzętu interfejsu.Odwołując się konkretnie do oprogramowania, dokument sterujący interfejsem może przypominać i abstrakcyjny interfejs programowania (API), który opisuje metody publiczne lub funkcje, które można wykorzystać do wprowadzania informacji do biblioteki, a także opisuje wynik, które wyniesie.Dokument kontroli interfejsu ogólnie opisuje, jak zintegrować system z większym systemem lub podłączyć go do systemu równoległego;Nie opisuje żadnego wewnętrznego działania systemu, które można pisać w osobnym rodzaju dokumencie.

Celem dokumentu kontrolnego interfejsu jest zapewnienie programistom sprzętu lub oprogramowania, które można użyć podczas tworzeniaSystem lub oprogramowanie, które będą przesyłać dane do i z systemu opisuje ICD.Zazwyczaj oznacza to zdefiniowanie dokładnych funkcji lub komponentów sprzętowych w sposób, w jaki znane są ich podpisy i podano tolerancje parametrów do użycia.W inżynierii oprogramowania może to oznaczać znajomość nazwy konkretnej funkcji, jakiego rodzaju zmiennych są akceptowane jako parametry i, być może, jakie limity funkcjonalne są umieszczane na przekazanych wartościach.W przypadku sprzętu informacje te mogą zawierać funkcje, jakie są szpilki sterowania złącza szeregowego, wszelkie używane sprzętowe przerwania oraz prędkość robocza urządzenia.

Jedną rzeczą, której dokument sterujący interfejsSystem przekłada się na wejście na wyjście lub ogólnie sposób wytwarzania wyjściowego.Umożliwia to programistom wąsko skoncentrowany widok systemu podczas tworzenia interfejsu, ale wymaga również, aby programiści systemu były ściśle przestrzegane przez wytyczne określone w samym dokumencie.Wygodą dla pisarzy dokumentu kontroli interfejsu i twórców systemu jest to, że wewnętrzna implementacja systemu nie jest opisana w dokumencie, a zatem można ją swobodnie zmienić bez wpływu na zewnętrzny rozwój interfejsów opartych na ICD.

W niektórych sytuacjach dokument sterowania interfejsu może pozwolić na testowanie systemów bez konieczności korzystania z pełnego interfejsu.Można to zrobić, symulując różne typy wyjściowe, które system może wygenerować zgodnie z opisem w ICD, a następnie przekazanie tego wyjścia przez zewnętrznie opracowany interfejs.Systemy, które są zainteresowane jedynie obsługą jednej strony systemu i mdash;takie jak wyjście, w przypadku sprzętu, takiego jak urządzenie wyświetlane i mdash;może zapewnić, że interfejs funkcjonuje w specyfikacjach bez konieczności wprowadzania danych w świecie rzeczywistym.