Revision 76f30473

b/docs/ich9-ehci-uhci.cfg
1
###########################################################################
2
#
3
# You can pass this file directly to qemu using the -readconfig
4
# command line switch.
5
#
6
# This config file creates a EHCI adapter with companion UHCI
7
# controllers as multifunction device in PCI slot "1d".
8
#
9
# Specify "bus=ehci.0" when creating usb devices to hook them up
10
# there.
11
#
12

  
13
[device "ehci"]
14
  driver = "ich9-usb-ehci1"
15
  addr = "1d.7"
16
  multifunction = "on"
17

  
18
[device "uhci-1"]
19
  driver = "ich9-usb-uhci1"
20
  addr = "1d.0"
21
  multifunction = "on"
22
  masterbus = "ehci.0"
23
  firstport = "0"
24

  
25
[device "uhci-2"]
26
  driver = "ich9-usb-uhci2"
27
  addr = "1d.1"
28
  multifunction = "on"
29
  masterbus = "ehci.0"
30
  firstport = "2"
31

  
32
[device "uhci-3"]
33
  driver = "ich9-usb-uhci3"
34
  addr = "1d.2"
35
  multifunction = "on"
36
  masterbus = "ehci.0"
37
  firstport = "4"
b/docs/usb2.txt
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

  

Also available in: Unified diff