COMEDI_GET_HARDCAL_C(3)

📦
version 0.11.0+5 · 7 versions
, in ubuntu resolute, ubuntu stonking

💅 COMEDI_GET_HARDCAL_C(3) 💅

okay bestie, so this is a page from the Comedi reference manual, and it's all about comedi_get_hardcal_converter. it's giving "library function that sets up your calibration vibe" and honestly? iconic. let's get into it 🫶

✨ NAME ✨

comedi_get_hardcal_converter — get the converter for a hardware-calibrated subdevice, periodt 💅

🌸 SYNOPSIS 🌸

#include <comedilib.h>

int comedi_get_hardcal_converter(comedi_t * device, unsigned subdevice,
                                 unsigned channel, unsigned range,
                                 enum comedi_conversion_direction direction,
                                 comedi_polynomial_t * converter);

like, that's the whole flex. #include <comedilib.h> first, no cap, then the function signature exactly as written 💖

🦋 STATUS 🦋

alpha — yeah, it's giving "still cooking", bestie 🍓

🎀 DESCRIPTION 🎀

so comedi_get_hardcal_converter initializes the comedi_polynomial_t that converter points to, so that it can then be handed off to either comedi_to_physical or comedi_from_physical. the result you get back can be used to convert data from the subdevice, channel, and range you specified. the direction parameter is the one that tells it which of those two it's gonna be passed to — so choose wisely, queen 👑

this function initializes the comedi_polynomial_t pointed to by converter as a simple linear function with no calibration information, which is the correct vibes for boards that do their gain/offset/nonlinearity corrections in hardware. it's giving "the hardware already handled it, we're just chillin" ✨

if your board needs calibration done in software by the host computer instead, then this is not your girl — use comedi_get_softcal_converter instead. a subdevice will advertise the fact that it depends on a software calibration with the SDF_SOFT_CALIBRATED subdevice flag. so check that flag, bestie, it's literally right there 🫶

also important: the result of this function will only depend on the channel parameter if either comedi_range_is_chan_specific or comedi_maxdata_is_chan_specific returns true for the specified subdevice. so like, sometimes channel matters and sometimes it doesn't — it's giving "it depends" 🙈

👑 RETURN VALUE 👑

  • returns 0 on success 💖
  • returns -1 on failure 💀

that's it. clean, simple, main character energy.

💜 AUTHORS 💜

shoutout to the legends who made this happen, fr fr:

  • David Schleef <ds@schleef.org> — Author.
  • Frank Mori Hess <fmhess@users.sourceforge.net> — Author.
  • Herman Bruyninckx <Herman.Bruyninckx@mech.kuleuven.ac.be> — Author.
  • Bernd Porr <tech@linux-usb-daq.co.uk> — Author.
  • Ian Abbott <abbotti@mev.co.uk> — Author.
  • Éric Piel <piel@delmic.com> — Author.

every single one of them an icon, no notes 🌟

okay legal corner, bestie, but make it cute:

  • Copyright © 1998-2003 David Schleef
  • Copyright © 2001-2003, 2005, 2008 Frank Mori Hess
  • Copyright © 2002-2003 Herman Bruyninckx
  • Copyright © 2012 Bernd Porr
  • Copyright © 2012 Ian Abbott
  • Copyright © 2012, 2015 Éric Piel

This document is part of Comedilib. In the context of this document, the term "source code" as defined by the license is interpreted as the XML source.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, version 2.1 of the License.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.

also the "no warranty" thing is real, bestie — it literally says WITHOUT ANY WARRANTY in all caps. i'm just the messenger 💀

and that's the whole page!! this came from the Comedi manual, dated 03/20/2026, and it was slayed from top to bottom 🎀✨ go forth and calibrate, queen 💖🦋

📦 where this page comes from