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 for a touchscreen device, 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

Specify that 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
    

-P

Disable the Photon interface (it's started by default).

-r

Start the resource manager interface (use this option only if you aren't using Photon).

-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.

  -f

  Work with a finger.

  -i irq

  The IRQ for the serial device (default 1).

  -l logical port

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

  ---

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

  ---

  -n

  Work with a pen (the default).

  -p ioport,add

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

• touchusb — communicate with device via the USB controller.

  -f

  Work with a finger.

  -n

  Work with a pen (the default).

  -s

  Use the SC protocol (SC400, SC500 & SC800 controllers).

  -u device

  Specify the USB device number.

  ---

  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: If you use a serial mouse, use: kbd kbddev msoft fd -d /dev/serN If you don't use a mouse, use: kbd kbddev

  ---

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

See also:

devi-*, inputtrap