TS_CALIBRATE(1) tslib TS_CALIBRATE(1)
NAME
ts_calibrate - A test program to calibrate a touch screen used by tslib.
SYNOPSIS
ts_calibrate
DESCRIPTION
ts_calibrate is used to manually configure tslib's linear filter plugin.
It draws crosshairs to the framebuffer to be touched by the user and
records expected vs. actual touch contact positions needed to apply the
filter and provide a desired touch user experience. It uses the
TSLIB_CALIBFILE environment variable to store it's values.
-r, --rotate [value]
Rotate the screen. value is 0 for 0 degree, 1 for 90 degrees (CW), 2
for 180 degrees (upside down) and 3 for 270 degrees (CCW). This
value will be added to the calibration config file TSLIB_CALIBFILE
and picked up from the linear filter module from there. It can be
changed by a linear module parameter.
-t, --min_interval
The time in milliseconds that has to pass before a crosshair is
pressed by the user. This may be useful to avoid insanely fast or
accidentally wrong taps and thus inaccurate calibration. Default: 0.
-c, --validate
Validate the calibration. Make sure the linear module is configured
in ts.conf so that the current calibration is applied. In this mode,
crosses are displayed at random locations on screen and touches are
evaluated against their positions. In this mode the --loops and
--boundary options are available.
-b, --boundary
Validation boundary in pixels. Available only when --validate is
used. This defines how strict the validation should be. It's the the
distance that an evaluated touch input is allowed to be apart from a
cross to still pass the validation. If this boundary is crossed,
validation fails. Default: 10.
-l, --loops
Number of loops in validation mode. Available only when --validate
is used. This defines how many crosses should be touched and evalu-
ated. Default: 3.
ENVIRONMENT VARIABLES
see ts.conf (5)
SEE ALSO
ts.conf (5), ts_test (1), ts_uinput (1)
TS_CALIBRATE(1)
Generated by dwww version 1.16 on Sat Oct 3 07:35:38 CEST 2026.