Caution: This version of this document is no longer maintained. For the latest documentation, see


Advanced Graphics utility for calibrating a touchscreen


gf-calib [options]

Runs on:



Use the 3 point calibration method. This is the default method.
Use the 4 point calibration method.
Overwrite the calibration configuration file if it exists. The default location is /etc/system/config/calib.$(hostname).
-d device
Use the specified GF device.
Do not display the pointer cursor when running.
-f file
The name and location of a configuration file to create instead of the default at /etc/system/config/calib.$(hostname).
-i idx
The display index. The default is 0.
-I idx
The layer index. The default is the main layer.
-m x y
Sets the touch screen matrix size. This is currently unused.
-o n
Target offset in pixels. Used by the 4 points method only.
Sets the touch matrix's origin to the Lower Right corner. Used by the 3 points method only.
-s n
The number of repeat samples before accepting a touch input. Default is 10.
-t n
Set new bullseye target size in pixels. The default is 47. Suggested values are between 30 and 100.
Be verbose.


The gf-calib utility is used to calibrate a touchscreen on a GF-embedded device. Once the touchscreen is successfully configured it must be calibrated. The calib utility saves a configuration file at /etc/system/config/calib.$(hostname). You can use the -f option to specify a different configuration file. For information about this file format, see the “Calibration file format” section of the “Writing an Input Device Driver” chapter of the Input DDK documentation.

To invoke the calibration screen:

  1. Start io-display with the appropriate graphics driver.
  2. Start devi-* with the appropriate command-line options for the touchscreen device.
  3. Run gf-calib.
  4. Follow the on-screen instructions to complete the calibration.

See also: