使用 cfgadm 命令热插拔 USB 设备（任务列表）

使用 cfgadm 命令热插拔 USB 设备

可以在正在运行的系统中添加或移除 USB 设备，而不必使用 cfgadm 命令。不过，USB 设备也可以逻辑方式热插拔，而不必以物理方式移除。在远程位置工作并且需要禁用或重置未正常运行的 USB 设备时，这种方案比较方便。cfgadm 命令还可提供显示 USB 设备树（包括制造商和产品信息）的方法。

cfgadm 命令可以显示有关附着点的信息，附着点是指系统中可以执行动态重新配置操作的位置。连接点由以下几项组成：

• 插卡，表示可以配置到系统中的硬件资源，如 USB 设备

• 插座，接受插卡的位置，如 USB 端口

连接点由逻辑连接点 ID 和物理连接点 ID (Ap_Ids) 表示。物理 Ap_Id 是连接点的物理路径名。逻辑 Ap_Id 是物理 Ap_Id 的用户友好替代项。有关 Ap_Id 的更多信息，请参见 cfgadm_usb(1M)。

cfgadm 命令提供了以下 USB 设备状态信息。

以下各小节介绍如何使用 cfgadm 命令通过软件热插拔 USB 设备。这些小节中的所有样例 USB 设备信息都已截断，以便集中阐明相关信息。

如何显示 USB 总线信息 (cfgadm)

有关使用 prtconf 命令显示 USB 配置信息的示例，请参见如何显示 USB 设备信息。

1. 显示 USB 总线信息。

   例如：

   % cfgadm
   Ap_Id                    Type         Receptacle   Occupant     Condition
   usb0/4.5                 usb-hub      connected    configured   ok
   usb0/4.5.1               usb-device   connected    configured   ok
   usb0/4.5.2               usb-printer  connected    configured   ok
   usb0/4.5.3               usb-mouse    connected    configured   ok
   usb0/4.5.4               usb-device   connected    configured   ok
   usb0/4.5.5               usb-storage  connected    configured   ok
   usb0/4.5.6               usb-communi  connected    configured   ok
   usb0/4.5.7               unknown      empty        unconfigured ok

   在前面的示例中，usb0/4.5.1 标识连接至二级外部集线器的端口 1 的设备，二级外部集线器连接至一级外部集线器的端口 5，而一级外部集线器连接至第一个 USB 控制器的根集线器端口 4。

2. 显示特定 USB 设备信息。

   例如：

   % cfgadm -l -s "cols=ap_id:info"
   Ap_Id       Information
    usb0/4.5.1  Mfg: Inside Out Networks Product: Edgeport/421 NConfigs: 1 
   Config: 0  : ...
    usb0/4.5.2  Mfg: <undef> Product: <undef>   NConfigs: 1 Config: 0 ...
    usb0/4.5.3  Mfg: Mitsumi Product: Apple USB Mouse NConfigs: 1
   Config: 0 ...
    usb0/4.5.4  Mfg: NMB  Product: NMB USB KB/PS2 M NConfigs: 1 Config: 0
    usb0/4.5.5  Mfg: Hagiwara Sys-Com  Product: SmartMedia R/W  NConfigs: 1 
   Config: 0 : ...
    usb0/4.5.6  Mfg: 3Com Inc.  Product: U.S.Robotics 56000 Voice USB Modem 
   NConfigs: 2 ...
    usb0/4.5.7

如何取消配置 USB 设备

可以取消配置仍通过物理方式连接至系统的 USB 设备。但是，无法再将驱动程序连接至该设备。请注意，prtconf 输出中会始终显示 USB 设备，即使已取消配置该设备也是如此。

1. 成为超级用户。
2. 取消配置 USB 设备。

   例如：

   # cfgadm -c unconfigure usb0/4.7
   Unconfigure the device: /devices/pci@8,700000/usb@5,3/hub@4:4.7
   This operation will suspend activity on the USB device
   Continue (yes/no)? y

3. 验证是否已取消配置该设备。

   例如：

   # cfgadm  
   Ap_Id                    Type         Receptacle   Occupant     Condition
   usb0/4.5                 usb-hub      connected    configured   ok
   usb0/4.5.1               usb-device   connected    configured   ok
   usb0/4.5.2               usb-printer  connected    configured   ok
   usb0/4.5.3               usb-mouse    connected    configured   ok
   usb0/4.5.4               usb-device   connected    configured   ok
   usb0/4.5.5               usb-storage  connected    configured   ok
   usb0/4.5.6               usb-communi  connected    configured   ok
   usb0/4.5.7               unknown      empty        unconfigured ok
   usb0/4.6                 usb-storage  connected    configured   ok
   usb0/4.7                 usb-storage  connected    unconfigured ok

