devi-microtouch

`devi-microtouch`

Microtouch input manager for Photon

Syntax:

devi-microtouch [general_opts] 
                protocol* [protocol_opts]*
                device* [device_opts]*
                filter* [filter_opts]*

Runs on:

Neutrino

Options:

When you use a devi- * driver, you need a calibration file. The calibration file is generated from the output produced by the calib utility:

calib > calib_file.txt

For more information, see the calib utility in the Utilities Reference, and Touchscreens in the Neutrino User's Guide.

General options:

-b

Prevent the use of the Ctrl-Alt-Shift-Backspace keychord to exit Photon (permitted by default).

-d device

Device (default: /dev/photon or $PHOTON).

-G

A graphics driver isn't required when starting a touchscreen driver. This option is useful when you're debugging.

-g input_group

Input group (default: 1).

-l

List the internal modules. Modules are listed in the following format where class is one of: D -- Device, P -- Protocol, or F -- Filter:

module name | date compiled | revision | class

-v[v]...

Verbose output. More v characters cause more verbosity.

The protocol and protocol_opts are:

microtouch [microtouch_opts] [fd fd_opts]
|[uart uart_opts]|[touchdev touchdev_opts] 
[touchusb touchusb_opts]_

The protocol modules and their options are:

microtouch -- Microtouch (uses Tablet Format)

-b baud

Baud rate (default 9600)

-R

Don't reset the device (default: reset it).

The device modules and their options are:

fd -- open a device via open().

-d device

The device to open fd on (default /dev/ser1).

-s

The input interface is serial (i.e. the module can use devctl() commands that are specific to a serial port).
uart -- access the 8250/16450/16550 UART directly.

-1

Use COM1.

-2

Use COM2.

-i irq

The IRQ for the serial device (default 4).

-p ioport

The port of the serial device (default 3f8).
touchdev -- communicate with device via the PS2 port.

-i irq

The IRQ for the serial device (default 1).

-p ioport, add

The port of the serial device (default 0x60), and a value to add to get the status.

-l logical port

Port is 0 if the device is connected to the PS2 keyboard port. Port is 1 if the device is connected to the PS2 mouse port (default).

If you want to specifiy the -l parameter in the touchdev module, you must place it before any other parameter.

touchusb -- communicate with device via the USB controller. This version of the USB module doesn't use any option.

If you use the touchdev module, you must disable the standard mouse/keyboard driver devi-hirun PS2 mouse module.

You can do this by creating a /etc/config/trap/input[.hostname] file with one of the following strings:

kbd kbddev msoft fd -d /dev/serN

-- if you use a serial mouse

kbd kbddev

-- if you don't use a mouse

The filter modules and their options are:

abs -- transform and compress absolute coordinate "touch" events.

-b

Touching the screen is a right mouse button (default left).

-c

Calibrate mode; don't transform coordinates.

-f filename

The calibration filename.

-o x,y

The origin of the display region (default: the origin of the graphics region).

-s x,y

The coordinates of the lower right corner of the display region (default: the width and height of the graphics region).

-x

Reverse the x coordinates.

-y

Reverse the y coordinates.

Description:

The devi-microtouch command starts the Microtouch input manager for Photon.

Examples:

Connect a Microtouch controller to first serial port:

devi-microtouch microtouch fd -d/dev/ser1 abs -b

Museum