USB shell
Overview
The sample enables new experimental USB device support and the shell function. It is primarily intended to aid in the development and testing of USB controller drivers and new USB support.
Building and flashing
Assuming the board has a supported USB device controller, the example can be built like:
west build -b reel_board samples/subsys/usb/shell
west flash
For the USB host functionality a supported host controller is required, currently it is only MAX3421E. The example can be built as follows:
west build -b nrf52840dk/nrf52840 --shield sparkfun_max3421e samples/subsys/usb/shell -- -DCONFIG_UHC_DRIVER=y -DCONFIG_USB_HOST_STACK=y
west flash
It is theoretically possible to build USB support using virtual USB controllers
for all platforms, eventually the devicetree overlay has to be adjusted slightly if
the platform has already defined or not zephyr_uhc0 or zephyr_udc0 nodelabels.
west build -b nrf52840dk/nrf52840 samples/subsys/usb/shell -- -DEXTRA_CONF_FILE=virtual.conf -DDTC_OVERLAY_FILE=virtual.overlay
west flash
Sample shell interaction
*** Booting Zephyr OS build v4.2.0-1588-g83f1bd7341de ***
uart:~$ usbd defcfg
dev: added default string descriptors
dev: register FS loopback_0
dev: register HS loopback_0
dev: USB initialized
uart:~$ usbh init
host: USB host initialized
uart:~$ usbh enable
host: USB host enabled
uart:~$ usbh bus resume
host: USB bus resumed
uart:~$ usbd enable
dev: USB enabled
[160:04:13.870,000] <inf> usb_loopback: Enable loopback_0
uart:~$ usbh device list
1
uart:~$ usbh device descriptor device 1
host: USB device with address 1
bLength 18
bDescriptorType 1
bcdUSB 200
bDeviceClass 239
bDeviceSubClass 2
bDeviceProtocol 1
bMaxPacketSize0 64
idVendor 2fe3
idProduct ffff
bcdDevice 402
iManufacturer 1
iProduct 2
iSerial 3
bNumConfigurations 1
uart:~$