system/devices/usb.rst

5 plug virtual USB devices or real host USB devices (only works with
6 certain host operating systems). QEMU will automatically create and
15 QEMU has XHCI host adapter support.  The XHCI hardware design is much
160 ``usb-host,hostbus=bus,hostaddr=addr``
161    Pass through the host device identified by bus and addr
163 ``usb-host,vendorid=vendor,productid=product``
164    Pass through the host device identified by vendor and product ID
176    host character device id.
265 Using host USB devices on a Linux host
308       device_add usb-host,vendorid=0x1234,productid=0x5678
311    You can use the option ``-device usb-host,...`` to do the same.
313 6. Now you can try to use the host USB device in QEMU.
318 ``usb-host`` properties for specifying the host device
322 specify which host device to pass through, but this is not
323 the only way to specify the host device. ``usb-host`` supports
341   the guest when it shows up somewhere in the host.
344   host, any device which is plugged in there gets passed to the
348   hostaddr isn't stable. The next time you plug the device into the host it
351 Note that on the host USB 1.1 devices are handled by UHCI/OHCI and USB
353 same physical port on the host may show up on different host buses
364         -device usb-host,bus=usb-bus.0,hostbus=3,hostport=1  \\
365         -device usb-host,bus=ehci.0,hostbus=1,hostport=1
367 ``usb-host`` properties for reset behavior
372 host.  There are three cases: