1 .TH comedi_calibrate 8 ""
3 \fBcomedi_calibrate\fR - COMEDI calibration utility
5 \fBcomedi_calibrate\fR [-f /dev/comediN]
8 \fBcomedi_calibrate\fR is used to autocalibrate \fBcomedi\fR
9 devices. Some \fBcomedi\fR devices have the ability to
10 measure internal stable voltage references and control
11 gains and offsets using programmable DACs. On these devices,
12 \fBcomedi_calibrate\fR determines the proper values to
13 feed into the programmable calibration
14 DACs. These calibration settings are then
15 saved to a file, which can be fed to comedi_apply_calibration()
16 and related functions.
18 If comedi_calibrate finds an existing calibration file, it
19 will not perform a new calibration by default. It will
20 simply read its calibration information from the file.
22 may be overriden with the
24 option, to force a new calibration to be performed.
26 After obtaining the calibration information for the board,
27 comedi_calibrate will then apply a calibration setting
28 appropriate for the specified subdevice, channel, and
35 options below). See the comedilib documentation for
36 comedi_apply_calibration() for more information.
38 \fBcomedi_calibrate\fR prints a lot of debugging information
43 \fBcomedi_calibrate\fR only works on boards that it understands.
44 For boards that are known to have autocalibration ability,
45 but are not currently supported, \fBcomedi_calibrate\fR will
46 output basic debugging information that is useful for
47 the author to add support for your device. Please send this
53 .BI comedi_calibrate\ \-\-file\ /dev/comediN
54 If no default calibration for \fI/dev/comediN\fR already exists,
56 and save results to default location.
59 .BI comedi_calibrate\ \-\-calibrate
60 Perform a calibration, using existing calibration (if it exists) as
64 .BI comedi_calibrate\ \-\-reset\ \-\-calibrate
65 Perform a fresh calibration and save results to default location.
68 .BI comedi_calibrate\ \-\-no\-calibrate\ \-\-subdevice\ subd\ \-\-range\ range\ \-\-save\-file\ cal_file
69 Apply calibration for subdevice \fIsubd\fR, range \fIrange\fR, using
70 the settings in the calibration file \fIcal_file\fR.
75 \fBcomedi_calibrate\fR recognizes the following options:
78 .BI \-a\ aref ,\ \-\-aref\ aref
79 Along with \fB--channel\fR, \fB--range\fR
80 and \fB--subdevice\fR, this specifies which calibration you want comedi_calibrate
81 leave applied to the board.
84 .B \-\-[no\-]calibrate
85 Force calibration to be performed (or not).
86 By default, comedi_calibrate will only perform a new calibration if
87 no existing calibration file is found (see \fB--save-file\fR).
90 .BI \-c\ channel, \-\-channel\ channel
91 Along with \fB--subdevice\fR, \fB--range\fR
92 and \fB--aref\fR, this specifies which calibration you want comedi_calibrate
93 to leave applied to the board.
97 Perform (or not) dump of various information about
98 state of calibration prior to performing new calibration.
101 .BI \-f\ /dev/comediN, \-\-file\ /dev/comediN
102 Perform calibration on device \fB/dev/comediN\fR.
106 Print help for options then exit.
110 Don't generate output to stdout.
113 .BI \-r\ range ,\ \-\-range\ range
114 Along with \fB--channel\fR, \fB--subdevice\fR
115 and \fB--aref\fR, this specifies which calibration you want comedi_calibrate
116 to leave applied to the board.
120 Reset (or don't reset) calibration subdevice to
121 a reasonable starting point before
122 performing calibration. The default is \fB--no-reset\fR. If
123 \fB--no-reset\fR is used, the calibration routine will try to use
124 an existing calibration (see \fB--save-file\fR) as a starting point.
127 pass is not sufficient, and you wish to perform another calibration
128 pass starting from the results of the previous pass.
132 Perform (or not) dump of various information about
133 state of calibration after performing new calibration.
136 .BI \-S\ file ,\ \-\-save-file\ file
137 Save calibration information to specified file,
138 instead of default location. If the file already exists, comedi_calibrate
139 will also use its contents as a starting point for the calibration pass (see
143 .BI \-s\ subdevice ,\ \-\-subdevice\ subdevice
144 Along with \fB--channel\fR, \fB--range\fR
145 and \fB--aref\fR, this specifies which calibration you want comedi_calibrate
146 to leave applied to the board.
150 Generate more verbose output to stdout, can be specified multiple times
163 David Schleef, <ds@schleef.org>
165 Frank Mori Hess, <fmhess@users.sourceforge.net>