system/devices/usb.rst

4 QEMU can emulate a PCI UHCI, OHCI, EHCI or XHCI USB controller. You can
24 only controller you need.  With only a single USB controller (and
38 When running EHCI in standalone mode you can add UHCI or OHCI
49 You can use the standard ``-device`` switch to add a EHCI controller to
52 ``-device usb-ehci,id=ehci``.  This will give you a USB 2.0 bus named
55 When adding USB devices using the ``-device`` switch you can specify the
83 you, which you can use like this:
129    you need to explicitly create a ``scsi-hd`` or ``scsi-cd`` device
151    automatically create SCSI disks for you. ``usb-bot`` supports up to
153    i.e. for three devices you must use 0+1+2. The 0+1+5 numbering from the
221 some available USB bus if you didn't specify one explicitly.
222 If you need to, you can also specify the physical port where
241 property specification. If you want to unplug devices too you should
242 specify some unique id which you can use to refer to the device.
243 You can then use ``device_del`` to unplug the device later.
255 That allows you to attach one or more scsi devices before making the
272 1. If you use an early Linux 2.4 kernel, verify that no Linux driver is
278    should enable it by default). You should see something like that:
285 3. Since only root can access to the USB devices directly, you can
287    devices you want to use. For testing, the following suffices:
301    You should see the list of the devices you can use (Never try to use
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.
315 When relaunching QEMU, you may have to unplug and plug again the USB
337 In theory you can combine all these properties as you like.  In
348   hostaddr isn't stable. The next time you plug the device into the host it
356 for 1.1 devices, you can pass through any device plugged into that port
388 the device not responding any more until you power-cycle (aka un-plug