How to Logically Connect a USB Device

Use this procedure to logically connect a USB device that was previously logically disconnected or unconfigured.

1. Become superuser.

2. Connect a USB device.

   # cfgadm -c configure usb0/4.7

   
   

3. Verify that the device is connected.

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

   
   

   The device is now available and visible to the system.

How to Logically Disconnect a USB Device Subtree

Use this procedure to disconnect a USB device subtree, which is the hierarchy (or tree) of devices below a hub.

1. Become superuser.

2. Remove a USB device subtree.

   # cfgadm -c disconnect -y usb0/4

   
   

3. Verify that the USB device subtree is disconnected.

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

   
   

How to Reset a USB Device

If a USB device behaves erratically, use the cfgadm command to reset the device, which logically removes and recreates the device.

1. Become superuser.

2. Make sure the device is not in use.

3. Reset the device.

   # cfgadm -x usb_reset -y usb0/4.7

   
   

4. Verify that the device is connected.

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

   
   

How to Change the Default Configuration of a Multi-Configuration USB Device

Keep the following in mind when working with multi-configuration USB devices:

• A USB device configuration defines how a device presents itself to the operating system. This is different from system device configurations discussed in other cfgadm sections.

• Some USB devices support multiple configurations, but only one configuration can be active at a time.

• Multi-configuration devices can be identified by examining the cfgadm -lv output. Nconfigs will be greater than 1.

• The default USB configuration is configuration 1. The current configuration is reflected in cfgadm -lv output as Config.

• Changes to the default configuration will persist across reboots, hot-removes, and reconfiguration of the device, as long as it is reconnected to the same port.

1. Make sure the device is not in use.

2. Change the default USB configuration.

   For example:

   # 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. Verify the device change.

   For example:

   # 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 now shows 2.