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
references 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 calibration information
from the file. This behaviour may be overriden 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 specified 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 currently
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 calibration 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>