STANNIX Community


Manual: ts_calibrate

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 evaluated. Default: 3.

ENVIRONMENT VARIABLES
       see ts.conf (5)

SEE ALSO
       ts.conf (5), ts_test (1), ts_uinput (1)

													     TS_CALIBRATE(1)