projects / qemu.git / blame
| Commit | Line | Data |
|---|---|---|
| 94527ead GH |
1 | |
| 2 | USB 2.0 Quick Start | |
| 3 | =================== | |
| 4 | ||
| 5 | The QEMU EHCI Adapter does *not* support companion controllers. That | |
| 6 | implies there are two completely separate USB busses: One USB 1.1 bus | |
| 7 | driven by the UHCI controller and one USB 2.0 bus driven by the EHCI | |
| 8 | controller. Devices must be attached to the correct controller | |
| 9 | manually. | |
| 10 | ||
| 11 | The '-usb' switch will make qemu create the UHCI controller as part of | |
| 12 | the PIIX3 chipset. The USB 1.1 bus will carry the name "usb.0". | |
| 13 | ||
| 14 | You can use the standard -device switch to add a EHCI controller to | |
| 15 | your virtual machine. It is strongly recommended to specify an ID for | |
| 16 | the controller so the USB 2.0 bus gets a individual name, for example | |
| 17 | '-device usb-ehci,id=ehci". This will give you a USB 2.0 bus named | |
| 18 | "ehci.0". | |
| 19 | ||
| 20 | I strongly recomment to also use -device to attach usb devices because | |
| 21 | you can specify the bus they should be attached to this way. Here is | |
| 22 | a complete example: | |
| 23 | ||
| 24 | qemu -M pc ${otheroptions} \ | |
| 25 | -drive if=none,id=usbstick,file=/path/to/image \ | |
| 26 | -usb \ | |
| 27 | -device usb-ehci,id=ehci \ | |
| 28 | -device usb-tablet,bus=usb.0 \ | |
| 29 | -device usb-storage,bus=ehci.0,drive=usbstick | |
| 30 | ||
| 31 | This attaches a usb tablet to the UHCI adapter and a usb mass storage | |
| 32 | device to the EHCI adapter. | |
| 33 | ||
| 34 | enjoy, | |
| 35 | Gerd | |
| 36 | ||
| 37 | -- | |
| 38 | Gerd Hoffmann <kraxel@redhat.com> |