Print this page
11641 spelling mistakes in section 7d of the manual
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man7d/ehci.7d.man.txt
+++ new/usr/src/man/man7d/ehci.7d.man.txt
1 1 EHCI(7D) Devices EHCI(7D)
2 2
3 3
4 4
5 5 NAME
6 6 ehci - Enhanced host controller driver
7 7
8 8 SYNOPSIS
9 9 usb@unit-address
10 10
11 11
12 12 DESCRIPTION
13 13 The ehci driver is a USBA (Solaris USB Architecture) compliant nexus
14 14 driver that supports the Enhanced Host Controller Interface
15 15 Specification 2.0, an industry standard developed by Intel.
16 16
17 17
18 18 A USB 2.0 host controller includes one high-speed host controller and
19 19 zero or more USB 1.1 host controllers. The high-speed host controller
20 20 implements an EHCI (Enhanced Host Controller Interface) that is used
21 21 for all high-speed communications to high-speed-mode devices.
22 22
23 23
|
↓ open down ↓ |
23 lines elided |
↑ open up ↑ |
24 24 All USB 2.0 devices connected to the root ports of the USB 2.0 host
25 25 controller and all devices connected to a high-speed-mode hub should be
26 26 routed to the EHCI host controller.
27 27
28 28
29 29 All full- and low-speed devices connected to the root ports of the USB
30 30 2.0 host controller should be routed to the companion USB 1.1 host
31 31 controllers. (OHCI or UHCI host controller).
32 32
33 33
34 - The ehci supports bulk, interrupt, control and iso chronous transfers
34 + The ehci supports bulk, interrupt, control and isochronous transfers
35 35 (on USB1.x devices behind a USB2.0 hub).
36 36
37 37 FILES
38 - /kernel/drv/ehci
39 - 32-bit ELF 86 kernel module
40 -
41 -
42 38 /kernel/drv/sparcv9/ehci
43 - 64-bit SPARC ELF kernel module
39 + Device driver (SPARC)
44 40
45 41
46 42 /kernel/drv/amd64/ehci
47 - 64-bit x86 ELF kernel module
43 + Device driver (x86)
48 44
49 45
50 46 /kernel/drv/ehci.conf
51 47 Driver configuration file
52 48
53 49
54 50 ATTRIBUTES
55 51 See attributes(5) for descriptions of the following attributes:
56 52
57 53
58 54
59 55
60 56 +---------------+-------------------------------+
61 57 |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
62 58 +---------------+-------------------------------+
63 59 |Architecture | SPARC, x86, PCI-based systems |
64 60 +---------------+-------------------------------+
65 61
66 62 SEE ALSO
67 63 add_drv(1M), prtconf(1M), rem_drv(1M), update_drv(1M), attributes(5),
68 64 hubd(7D), uhci(7D), ohci(7D), usba(7D)
69 65
70 66
71 67 Writing Device Drivers
72 68
73 69
74 70 Universal Serial Bus Specification 2.0
75 71
76 72
77 73 Enhanced Host Controller Interface Specification 1.0
78 74
79 75
80 76 System Administration Guide: Basic Administration
81 77
82 78
83 79 http://www.usb.org
84 80
85 81
86 82 http://www.intel.com/technology/usb/ehcispec.htm
87 83
88 84 DIAGNOSTICS
89 85 In addition to being logged, the following messages may appear on the
90 86 system console. All messages are formatted in the following manner:
91 87
92 88 WARNING: <device path> (ehci<instance number>): Message...
93 89
94 90
95 91
96 92 Unrecoverable USB hardware error.
97 93
98 94 There was an unrecoverable USB hardware error reported by the ehci
99 95 controller. Reboot the system. If this problem persists, contact
100 96 your system vendor.
101 97
102 98
103 99 No SOF interrupts.
104 100
105 101 No SOF interrupts have been received. This USB EHCI controller is
106 102 unusable.
107 103
108 104
109 105 Error recovery failure: Please hotplug the 2.0 hub at <device path>.
110 106
111 107 The driver failed to clear 2.0 hub's TT buffer. Remove and reinsert
112 108 the external USB2.0 hub.
113 109
114 110
115 111 Revision<xx> is not supported.
116 112
117 113 High speed USB devices prior to revision 0.95 are not supported.
118 114
119 115
120 116
121 117 The following messages may be entered into the system log. They are
122 118 formatted in the following manner:
123 119
124 120 <device path> (ehci<instance number>): Message...
125 121
126 122
127 123
128 124 Unable to take control from BIOS. Failure is ignored.
129 125
|
↓ open down ↓ |
72 lines elided |
↑ open up ↑ |
130 126 The driver was unable to take control of the EHCI hardware from the
131 127 system's BIOS. This failure is ignored. To abort the attach on this
132 128 take-over failure, comment out a property in ehci.conf. (x86 only).
133 129
134 130
135 131 Unable to take control from BIOS.
136 132
137 133 The driver is unable to take control of the EHCI hardware from the
138 134 system's BIOS and aborts the attach. High speed (USB 2.0) support
139 135 is disabled. In this case, all USB devices run at full/low speed.
140 - Contact your system vendor or your system administror for possible
141 - changes in BIOS settings. You can disable a property in ehci.conf
142 - to ignore this failure. (x86 only.)
136 + Contact your system vendor or your system administrator for
137 + possible changes in BIOS settings. You can disable a property in
138 + ehci.conf to ignore this failure. (x86 only.)
143 139
144 140
145 141 Low speed device is not supported.
146 142 Full speed device is not supported.
147 143
148 144 The driver detected a low or full speed device on its root hub
149 145 port. Per USB 2.0 specification, the device should be routed to a
150 146 companion host controller (OHCI or UHCI). However, no attached
151 147 companion host controller appears to be available. Therefore, low
152 148 and full speed devices are not supported.
153 149
154 150
155 151 Low speed endpoint's poll interval of <n> ms is below threshold.
156 152 Rounding up to 8 ms.
157 153
158 154 Low speed endpoints are limited to polling intervals between 8 ms
159 155 and 255 ms. If a device reports a polling interval that is less
160 156 than 8 ms, the driver uses 8 ms instead.
161 157
162 158
163 159 Low speed endpoint's poll interval is greater than 255 ms.
164 160
165 161 The low speed device's polling interval is out of range. The host
166 162 controller does not allocate bandwidth for this device. This device
167 163 is not usable.
168 164
169 165
170 166 Full speed endpoint's poll interval must be between 1 and 255 ms.
171 167
172 168 The full speed device's polling interval is out of range. The host
173 169 controller does not allocate bandwidth for this device. This device
174 170 is not usable.
175 171
176 172
177 173 High speed endpoint's poll interval must be between 1 and 16 units.
178 174
179 175 The high speed device's polling interval is out of range. The host
180 176 controller will not allocate bandwidth for this device. This device
181 177 will not be usable. Refer to the USB specification, revision 2.0
182 178 for the unit definition.
183 179
184 180
185 181 ehci_modify_qh_status_bit: Failed to halt qh=<address>.
186 182
187 183 Error recovery failed. Please disconnect and reinsert all devices
188 184 or reboot.
189 185
190 186
191 187 Note -
192 188
193 189 Due to recently discovered incompatibilities with this USB
194 190 controller, USB2.x transfer support has been disabled. However, this
195 191 device continues to function as a USB1.x controller. Information on
196 192 enabling USB2.x support is provided in this man page.
197 193
198 194 VIA chips may not be compatible with this driver. To bind ehci
199 195 specifically to the chip and eliminate the warnings, and to enable
200 196 USB2.x support, a new, more specific driver alias (refer to
201 197 add_drv(1M) and update_drv(1M)) must be specified for ehci. By
202 198 default, the ehci alias is 'pciclass,0c0320.' The compatible names in
203 199 the prtconf(1M) output provides additional aliases. For example:
204 200
205 201 # prtconf -vp | grep pciclass,0c0320
206 202 compatible: 'pci1106,3104.1106.3104.2063' +
207 203 'pci1106,3104.1106.3104' + 'pci1106,3104' +
208 204 pci1106,3104.2063' + 'pci1106,3104' + 'pciclass,0c0320' +
209 205 'pciclass,0c03'
210 206 ....
211 207
212 208
213 209 A more specific alias is 'pci1106,3104.' Perform the follow-
214 210 ing step to add this alias, then reboot the system:
215 211
216 212
217 213 # update_drv -a -i '"pci1106,3104"' ehci
218 214
219 215 # reboot
220 216
|
↓ open down ↓ |
68 lines elided |
↑ open up ↑ |
221 217
222 218
223 219 After you apply the above workaround, the following message is
224 220 displayed in your system log:
225 221
226 222
227 223 Applying VIA workarounds.
228 224
229 225
230 226
231 - May 13, 2017 EHCI(7D)
227 + January 10, 2020 EHCI(7D)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX