USB Server Installation

Please install USB Server on your computer. All necessary instructions are here.

If you have some problems during USB Server installation, please read the following.

If installation completed successfully daemon usbsrvd will be run in your system. You need to use the special utility usbsrv for sharing/unsharing USB devices. It is also installed in your system. All further operations are carried out with the help of this utility

Keys for using usbsrv utility

usbsrv [-l] [-s [sharing-options]] [-t [sharing-options]] [-n tcpport]

sharing-options:
[-h vid-pid]
[-d bus-dev]

Generat options:
-l, --list
Show the list of all USB devices currently present in USB Server configuration.

-s, --share
Share USB device.

-t, --stopsharing
Stop sharing USB device.

-n, --network
Change TCP port number used for accepting incoming connections.

-h, --hwid
Define USB device's Hardware ID in HEX.

-d, --busid
Define USB device's Bus ID in DEC.

How to get the list of USB devices:

To get the list of USB devices with what USB Server is working you need to carry out usbsrv -l

Utility outputs the information about USB devices the following way:

[device number:] [device description]
[bus-id] [hwid] [status]

To share/unshare USB device you need to select the device that must be shared/unshared. You can define USB device exactly in Linux OS with the help of 2 descriptors:

bus-id - it is the unique USB device descriptor on USB bus. It consists of 2 decimal values divided by line (2-1, 3-3). Please note that equal USB devices connected to the different USB ports have different bus-id. On the picture they are underlined blue.

Hardware ID is unique USB device descriptor that is assigned by vendor. It consists of two HEX numbers (0ea0-2168, 05d8-4002). Please note that equal USB devices always have the same HWIDs. On the picture they are underlined violet.

Each USB device has its own status:

device is plugged - USB device is connected to the computer but not shared!

device is initializing - USB device is in the pre-sharing mode.

device is shared and available for connection - USB device is shared and available for client's connection.

device is in use by client - USB device is shared and connected to the remote client.

device is shared but not plugged - USB device is shared but currently not plugged into computer.

USB device sharing

To share selected USB device you have to carry out "sharing" command and point out device's bus-id and hwid

E.g. to share USB Human Interface Device Mouse you have to carry out this command:
usbsrv -s -d 3-1 -h 1241-1166

And indicate both bus-id (3-1) and hwid (1241-1166) for this device.

Please note! If you plug this device into the other USB port, bus-id of this device will be changed. So to share this device you need to point appropriate bus-id in the command line.

USB device is shared until you give the proper command for stop sharing. If the device was shared in the current session, it will stay shared in the further sessions after system reboot!

USB device stop sharing

For stop sharing selected USB device you have to carry out "stop sharing" command and point out device's bus-id and hwid

E.g. to stop sharing USB Human Interface Device Mouse you have to carry out this command:
usbsrv -t -d 3-1 -h 1241-1166

TCP port changing for USB Server

Default USB Server accepts incoming connections from the clients on TCP port 32032. To change TCP port number you can use the command: usbsrv -n [port number]