comedi_calibrate(8)					      System Manager's Manual					       comedi_calibrate(8)

NAME

       comedi_calibrate - COMEDI calibration utility

SYNOPSIS

       comedi_calibrate [-f /dev/comediN]

DESCRIPTION

       comedi_calibrate  is  used to autocalibrate comedi devices.  Some comedi devices have the ability to measure internal stable voltage refer-
       ences and control gains and offsets using programmable DACs.  On these devices, comedi_calibrate determines the proper values to feed  into
       the programmable calibration DACs.  These calibration settings are then saved to a file, which can be fed to comedi_apply_calibration() and
       related functions.

       If comedi_calibrate finds an existing calibration file, it will not perform a new calibration by default.  It will simply read its calibra-
       tion information from the file.	This behaviour may be overridden with the --calibrate option, to force a new calibration to be performed.

       After obtaining the calibration information for the board, comedi_calibrate will then apply a calibration setting appropriate for the spec-
       ified subdevice, channel, and range (see the --subdevice , --channel , and --range options below).  See	the  comedilib	documentation  for
       comedi_apply_calibration() for more information.

       comedi_calibrate prints a lot of debugging information as it runs.

LIMITATIONS

       comedi_calibrate  only  works  on  boards that it understands.  For boards that are known to have autocalibration ability, but are not cur-
       rently supported, comedi_calibrate will output basic debugging information that is useful for the author to add support	for  your  device.
       Please send this output to him.

EXAMPLES

       comedi_calibrate --file /dev/comediN
	      If no default calibration for /dev/comediN already exists, perform a calibration and save results to default location.

       comedi_calibrate --calibrate
	      Perform a calibration, using existing calibration (if it exists) as starting point.

       comedi_calibrate --reset --calibrate
	      Perform a fresh calibration and save results to default location.

       comedi_calibrate --no-calibrate --subdevice subd  

	      --range range --save-file cal_file

	      Apply calibration for subdevice subd, range range, using the settings in the calibration file cal_file.

OPTIONS

       comedi_calibrate recognizes the following options:

       -a aref, --aref aref
	      Along  with  --channel,  --range	and  --subdevice,  this specifies which calibration you want comedi_calibrate leave applied to the
	      board.  The default is 0.

       --[no-]calibrate
	      Force calibration to be performed (or not).  By default, comedi_calibrate will only perform a new calibration if no  existing  cali-
	      bration file is found (see --save-file).

       -c channel,--channel channel
	      Along  with  --subdevice,  --range  and  --aref,	this specifies which calibration you want comedi_calibrate to leave applied to the
	      board.  The default is 0.

       --[no-]dump
	      Perform (or not) dump of various information about state of calibration prior to performing new calibration.

       -f /dev/comediN,--file /dev/comediN
	      Perform calibration on device /dev/comediN.

       --help Print help for options then exit.

       -q, --quiet
	      Don't generate output to stdout.

       -r range, --range range
	      Along with --channel, --subdevice and --aref, this specifies which calibration you want comedi_calibrate to  leave  applied  to  the
	      board.  The default is 0.

       --[no-]reset
	      Reset  (or  don't  reset)  calibration  subdevice  to  a	reasonable  starting  point before performing calibration.  The default is
	      --no-reset.  If --no-reset is used, the calibration routine will try to use an existing calibration (see --save-file) as a  starting
	      point.   This  is  useful  if a single calibration pass is not sufficient, and you wish to perform another calibration pass starting
	      from the results of the previous pass.

       --[no-]results
	      Perform (or not) dump of various information about state of calibration after performing new calibration.

       -S file, --save-file file
	      Save calibration information to specified file, instead of default location.  If the file already exists, comedi_calibrate will also
	      use its contents as a starting point for the calibration pass (see --no-reset).

       -s subdevice, --subdevice subdevice
	      Along  with --channel, --range and --aref, this specifies which calibration you want comedi_calibrate to leave applied to the board.
	      The default is 0.

       -v, --verbose
	      Generate more verbose output to stdout, can be specified multiple times

SEE ALSO

       comedi(7)

VERSION

       0.7.x

AUTHOR

       David Schleef, <ds@schleef.org>

       Frank Mori Hess, <fmhess@users.sourceforge.net>

								    2012-06-04						       comedi_calibrate(8)