usbid 2.2

USB文件系统抽象API

此模块提供了一个USB文件系统抽象API，可用于获取Linux系统上物理USB总线结构的详细信息。

# ls  /sys/bus/usb/devices/
1-0:1.0      1-1.3        1-1.3.1:1.0  1-1:1.0
1-1          1-1.3.1      1-1.3:1.0    usb1

bus-port.port.port ...

:config.interface

1-1:1.0        1-1.3:1.0        1-1.3.1:1.0

用法

API由一个USB根对象组成，从该对象可以访问所有子对象，就像Python容器类型一样。

>>> from usbid import USB
>>> usb = USB()
>>> usb
<usbid.fs.USB [/sys/bus/usb/devices] at ...>

>>> usb.keys()
['1', '2']

获取特定的总线。

>>> bus = usb['1']
>>> bus
<usbid.fs.Bus [usb1] at ...>

从总线获取端口。

>>> port = bus['1']
>>> port
<usbid.fs.Port [1-1] at ...>

从端口获取接口。

>>> port.interfaces
[<usbid.fs.Interface [1-1:1.0] at ...>]

接口可能有关联的tty。

>>> port.interfaces[0].tty
'ttyUSB0'

不推荐通过tty挂载名称引用USB接口。但记住文件系统名称进行唯一标识是一个好主意，通过此名称查找接口，然后连接到相应的tty。

>>> interface = usb.get_interface('1-1:1.0')
>>> interface.tty
'ttyUSB0'

对于调试，您可以打印USB结构。

>>> usb.printtree()
<usbid.fs.USB [/sys/bus/usb/devices] at ...>
  <usbid.fs.Bus [usb1] at ...>
      - Linux 3.13.0-48-generic xhci_hcd
      - xHCI Host Controller
    <usbid.fs.Interface [1-0:1.0] at ...>
    <usbid.fs.Port [1-1] at ...>
        - FTDI
        - FT232R USB UART
      <usbid.fs.Interface [1-1:1.0] at ...>
        - ttyUSB0

源代码

源代码位于一个GIT DVCS中，其主分支位于github。

贡献者

• Robert Niederreiter <rnix@squarewave.at>

• Jens W. Klein <jens@bluedynamics.com>

• Benjamin Stefaner <bs@kleinundpartner.at>

变更日志

许可证

版权（c）2013-2023，BlueDynamics Alliance，奥地利，德国，瑞士。保留所有权利。

重新分发和使用源代码和二进制代码（无论是修改还是未修改），前提是满足以下条件

• 源代码的重新分发必须保留上述版权声明、本条件列表和以下免责声明。

• 二进制形式的重新分发必须在本文档和/或其他随分发提供的材料中复制上述版权声明、本条件列表和以下免责声明。

• 未经事先书面许可，不得使用BlueDynamics Alliance的名称或其贡献者的名称来推广或支持从本软件派生的产品。

本软件由BlueDynamics Alliance提供，"按原样"提供，并且任何明示或暗示的保证，包括但不限于适销性和特定用途的适用性保证均被排除。在任何情况下，BlueDynamics Alliance均不对因使用本软件而产生的任何直接、间接、偶然、特殊、示范性或后果性的损害（包括但不限于替代货物或服务的采购；使用、数据或利润的损失；或业务的中断）承担责任，无论损害是由于何种原因引起的，以及基于何种责任理论，无论是合同、严格责任还是侵权（包括疏忽或不作为）。