Lines Matching +full:usb +full:- +full:attach
2 # README for usbip-utils
5 # 2005-2008 Takahiro Hirofuchi
8 USB/IP protocol allows to pass USB device from server to client over the
9 network. Server is a machine which provides (shares) a USB device. Client is
10 a machine which uses USB device provided by server over the network.
11 The USB device may be either physical device connected to a server or
12 software entity created on a server using USB gadget subsystem.
15 - usbip-vhci
16 A client side kernel module which provides a virtual USB Host Controller
17 and allows to import a USB device from a remote machine.
19 - usbip-host (stub driver)
20 A server side module which provides a USB device driver which can be
21 bound to a physical USB device to make it exportable.
23 - usbip-vudc
24 A server side module which provides a virtual USB Device Controller and allows
25 to export a USB device created using USB Gadget Subsystem.
27 - usbip-utils
32 - USB/IP device drivers
33 Found in the drivers/usb/usbip/ directory of the Linux kernel tree.
35 - libudev >= 2.0
38 - libwrap0-dev
41 - gcc >= 4.0
43 - libtool, automake >= 1.9, autoconf >= 2.5.0, pkg-config
46 - hwdata
47 Contains USB device identification data.
55 $ ./configure [--with-tcp-wrappers=no] [--with-usbids-dir=<dir>]
58 2. Compile & install USB/IP drivers.
63 First of them is physical usb device connected to the machine.
66 server:# (Physically attach your USB device.)
68 server:# insmod usbip-core.ko
69 server:# insmod usbip-host.ko
71 server:# usbipd -D
72 - Start usbip daemon.
74 server:# usbip list -l
75 - List driver assignments for USB devices.
77 server:# usbip bind --busid 1-2
78 - Bind usbip-host.ko to the device with busid 1-2.
79 - The USB device 1-2 is now exportable to other hosts!
80 - Use `usbip unbind --busid 1-2' to stop exporting the device.
82 Second of shareable entities is USB Gadget created using USB Gadget Subsystem
85 server:# (Create your USB gadget)
86 - Currently the most preferable way of creating a new USB gadget
89 - See vudc_server_example.sh for a short example of USB gadget creation
91 server:# insmod usbip-core.ko
92 server:# insmod usbip-vudc.ko
93 - To create more than one instance of vudc use num module param
96 - Assign your new gadget to USB/IP UDC
97 - Using ConfigFS interface you may do this simply by:
99 server:# echo "usbip-vudc.0" > UDC
101 server:# usbipd -D --device
102 - Start usbip daemon.
104 To attach new device to client machine below commands should be used:
106 client:# insmod usbip-core.ko
107 client:# insmod vhci-hcd.ko
109 client:# usbip list --remote <host>
110 - List exported USB devices on the <host>.
112 client:# usbip attach --remote <host> --busid 1-2
113 - Connect the remote USB device.
114 - When using vudc on a server side busid is really vudc instance name.
115 For example: usbip-vudc.0
118 - Show virtual port status.
120 client:# usbip detach --port <port>
121 - Detach the USB device.
125 ---------------------------
127 ---------------------------
128 Physically attach your USB devices to this host.
130 trois:# insmod path/to/usbip-core.ko
131 trois:# insmod path/to/usbip-host.ko
132 trois:# usbipd -D
134 In another terminal, let's look up what USB devices are physically
137 trois:# usbip list -l
138 Local USB devices
140 - busid 1-1 (05a9:a511)
141 1-1:1.0
143 - busid 3-2 (0711:0902)
144 3-2:1.0
146 - busid 3-3.1 (08bb:2702)
147 3-3.1:1.0
148 3-3.1:1.1
150 - busid 3-3.2 (04bb:0206)
151 3-3.2:1.0
153 - busid 3-3 (0409:0058)
154 3-3:1.0
156 - busid 4-1 (046d:08b2)
157 4-1:1.0
158 4-1:1.1
159 4-1:1.2
161 - busid 5-2 (058f:9254)
162 5-2:1.0
164 A USB storage device of busid 3-3.2 is now bound to the usb-storage
166 "exportable"; the device is bound to the usbip-host driver. Please
167 remember you can not export a USB hub.
169 Mark the device of busid 3-3.2 as exportable:
171 trois:# usbip --debug bind --busid 3-3.2
173 usbip debug: usbip_bind.c:162:[unbind_other] 3-3.2:1.0 -> usb-storage
175 bind device on busid 3-3.2: complete
177 trois:# usbip list -l
178 Local USB devices
182 - busid 3-3.2 (04bb:0206)
183 3-3.2:1.0
186 ---------------------------
188 ---------------------------
192 deux:# insmod path/to/usbip-core.ko
193 deux:# insmod path/to/vhci-hcd.ko
195 deux:# usbip list --remote 10.0.0.3
196 Exportable USB devices
198 - 10.0.0.3
199 1-1: Prolific Technology, Inc. : unknown product (067b:3507)
200 : /sys/devices/pci0000:00/0000:00:1f.2/usb1/1-1
202 : 0 - Mass Storage / SCSI / Bulk (Zip) (08/06/50)
204 1-2.2.1: Apple Computer, Inc. : unknown product (05ac:0203)
205 : /sys/devices/pci0000:00/0000:00:1f.2/usb1/1-2/1-2.2/1-2.2.1
207 : 0 - Human Interface Devices / Boot Interface Subclass / Keyboard (03/01/01)
209 1-2.2.3: OmniVision Technologies, Inc. : OV511+ WebCam (05a9:a511)
210 : /sys/devices/pci0000:00/0000:00:1f.2/usb1/1-2/1-2.2/1-2.2.3
212 : 0 - Vendor Specific Class / unknown subclass / unknown protocol (ff/00/00)
214 3-1: Logitech, Inc. : QuickCam Pro 4000 (046d:08b2)
215 : /sys/devices/pci0000:00/0000:00:1e.0/0000:02:0a.0/usb3/3-1
217 : 0 - Data / unknown subclass / unknown protocol (0a/ff/00)
218 : 1 - Audio / Control Device / unknown protocol (01/01/00)
219 : 2 - Audio / Streaming / unknown protocol (01/02/00)
221 Attach a remote USB device:
223 deux:# usbip attach --remote 10.0.0.3 --busid 1-1
231 6-1 -> usbip://10.0.0.3:3240/1-1 (remote bus/dev 001/004)
232 6-1:1.0 used by usb-storage
239 deux:# usbip detach --port 0
244 - See 'Debug Tips' on the project wiki.
245 - http://usbip.wiki.sourceforge.net/how-to-debug-usbip
246 - usbip-host.ko must be bound to the target device.
247 - See /sys/kernel/debug/usb/devices and find "Driver=..." lines of the device.
248 - Target USB gadget must be bound to vudc
249 (using USB gadget susbsys, not usbip bind command)
250 - Shutdown firewall.
251 - usbip now uses TCP port 3240.
252 - Disable SELinux.
253 - Check the kernel and daemon messages.
257 Mailing List: linux-usb@vger.kernel.org