Oracle® Solaris 11.2 Release Notes

Exit Print View

Updated: May 2015

SPARC: Desktop Issues With USB Keyboard, Mouse, and Physical Monitor (15700526)

When using a physical keyboard, mouse, or monitor, repeated attempts to open and use a terminal window on the Oracle Solaris Desktop can result in loss of characters and mouse control.

This issue might occur because of errors caused by missing microframes. These errors occur when full or low-speed USB 1.0 or 1.1 keyboard and mouse devices are connected to the USB ports on a system under an onboard USB 2.0 hub. However, these errors do not occur when the keyboard and the mouse devices are connected to a system USB port, which is in turn connected to an internal hub that is manually bound to the ohci (USB 1.0 or 1.1) driver.

Note -  If you are using a virtual keyboard and mouse, all devices under the hub are forced to run at low speed. The devices will still work, but they run at a lower USB 1.0 or 1.1 speed.

Workaround: Set the value for the ehci-port-forced-to-companion variable in the /kernel/drv/ehci.conf file. The value of this variable is used by the ehci (USB 2.0) driver to release control of a particular port on the USB controller.

The value of the ehci-port-forced-to-companion variable differs based on the type of platform and the type of USB device used. The following table lists the recommended usage of USB connectors and the corresponding value of the ehci-port-forced-to-companion variable.

Table 4-1  Recommended Usage of USB Connectors and Values
SPARC Platform
Type of USB Device
Recommended Usage of USB Connectors
Value of the ehci-port-forced-to-companion Variable in the /kernel/drv/ehci.conf File
T3-1, T3-2, T4-1, T4-2
Physical keyboard or mouse
Use the front USB connector
T3-4, T4-4
Physical keyboard or mouse
Use the rear USB connector
T3-1, T4-1, T3-2, T4-2, T3-4, T4-4
Virtual keyboard or mouse

To implement the workaround, perform the following steps:

  1. Connect the USB devices.

    The recommended USB connectors for the devices on various platforms are listed in Table 4–1.

  2. Set the value of the ehci-port-forced-to-companion variable in the /kernel/drv/ehci.conf file.

    For example, if the SPARC platform is T3–4 and you are using a physical keyboard, set ehci-port-forced-to-companion=3.

    For information about the value that you can set for this variable, see Table 4–1.

  3. Reboot the system.

    # init 6