HID input manager
Syntax:
devi-hid [general_opts]
protocol* [protocol_opts]*
filter* [filter_opts]*
Targets:
Any supported platform that has io-hid running.
Options:
General options
- -l
- List the internal modules. Modules are listed in the following format
where class may be P (protocol) or F (filter):
module name | date last compiled | revision | class
- -R res_x,res_y
- Specify the display resolution (e.g., -R800,480).
- -U user_name
- -U uid[:gid[,sup_gid]*]]
- (QNX Neutrino 6.6 or later)
Once running, run as the specified user, so that the program doesn't need to run as root:
- In the first form, the service sets itself to be the named user and uses that user's groups.
This form depends on the /etc/passwd and /etc/group files.
- In the second form, the service sets its user ID, and optionally its group ID and
supplementary groups, to the values provided.
- -v[v]...
- Verbose output.
More v characters cause more verbosity.
Protocol modules
The protocol modules and their options are:
- kbd
- Keyboard scan codes (connected to primary keyboard).
The options include:
- -k rate[,delay]
- The 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 150Hz after 500ms.
- -u device
- Optional; USB device number.
- mouse
- Common mouse protocol (no options).
- touch
- HID-compliant touchscreen.
The options include:
- -K
- Use kiosk mode (cursor doesn't drag).
- -m size
- The touchscreen Matrix size (default 1023).
This is used for calculated transformation points.
- -u device
- Optional; USB device number.
Filter modules
The filter modules and their options are:
- keyboard
- Translate scan codes to Unicode.
The options include:
- -k kbd_file
- The file to use to map the keyboard to support international
languages or alternate layouts, such as Dvorak.
- -L [N][C][S]
- Set the initial state of the keyboard and its LEDs (by default, all are off):
- C — turn CapsLock on
- N — turn NumLock on
- S — turn ScrollLock on
- rel
- Filter and compress the relative coordinates of mouse events.
The options include:
- -a
- Wheel acceleration parameter (default 10); the higher this value, the faster the mouse wheel acceleration.
- -G gain
- Motion multiplier (default 1).
- -l
- Swap right and left buttons.
- -T threshold
- Speed-doubling threshold in mickeys/second. If the mouse speed
exceeds this threshold, the cursor will move twice as far as it normally
does per mickey. (A mickey is the smallest amount of motion
the mouse can detect.) The default threshold is 100.
- -x
- Reverse X.
- -y
- Reverse Y.
- abs
- Transform and compress absolute coordinate touch events.
The options include:
- -a 3|4
- The transformation algorithm to use.
The available algorithms are 3-point (the default) and 4-point.
- -b
- Touching the screen is a right mouse button (default left).
- -c
- Calibrate mode; don't transform coordinates.
- -D pixels
- Use a differential filter that filters out packets that are within the given number of pixels of the last touch.
This prevents sending repeat coordinates.
- -f filename
- The name of the calibration file; the default is
/etc/system/config/calib.hostname.
- -N pixels
- Use a noise filter that filters out packets that are outside the given maximum number of pixels.
This filters out jittery events from some touchscreens.
- -O origin
- (Oh) The touchscreen origin, (0,0).
This is used for the calibration-free transformation.
If no calibration file is specified, the driver attempts to calculate the X,Y position based
on the screen resolution and the touchscreen matrix size (if known).
The possible values are:
- 0 — upper left
- 1 — lower left
- 2 — lower right
- 3 — upper right
- -o x,y
- The origin of the display region; the default is the origin of the graphics region.
- -S ms
- Use soft button release, which emulates a release event after the given number of milliseconds of
inactivity from the touch controller.
This is helpful for screens that aren't very sensitive, so that every event received
before the given number of milliseconds expire is treated as a pen-down event.
- -s x,y
- The coordinates of the lower right corner of the display region;
The default is the width and height of the graphics region.
- -x
- Reverse X.
- -y
- Reverse Y .
Description:
This manager is a universal input daemon for human interface devices (HIDs).
It's a client of io-hid, the HID server.
Note:
The
io-hid
resource manager must be running before
devi-hid can start.
This manager doesn't need information about the physical interfaces of
real devices: it relies on service from the io-hid
resource manager and supplementary input modules.
If you specify the verbosity option, activity messages are sent to
the console screen and to the system log.
Examples:
Start the keyboard and mouse manager:
devi-hid kbd mouse
Start the HID driver keyboard and touchscreen and tell the touchscreen to use the
older, four-point calibration algorithm:
devi-hid kbd touch abs -a4
Files:
- libhiddi.so
- Used by devi-hid
Errors:
If an error occurs in starting devi-hid, the HID won't work.
If you specify at least one v option, activity details
will be reported on the console screen and will be
appended to the system log; for more detail, increase the verbosity level.