/sys/kernel/debug/usb/devices解析

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

1.概述

USB设备通过debugfs导出/sys/kernel/debug/usb/devices显示内核已知的每个USB设备及其配置描述符。此文件对于用户模式下的状态查看
工具非常方便，可以扫描文本格式并忽略大部分文本。设备特定文件中提供了更详细的设备状态（包括类和供应商状态）。

此文件与poll()系统调用结合使用，还可用于检测何时添加或删除设备：

int fd;

struct pollfd pfd;

fd = open("/sys/kernel/debug/usb/devices", O_RDONLY);

pfd = { fd, POLLIN,  };

for (;;) {

    /* The first time through, this call will return immediately. */

    poll(&pfd, , -);

    /* To see what's changed, compare the file's previous and current

       contents or scan the filesystem.  (Scanning is more precise.) */

}

请注意，此行为旨在用于信息获取和调试目的。例如，使用诸如udev或HAL之类的程序来初始化设备或启动用户模式助手程序会更合适。

2.文件格式
每个T：行（拓扑信息：Lev，Prnt，Port，Cnt）的前4列中的数字可用于构建USB拓扑图。
每行标记有该行的单字符ID：

T = Topology (etc.)

B = Bandwidth (applies only to USB host controllers, which are virtualized as root hubs)

D = Device descriptor info.

