You are here: start » Tantalus' Firmwares » service » USB2IP

USB2IP

USB2IP (or USB/IP) allows the usage of USB devices over an IP network. For example it is possible to connect an USB scanner and use this device on a remote computer.

Supported NAS devices

USB2IP is available for the following NAS devices:

N2R1/N2B1 N1T1
Yes Yes

Configuration

The configuration of USB/IP can be found on the web interface: Network / Files → USB2IP.

When the service has been started, the list in the center of the configuration page displays all connected USB devices. If the connected device does not show up, click on Refresh.

Click on a device and afterwards on Export to share the device on the net. To cancel the export of the device, click on Release.

It is impossible to export an entire USB hub. Export only physical end devices!

Automatically export known devices when plugged in

  • Default: Deactivated

USB devices, which have been exported once, are known to the NAS. These devices will be automatically exported again, when they are plugged in or the service has been started. Devices which has been Released are no longer known to the NAS.

Usage

USB/IP uses special drivers, which requires individual steps on each operating system. But all operating systems uses the same command line interface (CLI) named usbip.

Linux

Install the package usbip to install the CLI program. It might be necessary to install the required kernel modules usbip_common_mod and vhci-hcd, because these modules are currently in the staging tree. The modules can be loaded by using modprobe:

> modprobe usbip_common_mod
> modprobe vhci-hcd

Windows

The official websites provides a packed/compressed driver. Download and extract the file. Afterwards install the driver by following these steps:

Control panel → Hardware → Yes, I have already connected the hardware → Add a new hardware device → Install the hardware that I manually select from a list (Advanced) → System Devices → Have Disk → Chose the uncompressed directory → USB/IP Enumerator → Finish.

Windows 7: Read the included USAGE file for additional steps.

The downloaded file also contains the CLI program usbip.

usbip

The CLI usbip provides the following important options to attach an USB device:

Usage: usbip [options]				
	-a, --attach [host] [bus_id]		
		Attach a remote USB device.	
 
	-x, --attachall [host]		
		Attach all remote USB devices on the specific host.	
 
	-d, --detach [ports]			
		Detach an imported USB device.	
 
	-l, --list [hosts]			
		List exported USB devices.	
 
	-p, --port				
		List virtual USB port status.

Example

The following example uses an USB mouse.

List all exported devices of the NAS lg-nas-n1t1:

> usbip -l lg-nas-n1t1
- lg-nas-n1t1
   1-1.4: Elan Microelectronics Corp. : Laser Mouse (04f3:0212)
        : /sys/devices/platform/orion-ehci.0/usb1/1-1/1-1.4
        : (Defined at Interface level) (00/00/00)
        :  0 - Human Interface Device / Boot Interface Subclass / Mouse (03/01/02)

Attach the mouse which uses the bus ID 1-1.4:

> usbip -a lg-nas-n1t1 1-1.4

Use the attached device as normal:

> lsusb | grep Laser
Bus 008 Device 004: ID 04f3:0212 Elan Microelectronics Corp. Laser Mouse

Links

You could leave a comment if you were logged in.