tmk_keyboard/converter/usb_desc_dump

USB Descriptor Dumper

2021-06-30

usb_desc_dump read USB descriptors and shows in HEX dump. This works on TMK USB-USB converter and USB Host Shield with Arduino Leonardo. USB hub is not supported. Device should be plugged directly.

Following descriptors are supported.

• Device Descriptor
• Configuration Descriptor
  • Interface Descriptor
  • Endpoint Descriptor
  • HID Descriptor
• HID Report descriptor

Example optput:

usb_state: 90

Address:01
lowspeed:01
idVendor:046A
idProduct:0011

Device Descriptor:
12  01  00  02  00  00  00  08  6A  04  11  00  00  01  00  00
00  01

Config0: len:0022
09  02  22  00  01  01  00  A0  32  09  04  00  00  01  03  01
01  00  09  21  11  01  00  01  22  40  00  07  05  81  03  08
00  0A

Report0: len:0040
05  01  09  06  A1  01  05  07  19  E0  29  E7  15  00  25  01
75  01  95  08  81  02  95  01  75  08  81  01  95  03  75  01
05  08  19  01  29  03  91  02  95  05  75  01  91  01  95  06
75  08  15  00  26  DD  00  05  07  19  00  29  DD  81  00  C0

To check descriptor content use 'USB Descriptor and Request Parser' on line.

• https://eleccelerator.com/usbdescreqparser/

Or you can use command line tool like hidrd.

• https://github.com/DIGImend/hidrd

$ cat | hidrd-convert -i hex -o spec
05  01  09  06  A1  01  05  07  19  E0  29  E7  15  00  25  01
75  01  95  08  81  02  95  01  75  08  81  01  95  03  75  01
05  08  19  01  29  03  91  02  95  05  75  01  91  01  95  06
75  08  15  00  26  DD  00  05  07  19  00  29  DD  81  00  C0
Usage Page (Desktop),               ; Generic desktop controls (01h)
Usage (Keyboard),                   ; Keyboard (06h, application collection)
Collection (Application),
    Usage Page (Keyboard),          ; Keyboard/keypad (07h)
    Usage Minimum (KB Leftcontrol), ; Keyboard left control (E0h, dynamic value)
    Usage Maximum (KB Right GUI),   ; Keyboard right GUI (E7h, dynamic value)
    Logical Minimum (0),
    Logical Maximum (1),
    Report Size (1),
    Report Count (8),
    Input (Variable),
    Report Count (1),
    Report Size (8),
    Input (Constant),
    Report Count (3),
    Report Size (1),
    Usage Page (LED),               ; LEDs (08h)
    Usage Minimum (01h),
    Usage Maximum (03h),
    Output (Variable),
    Report Count (5),
    Report Size (1),
    Output (Constant),
    Report Count (6),
    Report Size (8),
    Logical Minimum (0),
    Logical Maximum (221),
    Usage Page (Keyboard),          ; Keyboard/keypad (07h)
    Usage Minimum (None),           ; No event (00h, selector)
    Usage Maximum (KP Hexadecimal), ; Keypad Hexadecimal (DDh, selector)
    Input,
End Collection