`devh-ps2ser.so`

Driver for serial and PS2 human interface devices (HID)

Syntax:

io-hid -d ps2ser protocol_module[,options]:device_module[,options] 
                 [:protocol_module[,options]:device_module[,options]]... 
                 [opts=v[v...]]

Options:

Colons (:) separate modules; commas (,) separate module options.

opts=v[v...]

Increment verbosity. The default is zero verbosity.

protocol_module[,options]

The input protocol module. You can specify multiple protocol/device module pairs.

The protocol_module variable may be any one of the following modules:

ps2mouse

Regular PS/2 mouse. There are no options.

msoft[,options]...

Mouse compatible with Microsoft/IntelliMouse protocol (serial). Options:

b=baud -- Baud rate for serial device (default 1200)
3 -- Microsoft 3 button mouse
R -- Don't reset mouse (the default is to reset the mouse)
i -- IntelliMouse protocol (wheel mice)

msys[,options]...

Mouse compatible with Mouse Systems mouse protocol (used by Logitech). Options:

b=baud -- Baud rate for serial device (default 1200)
R -- Don't reset mouse (default reset mouse)

kbd[,options]...

Scan codes for primary keyboard. Options:

k=(rate[,delay]) -- Keyboard rate (Hz), delay (ms). If you continually depress a key, after delay milliseconds, it will input data rate times a second. The default is 30Hz after 500ms. This only works in conjunction with the kbddev device module.
R -- Don't reset the device while doing a protocol reset
r -- Reset the device while doing a protocol reset
s -- The device driver should supply valid symbols

device_module[,options]

Device modules. The device_module variable depends on the protocol_module specified. The following device modules are supported:

fd[,options]...

Opens a device via the open() function. Options:

d=device -- The device to open fd() on (default /dev/ser1)
s -- Specifies that the input interface is serial (this allows the module to use some devctl commands that are specific to a serial port)
P -- The processing priority for this input event

uart[,options]...

Enables direct access to 8250, 16450, and 16550 uarts. Options:

i=irq -- IRQ number for the serial device (default 4)
p=ioport -- The port of the serial device (default 3f8)
1 -- Use COM1
2 -- Use COM2
P -- The processing priority for this input event

kbddev[,options]...

For PS2 keyboard. Options:

f=filename -- Create the named file and collect all data passed to the protocol level (debug only)
i=irq -- IRQ number (default 1)
p=(ioport,add) -- Port address (default 0x60), and a value to add to get the status port address (default 4: 0x60 + 4 = 0x64)
r -- Reset the device on initiation
P priority -- The processing priority for keyboard events

mousedev[,options]...

For PS2 mouse. Options:

f=filename -- Create the named file and collect all data passed to the protocol level (debug only)
i=irq -- IRQ number (default 12)
p=(ioport,add) -- Port address (default 0x60), and a value to add to get the status port address (default 4: 0x60 + 4 = 0x64)
r -- Reset the device on initiation
P priority -- The processing priority for mouse events

The devh-ps2ser.so DLL provides io-hid with HID information. The DLL collects raw data from a variety of legacy devices (e.g. PS2 keyboards, and PS2 and serial mice), transforms it to unified USB HID report format, and then sends the data to io-hid. The io-hid manager forwards the data to devi-hid.

The devh-ps2ser.so DLL is usually started by io-hid in the system startup procedure (see diskboot).

The devh-ps2ser.so DLL is the low-level part of the input channel. You have to start devh-usb.so to provide any top-level services required.

Examples:

Start a regular PS/2 mouse, a Microsoft/IntelliMouse serial mouse on COM1, and a PS/2 keyboard:

io-hid -d ps2ser ps2mouse:mousedev:msoft:uart,1:kbd:kbddev

Files:

devh-ps2ser.so: The devh-ps2ser.so Dll is normally found in /lib/dll.

Errors:

If an error occurs in devh-ps2ser.so, the keyboard will not work in text mode. If you specify at least one v option, details of driver activity will be reported on the console screen and will be appended to the system log; for more detail, increase the verbosity level.