#include <analoginput.h>

Inheritance diagram for AnalogInput:

Collaboration diagram for AnalogInput:

Public Member Functions
	AnalogInput (void)

	AnalogInput (int aitype)

	AnalogInput (const string &deviceclass, int aitype=0)

virtual	~AnalogInput (void)

virtual int	open (const string &device) override

virtual int	open (Device &device) override

virtual bool	isOpen (void) const =0

virtual void	close (void)=0

virtual int	channels (void) const =0

virtual int	bits (void) const =0

virtual double	maxRate (void) const =0

virtual int	maxRanges (void) const =0

virtual double	unipolarRange (int index) const =0

virtual double	bipolarRange (int index) const =0

int	minGainIndex (bool unipolar) const

int	maxGainIndex (bool unipolar) const

int	gainIndex (bool unipolar, double maxvoltage) const

virtual int	testRead (InList &traces)

virtual int	prepareRead (InList &traces)=0

virtual int	startRead (QSemaphore sp=0, QReadWriteLock datamutex=0, QWaitCondition datawait=0, QSemaphore aosp=0)=0

virtual int	readData (void)=0

virtual int	convertData (void)=0

virtual void	model (InList &data, const vector< int > &aochannels, vector< float > &aovalues)

virtual int	stop (void)=0

virtual int	reset (void)=0

virtual bool	running (void) const

virtual void	take (const vector< AnalogInput * > &ais, const vector< AnalogOutput * > &aos, vector< int > &aiinx, vector< int > &aoinx, vector< bool > &airate, vector< bool > &aorate)

virtual void	addTraces (vector< TraceSpec > &traces, int deviceid) const

virtual int	matchTraces (InList &traces) const

int	analogInputType (void) const

Public Member Functions inherited from Device
	Device (int type=MiscellaneousType)

	Device (const string &deviceclass, int type=MiscellaneousType)

virtual	~Device (void)

virtual const Options &	info (void) const

virtual const Options &	settings (void) const

int	deviceType (void) const

string	deviceTypeStr (void) const

string	deviceClass (void) const

string	deviceFile (void) const

string	deviceName (void) const

string	deviceVendor (void) const

string	deviceIdent (void) const

virtual void	setDeviceIdent (const string &ident)

virtual void	clearError (void)

virtual string	errorStr (void) const

void	setErrorStr (const string &strg)

void	addErrorStr (const string &strg)

void	setErrorStr (int errnum)

void	addErrorStr (int errnum)

virtual bool	success (void) const

virtual bool	failed (void) const

Public Member Functions inherited from Options
	Options (void)

	Options (const Options &o)

	Options (const Options &o, int flags)

	Options (const string &name, const string &type, int flags, int style)

	Options (const Str &opttxt, const string &assignment=":=", const string &separator=",;")

	Options (const StrQueue &sq, const string &assignment=":=")

	Options (istream &str, const string &assignment=":=", const string &comment="#", const string &stop="", string *line=0)

virtual	~Options (void)

Options &	operator= (const Options &o)

Options &	assign (const Options &o)

Options &	append (const Options &o)

Options &	add (const Options &o)

Options &	insert (const Options &o, const string &atname="")

Options &	assign (const Options &o, int flags)

Options &	copy (Options &o, int flags)

Options &	append (const Options &o, int flags)

Options &	add (const Options &o, int flags)

Options &	insert (const Options &o, int flags, const string &atname="")

Parameter *	assign (const string &name, const string &value)

Options *	parentSection (void)

const Options *	parentSection (void) const

void	setParentSection (Options *parentsection)

void	resetParents (void)

Options *	rootSection (void)

const Options *	rootSection (void) const

string	name (void) const

virtual void	setName (const string &name)

virtual void	setName (const string &name, const string &type)

string	type (void) const

void	setType (const string &type)

string	include (void) const

void	setInclude (const string &include)

void	setInclude (const string &url, const string &name)

int	flag (void) const

bool	flag (int selectflag) const

Options &	setFlag (int flag)

Options &	addFlag (int flag)

Options &	delFlag (int flag)

Options &	clearFlag (void)

int	style (void) const

Options &	setStyle (int style)

Options &	addStyle (int style)

Options &	delStyle (int style)

Options &	clearStyle (void)

bool	checkType (int mask) const

Str	warning (void) const

iterator	begin (void)

iterator	end (void)

const_iterator	begin (void) const

const_iterator	end (void) const

section_iterator	sectionsBegin (void)

section_iterator	sectionsEnd (void)

const_section_iterator	sectionsBegin (void) const

const_section_iterator	sectionsEnd (void) const

const_iterator	find (const string &pattern, int level=-1) const

iterator	find (const string &pattern, int level=-1)

const_iterator	rfind (const string &pattern, int level=-1) const

iterator	rfind (const string &pattern, int level=-1)

const_section_iterator	findSection (const string &pattern, int level=-1) const

section_iterator	findSection (const string &pattern, int level=-1)

const_section_iterator	rfindSection (const string &pattern, int level=-1) const

section_iterator	rfindSection (const string &pattern, int level=-1)

const Parameter &	operator[] (int i) const

Parameter &	operator[] (int i)

const Parameter &	operator[] (const string &name) const

Parameter &	operator[] (const string &name)

const Options &	section (int i) const

Options &	section (int i)

const Options &	section (const string &name) const

Options &	section (const string &name)

Str	request (const string &name) const

Parameter &	setRequest (const string &name, const string &request)

Parameter::ValueType	valueType (const string &name) const

Parameter &	setValueType (const string &name, Parameter::ValueType type)

int	flags (const string &name) const

bool	flags (const string &name, int flag) const

Parameter &	setFlags (const string &name, int flags)

Parameter &	addFlags (const string &name, int flags)

Parameter &	delFlags (const string &name, int flags)

Parameter &	clearFlags (const string &name)

bool	changed (const string &name)

int	style (const string &name) const

Parameter &	setStyle (const string &name, int style)

Parameter &	addStyle (const string &name, int style)

Parameter &	delStyle (const string &name, int style)

Str	format (const string &name) const

Parameter &	setFormat (const string &name, int width=0, int prec=-1, char fmt='g')

Parameter &	setFormat (const string &name, const string &format)

int	formatWidth (const string &name) const

int	size (const string &name) const

Parameter &	add (const Parameter &np)

Parameter &	insert (const Parameter &np, const string &atname="")

Parameter &	addText (const string &name, const string &request, const string &dflt, int flags=0, int style=0)

Parameter &	addText (const string &name, const string &dflt="", int flags=0, int style=0)

Parameter &	insertText (const string &name, const string &atname, const string &request, const string &dflt, int flags=0, int style=0)

Parameter &	insertText (const string &name, const string &atname="", const string &dflt="", int flags=0, int style=0)

Str	text (const string &name, int index, const string &dflt="", const string &format="", const string &unit="") const

Str	text (const string &name, const string &dflt="", const string &format="", const string &unit="") const

void	texts (const string &name, vector< string > &s, const string &format="", const string &unit="") const

Str	allText (const string &name, const string &dflt="", const string &format="", const string &unit="", const string &separator=", ") const

Parameter &	setText (const string &name, const string &strg)

Parameter &	setText (const string &name, const Parameter &p)

Parameter &	pushText (const string &name, const string &strg)

Str	defaultText (const string &name, const string &format="", const string &unit="") const

Parameter &	setDefaultText (const string &name, const string &dflt)

Parameter &	addSelection (const string &name, const string &request, const string &selection, int flags=0, int style=0)

Parameter &	addSelection (const string &name, const string &selection="", int flags=0, int style=0)

Parameter &	insertSelection (const string &name, const string &atname, const string &request, const string &selection, int flags=0, int style=0)

Parameter &	insertSelection (const string &name, const string &atname="", const string &selection="", int flags=0, int style=0)

Parameter &	selectText (const string &name, const string &strg, int add=0)

Parameter &	selectText (const string &name, int index)

int	index (const string &name) const

int	index (const string &name, const string &strg) const

Parameter &	addNumber (const string &name, const string &request, double dflt, double minimum, double maximum=MAXDOUBLE, double step=1.0, const string &unit="", const string &outputunit="", const string &format="", int flags=0, int style=0)

