2 |
2 |
USB 2.0 Quick Start
|
3 |
3 |
===================
|
4 |
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.
|
|
5 |
The QEMU EHCI Adapter can be used with and without companion
|
|
6 |
controllers. See below for the companion controller mode.
|
|
7 |
|
|
8 |
When not running in companion controller mode there are two completely
|
|
9 |
separate USB busses: One USB 1.1 bus driven by the UHCI controller and
|
|
10 |
one USB 2.0 bus driven by the EHCI controller. Devices must be
|
|
11 |
attached to the correct controller manually.
|
10 |
12 |
|
11 |
13 |
The '-usb' switch will make qemu create the UHCI controller as part of
|
12 |
14 |
the PIIX3 chipset. The USB 1.1 bus will carry the name "usb.0".
|
... | ... | |
32 |
34 |
device to the EHCI adapter.
|
33 |
35 |
|
34 |
36 |
|
|
37 |
Companion controller support
|
|
38 |
----------------------------
|
|
39 |
|
|
40 |
Companion controller support has been added recently. The operational
|
|
41 |
model described above with two completely separate busses still works
|
|
42 |
fine. Additionally the UHCI and OHCI controllers got the ability to
|
|
43 |
attach to a usb bus created by EHCI as companion controllers. This is
|
|
44 |
done by specifying the masterbus and firstport properties. masterbus
|
|
45 |
specifies the bus name the controller should attach to. firstport
|
|
46 |
specifies the first port the controller should attach to, which is
|
|
47 |
needed as usually one ehci controller with six ports has three uhci
|
|
48 |
companion controllers with two ports each.
|
|
49 |
|
|
50 |
There is a config file in docs which will do all this for you, just
|
|
51 |
try ...
|
|
52 |
|
|
53 |
qemu -readconfig docs/ich9-ehci-uhci.cfg
|
|
54 |
|
|
55 |
... then use "bus=ehci.0" to assign your usb devices to that bus.
|
|
56 |
|
|
57 |
|
35 |
58 |
More USB tips & tricks
|
36 |
59 |
======================
|
37 |
60 |
|