Sebuah dokumen kontrol antarmuka (ICD) adalah deskripsi formal dari metode dan struktur yang terlibat dalam memberikan input dan menerima output dari sistem tertentu. Sistem yang dijelaskan oleh dokumen kontrol antarmuka dapat berupa perpustakaan perangkat lunak atau perangkat keras. Dokumen tidak harus mengikuti format tunggal apa pun tetapi dapat berupa kumpulan paragraf, bagan, atau bahkan hanya gambar teknis dari perangkat keras antarmuka. Jika merujuk secara khusus ke perangkat lunak, dokumen kontrol antarmuka dapat menyerupai dan antarmuka pemrograman abstrak ( API ), yang menggambarkan metode atau fungsi publik yang dapat digunakan untuk memasukkan informasi ke dalam perpustakaan dan juga menggambarkan output yang akan dihasilkan. Dokumen kontrol antarmuka umumnya menjelaskan bagaimana mengintegrasikan sistem ke dalam sistem yang lebih besar atau menghubungkannya ke sistem paralel; itu tidak menjelaskan cara kerja internal sistem, yang mungkin dijabarkan dalam jenis dokumen terpisah.
Pria memegang komputer
Tujuan dari dokumen kontrol antarmuka adalah untuk memberikan pengembang perangkat keras atau perangkat lunak beberapa dokumentasi yang dapat digunakan saat membuat sistem atau perangkat lunak yang akan mentransfer data ke dan dari sistem yang dijelaskan oleh ICD. Ini biasanya berarti mendefinisikan fungsi yang tepat atau komponen perangkat keras dengan cara yang tanda tangannya diketahui dan toleransi parameter untuk digunakan diberikan. Dalam rekayasa perangkat lunak, ini bisa berarti mengetahui nama fungsi tertentu, jenis variabel apa yang diterima sebagai parameter dan, mungkin, batasan fungsional apa yang ditempatkan pada nilai yang dilewatkan. Untuk suatu perangkat keras, informasi ini dapat mencakup fungsi pin dari kontrol konektor serial, interupsi perangkat keras apa pun yang digunakan, dan kecepatan kerja perangkat.
Satu hal yang tidak dijelaskan secara spesifik oleh dokumen kontrol antarmuka adalah bagaimana sistem menerjemahkan input menjadi output, atau bagaimana output diproduksi, secara umum. Ini memungkinkan pengembang untuk mengambil pandangan sistem yang terfokus secara sempit saat membuat antarmuka, tetapi juga mengharuskan pengembang sistem agar detail ICD mematuhi secara ketat pedoman yang dijabarkan dalam dokumen itu sendiri. Kenyamanan bagi penulis dokumen kontrol antarmuka dan pengembang sistem adalah bahwa implementasi internal sistem tidak dijelaskan dalam dokumen dan, dengan demikian, dapat diubah secara bebas tanpa mempengaruhi pengembangan luar antarmuka yang bergantung pada ICD.
Dalam beberapa situasi, dokumen kontrol antarmuka dapat memungkinkan pengujian sistem tanpa benar-benar harus menggunakan antarmuka yang lengkap. Hal ini dapat dilakukan dengan mensimulasikan berbagai jenis output yang dapat dihasilkan sistem seperti yang dijelaskan dalam ICD, dan kemudian meneruskan output tersebut melalui antarmuka yang dikembangkan secara eksternal. Sistem yang hanya tertarik menangani satu sisi sistem ? seperti output, dalam hal perangkat keras seperti perangkat tampilan ? dapat memastikan bahwa antarmuka berfungsi dalam spesifikasi tanpa memerlukan input dunia nyata.