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
25 therefore only a single USB bus) present in the system there is no
35 because it provides a single USB bus supporting both USB 2.0 and USB
45 The easiest way to add a UHCI controller to a ``pc`` machine is the
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
56 bus they should be attached to.  Here is a complete example:
67 This attaches a USB tablet to the UHCI adapter and a USB mass storage
74 The UHCI and OHCI controllers can attach to a USB bus created by EHCI
82 There is a config file in docs which will do all this for
91 Using the ``-usb`` switch for ``q35`` machines will create a similar
108    Pointer device that uses absolute coordinates (like a touchscreen).
118    a drive backed by a raw format disk image:
128    USB attached SCSI device. This does not create a SCSI disk, so
129    you need to explicitly create a ``scsi-hd`` or ``scsi-cd`` device
179    Braille device. This emulates a Baum Braille device USB port. id has to
180    specify a character device defined with ``-chardev …,id=id``.  One will
181    normally use BrlAPI to display the braille output on a BRLTTY-supported
196    specifies a netdev defined with ``-netdev …,id=id``. For instance,
227 Plugging a tablet into UHCI port 1 works like this::
231 Plugging a hub into UHCI port 2 works like this::
235 Plugging a virtual USB stick into port 4 of the hub just plugged works
240 In the monitor, the ``device_add` command also accepts a ``port``
265 Using host USB devices on a Linux host
310    Normally the guest OS should report that a new USB device is plugged.
316 device to make it work again (this is a bug).
338 practice only a few combinations are useful:
340 - ``vendorid`` and ``productid`` -- match for a specific device, pass it to
343 - ``hostbus`` and ``hostport`` -- match for a specific physical port in the
349   will get a new hostaddr.
354 depending on the speed. Supposing that devices plugged into a given
392 usb device at hand, so it's a trial-and-error game.  If the default