Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ devi-carrol

Media Vault

Software Library

Restoration Projects

Artifacts Sought

devi-carrol

[Previous] [Contents] [Index] [Next]

devi-carrol

Carrol Touch input manager for Photon

Syntax:

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

Runs on:

Neutrino

Options:


Note: 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 requires 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 | class
    
-t msecs
The throttle factor, in milliseconds (default: 0).
-v[v]...
Verbose output. More v characters cause more verbosity.

The protocol and protocol_opts are:

smartframe [smartframe_opts] [fd fd_opts]|[uart uart_opts]
fit [fit_opts] [fd fd_opts]|[uart uart_opts]

The protocol modules and their options are:

  • smartframe -- Carroll Touch Smartframe I protocol
    -b baud
    Baud rate (default 2400).
    -e
    Set Even Parity.
    -r
    Reset the device port.
  • fit -- Carrol Touch FIT protocol.
    -r
    Reset the device port.

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

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-carrol command starts the Carrol Touch input manager for Photon.

Examples:

Connect the smartframe controller to the first serial port, and use the serial manager to get input data. Touching the screen emulates a right mouse button press:

devi-carrol smartframe fd -d/dev/ser1 abs -b

Connect the fit controller to first serial port. No serial driver is running, so use the uart module to talk to the device directly:

devi-carrol fit uart 

See also:

inputtrap

Input drivers (devi-*) in the Utilities Summary


[Previous] [Contents] [Index] [Next]

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026