usb

Updated: October 26, 2022

Display USB device configuration

Note: You must be root to run this utility.

Syntax:

usb [-aDtVv] [-b busno -d devno -N name]

Runs on:

QNX Neutrino

Options:

-a
Display descriptors of type 0x24 under the config descriptor as audio descriptors.
-b busno
Display devices on specific busno only.
-D
Get descriptor data from the device, instead of from stored data (io-usb-otg by default stores standard descriptor information).
-d devno
Display device devno only.
-N name
Name of the USB manager to query. The default is /dev/usb/io-usb-otg.
-t
Use a “tree-like” output format.
-V
Display vendor-unique descriptors (at given verbosity level).
-v
Be verbose. The level of detail increases as you add v's.

Description:

The usb utility displays USB device configuration. As you repeat the number of -v (verbose) options, you'll get more levels of detail.

Examples:

Here's some sample output from the command usb -vvv. Note that a USB Hub device with an integrated card reader (IOGEAR Model GUH286) is connected in this case.

# usb -vvv
USB 0 (XHCI) v1.10, v1.01 DDK, v2.00 HCD, DLL: Active
    Control, Interrupt, Bulk(SG), Isoch(Stream), High speed, Super speed

Device Address : 1
Upstream Host Controller : 0
Upstream Device Address : 0
Upstream Port : 1
Upstream Port Speed : High
Vendor : 0x05e3
Product : 0x0608 (USB2.0 Hub)
Device Release : r32.98
USB Spec Release : v2.00
Serial Number : N/A
Class : 0x09 (Hub)
Subclass : 0x00
Protocol : 0x01
Max PacketSize0 : 64
Languages : 0x0409 (English)
Current Frame : 16304 (1024 bytes)
Hub Number Ports : 4
Hub Characteristics : 0x00e0 (Ganged power, Global over-current)
Hub Power On->Good : 100 ms
Hub Power Requirements : 100 mA
Configurations : 1
  Configuration : 1
    Attributes : 0xe0 (Self-powered, Remote-wakeup)
    Max Power : 100 mA
    Interfaces : 1
      Interface : 0 / 0
        Class : 0x09 (Hub)
        Subclass : 0x00
        Protocol : 0x00
        Endpoints : Control + 1
          Endpoint : 0
            Attributes : Control
            Max Packet Size: 1x 64 bytes
          Endpoint : 1
            Attributes : Interrupt/IN
            Max Packet Size: 1x 1 bytes
            Interval : 256 ms

Device Address : 2
Upstream Host Controller : 0
Upstream Device Address : 1
Upstream Port : 3
Upstream Port Speed : High
Vendor : 0x05e3
Product : 0x0608 (USB2.0 Hub)
Device Release : r32.98
USB Spec Release : v2.00
Serial Number : N/A
Class : 0x09 (Hub)
Subclass : 0x00
Protocol : 0x01
Max PacketSize0 : 64
Languages : 0x0409 (English)
Current Frame : 16328 (1024 bytes)
Hub Number Ports : 4
Hub Characteristics : 0x00e0 (Ganged power, Global over-current)
Hub Power On->Good : 100 ms
Hub Power Requirements : 100 mA
Configurations : 1
  Configuration : 1
    Attributes : 0xe0 (Self-powered, Remote-wakeup)
    Max Power : 100 mA
    Interfaces : 1
      Interface : 0 / 0
        Class : 0x09 (Hub)
        Subclass : 0x00
        Protocol : 0x00
        Endpoints : Control + 1
          Endpoint : 0
            Attributes : Control
            Max Packet Size: 1x 64 bytes
          Endpoint : 1
            Attributes : Interrupt/IN
            Max Packet Size: 1x 1 bytes
            Interval : 256 ms

Device Address : 3
Upstream Host Controller : 0
Upstream Device Address : 2
Upstream Port : 1
Upstream Port Speed : High
Vendor : 0x05e3
Product : 0x0716 (USB Storage)
Device Release : r97.44
USB Spec Release : v2.00
Serial Number : 000000009744
Class : 0x00 (Independent per interface)
Max PacketSize0 : 64
Languages : 0x0409 (English)
Current Frame : 1064 (1024 bytes)
Configurations : 1
  Configuration : 1
    Attributes : 0x80 (Bus-powered)
    Max Power : 500 mA
    Interfaces : 1
      Interface : 0 / 0
        Class : 0x08 (Mass Storage)
        Subclass : 0x06 (SCSI)
        Protocol : 0x50
        Endpoints : Control + 2
          Endpoint : 0
            Attributes : Control
            Max Packet Size: 1x 64 bytes
          Endpoint : 1
            Attributes : Bulk/IN
            Max Packet Size: 1x 512 bytes
          Endpoint : 2
            Attributes : Bulk/OUT
            Max Packet Size: 1x 512 bytes