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