P = Product ID info. (from Device descriptor, but they won't fit together on one line)

S = String descriptors.

C = Configuration descriptor info. (* = active configuration)

I = Interface descriptor info.

E = Endpoint descriptor info.

历史遗留：d = 十进制数（可能有前导空格或0） x = 十六进制数（可能有前导空格或0） s = string

1）拓扑信息：

T:  Bus=dd Lev=dd Prnt=dd Port=dd Cnt=dd Dev#=ddd Spd=dddd MxCh=dd

|   |      |      |       |       |      |        |        |__MaxChildren

|   |      |      |       |       |      |        |__Device Speed in Mbps

|   |      |      |       |       |      |__DeviceNumber

|   |      |      |       |       |__Count of devices at this level

|   |      |      |       |__Connector/Port on Parent for this device

|   |      |      |__Parent DeviceNumber

|   |      |__Level in topology for this bus

|   |__Bus number

|__Topology info tag

Speed如下，插入端口4的设备将显示Port = 03。

1.5 Mbit/s for low speed USB

  Mbit/s for full speed USB

 Mbit/s for high speed USB (added for USB 2.0); also used for Wireless USB, which has no fixed speed

 Mbit/s for SuperSpeed USB (added for USB 3.0)

2）带宽信息：

B:  Alloc=ddd/ddd us (xx%), #Int=ddd, #Iso=ddd

|   |                       |         |__Number of isochronous requests

|   |                       |__Number of interrupt requests

|   |__Total Bandwidth allocated to this bus

|__Bandwidth info tag

3）设备描述符信息和产品ID信息：

D:  Ver=x.xx Cls=xx(s) Sub=xx Prot=xx MxPS=dd #Cfgs=dd

P:  Vendor=xxxx ProdID=xxxx Rev=xx.xx

D:  Ver=x.xx Cls=xx(sssss) Sub=xx Prot=xx MxPS=dd #Cfgs=dd

|   |        |             |      |       |       |__NumberConfigurations

|   |        |             |      |       |__MaxPacketSize of Default Endpoint

|   |        |             |      |__DeviceProtocol

|   |        |             |__DeviceSubClass

|   |        |__DeviceClass

|   |__Device USB version

|__Device info tag #

P:  Vendor=xxxx ProdID=xxxx Rev=xx.xx

|   |           |           |__Product revision number

|   |           |__Product ID code

|   |__Vendor ID code

|__Device info tag #

4）字符串描述符信息：

S:  Manufacturer=ssss

|   |__Manufacturer of this device as read from the device.

|      For USB host controller drivers (virtual root hubs) this may

|      be omitted, or (for newer drivers) will identify the kernel

|      version and the driver which provides this hub emulation.

|__String info tag

S:  Product=ssss

|   |__Product description of this device as read from the device.

|      For older USB host controller drivers (virtual root hubs) this

|      indicates the driver; for newer ones, it's a product (and vendor)

|      description that often comes from the kernel's PCI ID database.

|__String info tag

S:  SerialNumber=ssss

|   |__Serial Number of this device as read from the device.

|      For USB host controller drivers (virtual root hubs) this is

|      some unique ID, normally a bus ID (address or slot name) that

|      can't be shared with any other device.

|__String info tag

5）配置描述符信息：

C:* #Ifs=dd Cfg#=dd Atr=xx MPwr=dddmA

| | |       |       |      |__MaxPower in mA

| | |       |       |__Attributes

| | |       |__ConfiguratioNumber

| | |__NumberOfInterfaces

| |__ "*" indicates the active configuration (others are " ")

|__Config info tag

USB设备可能具有多种配置，每种配置的行为都不同。例如，总线供电的配置可能比自供电配置的能力低得多。一次只能激活一个设备配
置; 大多数设备只有一个配置。
每个配置都包含一个或多个接口。每个接口都提供不同的“功能”，通常绑定到不同的USB设备驱动程序。一个常见的例子是带有用于回放的
音频接口的USB扬声器，以及用于软件音量控制的HID接口。

:6）接口描述符信息：

I:* If#=dd Alt=dd #EPs=dd Cls=xx(sssss) Sub=xx Prot=xx Driver=ssss

| | |      |      |       |             |      |       |__Driver name

| | |      |      |       |             |      |          or "(none)"

| | |      |      |       |             |      |__InterfaceProtocol

| | |      |      |       |             |__InterfaceSubClass

| | |      |      |       |__InterfaceClass

| | |      |      |__NumberOfEndpoints

| | |      |__AlternateSettingNumber

| | |__InterfaceNumber

| |__ "*" indicates the active altsetting (others are " ")

|__Interface info tag

一个给定接口可以具有一个或多个“可选”设置。例如，默认设置可能不会使用少量的周期性带宽。要使用大部分总线带宽，驱动程序必须
选择非默认的altsetting。
一次只能有一个接口的设置处于活动状态，并且一次只能有一个驱动程序绑定到接口。大多数设备每个接口只有一个可用设置。

7）端点描述符信息：

E:  Ad=xx(s) Atr=xx(ssss) MxPS=dddd Ivl=dddss

|   |        |            |         |__Interval (max) between transfers

|   |        |            |__EndpointMaxPacketSize

|   |        |__Attributes(EndpointType)

|   |__EndpointAddress(I=In,O=Out)

|__Endpoint info tag

所有周期性（中断或等时）端点的间隔都是非零的。对于高速端点，传输间隔可以以微秒而不是毫秒来度量。
对于高速周期端点，EndpointMaxPacketSize反映了每微帧数据传输大小。对于“高带宽”端点，每个端点可以反映两个或三个数据包（每125
个用户最多3个字节）。
使用Linux-USB堆栈，定期带宽保留使用URB提供的传输间隔和大小，这可能小于端点描述符中的传输间隔和大小。

3.此文件的使用例子

例如，如果用户或脚本仅对拓扑信息感兴趣，请使用类似的内容

grep ^T: /sys/kernel/debug/usb/devices 仅用于拓扑行。
grep -i ^[tdp]: /sys/kernel/debug/usb/devices 这样的命令可用于仅列出以方括号中的字符开头的行，其中有效字符为TDPCIE。使用稍
微更强大的脚本，它可以显示任何选定的行（例如，只显示T，D和P行）并更改其输出格式。（procusb Perl脚本是这个想法的开始。它将
仅列出从/sys/kernel/debug/usb/devices中选择的行[从TBDPSCIE中选择]或“All”行。）

拓扑行可用于生成系统根集线器上USB设备的图形/图示。
接口行可用于确定每个设备使用的驱动程序，以及被激活的可选设置。
配置行可用于列出系统的USB设备正在使用的最大功率（以毫安为单位）。例如:/sys/kernel/debug/usb/devices.

eg:

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=   MxCh=

B:  Alloc= / us ( %), #Int=  , #Iso=

D:  Ver= 1.00 Cls=(hub  ) Sub= Prot= MxPS=  #Cfgs=

P:  Vendor= ProdID= Rev= 0.00

S:  Product=USB UHCI Root Hub

S:  SerialNumber=dce0

C:* #Ifs=  Cfg#=  Atr= MxPwr=  0mA

I:  If#=  Alt=  #EPs=  Cls=(hub  ) Sub= Prot= Driver=hub

E:  Ad=(I) Atr=(Int.) MxPS=    Ivl=255ms

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=   MxCh=

D:  Ver= 1.00 Cls=(hub  ) Sub= Prot= MxPS=  #Cfgs=

P:  Vendor= ProdID= Rev= 1.00

C:* #Ifs=  Cfg#=  Atr=e0 MxPwr=100mA

I:  If#=  Alt=  #EPs=  Cls=(hub  ) Sub= Prot= Driver=hub

E:  Ad=(I) Atr=(Int.) MxPS=    Ivl=255ms

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=1.5  MxCh=

D:  Ver= 1.00 Cls=(>ifc ) Sub= Prot= MxPS=  #Cfgs=

P:  Vendor=04b4 ProdID= Rev= 0.00

C:* #Ifs=  Cfg#=  Atr= MxPwr=100mA

I:  If#=  Alt=  #EPs=  Cls=(HID  ) Sub= Prot= Driver=mouse

E:  Ad=(I) Atr=(Int.) MxPS=    Ivl= 10ms

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=   MxCh=

D:  Ver= 1.00 Cls=(>ifc ) Sub= Prot= MxPS=  #Cfgs=

P:  Vendor= ProdID= Rev= 1.08

S:  Manufacturer=Peracom Networks, Inc.

S:  Product=Peracom USB to Serial Converter

C:* #Ifs=  Cfg#=  Atr=a0 MxPwr=100mA

I:  If#=  Alt=  #EPs=  Cls=(>ifc ) Sub= Prot= Driver=serial

E:  Ad=(I) Atr=(Bulk) MxPS=   Ivl= 16ms

E:  Ad=(O) Atr=(Bulk) MxPS=   Ivl= 16ms

E:  Ad=(I) Atr=(Int.) MxPS=    Ivl=  8ms

从中选择仅T：和I：行（例如，使用procusb ti），我们有:

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=   MxCh=

T:  Bus= Lev= Prnt= Port=00 Cnt= Dev#=   Spd=   MxCh=   接在父设备的0号端口上， 而且自己有4个下行端口

I:  If#=  Alt=  #EPs=  Cls=(hub  ) Sub= Prot= Driver=hub

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=1.5  MxCh=

I:  If#=  Alt=  #EPs=  Cls=(HID  ) Sub= Prot= Driver=mouse

T:  Bus= Lev= Prnt= Port=02 Cnt= Dev#=   Spd=   MxCh=  接在父设备的2号端口上，自己没有下行端口

I:  If#=  Alt=  #EPs=  Cls=(>ifc ) Sub= Prot= Driver=serial

得出拓扑：

                    +------------------+

                    |  PC/root_hub ()|   Dev# =

                    +------------------+   (nn) is Mbps.

  Level            |  CN.   |  CN.  |   [CN = connector/port #]

                    +------------------+

                        /

                       /

          +-----------------------+

Level    | Dev#: -port hub ()|

          +-----------------------+

          |CN. |CN. |CN. |CN. |

          +-----------------------+

              \           \____________________

               \_____                          \

                     \                          \

             +--------------------+      +--------------------+

Level       | Dev# : mouse (1.5)|      | Dev# : serial ()|

             +--------------------+      +--------------------+

下面是我这个Renesas开发板的：

# cat /sys/kernel/debug/usb/devices 

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=  MxCh=

B:  Alloc=  / us ( %), #Int=  , #Iso=

D:  Ver= 2.00 Cls=(hub  ) Sub= Prot= MxPS= #Cfgs=

P:  Vendor=1d6b ProdID= Rev= 4.14

S:  Manufacturer=Linux 4.14. ehci_hcd

S:  Product=EHCI Host Controller

S:  SerialNumber=ee080100.usb

C:* #Ifs=  Cfg#=  Atr=e0 MxPwr=  0mA

I:* If#=  Alt=  #EPs=  Cls=(hub  ) Sub= Prot= Driver=hub

E:  Ad=(I) Atr=(Int.) MxPS=    Ivl=256ms

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=  MxCh=

B:  Alloc=  / us ( %), #Int=  , #Iso=

D:  Ver= 2.00 Cls=(hub  ) Sub= Prot= MxPS= #Cfgs=

P:  Vendor=1d6b ProdID= Rev= 4.14

S:  Manufacturer=Linux 4.14. ehci_hcd

S:  Product=EHCI Host Controller

S:  SerialNumber=ee0a0100.usb

C:* #Ifs=  Cfg#=  Atr=e0 MxPwr=  0mA

I:* If#=  Alt=  #EPs=  Cls=(hub  ) Sub= Prot= Driver=hub

E:  Ad=(I) Atr=(Int.) MxPS=    Ivl=256ms

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=   MxCh=

B:  Alloc=  / us ( %), #Int=  , #Iso=

D:  Ver= 1.10 Cls=(hub  ) Sub= Prot= MxPS= #Cfgs=

P:  Vendor=1d6b ProdID= Rev= 4.14

S:  Manufacturer=Linux 4.14. ohci_hcd

S:  Product=Generic Platform OHCI controller

S:  SerialNumber=ee080000.usb

C:* #Ifs=  Cfg#=  Atr=e0 MxPwr=  0mA

I:* If#=  Alt=  #EPs=  Cls=(hub  ) Sub= Prot= Driver=hub

E:  Ad=(I) Atr=(Int.) MxPS=    Ivl=255ms

T:  Bus= Lev= Prnt= Port= Cnt= Dev#=   Spd=   MxCh=

B:  Alloc=  / us ( %), #Int=  , #Iso=

D:  Ver= 1.10 Cls=(hub  ) Sub= Prot= MxPS= #Cfgs=

P:  Vendor=1d6b ProdID= Rev= 4.14

S:  Manufacturer=Linux 4.14. ohci_hcd

S:  Product=Generic Platform OHCI controller

S:  SerialNumber=ee0a0000.usb

C:* #Ifs=  Cfg#=  Atr=e0 MxPwr=  0mA

I:* If#=  Alt=  #EPs=  Cls=(hub  ) Sub= Prot= Driver=hub

E:  Ad=(I) Atr=(Int.) MxPS=    Ivl=255ms