Java Desktop System Release 3 Accessibility Guide

A.6 Configuring Alternative Pointer Devices

The following sections describe how to configure your system to use a standard physical mouse and another pointer device such as a single switch device or head tracker device, and how to configure On-Screen Keyboard to use the second pointer device.

A.6.1 To Configure Alternative Pointer Devices on Solaris Systems

To configure an alternative pointer device on a Solaris system, perform the following steps:

Note –

This procedure does not work on all Solaris platforms.

Before you connect the alternative pointer device to your system, enter the following command to list the existing devices:

ls -l /dev/usb/hid*
Connect the alternative pointer device to your system.
Enter the following command again to list the new device:

ls -l /dev/usb/hid*
Open the file /usr/openwin/server/etc/OWconfig.
Add the following lines to the OWconfig file:
```
# Sun Mouse module
	class="XINPUT" name="IMOUSE2"
	dev="/dev/usb/hid2" strmod="usbms"
	ddxHandler="ddxSUNWmouse.so.1"
	ddxInitFunc="ddxSUNWmouseProc";
```
where:
- the name option starts with the string IMOUSE but is extended to form a unique string, such as IMOUSE2 or IMOUSE3, depending on the number of existing devices.
- the dev option specifies the device name that you identified in Step 3.

Remove the following lines from the OWconfig file:

# Null Mouse module
	class="XINPUT" name="NMOUSE"
	ddxHandler="ddxSUNWmouse.so.1"
	ddxInitFunc="ddxnullmouseProc";

Save the /usr/openwin/server/etc/OWconfig file.
Restart the X Server.

A.6.2 To Configure Alternative Pointer Devices on Linux Systems

To configure an alternative pointer device on a Linux system, perform the following steps:

Before you connect the alternative pointer device to your system, enter the following command to list the existing devices:

ls -l /dev/usb/hid*
Connect the alternative pointer device to your system.
Enter the following command again to list the new device:

ls -l /dev/usb/hid*
Open the file /etc/X11/XF86Config.
Edit the InputDevice section where the Driver value is set to mouse as follows:
- Change the Option Device line to the following:
```
Option       "Device" "/dev/input/mouse0"
```
- Comment out the Option Protocol line as follows:
```
#Option       "Protocol" "explorerps/2"
```
Note –
If you are not using USB connections for your primary mouse device and other pointer device, you do not need to carry out this step.

Create a new InputDevice section as follows:

Section "InputDevice"
     Driver       "mouse"
     Identifier   "Mouse[3]"
     Option       "Device" "/dev/input/mouse1"
     Option       "Name" "Autodetection"
     Option       "Vendor" "Sysp"
   EndSection

Note –

If you are not using USB connections for your primary mouse device and other pointer device, you do not need to carry out this step.

Edit the ServerLayout section as follows:
- Change the InputDevice "Mouse[1]" line to the following:
```
InputDevice  "Mouse[1]" "CorePointer"
```
- Create a new InputDevice line as follows:
```
InputDevice  "Mouse[3]"
```
- Remove any occurrences of the attributes SendCore or AlwaysCore from any of InputDevice lines.
Note –
Ensure that only the device that you are using as the primary mouse device has the "CorePointer" attribute and ensure that the alternate input devices do not have the SendCore or AlwaysCore attributes.
Save the /etc/X11/XF86Config file.
Restart the X Server.

A.6.3 To Configure On-Screen Keyboard to Use an Alternative Pointer Device

To configure the On-Screen Keyboard application to use an alternative pointer device, perform the following steps.

Start the On-Screen Keyboard application.
Click on GOK in the GOK - main window.
Click on Preferences to open the Preferences dialog.
Click on the Actions tab.
In the Event Source options, select the Other input device option. On-Screen Reader displays the name of the input device that you configured in the text box next to the Other input device option.
Click OK to close the GOK Preferences dialog.