Gambaran umum pengembangan driver Windows untuk pengontrol fungsi USB

Artikel
01/12/2024

Artikel ini menjelaskan dukungan dalam sistem operasi Windows, untuk mengembangkan driver pengontrol fungsi Universal Serial Bus (USB) yang berkomunikasi dengan ekstensi pengontrol fungsi USB (UFX) yang disediakan Microsoft.

Alat pengembangan dan biner yang disediakan Microsoft

Windows Driver Kit (WDK) berisi sumber daya yang diperlukan untuk pengembangan driver, seperti header, pustaka, alat, dan sampel.

Mengunduh kit dan alat untuk Windows

Windows menyediakan driver pengontrol fungsi USB kotak masuk seperti UfxSynopsys.sys untuk perangkat keras pengontrol IP Sinopsi. Mereka umumnya memerlukan perubahan tingkat platform dan validasi yang biasanya dilakukan oleh mitra perangkat keras atau OEM saat memunculkan platform. Proses bring-up ini dapat mencakup integrasi dengan ACPI untuk memberi tahu driver sistem tentang peristiwa usb attach/detach, dan melakukan validasi tambahan menggunakan pengujian HLK yang disediakan Microsoft. Untuk menulis driver pengontrol Anda sendiri, Anda perlu:

UFX (Ufx01000.sys) dimuat sebagai FDO. Pengandar ini disertakan dalam Windows.
Tautkan ke pustaka stub (Ufx01000.lib). Pustaka stub ada di WDK. Pustaka menerjemahkan panggilan yang dilakukan oleh driver pengontrol fungsi dan meneruskannya ke UFX.
Sertakan Ufxclient.h yang disediakan dalam WDK.

Untuk mengirim permintaan dari mode pengguna, Anda memerlukan:

GenericUSBFn.sys dimuat sebagai driver kelas fungsi USB. Pengandar ini disertakan dalam Windows.
Sertakan Genericusbfnioctl.h yang disediakan dalam WDK.

Untuk mengirim permintaan dari driver kelas USB, Anda memerlukan:

UFX (Ufx01000.sys) dimuat sebagai FDO. Pengandar ini disertakan dalam Windows.
Sertakan Usbfnioctl.h yang disediakan di WDK.

Untuk menulis driver filter yang menangani pengisian daya melalui pengisi daya kepemilikan, Anda memerlukan:

Baik UfxChipidea.sys atau Ufxsynopsys.sys dimuat sebagai driver klien ke UFX.
Sertakan Ufxproprietarycharger.h yang disediakan dalam WDK.

Arsitektur UFX

Biasakan diri Anda dengan tumpukan driver USB yang disediakan Microsoft:

Driver sisi perangkat USB di Windows

Biasakan diri Anda dengan objek dan handel UFX

UFX memperluas fungsionalitas objek WDF untuk menentukan objek UCX khusus USB sendiri. Untuk detail selengkapnya tentang objek WDF, lihat Pengantar Objek Kerangka Kerja.

Untuk permintaan antrean, UFX menggunakan objek khusus USB. Untuk informasi selengkapnya, objek UFX dan handel yang digunakan oleh driver klien fungsi USB.