Parameter &	addNumber (const string &name, const string &request, double dflt, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	addNumber (const string &name, double dflt, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	addNumber (const string &name, double dflt, const string &unit, int flags, int style=0)

Parameter &	addNumber (const string &name, double dflt, double error, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	addNumber (const string &name, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	insertNumber (const string &name, const string &atname, const string &request, double dflt, double minimum, double maximum=MAXDOUBLE, double step=1.0, const string &unit="", const string &outputunit="", const string &format="", int flags=0, int style=0)

Parameter &	insertNumber (const string &name, const string &atname, const string &request, double dflt, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	insertNumber (const string &name, const string &atname, double dflt, const string &unit="", const string &format="", int flags=0, int style=0)

Parameter &	insertNumber (const string &name, const string &atname, const string &unit="", const string &format="", int flags=0, int style=0)

double	number (const string &name, double dflt=0.0, const string &unit="", int index=0) const

double	number (const string &name, const string &unit, double dflt=0.0, int index=0) const

double	number (const string &name, int index, double dflt=0.0, const string &unit="") const

double	number (const string &name, int index, const string &unit, double dflt=0.0) const

void	numbers (const string &name, vector< double > &n, const string &unit="") const

double	error (const string &name, const string &unit="", int index=0) const

double	error (const string &name, int index, const string &unit="") const

void	errors (const string &name, vector< double > &n, const string &unit="") const

Parameter &	setNumber (const string &name, double number, double error, const string &unit="")

Parameter &	setNumber (const string &name, double number, const string &unit="")

Parameter &	pushNumber (const string &name, double number, double error=-1.0, const string &unit="")

Parameter &	pushNumber (const string &name, double number, const string &unit)

Parameter &	setNumber (const string &name, const Parameter &p)

double	defaultNumber (const string &name, const string &unit="") const

Parameter &	setDefaultNumber (const string &name, double dflt, const string &unit="")

double	minimum (const string &name, const string &unit="") const

double	maximum (const string &name, const string &unit="") const

double	step (const string &name, const string &unit="") const

Parameter &	setStep (const string &name, double step, const string &unit="")

Parameter &	setMinMax (const string &name, double minimum=-MAXDOUBLE, double maximum=MAXDOUBLE, double step=1.0, const string &unit="")

Str	unit (const string &name) const

Str	outUnit (const string &name) const

Parameter &	setUnit (const string &name, const string &internunit, const string &outunit="")

Parameter &	setOutUnit (const string &name, const string &outputunit)

Parameter &	changeUnit (const string &name, const string &internunit)

Parameter &	addInteger (const string &name, const string &request, long dflt, long minimum=LONG_MIN, long maximum=LONG_MAX, long step=1, const string &unit="", const string &outputunit="", int width=0, int flags=0, int style=0)

Parameter &	addInteger (const string &name, long dflt, const string &unit="", int width=0, int flags=0, int style=0)

Parameter &	addInteger (const string &name, const string &unit="")

Parameter &	insertInteger (const string &name, const string &atname, const string &request, long dflt, long minimum=LONG_MIN, long maximum=LONG_MAX, long step=1, const string &unit="", const string &outputunit="", int width=0, int flags=0, int style=0)

Parameter &	insertInteger (const string &name, const string &atname, long dflt, const string &unit="", int width=0, int flags=0, int style=0)

Parameter &	insertInteger (const string &name, const string &atname, const string &unit="", int width=0, int flags=0, int style=0)

long	integer (const string &name, const string &unit="", long dflt=0, int index=0) const

long	integer (const string &name, int index, long dflt=0, const string &unit="") const

long	integer (const string &name, int index, const string &unit, long dflt=0) const

void	integers (const string &name, vector< long > &n, const string &unit="") const

void	integers (const string &name, vector< int > &n, const string &unit="") const

Parameter &	setInteger (const string &name, long number, long error, const string &unit="")

Parameter &	setInteger (const string &name, long number, const string &unit="")

Parameter &	pushInteger (const string &name, long number, long error, const string &unit="")

Parameter &	pushInteger (const string &name, long number, const string &unit="")

Parameter &	setInteger (const string &name, const Parameter &p)

long	defaultInteger (const string &name, const string &unit="") const

Parameter &	setDefaultInteger (const string &name, long dflt, const string &unit="")

Parameter &	setMinMax (const string &name, long minimum=LONG_MIN, long maximum=LONG_MAX, long step=1, const string &unit="")

Parameter &	setMinMax (const string &name, int minimum, int maximum, int step=1, const string &unit="")

Parameter &	addBoolean (const string &name, const string &request, bool dflt, int flags=0, int style=0)

Parameter &	addBoolean (const char name, const char request, bool dflt, int flags=0, int style=0)

Parameter &	addBoolean (const string &name, bool dflt, int flags=0, int style=0)

Parameter &	addBoolean (const char *name, bool dflt, int flags=0, int style=0)

Parameter &	insertBoolean (const string &name, const string &atname="", const string &request="", bool dflt=false, int flags=0, int style=0)

Parameter &	insertBoolean (const string &name, const string &atname, int flags=0, int style=0)

bool	boolean (const string &name, bool dflt=false, int index=0) const

bool	boolean (const string &name, int index, bool dflt=false) const

void	booleans (const string &name, vector< bool > &n) const

Parameter &	setBoolean (const string &name, bool b)

Parameter &	setBoolean (const string &name, const Parameter &p)

bool	defaultBoolean (const string &name) const

Parameter &	setDefaultBoolean (const string &name, bool dflt)

Parameter &	addDate (const string &name, const string &request, int year=0, int month=0, int day=0, int flags=0, int style=0)

Parameter &	addDate (const string &name, int year, int month, int day, int flags=0, int style=0)

Parameter &	addDate (const string &name, int flags=0, int style=0)

Parameter &	insertDate (const string &name, const string &atname="", const string &request="", int year=0, int month=0, int day=0, int flags=0, int style=0)

Parameter &	insertDate (const string &name, const string &atname, int year=0, int month=0, int day=0, int flags=0, int style=0)

Parameter &	insertDate (const string &name, const string &atname, int flags=0, int style=0)

const Parameter &	date (const string &name, int index, int &year, int &month, int &day) const

Parameter &	setDate (const string &name, int year, int month, int day)

Parameter &	setDate (const string &name, const string &date)

Parameter &	setDate (const string &name, const struct tm &date)

Parameter &	setDate (const string &name, const time_t &time)

Parameter &	setCurrentDate (const string &name)

Parameter &	setDate (const string &name, const Parameter &p)

const Parameter &	defaultDate (const string &name, int index, int &year, int &month, int &day) const

Parameter &	setDefaultDate (const string &name, int year, int month, int day)

Parameter &	addTime (const string &name, const string &request, int hour=0, int minutes=0, int seconds=0, int milliseconds=0, int flags=0, int style=0)

Parameter &	addTime (const string &name, int hour, int minutes, int seconds, int milliseconds=0, int flags=0, int style=0)

Parameter &	addTime (const string &name, int flags=0, int style=0)

Parameter &	insertTime (const string &name, const string &atname="", const string &request="", int hour=0, int minutes=0, int seconds=0, int milliseconds=0, int flags=0, int style=0)

Parameter &	insertTime (const string &name, const string &atname, int hour=0, int minutes=0, int seconds=0, int milliseconds=0, int flags=0, int style=0)

Parameter &	insertTime (const string &name, const string &atname, int flags=0, int style=0)

const Parameter &	time (const string &name, int index, int &hour, int &minutes, int &seconds, int &milliseconds) const

Parameter &	setTime (const string &name, int hour, int minutes, int seconds, int milliseconds=0)

Parameter &	setTime (const string &name, const string &time)

Parameter &	setTime (const string &name, const struct tm &time)

Parameter &	setTime (const string &name, const time_t &time)

Parameter &	setCurrentTime (const string &name)

Parameter &	setTime (const string &name, const Parameter &p)

const Parameter &	defaultTime (const string &name, int index, int &hour, int &minutes, int &seconds, int &milliseconds) const

Parameter &	setDefaultTime (const string &name, int hour, int minutes, int seconds, int milliseconds=0)

Options &	newSection (int level, const string &name, const string &type="", int flag=0, int style=0)

Options &	newSection (int level, const string &name, int flag, int style=0)

Options &	newSection (const string &name, const string &type="", int flag=0, int style=0)

Options &	newSection (const string &name, int flag, int style=0)

Options &	newSubSection (const string &name, const string &type="", int flag=0, int style=0)

Options &	newSubSection (const string &name, int flag, int style=0)

Options &	newSubSubSection (const string &name, const string &type="", int flag=0, int style=0)

Options &	newSubSubSection (const string &name, int flag, int style=0)

Options &	addSection (const string &name, const string &type="", int flag=0, int style=0)

Options &	addSection (const string &name, int flag, int style=0)

Options &	insertSection (const string &name, const string &atpattern, const string &type="", int flag=0, int style=0)

Options &	insertSection (const string &name, const string &atpattern, int flag, int style=0)

Options &	newSection (int level, const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSection (int level, const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSection (int level, const Options &opt, const string &name, int flag, int style=0)

Options &	newSection (const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSection (const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSection (const Options &opt, const string &name, int flag, int style=0)

Options &	newSubSection (const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSubSection (const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSubSection (const Options &opt, const string &name, int flag, int style=0)

Options &	newSubSubSection (const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSubSubSection (const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	newSubSubSection (const Options &opt, const string &name, int flag, int style=0)

Options &	addSection (const Options &opt, int selectmask, const string &name="", const string &type="", int flag=0, int style=0)

Options &	addSection (const Options &opt, const string &name="", const string &type="", int flag=0, int style=0)

Options &	addSection (const Options &opt, const string &name, int flag, int style=0)

Options &	insertSection (const Options &opt, int selectmask, const string &name, const string &atpattern, const string &type="", int flag=0, int style=0)

Options &	insertSection (const Options &opt, const string &name, const string &atpattern, const string &type="", int flag=0, int style=0)

Options &	insertSection (const Options &opt, const string &name, const string &atpattern, int flag, int style=0)

Options &	newSection (Options *opt, bool newparent=false)

Options &	addSection (Options *opt, bool newparent=false)

Options &	insertSection (Options *opt, const string &atpattern, bool newparent=false)

Options &	newSections (Options *opt, bool newparent=false)

void	endSection (void)

void	clearSections (void)

void	setSection (Options &opt)

void	lastSection (void)

int	up (void)

int	down (void)

Parameter &	setDefault (const string &name)

Options &	setDefaults (int flags=0)

Parameter &	setToDefault (const string &name)

Options &	setToDefaults (int flags=0)

Options &	erase (iterator p)

Options &	erase (section_iterator p)

Options &	erase (Options *s)

Options &	erase (const string &pattern)

Options &	erase (int selectflag)

Options &	pop (void)

Options &	popSection (void)

Options &	flatten (Options *root=0)

Options &	clear (bool revert=true)

int	size (void) const

int	size (int selectflag) const

bool	empty (void) const

int	parameterSize (void) const

int	parameterSize (int flags) const

int	sectionsSize (void) const

int	sectionsSize (int flags) const

bool	exist (const string &pattern) const

bool	existSection (const string &pattern) const

Options &	setFlags (int flags, int selectflag=0)

Options &	addFlags (int flags, int selectflag=0)

Options &	delFlags (int flags, int selectflag=0)

Options &	setValueTypeFlags (int flags, int typemask)

Options &	addValueTypeFlags (int flags, int typemask)

Options &	delValueTypeFlags (int flags, int typemask)

Options &	setStyles (int style, int selectflag=0)

Options &	addStyles (int style, int selectflag=0)

Options &	delStyles (int style, int selectflag=0)

int	styleSize (int style) const

Options &	setValueTypeStyles (int style, int typemask)

Options &	addValueTypeStyles (int style, int typemask)

Options &	delValueTypeStyles (int style, int typemask)

int	nameWidth (int selectmask=0, bool detailed=false, bool escape=false) const

string	save (int selectmask=0, int flags=0) const

ostream &	save (ostream &str, const string &start="", int selectmask=0, int flags=0, int width=-1) const

ostream &	save (ostream &str, const string &textformat, const string &numberformat, const string &boolformat="%i=%b", const string &dateformat="%i=%04Y-%02m-%02d", const string &timeformat="%i=%02H:%02M:%02S", const string &sectionformat="%i", int selectmask=0, const string &start="") const

ostream &	saveXML (ostream &str, int selectmask=0, int flags=0, int level=0, int indent=4) const

Options &	read (const string &opttxt, int flag, const string &assignment=":=", const string &separator=",;", int *indent=0)

Options &	read (const string &opttxt, const string &assignment=":=", const string &separator=",;")

istream &	read (istream &str, int flag, const string &assignment=":=", const string &comment="#", const string &stop="", Str *line=0)

istream &	read (istream &str, const string &assignment=":=", const string &comment="#", const string &stop="", Str *line=0)

Options &	read (const StrQueue &sq, int flag=0, const string &assignment=":=")

bool	read (const Parameter &p, int flag=0)

Options &	read (const Options &o, int flags=0, int flag=0)

bool	readAppend (const Parameter &p)

Options &	readAppend (const Options &o, int flags=0)

Options &	load (const Str &opttxt, const string &assignment=":=", const string &separator=",;", int indent=0, int indentspacing=0, int *level=0)

istream &	load (istream &str, const string &assignment=":=", const string &comment="#", const string &stop="", string *line=0)

Options &	load (const StrQueue &sq, const string &assignment=":=")

virtual void	notify (void)

void	callNotifies (void)

bool	setNotify (bool notify=true)

bool	unsetNotify (void)

bool	notifying (void) const

Protected Member Functions
virtual int	testReadData (InList &traces)

virtual int	testReadDevice (InList &traces)=0

void	setAnalogInputType (int aitype)

void	setReadSleep (unsigned long ms)

void	setInfo (void)

void	setSettings (const InList &traces, int readbuffer=0, int updatebuffer=0)

virtual void	startThread (QSemaphore sp=0, QReadWriteLock datamutex=0, QWaitCondition *datawait=0, bool error=false)

virtual void	run (void)

virtual void	stopRead (void)

Protected Member Functions inherited from Device
void	setDeviceType (int type)

void	setDeviceClass (const string &deviceclass)

void	setDeviceFile (const string &devicefile)

void	setDeviceName (const string &devicename)

void	setDeviceVendor (const string &devicevendor)

void	addInfo (void)

void	lock (void) const

void	unlock (void) const

QMutex *	mutex (void) const

virtual void	initOptions (void)

Additional Inherited Members
Public Types inherited from Device
enum	DeviceTypes { MiscellaneousType = 0, AnalogInputType = 1, AnalogOutputType = 2, DigitalIOType = 3, TriggerType = 4, AttenuatorType = 5, AttenuateType = 6, ManipulatorType = 7, TemperatureType = 8, CameraType = 9 }

Public Types inherited from Options
enum	SaveFlags { NoName = 1, NoType = 2, NoInclude = 4, SwitchNameType = 8, Embrace = 16, PrintRequest = 32, FirstOnly = 64, PrintType = 128, PrintStyle = 256, DontCloseSection = 512, AlwaysQuote = 1024, EscapeQuotes = 2048 }

typedef deque< Parameter > ::iterator	iterator

typedef deque< Parameter > ::const_iterator	const_iterator

typedef deque< Options * > ::iterator	section_iterator

typedef deque< Options * > ::const_iterator	const_section_iterator

Static Public Member Functions inherited from Device
static int	deviceTypes (void)

static string	deviceTypeStr (int type)

static string	getErrorStr (int ern)

Static Public Member Functions inherited from Options
static double	floorLog10 (double v)

static double	floor10 (double v, double scale=1.0)

static double	ceil10 (double v, double scale=1.0)

Static Public Attributes inherited from Device
static const int	NotOpen = -1

static const int	InvalidDevice = -2

static const int	ReadError = -3

static const int	WriteError = -4

static const int	InvalidParam = -5

Static Public Attributes inherited from Options
static const int	NonDefault = Parameter::NonDefault

static const long	TabSection = 0x04000000

Protected Attributes inherited from Device
Options	Info

Options	Settings

Detailed Description

Interface for accessing analog input of a data-aquisition board.

Author: Marco Hackenberg; Jan Benda

Todo:

add probe function that returns a string of possible supported devices.

add directread function for single point acquisition

add a flag for indicating whether device is capable of streaming input

In case you want to use a analog input device within RELACS, your AnalogInput implementation needs to provide a void default constructor (i.e. with no parameters) that does not open the device. Also, include the header file <relacs/relacsplugin.h> and make the AnalogInput device known to RELACS with the addAnalogInput( ClassNameOfYourAnalogInputImplementation, PluginSetName ) macro.

Constructor & Destructor Documentation

AnalogInput ( void )

Create a new AnalogInput without opening a device. Reimplement this constructor.

AnalogInput ( int aitype )

Constructs an AnalogInput with type id aitype.

See Also: setAnalogInputType()

AnalogInput	(	const string &	deviceclass,
		int	aitype = `0`
	)

Constructs an AnalogInput with device class deviceclass and type id aitype.

See Also: setDeviceClass(), setAnalogInputType()

~AnalogInput ( void )

virtual

Stop analog input and close the daq driver.

Member Function Documentation

int open ( const string & device )

overridevirtual

Open the analog input device specified by device. Returns zero on success, or InvalidDevice (or any other negative number indicating the error).

See Also: isOpen(), close(), reset()

Reimplemented from Device.

Reimplemented in AISim.

References Options::clear(), Device::Info, Device::InvalidDevice, and Device::setDeviceFile().

int open ( Device & device )

overridevirtual

Open the analog input device specified by device. Returns zero on success, or InvalidDevice (or any other negative number indicating the error).

See Also: isOpen(), close(), reset()

Reimplemented from Device.

Reimplemented in AISim.

References Options::clear(), Device::deviceIdent(), Device::Info, Device::InvalidDevice, and Device::setDeviceFile().

virtual bool isOpen ( void ) const

pure virtual

Returns true if the device is open.

See Also: open(), close(), reset()

Implements Device.

Implemented in AISim.

Referenced by Acquire::addInput(), AnalogInput::gainIndex(), AnalogInput::maxGainIndex(), AnalogInput::minGainIndex(), AnalogInput::setInfo(), and AnalogInput::testReadData().

virtual void close ( void )

pure virtual

Stop all activity and close the device.

See Also: open(), isOpen(), reset()

Implements Device.

Implemented in AISim.

virtual int channels ( void ) const

pure virtual

Number of analog input channels.

Implemented in AISim.

Referenced by AnalogInput::setInfo(), and AnalogInput::testReadData().

virtual int bits ( void ) const

pure virtual

Resolution in bits of analog input.

Implemented in AISim.

Referenced by AnalogInput::setInfo().

virtual double maxRate ( void ) const

pure virtual

Maximum sampling rate in Hz of analog input.

Implemented in AISim.

Referenced by AnalogInput::setInfo(), and AnalogInput::testReadData().

virtual int maxRanges ( void ) const

pure virtual

Maximum number of analog input ranges.

Implemented in AISim.

Referenced by Acquire::adjustGain(), AnalogInput::gainIndex(), AnalogInput::maxGainIndex(), Acquire::maxValues(), Acquire::maxVoltages(), AnalogInput::minGainIndex(), and AnalogInput::testReadData().

virtual double unipolarRange ( int index ) const

pure virtual

Voltage range index in Volt for unipolar mode. If -1 is returned this range is not supported.

Implemented in AISim.

Referenced by Acquire::adjustGain(), AnalogInput::gainIndex(), AnalogInput::maxGainIndex(), Acquire::maxValues(), Acquire::maxVoltages(), AnalogInput::minGainIndex(), Simulator::read(), Simulator::restartRead(), Acquire::setGain(), and AnalogInput::testReadData().

virtual double bipolarRange ( int index ) const

pure virtual

Voltage range index in Volt for bipolar mode. If -1 is returned this range is not supported.

Implemented in AISim.

Referenced by Acquire::adjustGain(), AnalogInput::gainIndex(), AnalogInput::maxGainIndex(), Acquire::maxValues(), Acquire::maxVoltages(), AnalogInput::minGainIndex(), Simulator::read(), Simulator::restartRead(), Acquire::setGain(), and AnalogInput::testReadData().

int minGainIndex ( bool unipolar ) const

Returns: the gain index for the minimum gain (largest range) available for inputs of polarity unipolar.

See Also: maxGainIndex(), gainIndex()

References AnalogInput::bipolarRange(), Options::index(), AnalogInput::isOpen(), AnalogInput::maxRanges(), and AnalogInput::unipolarRange().

Referenced by Acquire::adjustGain().

int maxGainIndex ( bool unipolar ) const

Returns: the gain index for the maximum gain (smallest range) available for inputs of polarity unipolar.

See Also: minGainIndex(), gainIndex()

References AnalogInput::bipolarRange(), Options::index(), AnalogInput::isOpen(), AnalogInput::maxRanges(), and AnalogInput::unipolarRange().

int gainIndex	(	bool	unipolar,
		double	maxvoltage
	)		const

Returns: the gain index for the largest gain (smallest range) available for inputs of polarity unipolar that just fits maxvoltage.

See Also: minGainIndex(), maxGainIndex()

References AnalogInput::bipolarRange(), AnalogInput::isOpen(), AnalogInput::maxRanges(), and AnalogInput::unipolarRange().

Referenced by Acquire::adjustGain(), AnalogInput::setSettings(), and AnalogInput::testReadData().

int testRead ( InList & traces )

virtual

Test settings for analog input on the device for each input channel in traces. First, all error flags in traces are cleared (DaqError::clearError()). If an error ocurred in any trace, the corresponding errorflags in the InData are set and a negative value is returned. The channels in traces are not sorted. Simply calls testReadData() and testReadDevice(). This function can be called any time independently of prepareRead() and startRead() with different traces.

References InList::clearError(), AnalogInput::testReadData(), and AnalogInput::testReadDevice().

virtual int prepareRead ( InList & traces )

pure virtual

Prepare analog input of the input traces traces on the device as much as possible. If an error ocurred in any channel, the corresponding errorflags in the InData structure are filled and a negative value is returned. In addition, according to the InData::gainIndex() of each trace the gain and the minimum and maximum possible output voltages for each of the traces should be set (see InData::setGain(), InData::setMaxVoltage(), InData::setMinVoltage() ). This function assumes that traces successfully passed testRead(). The channels in traces are not sorted.

Implemented in AISim.

virtual int startRead	(	QSemaphore *	sp = `0`,
		QReadWriteLock *	datamutex = `0`,
		QWaitCondition *	datawait = `0`,
		QSemaphore *	aosp = `0`
	)

pure virtual

Start non-blocking analog input for the input traces that were passed to the previous call of prepareRead(). If an error ocurred in any channel, the corresponding errorflags in the InData structure are filled and a negative value is returned. Also start possible pending acquisition on other devices that are known from take().

Parameters

[in]	sp	if not null, a thread is started reading out the running analog input. When the thread and analog input is finished, releases the semaphore by one. On error, the semaphore is released by 1000 so that the process waiting on the semaphore is waking up immediately.
[in]	datamutex	the mutex for locking the input traces that were passed to the previous call of prepareRead().
[in]	datawait	a waitcondition that is waken up whnever the thread put new data into the input traces.
[in]	aosp	is the semaphore that guards analog outputs. if `null`, then do not start analog outputs.

Returns: -1 on failure, 0 on success and 1 on succes and if for an analog output further calls to writeData() are necessary. This function is called after a successfull prepareRead() or after stop(). This function should be as quick as possible.

Implemented in AISim.

virtual int readData ( void )

pure virtual

Read data from a running data acquisition and store them in an internal buffer. Returns the total number of read data values. If an error ocurred in any channel, the corresponding errorflags in the InData structure are filled and a -2 is returned. If no acquisition is running and therefore no more data are to be expected, -1 is returned. This function is called periodically after reading has been successfully started by startRead(). This function does not modify the traces passed to prepareRead()!

Implemented in AISim.

Referenced by AnalogInput::run().

virtual int convertData ( void )

pure virtual

Convert the acquired data from the internal buffer to numbers in the secondary unit and store the data in the traces that were passed to the previous call of prepareRead(). Returns the number of data values that were added to the traces (sum over all traces). If an error ocurred in any channel, the corresponding errorflags in the InData structure are filled and a negative value is returned. This function is called periodically after one or several calls to readData().

Implemented in AISim.

Referenced by AnalogInput::run().

void model	(	InList &	data,
		const vector< int > &	aochannels,
		vector< float > &	aovalues
	)

virtual

Compute a dynamic clamp model. An implementation is only needed for an analog input simulation.

Referenced by Model::next().

virtual int stop ( void )

pure virtual

Stop any running ananlog input activity, but preserve all so far read in data. The next call to readData() will return the data. Should call stopRead() to stop the thread. Returns zero on success, otherwise one of the flags NotOpen, InvalidDevice, ReadError.

See Also: reset(), startRead()

Implemented in AISim.

virtual int reset ( void )

pure virtual

Clear any internal data buffers and reset the device. Assumes that analog input is already stopped. Returns zero on success, otherwise one of the flags NotOpen, InvalidDevice, ReadError.

See Also: stop(), close(), open(), isOpen()

Reimplemented from Device.

Implemented in AISim.

Referenced by AnalogInput::run().

bool running ( void ) const

virtual

Returns: true if analog input is running. The default implementation checks whether the thread is still running. In your implementation you should use this information as well.

Reimplemented in AISim.

void take	(	const vector< AnalogInput * > &	ais,
		const vector< AnalogOutput * > &	aos,
		vector< int > &	aiinx,
		vector< int > &	aoinx,
		vector< bool > &	airate,
		vector< bool > &	aorate
	)

virtual

Check for every analog input and analog output device in ais and aos, respectively, whether it can be simultaneously started by startRead() from this device. Add the indices of those devices to aiinx and aoinx, respectively. The corresponding entries in airate and aorate should be set to true if these devices should use the same sampling rate as this.

void addTraces	(	vector< TraceSpec > &	traces,
		int	deviceid
	)		const

virtual

If the analog input device supports inputs that are not physical input lines but rather readable internal variables, like model outputs of a dynamic clamp modul, then reimplement this function. Add for each such variable a TraceSpec to traces. deviceid is the id of this analog input device that you should pass as the device to TraceSpec.

int matchTraces ( InList & traces ) const

virtual

May match trace names with driver internal trace names, for example trace names of a dynamic clamp model.

Returns: 0: no traces needed to be matched.; n: n traces have been successfully matched.; -1: Failed to match a trace.

int analogInputType ( void ) const

The id of the analog input implementation.

See Also: setAnalogInputType(), deviceType(), deviceName(), ident()

int testReadData ( InList & traces )

protectedvirtual

Test each input channel in traces for valid settings. If an error ocurred in any trace, the corresponding errorflags in the InData are set and a negative value is returned. The following error conditions are checked: DeviceNotOpen, NoData (InData::capacity() <= 0), MultipleDevices, MultipleStartSources, MultipleDelays, MultipleSampleRates, MultipleContinuous, MultipleBuffersizes (InData::capacity()), MultipleBufferTimes, MultipleUpdateTimes, InvalidStartSource (InData::startSource() < 0), InvalidDelay (InData::delay() < 0), InvalidSampleRate (InData::sampleRate() > maxRate() or < 1.0), InvalidChannel (InData::channel() >= channels() or < 0), MultipleChannels, InvalidReference (InData::reference() != InData::Differential, InData::Referenced, InData::NonReferenced), InvalidGain (InData::gainIndex() not valid, i.e. < 0 or >= maxRanges() or the corresponding range in unipolarRange() or bipolarRange does not exist). This function is called by testRead().

Referenced by AnalogInput::testRead().

virtual int testReadDevice ( InList & traces )

protectedpure virtual

Device driver specific tests on the settings in traces for each input channel. Before this function is called, the validity of the settings in traces was already tested by testReadData(). testWriteDevice() is called even if an error was detected by testWriteData(). This function should test whether the settings are really supported by the hardware. If an error ocurred in any trace, the corresponding errorflags in the InData are set and a negative value is returned. In addition, according to the gainIndex() of each trace the gain and the minimum and maximum possible output voltages for each of the traces should be set (see InData::setGain(), InData::setMaxVoltage(), InData::setMinVoltage() ). The channels in traces are not sorted. This function is called by testRead().

Referenced by AnalogInput::testRead().

void setAnalogInputType ( int aitype )

protected

Set id of the analog input implementation to aitype. This function should be called in the constructor of an implementation of AnalogInput.

See Also: analogInputType(), setDeviceType(), setDeviceName(), setDeviceFile(), setIdent()

void setReadSleep ( unsigned long ms )

protected

Set the time for sleeping between calls of readData() to ms milliseconds.

void setInfo ( void )

protected

Set the device info(). Call this function from open().

See Also: info()

References Device::addInfo(), Options::addInteger(), Options::addNumber(), AnalogInput::bits(), AnalogInput::channels(), Options::clear(), Device::Info, AnalogInput::isOpen(), and AnalogInput::maxRate().

Referenced by AISim::open().

void setSettings	(	const InList &	traces,
		int	readbuffer = `0`,
		int	updatebuffer = `0`
	)

protected

Set the settings() for traces. Call this function from within a successful prepareRead().

Parameters

[in]	traces	the input traces for which the settings string should be constructed.
[in]	readbuffer	is the size of the driver's buffer in bytes.
[in]	updatebuffer	is the size of the internal buffer in bytes.