Stworzenie nowego urządzenia (na razie jego szkieletu) polega na stworzeniu nowego katalogu:
|
1 2 3 4 5 6 |
$ mkdir g1 $ cd g1 $ ls UDC bDeviceSubClass bcdUSB idProduct strings bDeviceClass bMaxPacketSize0 configs idVendor bDeviceProtocol bcdDevice functions os_desc |
Należy określić identyfikatory: producenta i urządzenia:
|
1 2 |
$ echo > idVendor $ echo > idProduct |
W celach testowych możemy posłużyć się identyfikatorami zarejestrowanymi przez Linux Foundation:
|
1 2 3 4 5 6 7 8 9 10 11 |
1d6b Linux Foundation 0001 1.1 root hub 0002 2.0 root hub 0003 3.0 root hub 0100 PTP Gadget 0101 Audio Gadget 0102 EEM Gadget 0103 NCM (Ethernet) Gadget 0104 Multifunction Composite Gadget 0105 FunctionFS Gadget 0200 Qemu Audio Device |
Urządzenie powinno także zgłaszać numer seryjny, oraz nazwy: urządzenia i producenta. W tym celu, należy stworzyć odpowiedni podkatalog strings. Numer określa język (0x409 – angielski por. http://en.wikipedia.org/wiki/Locale#Specifics_for_Microsoft_platforms).
|
1 2 3 4 |
$ mkdir strings/0x409 $ echo > strings/0x409/serialnumber $ echo > strings/0x409/manufacturer $ echo > strings/0x409/product |
Można przystąpić do tworzenia konfiguracji:
|
1 2 3 4 |
$ mkdir configs/c.1 $ mkdir configs/c.1/strings/0x409 $ echo > configs/c.1/strings/0x409/configuration $ echo 120 > configs/c.1/MaxPower |
Funkcje (interfejsy)
|
1 |
$ mkdir functions/ncm.usb0 |
Zostanie automatycznie załadowany moduł usb_f_ncm.ko
Poszczególne funkcje dostarczają własnego zestawu atrybutów, które należy ustawić. Dla NCM (karta sieciowa) są to:
|
1 |
dev_addr host_addr ifname qmult |
Następnie dodajemy interfejs do konfiguracji:
|
1 |
$ ln -s functions/ncm.usb0 configs/c.1 |
Skonfigurowany w powyższy sposób gadget, należy na koniec skojarzyć ze sterownikiem kontrolera UDC. W tym celu wpisujemy jego nazwę do:
|
1 |
$ echo <udc name> > UDC |
Nazwa określona jest w:
|
1 2 |
$ ls /sys/class/udc/ ci_hdrc.0 |
Stąd:
|
1 |
$ echo ci_hdrc.0 > UDC |
W systemie działającym na Wandboard-zie rejestrowany jest interfejs sieciowy usb0.
Po stronie PC mamy:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
$ lsusb Bus 001 Device 065: ID 1d6b:0103 Linux Foundation NCM (Ethernet) Gadget $ dmesg usb 1-1.1: new high-speed USB device number 65 using xhci_hcd usb 1-1.1: New USB device found, idVendor=1d6b, idProduct=0103 usb 1-1.1: New USB device strings: Mfr=1, Product=2, SerialNumber=3 usb 1-1.1: Product: WB Test Device usb 1-1.1: Manufacturer: BIS-Linux usb 1-1.1: SerialNumber: 0123456789abcd cdc_ncm 1-1.1:1.0: MAC-Address: 4e:31:19:b1:03:c8 cdc_ncm 1-1.1:1.0 usb0: register 'cdc_ncm' at usb-0000:00:10.0-1.1, CDC NCM, 4e:31:19:b1:03:c8 usbcore: registered new interface driver cdc_ncm cdc_ncm 1-1.1:1.0 usb0: 425 mbit/s downlink 425 mbit/s uplink |
Mechanizm configfs umożlwia modyfikowanie urządzeń w locie – konfiguracje ich interfejsy mogą być na bieżąco zmieniane. Możliwe jest także obsługiwanie endpointów z przestrzeni użytkownika (libusb).
Dla ułatwienia konfiguracji urządzeń klienckich, powstała biblioteka libgusb (https://github.com/libusbg/libusbg).
Wandboard QUAD i inne zestawy z procesorami i.MX6 firmy Freescale wykorzystywane są podczas organizowanych przeze mnie szkoleń. Więcej informacji: http://bis-linux.com/pl/terminy_szkolen