如何配置 USB 设备

1. 成为超级用户。
2. 配置 USB 设备。

   例如：

   # cfgadm -c configure usb0/4.7 

3. 验证是否已配置 USB 设备。

   例如：

   # cfgadm usb0/4.7
   Ap_Id                  Type         Receptacle  Occupant    Condition
   usb0/4.7               usb-storage  connected   configured  ok

如何以逻辑方式断开 USB 设备连接

如果要从系统和 prtconf 输出中移除 USB 设备，但物理位置远离系统，则只需以逻辑方式断开 USB 设备连接即可。从物理角度来看，该设备仍然处于连接状态。但是，从逻辑角度来看，对系统而言设备已断开连接、不可用且不可见。

1. 成为超级用户。
2. 断开 USB 设备连接。

   例如：

   # cfgadm -c disconnect -y usb0/4.7

3. 验证是否已断开该设备的连接。

   例如：

   # cfgadm usb0/4.7
   Ap_Id                  Type      Receptacle    Occupant      Condition
   usb0/4.7               unknown   disconnected  unconfigured  ok

如何以逻辑方式连接 USB 设备

使用此过程可以逻辑方式连接先前通过逻辑方式断开连接或取消配置的 USB 设备。

1. 成为超级用户。
2. 连接 USB 设备。

   例如：

   # cfgadm -c configure usb0/4.7

3. 验证是否已连接该设备。

   例如：

   # cfgadm usb0/4.7
   Ap_Id                  Type         Receptacle  Occupant    Condition
   usb0/4.7               usb-storage  connected   configured  ok

   对系统而言设备现在可用且可见。

如何以逻辑方式断开 USB 设备子树连接

使用此过程可以断开 USB 设备子树连接，该子树是集线器下的设备分层结构（或树）。

1. 成为超级用户。
2. 移除 USB 设备子树。

   例如：

   # cfgadm -c disconnect -y usb0/4

3. 验证是否已断开 USB 设备子树连接。

   例如：

   # cfgadm usb0/4
   Ap_Id                  Type       Receptacle   Occupant     Condition
   usb0/4                 unknown    disconnected unconfigured ok

如何重置 USB 设备

如果 USB 设备行为异常，请使用 cfgadm 命令重置该设备，即以逻辑方式移除并重新创建该设备。

1. 成为超级用户。
2. 确保设备未被使用。
3. 重置设备。

   例如：

   # cfgadm -x usb_reset -y usb0/4.7

4. 验证是否已连接该设备。

   例如：

   # cfgadm usb0/4.7
   Ap_Id                  Type         Receptacle   Occupant     Condition
   usb0/4.7               usb-storage  connected    configured   ok

如何更改多重配置 USB 设备的缺省配置

使用多重配置 USB 设备时，请牢记以下要点：

• USB 设备配置定义了设备向操作系统显示其本身的方式。此方法不同于其他 cfgadm 部分中介绍的系统设备配置。

• 某些 USB 设备支持多种配置，但一次只能有一种配置处于活动状态。

• 通过检查 cfgadm -lv 输出，可以确定多重配置设备。Nconfigs 将大于 1。

• 缺省 USB 配置为配置 1。当前配置在 cfgadm -lv 输出中反映为 Config。

• 只要将设备重新连接至同一个端口，对缺省配置所做的更改在重新引导、热移除以及重新配置设备期间就将始终保持不变。

1. 确保设备未被使用。
2. 更改缺省 USB 配置。

   例如：

   # cfgadm -x usb_config -o config=2 usb0/4
      Setting the device: /devices/pci@1f,0/usb@c,3:4
      to USB configuration 2
      This operation will suspend activity on the USB device
      Continue (yes/no)? yes

3. 验证设备是否已更改。

   例如：

   # cfgadm -lv usb0/4
   Ap_Id  Receptacle   Occupant     Condition  Information When  Type    
        Busy     Phys_Id
   usb0/4 connected    unconfigured ok         Mfg: Sun  2000   
   Product: USB-B0B0 aka Robotech
   With 6 EPPS High Clk Mode   NConfigs: 7  Config: 2  : EVAL Board Setup  
   unavailable
   usb-device   n        /devices/pci@1f,0/usb@c,3:4

   请注意，Config: 现在显示 2。