ehci(4d) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

ehci(4d)

Device Drivers & /dev files                                           ehci(4D)



NAME
       ehci - Enhanced host controller driver

SYNOPSIS
       usb@unit-address

DESCRIPTION
       The  ehci  driver is a USBA (Oracle Solaris USB Architecture) compliant
       nexus driver that supports the Enhanced Host Controller Interface Spec‐
       ification 2.0, an industry standard developed by Intel.


       A  USB  2.0 host controller includes one high-speed host controller and
       zero or more USB 1.1 host controllers. The high-speed  host  controller
       implements  an  EHCI  (Enhanced Host Controller Interface) that is used
       for all high-speed communications to high-speed-mode devices.


       All USB 2.0 devices connected to the root ports of  the  USB  2.0  host
       controller and all devices connected to a high-speed-mode hub should be
       routed to the EHCI host controller.


       All full- and low-speed devices connected to the root ports of the  USB
       2.0 host controller should be routed to the companion USB 1.1 host con‐
       trollers. (OHCI or UHCI host controller).


       The ehci supports bulk, interrupt, control and iso  chronous  transfers
       (on USB1.x devices behind a USB2.0 hub).

FILES
       /kernel/drv/sparcv9/ehci    64-bit SPARC ELF kernel module


       /kernel/drv/amd64/ehci      64-bit x86 ELF kernel module


       /kernel/drv/ehci.conf       Driver configuration file


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ ArchitectureSPARC, x86, PCI-based systems _ Availabili‐
       tysystem/io/usb


SEE ALSO
       hubd(4D), ohci(4D), uhci(4D), usba(4D), attributes(7), add_drv(8), prt‐
       conf(8), rem_drv(8), update_drv(8)


       Writing Device Drivers in Oracle Solaris 11.4


       Universal Serial Bus Specification 2.0


       Enhanced Host Controller Interface Specification 1.0


       https://www.usb.org/


       https://www.intel.com/

DIAGNOSTICS
       In addition to being logged, the following messages may appear  on  the
       system console. All messages are formatted in the following manner:

         WARNING: <device path> (ehci<instance number>): Message...


       Unrecoverable USB hardware error.

           There  was an unrecoverable USB hardware error reported by the ehci
           controller. Reboot the system. If this  problem  persists,  contact
           your system vendor.


       No SOF interrupts.


           No  SOF  interrupts have been received. This USB EHCI controller is
           unusable.



       Error recovery failure: Please hotplug the 2.0 hub at <device path>.

           The driver failed to clear 2.0 hub's TT buffer. Remove and reinsert
           the external USB2.0 hub.


       Revision<xx> is not supported.

           High speed USB devices prior to revision 0.95 are not supported.



       The  following  messages  may  be entered into the system log. They are
       formatted in the following manner:

         <device path> (ehci<instance number>): Message...


       Unable to take control from BIOS. Failure is ignored.

           The driver was unable to take control of the EHCI hardware from the
           system's BIOS. This failure is ignored. To abort the attach on this
           take-over failure, comment out a property in ehci.conf. (x86 only).


       Unable to take control from BIOS.

           The driver is unable to take control of the EHCI hardware from  the
           system's  BIOS  and aborts the attach. High speed (USB 2.0) support
           is disabled. In this case, all USB devices run at  full/low  speed.
           Contact  your system vendor or your system administrator for possi‐
           ble changes in  BIOS  settings.  You  can  disable  a  property  in
           ehci.conf to ignore this failure. (x86 only.)


       Low speed device is not supported.
       Full speed device is not supported.

           The  driver  detected  a  low  or full speed device on its root hub
           port. Per USB 2.0 specification, the device should be routed  to  a
           companion host controller (OHCI or UHCI). However, no attached com‐
           panion host controller appears to be available. Therefore, low  and
           full speed devices are not supported.



       Low speed endpoint's poll interval of <n> ms is below threshold. Round‐
       ing up to 8 ms.

           Low speed endpoints are limited to polling intervals between  8  ms
           and  255  ms.  If  a device reports a polling interval that is less
           than 8 ms, the driver uses 8 ms instead.


       Low speed endpoint's poll interval is greater than 255 ms.

           The low speed device's polling interval is out of range.  The  host
           controller does not allocate bandwidth for this device. This device
           is not usable.


       Full speed endpoint's poll interval must be between 1 and 255 ms.

           The full speed device's polling interval is out of range. The  host
           controller does not allocate bandwidth for this device. This device
           is not usable.


       High speed endpoint's poll interval must be between 1 and 16 units.

           The high speed device's polling interval is out of range. The  host
           controller will not allocate bandwidth for this device. This device
           will not be usable. Refer to the USB  specification,  revision  2.0
           for the unit definition.


       ehci_modify_qh_status_bit: Failed to halt qh=<address>.

           Error  recovery  failed. Please disconnect and reinsert all devices
           or reboot.



       Due to recently discovered incompatibilities with this USB  controller,
       USB2.x transfer support has been disabled. However, this device contin‐
       ues to function as a USB1.x controller. Information on enabling  USB2.x
       support is provided in this man page.


       VIA chips may not be compatible with this driver. To bind ehci specifi‐
       cally to the chip and eliminate the warnings, and to enable USB2.x sup‐
       port,  a  new,  more  specific  driver  alias  (refer to add_drv(8) and
       update_drv(8)) must be specified for ehci. By default, the  ehci  alias
       is  pciclass,0c0320. The compatible names in the prtconf(8) output pro‐
       vides additional aliases. For example:



            # prtconf -vp | grep pciclass,0c0320
                 compatible: 'pci1106,3104.1106.3104.2063' +
         ´pci1106,3104.1106.3104' + 'pci1106,3104' +
          pci1106,3104.2063' + 'pci1106,3104' + 'pciclass,0c0320' +
         ´pciclass,0c03'
                  ....


                A more specific alias is 'pci1106,3104.' Perform the follow-
                ing step to add this alias, then reboot the system:


                # update_drv -a -i '"pci1106,3104"' ehci

                # reboot



       After you apply the above workaround, the  following  message  is  dis‐
       played in your system log:


       Applying VIA workarounds.



Oracle Solaris 11.4               20 Jul 2020                         ehci(4D)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3