1comedi_calibrate(8) System Manager's Manual comedi_calibrate(8)
2
6 comedi_calibrate - COMEDI calibration utility
7
9 comedi_calibrate [-f /dev/comediN]
10
12 comedi_calibrate is used to autocalibrate comedi devices. Some comedi
13 devices have the ability to measure internal stable voltage references
14 and control gains and offsets using programmable DACs. On these
15 devices, comedi_calibrate determines the proper values to feed into the
16 programmable calibration DACs. These calibration settings are then
17 saved to a file, which can be fed to comedi_apply_calibration() and
18 related functions.
19 If comedi_calibrate finds an existing calibration file, it will not
21 perform a new calibration by default. It will simply read its calibra‐
22 tion information from the file. This behaviour may be overriden with
23 the --calibrate option, to force a new calibration to be performed.
24 After obtaining the calibration information for the board, comedi_cali‐
26 brate will then apply a calibration setting appropriate for the speci‐
27 fied subdevice, channel, and range (see the --subdevice , --channel ,
28 and --range options below). See the comedilib documentation for
29 comedi_apply_calibration() for more information.
30 comedi_calibrate prints a lot of debugging information as it runs.
32
35 comedi_calibrate only works on boards that it understands. For boards
36 that are known to have autocalibration ability, but are not currently
37 supported, comedi_calibrate will output basic debugging information
38 that is useful for the author to add support for your device. Please
39 send this output to him.
40
43 comedi_calibrate --file /dev/comediN
44 If no default calibration for /dev/comediN already exists, per‐
45 form a calibration and save results to default location.
46 comedi_calibrate --calibrate
49 Perform a calibration, using existing calibration (if it exists)
50 as starting point.
51 comedi_calibrate --reset --calibrate
54 Perform a fresh calibration and save results to default loca‐
55 tion.
56 comedi_calibrate --no-calibrate --subde‐
59 vice subd --range range --save-file cal_file
60 Apply calibration for subdevice subd, range range, using the
61 settings in the calibration file cal_file.
62
66 comedi_calibrate recognizes the following options:
67 -a aref, --aref aref
70 Along with --channel, --range and --subdevice, this specifies
71 which calibration you want comedi_calibrate leave applied to the
72 board. The default is 0.
73 --[no-]calibrate
76 Force calibration to be performed (or not). By default,
77 comedi_calibrate will only perform a new calibration if no
78 existing calibration file is found (see --save-file).
79 -c channel,--channel channel
82 Along with --subdevice, --range and --aref, this specifies which
83 calibration you want comedi_calibrate to leave applied to the
84 board. The default is 0.
85 --[no-]dump
88 Perform (or not) dump of various information about state of cal‐
89 ibration prior to performing new calibration.
90 -f /dev/comediN,--file /dev/comediN
93 Perform calibration on device /dev/comediN.
94 --help Print help for options then exit.
97 -q, --quiet
100 Don't generate output to stdout.
101 -r range, --range range
104 Along with --channel, --subdevice and --aref, this specifies
105 which calibration you want comedi_calibrate to leave applied to
106 the board. The default is 0.
107 --[no-]reset
110 Reset (or don't reset) calibration subdevice to a reasonable
111 starting point before performing calibration. The default is
112 --no-reset. If --no-reset is used, the calibration routine will
113 try to use an existing calibration (see --save-file) as a start‐
114 ing point. This is useful if a single calibration pass is not
115 sufficient, and you wish to perform another calibration pass
116 starting from the results of the previous pass.
117 --[no-]results
120 Perform (or not) dump of various information about state of cal‐
121 ibration after performing new calibration.
122 -S file, --save-file file
125 Save calibration information to specified file, instead of
126 default location. If the file already exists, comedi_calibrate
127 will also use its contents as a starting point for the calibra‐
128 tion pass (see --no-reset).
129 -s subdevice, --subdevice subdevice
132 Along with --channel, --range and --aref, this specifies which
133 calibration you want comedi_calibrate to leave applied to the
134 board. The default is 0.
135 -v, --verbose
138 Generate more verbose output to stdout, can be specified multi‐
139 ple times
140
144 comedi(7)
145
148 0.7.x
149
152 David Schleef, <ds@schleef.org>
153 Frank Mori Hess, <fmhess@users.sourceforge.net>
155 comedi_calibrate(8)