Difference between revisions of "USB"

From Stm32World Wiki
Jump to navigation Jump to search
Line 128: Line 128:
 
* [https://github.com/obdev/v-usb/blob/master/usbdrv/USB-IDs-for-free.txt Free USB IDs]
 
* [https://github.com/obdev/v-usb/blob/master/usbdrv/USB-IDs-for-free.txt Free USB IDs]
 
* [https://eleccelerator.com/tutorial-about-usb-hid-report-descriptors/ Tutorial about USB HID Report Descriptors]
 
* [https://eleccelerator.com/tutorial-about-usb-hid-report-descriptors/ Tutorial about USB HID Report Descriptors]
 +
* [https://pixcl.com/stm32cubemx-truestudio-and-custom-hid-code/ STM32CubeMX, TrueStudio and Custom HID Code]
  
 
<!--
 
<!--
 
* [https://beyondlogic.org/usbnutshell/usb5.shtml USB In a Nutshell]]
 
* [https://beyondlogic.org/usbnutshell/usb5.shtml USB In a Nutshell]]
 
-->
 
-->

Revision as of 04:18, 1 September 2021


Speed

USB is available in different generations:

Normal speed 1.5 <= Mbps
Full speed <= 12 Mbps
High speed <= 480 Mbps

Device classes

HID Human interface device
MSC Mass storage class
CDC Communication device class
DFU Device firmware update

Descriptors

One of the most complex things when developing USB is the descriptors. Descriptors are used by a USB Gadgets to inform the USB Host about it's capabilities.

Overall, USB Descriptors is a hierarchy of descriptors organised like this:

USB Descriptor Hierarchy.png

A USB device (or gadget) can only have one device descriptor.

When a USB host enumerates a USB device, the device and configuration descriptors are analysed and one configuration is enabled. Only one configuration can be active at any time.

While it _is_ possible for a host to switch configuration on a device offering more than one, it is very rare for devices to offer more than one configuration.

All descriptors, device, configuration or interface, follow the same common format:

Offset Field Size Value Description
0 bLength 1 Number Size of the complete descriptor in bytes
1 bDescriptorType 1 Constant Descriptor type
2 ... n Descriptor parameters

Device Descriptors

The device descriptor represents the entire device and as such each device can only have one of these.

The device descriptor specifies the basic information about the device, such as USB version, packet size, vendor and product id.

Offset Field Size Value Description
0 bLength 1 Number Size of the complete descriptor in bytes
1 bDescriptorType 1 Constant Descriptor type
2 bcdUSB 2 BCD USB specification compliance
4 bDeviceClass 1 Class Contains a class code or zero (indicating each interface specifies it's own) or 0xff (class code vendor specified)

Configuration Descriptors

Configuration Descriptor.png

Interface Descriptors

Endpoint Descriptors

String Descriptors

Miscellaneous Links