usbmgr.conf5

Overview

usbmgr.conf is the main configuration file for usbmgr daemon, it has the proper entries to support a wide list of USB devices and the required usb kernel module to make them work.

Standard usbmgr distribution already has a list of well known devices and their proper entries, so you don't need to edit it to have it working.

In case you want or need to add a new device, you can do it with the help of dump_usbdev, it aids you in writing usbmgr.conf. After usbmgr has been started, running dump_usbdev will dump infomation about all attached devices in a format suitable for usbmgr.conf.

If you connect USB devices to your USB HUB, you'll see a line like the following.

-------------------------------------------------------------
class 0x9 subclass 0x0 protocol 0x0 module <module_name>
-------------------------------------------------------------

"class 0x9" means USB HUB. If no USB devices are connected, only the root HUB will appear. Modifying "<module_name>" would make the configuration for this device(HUB) complete. In the case of a HUB, you should change "module_name" to "none" because the HUB driver is included in usbcore.

After a USB mouse has been connected to the HUB, running dump_usbdev will give you the following.

-------------------------------------------------------------
class 0x9 subclass 0x0 protocol 0x0 module <module_name>
vendor 0x56e product 0x4 module <module_name>
-------------------------------------------------------------

The 2nd line is new. This is the infomation about the USB mouse. The USB mouse requires the "hid" and "mousedev" drivers. So, "<module_name>" should be changed to "hid , mousedev". So the complete usbmgr.conf entry would look like this:

-------------------------------------------------------------
class 0x9 subclass 0x0 protocol 0x0 module none
vendor 0x56e product 0x4 module hid , mousedev
-------------------------------------------------------------

You should copy this into /etc/usbmgr/usbmgr.conf, and then run update_usbdb to create the configuration data.

Environment

None.