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 sterowania 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 spowodują. 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 funkcjonowania systemu, które można określić w osobnym rodzaju dokumencie.

Celem dokumentu kontrolnego interfejsu jest zapewnienie programistom sprzętu lub oprogramowania pewną dokumentację, której można użyć podczas tworzenia systemu lub oprogramowania, które będą przesyłać dane do i z systemu opisywane przez 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 funkcje sterują złącza szeregowego, wszelkie używane sprzętowe przerwania oraz prędkość robocza urządzenia.

Jedną rzeczą, którą dokument sterujący interfejsu nie opisuje konkretnie, jest to, w jaki sposób system tłumaczy Input Into Wyjście lub sposób wytwarzania wyjściowego ogólnie. Umożliwia to programistom wąsko skoncentrowany widok systemu podczas tworzenia interfejsu, ale wymaga również, aby programiści systemu systemu ICD ściśle przylegali do wytycznych określonych 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 swobodnie zmienić bez wpływu na zewnętrzny rozwój interfejsów opartych na ICD.

W niektórych sytuacjach dokument sterowania interfejsem 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 - takie jakWyjście, w przypadku sprzętu, takiego jak urządzenie wyświetlane-może zapewnić, że interfejs działa w specyfikacjach bez konieczności wprowadzania danych w świecie rzeczywistym.