plucky (3) comedi_digital_trigger_enable_levels.3.gz

Provided by: libcomedi-dev_0.11.0+5-1.3_amd64 bug

NAME

       comedi_digital_trigger_enable_levels - set digital trigger level detection

SYNOPSIS

       #include <comedilib.h>

       int comedi_digital_trigger_enable_levels(comedi_t * device, unsigned int subdevice,
                                                unsigned int trigger_id, unsigned int base_input,
                                                unsigned int high_level_inputs, unsigned int low_level_inputs);

STATUS

       alpha

DESCRIPTION

       This function enables level detection for a digital trigger on a subdevice. If the subdevice supports
       several digital triggers, the trigger_id selects one. The high_level_inputs and low_level_inputs
       parameters are bit fields that enable (1) or disable (0) high and low level detection on a set of (up to)
       32 inputs. The least-significant bit corresponds to the input specified by the base_input parameter, with
       subsequent bits corresponding to subsequent inputs.

       Successive calls to this function have an cumulative effect, which allows digital triggers to be set up
       for more than 32 inputs. There may also be a cumulative effect with calls to
       comedi_digital_trigger_enable_edges if the digital trigger supports a combination of edge and level
       triggering. Due to the cumulative effect, it may be necessary to call comedi_digital_trigger_disable to
       clear the old settings before reconfiguring the digital trigger inputs.

       A digital trigger may support edge detection, level detection, both at different times, or both at the
       same time. If it supports both but not at the same time, configuring level triggers will disable any
       previous edge triggers, or vice versa.

       This function is only useable on subdevices that provide support for the INSN_CONFIG_DIGITAL_TRIG
       configuration instruction, and only if the digital trigger supports level detection.

RETURN VALUE

       0 on success, -1 on error.

AUTHORS

       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.

       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.