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)