NAME¶

ehci — USB Enhanced Host Controller driver

SYNOPSIS¶

device ehci

DESCRIPTION¶

The ehci driver provides support for the USB Enhanced Host Controller Interface, which is used by USB 2.0 controllers.

EHCI controllers are peculiar in that they can only handle the USB 2.0 protocol. This means that they normally have one or more companion controllers (i.e., ohci(4) or uhci(4)) handling USB 1.x devices. Consequently each USB connector is electrically connected to two USB controllers. The handling of this is totally automatic, but can be noticed since USB 1.x and USB 2.0 devices plugged in to the same connector appear to connect to different USB buses.

LOADER TUNABLES¶

When the kernel has been compiled with options USB_DEBUG, some tunables become available that affect the behavior of ehci. These tunables can be set at the loader(8) prompt before booting the kernel or stored in loader.conf(5).

hw.usb.ehci.lostintrbug

This tunable enables the lost interrupt quirk. The default value is 0 (off).

hw.usb.ehci.iaadbug

This tunable enables the EHCI doorbell quirk. The default value is 0 (off).

hw.usb.ehci.no_hs

This tunable disables USB devices to attach like HIGH-speed ones and will force all attached devices to attach to the FULL- or LOW-speed companion controller. The default value is 0 (off).

SYSCTL VARIABLES¶

The following variables are available as both sysctl(8) variables and loader(8) tunables:

hw.usb.ehci.debug

Debug output level, where 0 is debugging disabled and larger values increase debug message verbosity. Default is 0.

SEE ALSO¶

ohci(4), uhci(4), usb(4), xhci(4)

HISTORY¶

The ehci device driver first appeared in FreeBSD 5.1.