comedi_calibrate(8)

💅 NAME 💅

comedi_calibrate — the COMEDI calibration utility, bestie edition. It's giving "let me fix your board's voltage vibes."

---

✨ SYNOPSIS ✨

comedi_calibrate [-f /dev/comediN]

---

🎀 DESCRIPTION 🎀

okay so. comedi_calibrate is literally here to autocalibrate your comedi devices. Some comedi devices have the ability to measure internal stable voltage references and control gains and offsets using programmable DACs. On those devices, comedi_calibrate figures out the proper values to feed into the programmable calibration DACs. Those calibration settings get saved to a file, and that file can be fed to comedi_apply_calibration() and related functions. slay.

so here's the tea 🫖 — if comedi_calibrate finds an existing calibration file, it will not perform a new calibration by default. It just reads its calibration information from the file. iconic, low-effort, we respect it. But you can override this behaviour with the --calibrate option if you want 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 (peep the --subdevice, --channel, and --range options down below 👇). See the comedilib documentation for comedi_apply_calibration() for more info.

Also: comedi_calibrate prints a lot of debugging information as it runs. not me being chatty, it's just built different 💀

---

😭 LIMITATIONS 😭

comedi_calibrate only works on boards that it understands. periodt. 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. 🥺 do it for the plot.

---

🌈 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.BI--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 to 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) — go read it, bestie, it's the main character of this whole cinematic universe 💖

---

⭐ VERSION ⭐

0.7.x

---

💜 AUTHOR 💜

David Schleef, <ds@schleef.org>

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

---

and that's the whole thing, no cap 🫶 this was comedi_calibrate(8) from the System Manager's Manual, sittin' pretty at version 0.7.x — go calibrate something and make it ✨ iconic ✨