NAME

comedi_get_cmd_timing_constraints - Get the hardware timing constraints for a streaming subdevice

SYNOPSIS

#include <comedilib.h>

int comedi_get_cmd_timing_constraints(comedi_t * device, unsigned int subdevice, unsigned int scan_begin_src, unsigned int * scan_begin_min, unsigned int convert_src, unsigned int * convert_min, unsigned int * chanlist, unsigned int chanlist_len);

STATUS

alpha

DESCRIPTION

This function queries the hardware timing constraints of a streaming subdevice.

The values returned by this function may indicate the range of valid inputs for comedi_cmd->scan_begin_arg and comedi_cmd->convert_arg, for instance when comedi_cmd->scan_begin_src==TRIG_TIMER or comedi_cmd->convert_src==TRIG_TIMER. For TRIG_EXT (or other modes?), these returned values are mostly informational and may be used in conjunction with other triggering hardware.

If it is possible for the hardware constraints to depend on whether [*]_src==TRIG_TIMER or [*]_src==TRIG_EXT, the values returned by this function will depend on these inputs. Alternatively, one can specify something like [*]_src==TRIG_TIMER|TRIG_EXT and retrieve the value that is the smallest that satisfies both trigger sources.

scan_begin_min may be given as NULL, such that nothing will be returned for minimum scan speed.

convert_min may be given as NULL, such that nothing will be returned for minimum scan speed.

RETURN VALUE

0 on success, -1 on error.

AUTHORS

David Schleef <ds@schleef.org>

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

Herman Bruyninckx <Herman.Bruyninckx@mech.kuleuven.ac.be>

Bernd Porr <tech@linux-usb-daq.co.uk>

Ian Abbott <abbotti@mev.co.uk>

Éric Piel <piel@delmic.com>

Spencer Olson <olsonse@umich.edu>

COPYRIGHT

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
Copyright © 2016-2018 Spencer Olson

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.