Man Linux: Main Page and Category List

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>

                                                           comedi_calibrate(8)