Vaisala WXT weather sensor. More...

#include <WxtSensor.h>

Inheritance diagram for nidas::dynld::WxtSensor:

[legend]

Public Member Functions
	WxtSensor ()

	~WxtSensor ()

int	scanSample (AsciiSscanf sscanf, const char inputstr, float *data_ptr)

void	init ()
	Initialize the CharacterSensor instance for post-processing.

bool	process (const Sample samp, std::list< const Sample > &results) throw ()
	Process a raw sample, which in this case means do a sscanf on the character string contents, creating a processed sample of binary floating point data.

const std::string &	getUName () const

void	setUName (const std::string &val)

const std::string &	getVName () const

void	setVName (const std::string &val)

void	validateSscanfs ()
	Virtual method to check that the Sscanfs for this CharacterSensor are OK.

nidas::util::Termios &	termios ()
	Expose the Termios.

const nidas::util::Termios &	getTermios () const
	Get a read-only copy of the Termios.

SampleScanner *	buildSampleScanner ()
	Calls CharacterSensor::buildSampleScanner(), and then sets the per-byte transmission delay for that scanner: SampleScanner::setUsecsPerByte().

IODevice *	buildIODevice ()
	Creates an IODevice depending on the device name prefix: name prefix type of IODevice inet: TCPSocketIODevice sock: TCPSocketIODevice usock: UDPSocketIODevice btspp: BluetoothRFCommSocketIODevice all others SerialPortIODevice.

void	open (int flags)
	Open the device connected to the sensor.

void	close ()
	close my associated device.

void	applyTermios ()
	If the underlying IODevice is a SerialPortIODevice, update the current Termios to the device.

void	setMessageParameters (unsigned int len, const std::string &sep, bool eom)
	Set message separator and message length parameters, which are used to parse and time-tag samples from the IODevice.

void	printStatus (std::ostream &ostr) throw ()

bool	isPrompting () const
	Is prompting active, i.e.

void	startPrompting ()
	Start the prompters.

void	stopPrompting ()

void	fromDOMElement (const xercesc::DOMElement *node)

int	getUsecsPerByte () const
	If the underlying IODevice is a SerialPortIODevice, return the value of SerialPortIODevice::getUsecsPerByte(), otherwise return 0, which means no timetag correction for transmission delay will be applied.

void	validate ()
	Implementation of DSMSensor::validate for a Character Sensor.

const std::string &	getMessageSeparator () const
	Get message separator with backslash sequences replaced by their intended character.

const std::string	getBackslashedMessageSeparator () const
	Get message separator with backslash sequences added back.

bool	getMessageSeparatorAtEOM () const

int	getMessageLength () const

virtual void	addPrompt (const std::string &promptString, double promptRate, double promptOffset)
	Prompting Sensors can have multiple prompts and rates.

const std::list< Prompt > &	getPrompts () const

virtual bool	isPrompted () const
	Is this a prompted sensor.

virtual void	togglePrompting ()

void	setInitString (const std::string &val)
	Set the initialization string(s) for this sensor.

const std::string &	getInitString () const

virtual void	sendInitString ()

bool	getNullTerminated () const

int	getNumScanfFailures () const
	How many samples have resulted in complete scanf failures - nothing parsed, because the sensor messages do not correspond to the sscanf format.

int	getNumScanfPartials () const
	How many samples have been partially scanned, because a character in the middle of a message conflicts with the sscanf format.

const std::list< AsciiSscanf * > &	getScanfers () const
	Return the list of AsciiSscanfs requested for this CharacterSensor.

int	getMaxScanfFields () const
	The maximum number of fields in any of the AsciiSscanfs for this CharacterSensor.

bool	doesAsciiSscanfs ()

void	setDSMConfig (const DSMConfig *val)
	Set the DSMConfig for this sensor.

const DSMConfig *	getDSMConfig () const
	What DSMConfig am I associated with?

const Site *	getSite () const
	What Site am I associated with?

virtual void	setDeviceName (const std::string &val)
	Set the name of the system device that the sensor is connected to.

virtual const std::string &	getDeviceName () const
	Fetch the name of the system device that the sensor is connected to.

virtual void	setClassName (const std::string &val)
	Set the class name.

virtual const std::string &	getClassName () const
	Fetch the class name.

virtual void	setCatalogName (const std::string &val)
	Set the name of the catalog entry for this sensor.

virtual const std::string &	getCatalogName () const
	Fetch the name of the catalog entry for this sensor.

const std::string &	getDSMName () const
	Fetch the DSM name.

virtual std::string	getName () const
	Return a name that should fully identify this sensor.

const std::string &	getLocation () const
	Location string.

void	setLocation (const std::string &val)

const std::string &	getSuffix () const
	Sensor suffix, which is added to variable names.

void	setSuffix (const std::string &val)

int	getStation () const

void	setStation (int val)

void	setHeight (const std::string &val)
	Set sensor height above ground via a string which is added to variable names.

void	setHeight (float val)
	Set sensor height above ground.

const std::string &	getHeightString () const
	Get sensor height above ground in a string.

float	getHeight () const
	Get sensor height above ground.

void	setDepth (const std::string &val)
	Set sensor depth below ground via a string which is added to variable names.

void	setDepth (float val)
	Set sensor depth below ground.

const std::string &	getDepthString () const
	Get sensor depth below ground in a string.

float	getDepth () const
	Get sensor depth below ground.

const std::string &	getFullSuffix () const
	Full sensor suffix, the concatenation of the sensor suffix, if any, and the height or depth string, if any.

std::string	expandString (const std::string &input) const
	Utility function to expand ${TOKEN} or $TOKEN fields in a string with their value from getTokenValue().

bool	getTokenValue (const std::string &token, std::string &value) const
	Implement a lookup for tokens that I know about, like $HEIGHT.

const Dictionary &	getDictionary () const

SampleSource *	getRawSampleSource ()
	Implementation of SampleSource::getRawSampleSource().

SampleSource *	getProcessedSampleSource ()
	Implementation of SampleSource::getProcessedSampleSource().

const SampleTag *	getRawSampleTag () const
	Convenience function to get my one-and-only raw SampleTag().

virtual void	addSampleTag (SampleTag *val)
	Add a SampleTag to this sensor.

virtual void	removeSampleTag (SampleTag *val)
	Remove val from the list of SampleTags, and delete it.

std::list< const SampleTag * >	getSampleTags () const
	Implementation of SampleSource::getSampleTags().

std::list< SampleTag * > &	getSampleTags ()
	Non-const method to get a list of non-const pointers to SampleTags.

SampleTagIterator	getSampleTagIterator () const

void	addSampleClient (SampleClient *c) throw ()
	Add a SampleClient to this SampleSource.

void	removeSampleClient (SampleClient *c) throw ()
	Remove a SampleClient from this SampleSource This will also remove a SampleClient if it has been added with addSampleClientForTag().

void	addSampleClientForTag (SampleClient client, const SampleTag tag) throw ()
	Add a SampleClient to this SampleSource.

void	removeSampleClientForTag (SampleClient client, const SampleTag tag) throw ()
	Remove a SampleClient for a given SampleTag from this SampleSource.

int	getClientCount () const throw ()
	How many SampleClients are currently in my list.

void	flush ()
	Implementation of SampleClient::flush().

void	distributeRaw (const Sample *s)
	Distribute a raw sample which has been read from my file descriptor in real time.

const SampleStats &	getSampleStats () const

virtual int	getReadFd () const

virtual int	getWriteFd () const

virtual bool	reopenOnIOException () const
	Whether to reopen this sensor on an IOException.

void	setId (dsm_sample_id_t val)
	Set the various levels of the sensor identification.

void	setSensorId (unsigned int val)

void	setDSMId (unsigned int val)

dsm_sample_id_t	getId () const
	Get the various levels of the samples identification.

unsigned int	getDSMId () const

unsigned int	getSensorId () const

virtual void	setLatency (float val)
	Set desired latency, providing some control over the response time vs buffer efficiency tradeoff.

virtual float	getLatency () const

virtual void	setTimeoutMsecs (int val)
	Set the sensor timeout value in milliseconds.

virtual int	getTimeoutMsecs () const

int	getTimeoutCount () const

void	incrementTimeoutCount ()

void	addParameter (Parameter *val)
	Add a parameter to this DSMSensor.

const std::list< const Parameter * > &	getParameters () const
	Get list of parameters.

const Parameter *	getParameter (const std::string &name) const
	Fetch a parameter by name.

void	setIODevice (IODevice *val)
	Set the IODevice for this sensor.

void	setSampleScanner (SampleScanner *val)
	Set the SampleScanner for this sensor.

virtual int	getDefaultMode () const
	How do I want to be opened.

virtual void	setDefaultMode (int val)

virtual size_t	getBytesAvailable () const
	How many bytes are available to read on this sensor.

virtual size_t	read (void *buf, size_t len)
	Read from the device (duh).

virtual size_t	read (void *buf, size_t len, int msecTimeout)
	Read from the device with a timeout.

virtual size_t	write (const void *buf, size_t len)
	Write to the device (duh).

virtual void	ioctl (int request, void *buf, size_t len)
	Perform an ioctl on the device.

virtual bool	readSamples ()
	Read samples from my associated file descriptor, and distribute() them to my RawSampleClient's.

virtual Sample *	nextSample ()
	Extract the next sample from the buffer.

virtual Sample *	readSample ()
	Return the next sample.

bool	receive (const Sample *s)
	A DSMSensor can be used as a SampleClient, meaning it receives its own raw samples.

void	printStatusHeader (std::ostream &ostr)

void	printStatusTrailer (std::ostream &ostr)

void	calcStatistics (unsigned int periodUsec)
	Update the sensor sampling statistics.

unsigned int	getMaxSampleLength () const

unsigned int	getMinSampleLength () const

float	getObservedSamplingRate () const

float	getObservedDataRate () const

size_t	getBadTimeTagCount () const

VariableIterator	getVariableIterator () const

xercesc::DOMElement *	toDOMParent (xercesc::DOMElement *parent, bool complete) const

xercesc::DOMElement *	toDOMElement (xercesc::DOMElement *node, bool complete) const

virtual void	setTypeName (const std::string &val)
	Set the type name of this sensor, e.g.: "ACME Model 99 Mach7 Particle Disambiguator".

virtual const std::string &	getTypeName (void) const
	Get the type name of this sensor.

bool	getDuplicateIdOK () const
	getDuplicateIdOK will be true if it is OK for samples from this sensor to have identical IDs to samples from another sensor.

void	setDuplicateIdOK (bool val)
	Set the duplicate ID attribute of this DSMSensor.

virtual bool	getApplyVariableConversions () const

virtual void	setApplyVariableConversions (bool val)

virtual int	getDriverTimeTagUsecs () const

virtual void	setDriverTimeTagUsecs (int val)

void	addCalFile (CalFile *val)
	Add a calibration file for this DSMSensor.

const std::map< std::string, CalFile * > &	getCalFiles ()
	Return the collection of CalFiles, mapped by name.

CalFile *	getCalFile (const std::string &name)
	Return a CalFile by its getName().

void	removeCalFiles ()
	Remove all CalFiles.

virtual void	executeXmlRpc (XmlRpc::XmlRpcValue &, XmlRpc::XmlRpcValue &)
	Method invoked when the DSMEngineIntf XmlRpcServer receives a "SensorAction" request, with a "device" string matching the string that this DSMSensor registers via DSMEngine::registerSensorWithXmlRpc(string,DSMServer*).

virtual const std::list< SampleTag * > &	getNonConstSampleTags ()
	We'll allow derived classes and calibration applications to change the SampleTags, so this method returns a list of non-constant SampleTags.

bool	allowOpen ()

bool	readBuffer ()
	Read into my SampleScanner's buffer.

bool	readBuffer (int msecTimeout)
	Read into my SampleScanner's buffer.

Static Public Member Functions
static const std::string	getClassName (const xercesc::DOMElement node, const Project project)
	Crawl through the DOM tree for a DSMSensor to find the class name - scanning the catalog entry if necessary.

static void	deleteLooper ()

static const XMLCh *	getNamespaceURI ()

Protected Member Functions
void	initPrompting ()
	Perform whatever is necessary to initialize prompting right after the device is opened.

void	shutdownPrompting ()
	Shutdown prompting, typically done when a device is closed.

void	unixDevInit (int flags)

void	setPromptRate (const double val)
	Set the rate at which `<sensor>` prompts are sent to this sensor.

double	getPromptRate () const

void	setPromptOffset (const double val)

double	getPromptOffset () const

void	setPromptString (const std::string &val)
	Set the `<sensor>` prompt string for this sensor.

const std::string &	getPromptString () const

SampleT< float > *	searchSampleScanners (const Sample samp, SampleTag *stag_out=0) throw ()
	Search through the AsciiSscanf instances attached to this sensor, looking for the next scanner which parses at least one variable from the given raw sample.

void	adjustTimeTag (SampleTag stag, SampleT< float > outs)
	Apply TimetagAdjuster and lag adjustments to the timetag of the given sample.

void	clearBuffer ()
	Clear the internal buffer.

IODevice *	getIODevice () const

SampleScanner *	getSampleScanner () const

void	setFullSuffix (const std::string &val)

virtual int	getLagUsecs () const
	Return the sampling lag for this sensor in microseconds.

virtual double	getLagSecs () const
	Return the sampling lag for this sensor in seconds.

virtual void	setLagSecs (double val)
	Set the sampling lag for this sensor in seconds.

void	applyConversions (SampleTag stag, SampleT< float > outs, float *results=0)
	Perform variable conversions for the variables in `stag` whose values and sample time have been set in `outs`.

void	trimUnparsed (SampleTag stag, SampleT< float > outs, int nparsed)
	Fill with floatNAN all the values past `nparsed` values in output sample `outs`, and trim the length of the sample to match the length of the variables in SampleTag `stag`.

VariableIndex	findVariableIndex (const std::string &vprefix)
	Search all the sample tags for a variable whose name starts with the given prefix, and return it's index in the list of variables in the sample tag.

Static Protected Member Functions
static Looper *	getLooper ()
	Fetch a pointer to a static instance of a Looper thread.

Protected Attributes
std::map< const SampleTag , TimetagAdjuster >	_ttadjusters

bool	_openable
	Whether this sensor is allowed to be opened.

Private Member Functions
void	wxtValidateSscanfs ()

void	addSampleTag (const SampleTag *val)
	DSMSensor does provide public support for SampleSource::addSampleTag(const SampleTag* val).

void	removeSampleTag (const SampleTag *val)
	DSMSensor does not provide public support for SampleSource::removeSampleTag(const SampleTag* val)

Private Attributes
std::map< dsm_sample_id_t, std::vector< std::string > >	_field_formats
	For each `<sample>` with an scanfFormat, the parse format tokenized by commas.

std::string	_uName
	Initial characters in wind U component variable name.

std::string	_vName
	Initial characters in wind V component variable name.

int	_speedIndex
	Index of wind speed in output sample.

int	_dirIndex
	Index of wind direction in output sample.

int	_uIndex
	Index of wind u component in output sample.

int	_vIndex
	Index of wind v component in output sample.

dsm_sample_id_t	_speedDirId
	ID of sample containing wind speed, direction.

dsm_sample_id_t	_uvId
	ID of sample containing wind U,V components.

int	_uvlen
	Length of output U,V sample.

nidas::util::Termios	_termios
	Serial I/O parameters.

SerialPortIODevice *	_serialDevice
	Non-null if the underlying IODevice is a SerialPortIODevice.

std::list< Prompter * >	_prompters

bool	_prompting

int	_rts485
	Should the RTS line on this port be controled for half-duplex 485? See SerialPortIODevice.h.

std::string	_messageSeparator

bool	_separatorAtEOM

int	_messageLength

std::list< Prompt >	_prompts

std::string	_promptString

double	_promptRate

double	_promptOffset

std::list< AsciiSscanf * >	_sscanfers

std::list< AsciiSscanf * >::const_iterator	_nextSscanfer

int	_maxScanfFields

int	_scanfFailures

int	_scanfPartials

bool	_prompted

std::string	_initString
	String that is sent once after sensor is opened.

std::string	_emptyString

std::string	_devname

nidas::core::DSMSensor::MyDictionary	_dictionary

IODevice *	_iodev

int	_defaultMode

std::string	_className
	Class name attribute of this sensor.

std::string	_catalogName

std::string	_suffix
	Sensor suffix, which is added to variable names.

std::string	_heightString

std::string	_depthString

float	_height

std::string	_fullSuffix
	Concatenation of sensor suffix, and the height or depth string.

std::string	_location

SampleScanner *	_scanner

const DSMConfig *	_dsm

dsm_sample_id_t	_id
	Id of this sensor.

SampleTag	_rawSampleTag

std::list< SampleTag * >	_sampleTags

SampleSourceSupport	_rawSource

SampleSourceSupport	_source

float	_latency

std::map< std::string, Parameter * >	_parameters
	Map of parameters by name.

std::list< const Parameter * >	_constParameters
	List of const pointers to Parameters for providing via getParameters().

std::map< std::string, CalFile * >	_calFiles

std::string	_typeName

int	_timeoutMsecs

bool	_duplicateIdOK

bool	_applyVariableConversions

int	_driverTimeTagUsecs

int	_nTimeouts

int	_lag

int	_station

Static Private Attributes
static bool	zebra = false

static Looper *	_looper = 0

static nidas::util::Mutex	_looperMutex

static XMLCh *	namespaceURI = 0

Detailed Description

Vaisala WXT weather sensor.

This is a serial sensor, but the messages contain multiple fields, and one or more of the fields may be missing values. The missing value is indicated by a '#' in place of the Units character specifier. This makes it infeasible to parse the message with the normal serial sensor scanf string. Instead, the scanf format string is comma-separated along with the raw data message, and variables are scanned individually.

Support is also provided for derivation of wind U,V components from wind speed and direction. To produce a derived U and V, add a <sample> element to the WxtSensor without a scanFormat attribute, containing the U and V variables:

   <serialSensor ID="WXT510" class="WxtSensor" ... >
       <parameter name="u" type="string" value="wu"/>
       <parameter name="v" type="string" value="wv"/>
       <!-- sample for values parsed from WxT -->
       <sample id="1" scanfFormat="0R0,Dn=%fD,Dm=%fD,Dx=%fD,Sn=%fM,Sm=%fM,...">
          <variable name="wdir_min" longname="Wind direction minimum" units="m/s"/>
          ...
       </sample>
       <!-- sample with derived U,V -->
       <sample id="2">
          <variable name="wu" longname="Wind U component" units="m/s"/>
          <variable name="wv" longname="Wind V component" units="m/s"/>
       </sample>
   </serialSensor>

The WxtSensor code makes no assumption about which sample contains the U and V variables, and their names. As above, you must tell NIDAS the names of the U and V variables via the "u" and "v" parameters. The u and v are calculated from the wind speed and direction as:

float u = -spd * ::sin(dir * M_PI / 180.0);

float v = -spd * ::cos(dir * M_PI / 180.0);

nidas::core::getSample

Sample * getSample(sampleType type, unsigned int len)

A convienence method for getting a sample of an enumerated type from a pool.

Definition Sample.cc:70

These calculations are done after the speed and direction have been corrected by any optional linear or polynomical conversion with a possible cal file.

Constructor & Destructor Documentation

◆ WxtSensor()

WxtSensor::WxtSensor ( )

◆ ~WxtSensor()

WxtSensor::~WxtSensor ( )

Member Function Documentation

◆ addCalFile()

void DSMSensor::addCalFile ( CalFile * val )

inherited

Add a calibration file for this DSMSensor.

After this method is finished, DSMSensor will own the pointer, and will delete it in the DSMSensor destructor.

References nidas::core::DSMSensor::_calFiles, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ addParameter()

void DSMSensor::addParameter ( Parameter * val )

inherited

Add a parameter to this DSMSensor.

DSMSensor will then own the pointer and will delete it in its destructor. If a Parameter exists with the same name, it will be replaced with the new Parameter.

References nidas::core::DSMSensor::_constParameters, nidas::core::DSMSensor::_parameters, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ addPrompt()

virtual void nidas::core::CharacterSensor::addPrompt	(	const std::string &	promptString,
		double	promptRate,
		double	promptOffset )

inlinevirtualinherited

Prompting Sensors can have multiple prompts and rates.

Add another prompt and rate to this sensor.

Parameters

promptString	May contain backslash escape sequences.
promptRate	prompts/sec.

References nidas::core::CharacterSensor::_prompted, nidas::core::CharacterSensor::_prompts, and nidas::core::getSample().

Referenced by nidas::core::CharacterSensor::validate().

◆ addSampleClient()

void nidas::core::DSMSensor::addSampleClient	(	SampleClient *	c	)
throw	(	)

inlinevirtualinherited

Add a SampleClient to this SampleSource.

The pointer to the SampleClient must remain valid, until after it is removed.

Implements nidas::core::SampleSource.

References nidas::core::DSMSensor::_source, and nidas::core::SampleSourceSupport::addSampleClient().

Referenced by nidas::core::SamplePipeline::addSampleClient(), and nidas::core::SamplePipeline::addSampleClientForTag().

◆ addSampleClientForTag()

void nidas::core::DSMSensor::addSampleClientForTag	(	SampleClient *	client,
		const SampleTag *	tag )
throw	(	)

inlinevirtualinherited

Add a SampleClient to this SampleSource.

The pointer to the SampleClient must remain valid, until after it is removed.

Implements nidas::core::SampleSource.

References nidas::core::DSMSensor::_source, and nidas::core::SampleSourceSupport::addSampleClientForTag().

Referenced by nidas::core::SamplePipeline::addSampleClientForTag().

◆ addSampleTag() [1/2]

void DSMSensor::addSampleTag ( const SampleTag * val )

privatevirtualinherited

DSMSensor does provide public support for SampleSource::addSampleTag(const SampleTag* val).

Exceptions

nidas::util::InvalidParameterException

Implements nidas::core::SampleSource.

References nidas::core::getSample().

◆ addSampleTag() [2/2]

void DSMSensor::addSampleTag ( SampleTag * val )

virtualinherited

Add a SampleTag to this sensor.

DSMSensor will own the SampleTag. Throw an exception the DSMSensor cannot support the sample (bad rate, wrong number of variables, etc). Note that a SampleTag may be changed after it has been added. addSampleTag() is called when a sensor is initialized from the sensor catalog. The SampleTag may be modified later if it is overridden in the actual sensor entry. For this reason, it is wise to wait to scan the SampleTags of a DSMSensor in the validate(), init() or open() methods, which are invoked after fromDOMElement.

Exceptions

nidas::util::InvalidParameterException

Reimplemented in nidas::dynld::iss::TiltSensor, nidas::dynld::iss::WICORSensor, and nidas::dynld::isff::DAUSensor.

References nidas::core::DSMSensor::_sampleTags, nidas::core::DSMSensor::_source, nidas::core::SampleSourceSupport::addSampleTag(), GET_DSM_ID, GET_SHORT_ID, nidas::core::DSMSensor::getName(), nidas::core::getSample(), and LOG_WARNING.

Referenced by nidas::dynld::isff::WisardMote::addMoteSampleTag(), nidas::dynld::iss::WICORSensor::addSampleTag(), nidas::dynld::RawSampleService::connect(), nidas::core::DSMSensor::fromDOMElement(), nidas::dynld::RawSampleService::fromDOMElement(), nidas::dynld::raf::SyncServer::initSensors(), and main().

◆ adjustTimeTag()

void CharacterSensor::adjustTimeTag	(	SampleTag *	stag,
		SampleT< float > *	outs )

protectedinherited

Apply TimetagAdjuster and lag adjustments to the timetag of the given sample.

References nidas::core::CharacterSensor::_ttadjusters, and nidas::core::DSMSensor::getLagUsecs().

Referenced by nidas::dynld::isff::NCAR_TRH::process(), nidas::core::CharacterSensor::process(), and nidas::dynld::ModbusRTU::process().

◆ allowOpen()

bool nidas::core::DSMSensor::allowOpen ( )

inlineinherited

References nidas::core::DSMSensor::_openable.

Referenced by nidas::core::DSMConfig::addSensor().

◆ applyConversions()

void DSMSensor::applyConversions	(	SampleTag *	stag,
		SampleT< float > *	outs,
		float *	results = 0 )

protectedinherited

Perform variable conversions for the variables in stag whose values and sample time have been set in outs.

This method can be used by subclasses to apply any variable conversions associated with the variables in the given SampleTag, using a general algorithm which loops over each value in each variable. The min/max value limits of a variable are applied also, so if a variable value is converted but lies outside the min/max range, the value is set to floatNAN. Typically this can be the last step applied to the output sample of a sensor's process() method, and note that the sample time must already be set in the output sample outs, since that time will be used to look up conversions in calibration files.

If results is non-null, then the converted values are written into results instead of overwriting the values in outs. This is used when one variable's results may be used to filter other variables without replacing the one variable's results. An example is the Ifan variable in the TRH WisardMote. results must point to enough memory to hold all of the values in outs, including for any Variables with multiple values (getLength() > 1).

See Variable::convert().

References fp, nidas::core::getSample(), and nidas::core::SampleTag::getVariables().

Referenced by nidas::dynld::isff::WisardMote::convert(), nidas::dynld::iss::WICORSensor::process(), nidas::dynld::iss::TiltSensor::process(), nidas::core::CharacterSensor::process(), and nidas::dynld::raf::A2D_Serial::process().

◆ applyTermios()

void SerialSensor::applyTermios ( )

inherited

If the underlying IODevice is a SerialPortIODevice, update the current Termios to the device.

Exceptions

nidas::util::IOException

References nidas::core::SerialSensor::_serialDevice, nidas::core::SerialSensor::_termios, nidas::core::SerialPortIODevice::applyTermios(), and nidas::core::SerialPortIODevice::termios().

Referenced by nidas::core::RemoteSerialConnection::doEscCmds().

◆ buildIODevice()

IODevice * SerialSensor::buildIODevice ( )

virtualinherited

Creates an IODevice depending on the device name prefix: name prefix type of IODevice inet: TCPSocketIODevice sock: TCPSocketIODevice usock: UDPSocketIODevice btspp: BluetoothRFCommSocketIODevice all others SerialPortIODevice.

If a SerialPortIODevice is created, the Termios of this SerialSensor is copied to the device, which will then be applied when the device is opened.

Exceptions

nidas::util::IOException

Reimplemented from nidas::core::CharacterSensor.

References nidas::core::SerialSensor::_rts485, nidas::core::SerialSensor::_serialDevice, nidas::core::SerialSensor::_termios, nidas::core::DSMSensor::getDeviceName(), nidas::core::getSample(), nidas::core::SerialPortIODevice::setRTS485(), and nidas::core::SerialPortIODevice::termios().

Referenced by nidas::dynld::ModbusRTU::open().

◆ buildSampleScanner()

SampleScanner * SerialSensor::buildSampleScanner ( )

virtualinherited

Calls CharacterSensor::buildSampleScanner(), and then sets the per-byte transmission delay for that scanner: SampleScanner::setUsecsPerByte().

Exceptions

nidas::util::InvalidParameterException

Reimplemented from nidas::core::CharacterSensor.

References nidas::core::CharacterSensor::buildSampleScanner(), DLOG, nidas::core::DSMSensor::getName(), nidas::core::getSample(), and nidas::core::SerialSensor::getUsecsPerByte().

◆ calcStatistics()

void nidas::core::DSMSensor::calcStatistics ( unsigned int periodUsec )

inlineinherited

Update the sensor sampling statistics.

Should be called every periodUsec by a user of this sensor.

Parameters

periodUsec Statistics period.

References nidas::core::DSMSensor::_scanner, and nidas::core::SampleScanner::calcStatistics().

◆ clearBuffer()

void nidas::core::DSMSensor::clearBuffer ( )

inlineprotectedinherited

Clear the internal buffer.

References nidas::core::DSMSensor::_scanner, and nidas::core::SampleScanner::clearBuffer().

Referenced by nidas::dynld::isff::CSAT3_Sonic::dataMode(), nidas::dynld::isff::CSAT3_Sonic::querySonic(), nidas::dynld::raf::SppSerial::sendInitPacketAndCheckAck(), nidas::dynld::raf::UHSAS_Serial::sendInitString(), and nidas::dynld::isff::CSAT3_Sonic::sendRateCommand().

◆ close()

void SerialSensor::close ( )

virtualinherited

close my associated device.

Exceptions

nidas::util::IOException;

Reimplemented from nidas::core::DSMSensor.

Reimplemented in nidas::dynld::raf::VCSEL2_Serial, and nidas::dynld::raf::VCSEL_Serial.

References nidas::core::DSMSensor::close(), and nidas::core::SerialSensor::shutdownPrompting().

Referenced by nidas::dynld::isff::MOSMote::close(), nidas::dynld::raf::AlicatSDI::close(), nidas::dynld::raf::PPT_Serial::close(), nidas::dynld::raf::VCSEL2_Serial::close(), and nidas::dynld::raf::VCSEL_Serial::close().

◆ deleteLooper()

void DSMSensor::deleteLooper ( )

staticinherited

References nidas::core::DSMSensor::_looper, nidas::core::DSMSensor::_looperMutex, and nidas::core::getSample().

Referenced by nidas::core::DSMEngine::main().

◆ distributeRaw()

void nidas::core::DSMSensor::distributeRaw ( const Sample * s )

inlineinherited

Distribute a raw sample which has been read from my file descriptor in real time.

References nidas::core::DSMSensor::_rawSource, and nidas::core::SampleSourceSupport::distribute().

Referenced by nidas::dynld::isff::CSAT3_Sonic::dataMode(), nidas::dynld::raf::AlicatSDI::open(), nidas::dynld::isff::CSAT3_Sonic::querySonic(), nidas::dynld::raf::A2D_Serial::readConfig(), nidas::dynld::isff::CSAT3_Sonic::sendRateCommand(), and nidas::dynld::isff::CSAT3_Sonic::terminalMode().

◆ doesAsciiSscanfs()

bool CharacterSensor::doesAsciiSscanfs ( )

inherited

Returns: : true if this CharacterSensor as been configured to use one or more AsciiSscanf objects to parse its data.

References nidas::core::DSMSensor::getSampleTagIterator(), nidas::core::SampleTag::getScanfFormat(), and nidas::core::SampleTagIterator::hasNext().

Referenced by nidas::core::CharacterSensor::buildSampleScanner(), nidas::dynld::GPS_NMEA_Serial::buildSampleScanner(), and nidas::dynld::UDPSocketSensor::buildSampleScanner().

◆ executeXmlRpc()

virtual void nidas::core::DSMSensor::executeXmlRpc	(	XmlRpc::XmlRpcValue &	,
		XmlRpc::XmlRpcValue &	)

inlinevirtualinherited

Method invoked when the DSMEngineIntf XmlRpcServer receives a "SensorAction" request, with a "device" string matching the string that this DSMSensor registers via DSMEngine::registerSensorWithXmlRpc(string,DSMServer*).

The default base class method does nothing.

Reimplemented in nidas::dynld::DSC_A2DSensor, nidas::dynld::raf::A2D_Serial, nidas::dynld::raf::DSMAnalogSensor, and nidas::dynld::raf::PSI9116_Sensor.

Referenced by nidas::core::DSMEngineIntf::SensorAction::execute().

◆ expandString()

std::string nidas::core::DSMSensor::expandString ( const std::string & input ) const

inlineinherited

Utility function to expand ${TOKEN} or $TOKEN fields in a string with their value from getTokenValue().

If curly brackets are not used, then the TOKEN should be delimited by a '/', a '.' or the end of string, e.g.: xxx/yyy/$ZZZ.dat

References nidas::core::DSMSensor::_dictionary, and nidas::core::Dictionary::expandString().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ findVariableIndex()

VariableIndex DSMSensor::findVariableIndex ( const std::string & vprefix )

protectedinherited

Search all the sample tags for a variable whose name starts with the given prefix, and return it's index in the list of variables in the sample tag.

If no such variable is found, return -1.

References nidas::core::getSample(), nidas::core::DSMSensor::getSampleTags(), and nidas::core::SampleTag::getVariables().

Referenced by nidas::dynld::isff::CSI_IRGA_Sonic::checkSampleTags(), and nidas::dynld::isff::NCAR_TRH::validate().

◆ flush()

void nidas::core::DSMSensor::flush ( )

inlinevirtualinherited

Implementation of SampleClient::flush().

This is where a DSMSensor's process() method could send out any buffered results that might be ready.

Implements nidas::core::SampleSource.

◆ fromDOMElement()

void SerialSensor::fromDOMElement ( const xercesc::DOMElement * node )

virtualinherited

Exceptions

nidas::util::InvalidParameterException

Reimplemented from nidas::core::CharacterSensor.

Reimplemented in nidas::dynld::isff::Wind2D, and nidas::dynld::iss::TiltSensor.

References nidas::core::SerialSensor::_rts485, nidas::core::SerialSensor::_termios, nidas::core::CharacterSensor::fromDOMElement(), nidas::core::DSMSensor::getName(), nidas::core::getSample(), nidas::util::Termios::setBaudRate(), nidas::util::Termios::setDataBits(), nidas::util::Termios::setParity(), and nidas::util::Termios::setStopBits().

Referenced by nidas::dynld::isff::DAUSensor::fromDOMElement(), nidas::dynld::isff::Wind2D::fromDOMElement(), and nidas::dynld::iss::TiltSensor::fromDOMElement().

◆ getApplyVariableConversions()

virtual bool nidas::core::DSMSensor::getApplyVariableConversions ( ) const

inlinevirtualinherited

References nidas::core::DSMSensor::_applyVariableConversions.

Referenced by nidas::core::DSMSensor::fromDOMElement(), nidas::dynld::raf::DSMArincSensor::init(), nidas::dynld::raf::UHSAS_Serial::init(), nidas::dynld::isff::CSI_IRGA_Sonic::process(), and nidas::dynld::raf::SppSerial::validate().

◆ getBackslashedMessageSeparator()

const std::string nidas::core::CharacterSensor::getBackslashedMessageSeparator ( ) const

inlineinherited

Get message separator with backslash sequences added back.

References nidas::core::CharacterSensor::_messageSeparator, and nidas::util::addBackslashSequences().

Referenced by nidas::core::RemoteSerialConnection::setSensor().

◆ getBadTimeTagCount()

size_t nidas::core::DSMSensor::getBadTimeTagCount ( ) const

inlineinherited

References nidas::core::DSMSensor::_scanner, and nidas::core::SampleScanner::getBadTimeTagCount().

Referenced by nidas::core::DSMSensor::printStatus().

◆ getBytesAvailable()

virtual size_t nidas::core::DSMSensor::getBytesAvailable ( ) const

inlinevirtualinherited

How many bytes are available to read on this sensor.

See also: IODevice::getBytesAvailable().

Exceptions

nidas::util::IOException

References nidas::core::DSMSensor::_iodev, and nidas::core::IODevice::getBytesAvailable().

Referenced by nidas::core::DatagramSampleScanner::readBuffer().

◆ getCalFile()

CalFile * DSMSensor::getCalFile ( const std::string & name )

inherited

Return a CalFile by its getName().

Will return NULL if not found.

References nidas::core::DSMSensor::_calFiles.

Referenced by nidas::dynld::ParoSci_202BG_P::init(), nidas::dynld::ParoSci_202BG_T::init(), and nidas::dynld::isff::Wind3D::parseParameters().

◆ getCalFiles()

const std::map< std::string, CalFile * > & nidas::core::DSMSensor::getCalFiles ( )

inlineinherited

Return the collection of CalFiles, mapped by name.

References nidas::core::DSMSensor::_calFiles.

Referenced by nidas::dynld::A2DSensor::init(), nidas::dynld::raf::A2D_Serial::init(), sensorTitle(), and PConfig::showCalFiles().

◆ getCatalogName()

virtual const std::string & nidas::core::DSMSensor::getCatalogName ( ) const

inlinevirtualinherited

Fetch the name of the catalog entry for this sensor.

References nidas::core::DSMSensor::_catalogName.

Referenced by SampleCounter::collectMetadata(), parseOther(), nidas::core::DSMSensor::printStatus(), ExtractFast2D::run(), ExtractDMT::run(), sensorTitle(), and PConfig::showCalFiles().

◆ getClassName() [1/2]

virtual const std::string & nidas::core::DSMSensor::getClassName ( ) const

inlinevirtualinherited

Fetch the class name.

References nidas::core::DSMSensor::_className.

Referenced by SampleCounter::collectMetadata(), nidas::core::DSMSensor::fromDOMElement(), nidas::core::DSMSensor::getClassName(), parseAnalog(), parseOther(), nidas::core::DSMSensor::printStatus(), nidas::core::DSMConfig::sensorFromDOMElement(), sensorTitle(), PConfig::showAll(), PConfig::showCalFiles(), PConfig::showSensorClasses(), and nidas::dynld::raf::UDPArincSensor::~UDPArincSensor().

◆ getClassName() [2/2]

const string DSMSensor::getClassName	(	const xercesc::DOMElement *	node,
		const Project *	project )

staticinherited

Crawl through the DOM tree for a DSMSensor to find the class name - scanning the catalog entry if necessary.

Exceptions

nidas::util::InvalidParameterException

References nidas::core::DSMSensor::getClassName(), and nidas::core::getSample().

◆ getClientCount()

int nidas::core::DSMSensor::getClientCount	(		)	const
throw	(	)

inlinevirtualinherited

How many SampleClients are currently in my list.

Implements nidas::core::SampleSource.

References nidas::core::DSMSensor::_source, and nidas::core::SampleSourceSupport::getClientCount().

◆ getDefaultMode()

virtual int nidas::core::DSMSensor::getDefaultMode ( ) const

inlinevirtualinherited

How do I want to be opened.

The user can ignore it if they want to.

Returns: one of O_RDONLY, O_WRONLY or O_RDWR.

References nidas::core::DSMSensor::_defaultMode.

Referenced by nidas::core::DSMSensor::fromDOMElement(), and nidas::core::SensorOpener::run().

◆ getDepth()

float nidas::core::DSMSensor::getDepth ( ) const

inlineinherited

Get sensor depth below ground.

Returns: Depth of sensor below ground, in meters.

References nidas::core::DSMSensor::_height.

◆ getDepthString()

const std::string & nidas::core::DSMSensor::getDepthString ( ) const

inlineinherited

Get sensor depth below ground in a string.

Returns: Depth of sensor below ground, e.g. "5cm".

References nidas::core::DSMSensor::_depthString.

Referenced by SampleCounter::collectMetadata().

◆ getDeviceName()

virtual const std::string & nidas::core::DSMSensor::getDeviceName ( ) const

inlinevirtualinherited

Fetch the name of the system device that the sensor is connected to.

References nidas::core::DSMSensor::_devname.

Referenced by nidas::core::SensorHandler::add(), nidas::core::CharacterSensor::buildIODevice(), nidas::core::SerialSensor::buildIODevice(), nidas::core::CharacterSensor::buildSampleScanner(), nidas::dynld::IR104_Relays::clearOutputs(), nidas::core::DSMSensor::close(), SampleCounter::collectMetadata(), DataStats::createCounters(), nidas::dynld::raf::DSMArincSensor::fromDOMElement(), nidas::dynld::IR104_Relays::getInputs(), nidas::core::DSMSensor::getName(), nidas::dynld::IR104_Relays::getOutputs(), nidas::core::DSMSensor::open(), nidas::core::SerialSensor::open(), nidas::dynld::DSC_A2DSensor::open(), nidas::dynld::IR104_Relays::open(), nidas::dynld::ModbusRTU::open(), nidas::dynld::raf::A2D_Serial::open(), nidas::dynld::raf::DSMAnalogSensor::open(), nidas::dynld::raf::PSI9116_Sensor::open(), nidas::dynld::raf::UDPArincSensor::open(), parseOther(), nidas::core::DSMSensor::printStatus(), nidas::dynld::ModbusRTU::process(), nidas::dynld::raf::DSMArincSensor::registerWithUDPArincSensor(), nidas::core::CharacterSensor::sendInitString(), sensorTitle(), nidas::dynld::IR104_Relays::setOutputs(), nidas::dynld::IR104_Relays::setOutputs(), PConfig::showCalFiles(), and nidas::core::DSMSensor::validate().

◆ getDictionary()

const Dictionary & nidas::core::DSMSensor::getDictionary ( ) const

inlineinherited

References nidas::core::DSMSensor::_dictionary.

◆ getDriverTimeTagUsecs()

virtual int nidas::core::DSMSensor::getDriverTimeTagUsecs ( ) const

inlinevirtualinherited

References nidas::core::DSMSensor::_driverTimeTagUsecs.

Referenced by nidas::core::DriverSampleScanner::nextSample().

◆ getDSMConfig()

const DSMConfig * nidas::core::DSMSensor::getDSMConfig ( ) const

inlineinherited

What DSMConfig am I associated with?

References nidas::core::DSMSensor::_dsm.

Referenced by SampleCounter::collectMetadata(), DataStats::createCounters(), nidas::core::DSMSensor::fromDOMElement(), SampleCounter::generateStreamId(), nidas::core::DSMSensor::MyDictionary::getTokenValue(), nidas::dynld::isff::CSAT3_Sonic::open(), nidas::core::DSMSensor::printStatusHeader(), nidas::core::DSMSensor::readSamples(), nidas::dynld::raf::DSMArincSensor::registerWithUDPArincSensor(), and nidas::core::DSMSensor::validate().

◆ getDSMId()

unsigned int nidas::core::DSMSensor::getDSMId ( ) const

inlineinherited

References nidas::core::DSMSensor::_id, and GET_DSM_ID.

Referenced by nidas::core::Site::findSensor(), nidas::core::DSMSensor::fromDOMElement(), nidas::dynld::isff::CSAT3_Sonic::open(), nidas::core::SampleScanner::readBuffer(), nidas::core::DSMSensor::readSamples(), sensorTitle(), PConfig::showAll(), PConfig::showSensorClasses(), nidas::core::Site::validate(), nidas::core::DSMConfig::validateSensorAndSampleIds(), nidas::core::MessageStreamScanner::warnBackwardsStepTimeTag(), and nidas::core::MessageStreamScanner::warnNonIncrTimeTag().

◆ getDSMName()

const std::string & DSMSensor::getDSMName ( ) const

inherited

Fetch the DSM name.

References nidas::core::DSMSensor::_dsm, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::getName().

◆ getDuplicateIdOK()

bool nidas::core::DSMSensor::getDuplicateIdOK ( ) const

inlineinherited

getDuplicateIdOK will be true if it is OK for samples from this sensor to have identical IDs to samples from another sensor.

That other sensor must also agree that dupicateIdOK are OK. This can be useful if one may not be certain of the device name, e.g. /dev/ttyUSB*, that the system will assign to a sensor may use, but there are identifiers in the data returned that allow one to sort things out. In general, getDuplicateID is false.

References nidas::core::DSMSensor::_duplicateIdOK.

Referenced by nidas::core::Site::validate(), and nidas::core::DSMConfig::validateSensorAndSampleIds().

◆ getFullSuffix()

const std::string & nidas::core::DSMSensor::getFullSuffix ( ) const

inlineinherited

Full sensor suffix, the concatenation of the sensor suffix, if any, and the height or depth string, if any.

The full sensor suffix are words 2 and 3 in the dot-separated name: variable[.sensor][.height][.site]

References nidas::core::DSMSensor::_fullSuffix.

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ getHeight()

float nidas::core::DSMSensor::getHeight ( ) const

inlineinherited

Get sensor height above ground.

Returns: Height of sensor above ground, in meters. Nan if unknown.

References nidas::core::DSMSensor::_height.

◆ getHeightString()

const std::string & nidas::core::DSMSensor::getHeightString ( ) const

inlineinherited

Get sensor height above ground in a string.

Returns: Height of sensor above ground, e.g. "15m".

References nidas::core::DSMSensor::_heightString.

Referenced by SampleCounter::collectMetadata(), nidas::core::DSMSensor::MyDictionary::getTokenValue(), ARLIngest::prepareHeaderIds(), SampleToDatabase::SampleToDatabase(), and PConfig::showCalFiles().

◆ getId()

dsm_sample_id_t nidas::core::DSMSensor::getId ( ) const

inlineinherited

Get the various levels of the samples identification.

A sample tag ID is a 32-bit value comprised of four parts: 6-bit sample type id(not used by DSMSensor), a 10-bit DSM id, 16-bit sensor+sample ids.

References nidas::core::DSMSensor::_id, and GET_FULL_ID.

◆ getInitString()

const std::string & nidas::core::CharacterSensor::getInitString ( ) const

inlineinherited

References nidas::core::CharacterSensor::_initString.

Referenced by nidas::core::CharacterSensor::sendInitString().

◆ getIODevice()

IODevice * nidas::core::DSMSensor::getIODevice ( ) const

inlineprotectedinherited

References nidas::core::DSMSensor::_iodev.

◆ getLagSecs()

virtual double nidas::core::DSMSensor::getLagSecs ( ) const

inlineprotectedvirtualinherited

Return the sampling lag for this sensor in seconds.

See getLagUsecs().

References nidas::core::DSMSensor::_lag, and USECS_PER_SEC.

◆ getLagUsecs()

virtual int nidas::core::DSMSensor::getLagUsecs ( ) const

inlineprotectedvirtualinherited

Return the sampling lag for this sensor in microseconds.

A positive lag means one should adjust the sample time tags for this sensor earlier in time to achieve a better estimate of the actual time to be associated for each sample. Derived classes can use this method in their process method to correct for inherent, constant, sampling lags of a sensor. A fixed sample lag, in fractional seconds, can be set for a sensor in the XML:

<sensor>
    <parameter name="lag" type = "float" value="0.186"/>
</sensor>

The DSMSensor::fromDOM() method parses this parameter and sets the value of the lag.

References nidas::core::DSMSensor::_lag.

Referenced by nidas::core::CharacterSensor::adjustTimeTag(), nidas::dynld::raf::A2D_Serial::process(), nidas::dynld::raf::DSMMesaSensor::process(), and nidas::dynld::raf::UHSAS_Serial::process().

◆ getLatency()

virtual float nidas::core::DSMSensor::getLatency ( ) const

inlinevirtualinherited

References nidas::core::DSMSensor::_latency.

Referenced by nidas::dynld::DSC_A2DSensor::open(), nidas::dynld::DSC_Event::open(), and nidas::dynld::raf::DSMAnalogSensor::open().

◆ getLocation()

const std::string & DSMSensor::getLocation ( ) const

inherited

Location string.

A DSMConfig also has a Location. If the location has not been set for this DSMSensor, then the location of the DSMConfig will be returned.

References nidas::core::DSMSensor::_dsm, and nidas::core::DSMSensor::_location.

Referenced by SampleCounter::collectMetadata(), and nidas::core::DSMSensor::printStatusHeader().

◆ getLooper()

Looper * DSMSensor::getLooper ( )

staticprotectedinherited

Fetch a pointer to a static instance of a Looper thread.

Use this Looper for periodic callbacks, as for prompting, in support of a DSMSensor.

References nidas::core::DSMSensor::_looper, nidas::core::DSMSensor::_looperMutex, nidas::core::getSample(), and LOG_WARNING.

Referenced by nidas::dynld::isff::MOSMote::close(), nidas::dynld::isff::MOSMote::open(), nidas::core::SerialSensor::startPrompting(), and nidas::core::SerialSensor::stopPrompting().

◆ getMaxSampleLength()

unsigned int nidas::core::DSMSensor::getMaxSampleLength ( ) const

inlineinherited

References nidas::core::DSMSensor::_scanner, and nidas::core::SampleScanner::getMaxSampleLength().

Referenced by nidas::core::DSMSensor::printStatus().

◆ getMaxScanfFields()

int nidas::core::CharacterSensor::getMaxScanfFields ( ) const

inlineinherited

The maximum number of fields in any of the AsciiSscanfs for this CharacterSensor.

Prior to scanning a message, a sample of this size must be allocated.

References nidas::core::CharacterSensor::_maxScanfFields.

◆ getMessageLength()

int nidas::core::CharacterSensor::getMessageLength ( ) const

inlineinherited

References nidas::core::CharacterSensor::_messageLength.

Referenced by nidas::core::CharacterSensor::buildSampleScanner(), nidas::dynld::GPS_NMEA_Serial::buildSampleScanner(), nidas::dynld::isff::CSAT3_Sonic::dataMode(), nidas::core::SerialSensor::open(), nidas::dynld::isff::CSAT3_Sonic::open(), and nidas::core::RemoteSerialConnection::setSensor().

◆ getMessageSeparator()

const std::string & nidas::core::CharacterSensor::getMessageSeparator ( ) const

inlineinherited

Get message separator with backslash sequences replaced by their intended character.

References nidas::core::CharacterSensor::_messageSeparator.

Referenced by nidas::core::CharacterSensor::buildSampleScanner(), nidas::dynld::GPS_NMEA_Serial::buildSampleScanner(), nidas::dynld::isff::CSAT3_Sonic::dataMode(), nidas::core::SerialSensor::open(), nidas::dynld::isff::CSAT3_Sonic::open(), nidas::dynld::raf::PSI9116_Sensor::open(), nidas::dynld::isff::DAUSensor::process(), and nidas::dynld::raf::CDP_Serial::validate().

◆ getMessageSeparatorAtEOM()

bool nidas::core::CharacterSensor::getMessageSeparatorAtEOM ( ) const

inlineinherited

References nidas::core::CharacterSensor::_separatorAtEOM.

Referenced by nidas::core::CharacterSensor::buildSampleScanner(), nidas::dynld::GPS_NMEA_Serial::buildSampleScanner(), nidas::dynld::isff::CSAT3_Sonic::open(), nidas::dynld::raf::PSI9116_Sensor::open(), and nidas::core::RemoteSerialConnection::setSensor().

◆ getMinSampleLength()

unsigned int nidas::core::DSMSensor::getMinSampleLength ( ) const

inlineinherited

References nidas::core::DSMSensor::_scanner, and nidas::core::SampleScanner::getMinSampleLength().

Referenced by nidas::core::DSMSensor::printStatus().

◆ getName()

virtual std::string nidas::core::DSMSensor::getName ( ) const

inlinevirtualinherited

Return a name that should fully identify this sensor.

This name could be used in informative messages. The returned name has this format: dsmName:deviceName.

References nidas::core::DSMSensor::getDeviceName(), and nidas::core::DSMSensor::getDSMName().

◆ getNamespaceURI()

static const XMLCh * nidas::core::DOMable::getNamespaceURI ( )

inlinestaticinherited

References nidas::core::DOMable::namespaceURI.

◆ getNonConstSampleTags()

virtual const std::list< SampleTag * > & nidas::core::DSMSensor::getNonConstSampleTags ( )

inlinevirtualinherited

We'll allow derived classes and calibration applications to change the SampleTags, so this method returns a list of non-constant SampleTags.

References nidas::core::DSMSensor::_sampleTags.

◆ getNullTerminated()

bool nidas::core::CharacterSensor::getNullTerminated ( ) const

inlineinherited

References nidas::core::SampleScanner::getNullTerminate(), and nidas::core::DSMSensor::getSampleScanner().

Referenced by nidas::core::RemoteSerialConnection::setSensor().

◆ getNumScanfFailures()

int nidas::core::CharacterSensor::getNumScanfFailures ( ) const

inlineinherited

How many samples have resulted in complete scanf failures - nothing parsed, because the sensor messages do not correspond to the sscanf format.

References nidas::core::CharacterSensor::_scanfFailures.

◆ getNumScanfPartials()

int nidas::core::CharacterSensor::getNumScanfPartials ( ) const

inlineinherited

How many samples have been partially scanned, because a character in the middle of a message conflicts with the sscanf format.

References nidas::core::CharacterSensor::_scanfPartials.

◆ getObservedDataRate()

float nidas::core::DSMSensor::getObservedDataRate ( ) const

inlineinherited

References nidas::core::DSMSensor::_scanner, and nidas::core::SampleScanner::getObservedDataRate().

Referenced by nidas::core::DSMSensor::printStatus().

◆ getObservedSamplingRate()

float nidas::core::DSMSensor::getObservedSamplingRate ( ) const

inlineinherited

References nidas::core::DSMSensor::_scanner, and nidas::core::SampleScanner::getObservedSamplingRate().

Referenced by nidas::core::DSMSensor::printStatus().

◆ getParameter()

const Parameter * DSMSensor::getParameter ( const std::string & name ) const

inherited

Fetch a parameter by name.

Returns a NULL pointer if no such parameter exists.

References nidas::core::DSMSensor::_parameters.

◆ getParameters()

const std::list< const Parameter * > & nidas::core::DSMSensor::getParameters ( ) const

inlineinherited

Get list of parameters.

References nidas::core::DSMSensor::_constParameters.

Referenced by nidas::dynld::isff::Wind2D::fromDOMElement(), nidas::dynld::isff::ATIK_Sonic::parseParameters(), nidas::dynld::isff::CSAT3_Sonic::parseParameters(), nidas::dynld::isff::CSI_IRGA_Sonic::parseParameters(), nidas::dynld::isff::Wind3D::parseParameters(), nidas::dynld::A2DSensor::validate(), nidas::dynld::DSC_FreqCounter::validate(), and nidas::dynld::IEEE_Float::validate().

◆ getProcessedSampleSource()

SampleSource * nidas::core::DSMSensor::getProcessedSampleSource ( )

inlinevirtualinherited

Implementation of SampleSource::getProcessedSampleSource().

Return the SampleSource for processed samples from this DSMSensor.

Implements nidas::core::SampleSource.

Referenced by nidas::dynld::RawSampleService::schedule().

◆ getPromptOffset()

double nidas::core::CharacterSensor::getPromptOffset ( ) const

inlineprotectedinherited

References nidas::core::CharacterSensor::_promptOffset.

Referenced by nidas::core::CharacterSensor::validate().

◆ getPromptRate()

double nidas::core::CharacterSensor::getPromptRate ( ) const

inlineprotectedinherited

References nidas::core::CharacterSensor::_promptRate.

Referenced by nidas::core::CharacterSensor::validate().

◆ getPrompts()

const std::list< Prompt > & nidas::core::CharacterSensor::getPrompts ( ) const

inlineinherited

References nidas::core::CharacterSensor::_prompts.

Referenced by nidas::core::SerialSensor::initPrompting(), and nidas::core::CharacterSensor::validate().

◆ getPromptString()

const std::string & nidas::core::CharacterSensor::getPromptString ( ) const

inlineprotectedinherited

References nidas::core::CharacterSensor::_promptString.

Referenced by nidas::core::CharacterSensor::validate().

◆ getRawSampleSource()

SampleSource * nidas::core::DSMSensor::getRawSampleSource ( )

inlinevirtualinherited

Implementation of SampleSource::getRawSampleSource().

Return the SampleSource for raw samples from this DSMSensor. A DSMSensor is only a SampleSource of raw samples when running in real-time, not during post-processing.

Implements nidas::core::SampleSource.

References nidas::core::DSMSensor::_rawSource.

Referenced by nidas::core::RemoteSerialConnection::close(), and nidas::dynld::RawSampleService::schedule().

◆ getRawSampleTag()

const SampleTag * nidas::core::DSMSensor::getRawSampleTag ( ) const

inlineinherited

Convenience function to get my one-and-only raw SampleTag().

Equivalent to: getRawSampleSource()->getSampleTags()->front()

References nidas::core::DSMSensor::_rawSampleTag.

Referenced by nidas::core::SamplePipeline::addSampleClient(), nidas::core::SamplePipeline::addSampleClientForTag(), nidas::dynld::RawSampleService::connect(), nidas::dynld::RawSampleService::fromDOMElement(), nidas::dynld::raf::SyncServer::initSensors(), nidas::core::SamplePipeline::removeSampleClient(), nidas::core::SamplePipeline::removeSampleClientForTag(), DataStats::run(), DataPrep::run(), and StatsProcess::run().

◆ getReadFd()

virtual int nidas::core::DSMSensor::getReadFd ( ) const

inlinevirtualinherited

References nidas::core::DSMSensor::_iodev, and nidas::core::IODevice::getReadFd().

Referenced by nidas::dynld::IR104_Relays::clearOutputs(), nidas::core::SensorHandler::PolledDSMSensor::getFd(), nidas::dynld::IR104_Relays::getInputs(), nidas::dynld::IR104_Relays::getOutputs(), nidas::core::SerialSensor::open(), nidas::dynld::IR104_Relays::open(), nidas::dynld::DSC_Event::printStatus(), nidas::dynld::DSC_FreqCounter::printStatus(), nidas::dynld::DSC_PulseCounter::printStatus(), nidas::dynld::raf::DSMArincSensor::printStatus(), nidas::dynld::raf::TwoD_USB::printStatus(), nidas::dynld::raf::TwoDS::printStatus(), nidas::core::SampleScanner::readBuffer(), nidas::dynld::IR104_Relays::setOutputs(), and nidas::dynld::IR104_Relays::setOutputs().

◆ getSampleScanner()

SampleScanner * nidas::core::DSMSensor::getSampleScanner ( ) const

inlineprotectedinherited

References nidas::core::DSMSensor::_scanner.

Referenced by nidas::core::CharacterSensor::getNullTerminated(), nidas::dynld::ModbusRTU::open(), and nidas::core::CharacterSensor::setMessageParameters().

◆ getSampleStats()

const SampleStats & nidas::core::DSMSensor::getSampleStats ( ) const

inlinevirtualinherited

Implements nidas::core::SampleSource.

References nidas::core::DSMSensor::_source, and nidas::core::SampleSourceSupport::getSampleStats().

◆ getSampleTagIterator()

SampleTagIterator nidas::core::DSMSensor::getSampleTagIterator ( ) const

inlinevirtualinherited

Implements nidas::core::SampleSource.

Referenced by nidas::core::SamplePipeline::connect(), DataStats::createCounters(), nidas::core::SamplePipeline::disconnect(), nidas::core::CharacterSensor::doesAsciiSscanfs(), nidas::core::Site::findSensor(), nidas::dynld::raf::DSMMesaSensor::fromDOMElement(), nidas::dynld::raf::A2DBoardTempSensor::init(), init(), PConfig::loadVariables(), parseAnalog(), parseOther(), DataPrep::run(), StatsProcess::run(), SampleDispatcher::SampleDispatcher(), DumpClient::setSensors(), PConfig::showAll(), and nidas::core::DSMSensor::toDOMParent().

◆ getSampleTags() [1/2]

std::list< SampleTag * > & nidas::core::DSMSensor::getSampleTags ( )

inlineinherited

Non-const method to get a list of non-const pointers to SampleTags.

References nidas::core::DSMSensor::_sampleTags.

◆ getSampleTags() [2/2]

std::list< const SampleTag * > nidas::core::DSMSensor::getSampleTags ( ) const

inlinevirtualinherited

Implementation of SampleSource::getSampleTags().

Implements nidas::core::SampleSource.

References nidas::core::DSMSensor::_source, and nidas::core::SampleSourceSupport::getSampleTags().

◆ getScanfers()

const std::list< AsciiSscanf * > & nidas::core::CharacterSensor::getScanfers ( ) const

inlineinherited

Return the list of AsciiSscanfs requested for this CharacterSensor.

This list is only valid after the init() method has been called.

References nidas::core::CharacterSensor::_sscanfers.

Referenced by nidas::dynld::isff::CSI_IRGA_Sonic::checkSampleTags(), nidas::dynld::raf::UHSAS_Serial::init(), init(), nidas::dynld::isff::ATIK_Sonic::process(), nidas::dynld::isff::Wind2D::validateSscanfs(), nidas::dynld::isff::Wind3D::validateSscanfs(), and wxtValidateSscanfs().

◆ getSensorId()

unsigned int nidas::core::DSMSensor::getSensorId ( ) const

inlineinherited

References nidas::core::DSMSensor::_id, and GET_SPS_ID.

Referenced by nidas::core::Site::findSensor(), nidas::core::DSMSensor::fromDOMElement(), nidas::dynld::isff::CSAT3_Sonic::open(), ARLIngest::prepareHeaderIds(), nidas::dynld::isff::WisardMote::process(), nidas::core::SampleScanner::readBuffer(), nidas::core::DSMSensor::readSamples(), sensorTitle(), PConfig::showAll(), PConfig::showSensorClasses(), nidas::core::DSMSensor::validate(), nidas::core::Site::validate(), nidas::core::DSMConfig::validateSensorAndSampleIds(), nidas::core::MessageStreamScanner::warnBackwardsStepTimeTag(), and nidas::core::MessageStreamScanner::warnNonIncrTimeTag().

◆ getSite()

const Site * DSMSensor::getSite ( ) const

inherited

What Site am I associated with?

References nidas::core::DSMSensor::_dsm.

Referenced by SampleCounter::collectMetadata(), and nidas::core::DSMSensor::fromDOMElement().

◆ getStation()

int nidas::core::DSMSensor::getStation ( ) const

inlineinherited

References nidas::core::DSMSensor::_station.

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ getSuffix()

const std::string & nidas::core::DSMSensor::getSuffix ( ) const

inlineinherited

Sensor suffix, which is added to variable names.

It is only necessary to have a sensor suffix to make variable names unique. For example, if there are multiple sensors at the same height, with common variable names, then one can use a sensor suffix to make unique names. The sensor suffix is the second dot-separated word in a variable name, where only the first word is required: variable[.sensor][.height][.site]

References nidas::core::DSMSensor::_suffix.

Referenced by nidas::core::DSMSensor::fromDOMElement(), nidas::core::DSMSensor::MyDictionary::getTokenValue(), nidas::dynld::raf::TwoD64_USB::processImageRecord(), sensorTitle(), nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setHeight(), and nidas::core::DSMSensor::setHeight().

◆ getTermios()

const nidas::util::Termios & nidas::core::SerialSensor::getTermios ( ) const

inlineinherited

Get a read-only copy of the Termios.

References nidas::core::SerialSensor::_termios.

Referenced by nidas::dynld::ModbusRTU::open(), and nidas::core::RemoteSerialConnection::setSensor().

◆ getTimeoutCount()

int nidas::core::DSMSensor::getTimeoutCount ( ) const

inlineinherited

References nidas::core::DSMSensor::_nTimeouts.

Referenced by nidas::core::DSMSensor::close().

◆ getTimeoutMsecs()

virtual int nidas::core::DSMSensor::getTimeoutMsecs ( ) const

inlinevirtualinherited

References nidas::core::DSMSensor::_timeoutMsecs.

Referenced by nidas::core::RemoteSerialConnection::close(), nidas::core::RemoteSerialConnection::doEscCmds(), nidas::core::SensorHandler::PolledDSMSensor::getTimeoutMsecs(), and nidas::core::RemoteSerialConnection::setSensor().

◆ getTokenValue()

bool nidas::core::DSMSensor::getTokenValue	(	const std::string &	token,
		std::string &	value ) const

inlineinherited

Implement a lookup for tokens that I know about, like $HEIGHT.

For other tokens, call getDSMConfig()->getTokenValue(token,value);

References nidas::core::DSMSensor::_dictionary, and nidas::core::DSMSensor::MyDictionary::getTokenValue().

◆ getTypeName()

virtual const std::string & nidas::core::DSMSensor::getTypeName ( void ) const

inlinevirtualinherited

Get the type name of this sensor.

References nidas::core::DSMSensor::_typeName.

◆ getUName()

const std::string & nidas::dynld::WxtSensor::getUName ( ) const

inline

References _uName.

Referenced by init().

◆ getUsecsPerByte()

int SerialSensor::getUsecsPerByte ( ) const

inherited

If the underlying IODevice is a SerialPortIODevice, return the value of SerialPortIODevice::getUsecsPerByte(), otherwise return 0, which means no timetag correction for transmission delay will be applied.

References nidas::core::SerialSensor::_serialDevice, and nidas::core::SerialPortIODevice::getUsecsPerByte().

Referenced by nidas::core::SerialSensor::buildSampleScanner(), and nidas::dynld::GPS_NMEA_Serial::buildSampleScanner().

◆ getVariableIterator()

VariableIterator DSMSensor::getVariableIterator ( ) const

inherited

Referenced by nidas::core::DSMSensor::fromDOMElement(), DataPrep::matchVariables(), and nidas::core::Site::validate().

◆ getVName()

const std::string & nidas::dynld::WxtSensor::getVName ( ) const

inline

References _vName.

Referenced by init().

◆ getWriteFd()

virtual int nidas::core::DSMSensor::getWriteFd ( ) const

inlinevirtualinherited

References nidas::core::DSMSensor::_iodev, and nidas::core::IODevice::getWriteFd().

Referenced by nidas::dynld::isff::MOSMote::MOS_TimeSyncer::looperNotify(), and nidas::core::SerialSensor::open().

◆ incrementTimeoutCount()

void nidas::core::DSMSensor::incrementTimeoutCount ( )

inlineinherited

References nidas::core::DSMSensor::_nTimeouts.

Referenced by nidas::core::SensorOpener::run().

◆ init()

void WxtSensor::init ( )

virtual

Initialize the CharacterSensor instance for post-processing.

This should only be done after the CharacterSensor has been initialized with fromDOMElement. Calls validateSscanfs.

Exceptions

nidas::util::InvalidParameterException

parameter name

ptr to setXXX member function for setting parameter.

Reimplemented from nidas::core::CharacterSensor.

References _dirIndex, _field_formats, _speedDirId, _speedIndex, _uIndex, _uvId, _uvlen, _vIndex, nidas::core::AsciiSscanf::getFormat(), nidas::core::SampleTag::getId(), nidas::core::DSMSensor::getName(), nidas::core::Variable::getName(), nidas::core::AsciiSscanf::getNumberOfFields(), nidas::core::DSMSensor::getParameter(), nidas::core::getSample(), nidas::core::AsciiSscanf::getSampleTag(), nidas::core::DSMSensor::getSampleTagIterator(), nidas::core::CharacterSensor::getScanfers(), getUName(), nidas::core::SampleTag::getVariableIterator(), nidas::core::SampleTag::getVariables(), getVName(), nidas::core::SampleTagIterator::hasNext(), nidas::core::CharacterSensor::init(), setUName(), setVName(), string_token(), and wxtValidateSscanfs().

◆ initPrompting()

void SerialSensor::initPrompting ( )

protectedinherited

Perform whatever is necessary to initialize prompting right after the device is opened.

Exceptions

nidas::util::IOException

References nidas::core::SerialSensor::_prompters, nidas::core::CharacterSensor::getPrompts(), nidas::core::getSample(), nidas::core::CharacterSensor::isPrompted(), MSECS_PER_SEC, nidas::util::replaceBackslashSequences(), and nidas::core::SerialSensor::startPrompting().

Referenced by nidas::core::SerialSensor::open().

◆ ioctl()

virtual void nidas::core::DSMSensor::ioctl	(	int	request,
		void *	buf,
		size_t	len )

inlinevirtualinherited

Perform an ioctl on the device.

request is an integer value which must be supported by the device. Normally this is a value from a header file for the device.

Exceptions

nidas::util::IOException

References nidas::core::DSMSensor::_iodev, nidas::core::IODevice::ioctl(), and len.

◆ isPrompted()

virtual bool nidas::core::CharacterSensor::isPrompted ( ) const

inlinevirtualinherited

Is this a prompted sensor.

Will be true if setPromptString() has been called with a non-empty string, and setPromptRate() has been called with a rate other than IRIG_ZERO_HZ.

References nidas::core::CharacterSensor::_prompted.

Referenced by nidas::core::SerialSensor::initPrompting(), nidas::core::RemoteSerialConnection::setSensor(), nidas::core::SerialSensor::startPrompting(), and nidas::core::SerialSensor::stopPrompting().

◆ isPrompting()

bool nidas::core::SerialSensor::isPrompting ( ) const

inlinevirtualinherited

Is prompting active, i.e.

isPrompted() is true, and startPrompting has been called?

Reimplemented from nidas::core::CharacterSensor.

References nidas::core::SerialSensor::_prompting.

◆ nextSample()

virtual Sample * nidas::core::DSMSensor::nextSample ( )

inlinevirtualinherited

Extract the next sample from the buffer.

Returns a null pointer if there are no samples left in the buffer.

Reimplemented in nidas::dynld::raf::A2D_Serial, nidas::dynld::raf::AlicatSDI, and nidas::dynld::raf::UDPArincSensor.

References nidas::core::DSMSensor::_scanner, and nidas::core::SampleScanner::nextSample().

Referenced by nidas::dynld::isff::CSAT3_Sonic::dataMode(), nidas::dynld::raf::AlicatSDI::nextSample(), nidas::dynld::raf::UDPArincSensor::nextSample(), nidas::dynld::isff::CSAT3_Sonic::querySonic(), nidas::core::DSMSensor::readSample(), nidas::core::DSMSensor::readSamples(), nidas::dynld::raf::UHSAS_Serial::sendInitString(), nidas::dynld::isff::CSAT3_Sonic::sendRateCommand(), and nidas::dynld::isff::CSAT3_Sonic::terminalMode().

◆ open()

void SerialSensor::open ( int flags )

virtualinherited

Open the device connected to the sensor.

This calls CharacterSensor::open(), and then sets up the port prompting if it is required.

Exceptions

nidas::util::IOException
nidas::util::InvalidParameterException

Reimplemented from nidas::core::CharacterSensor.

Reimplemented in nidas::dynld::raf::UHSAS_Serial, nidas::dynld::raf::VCSEL2_Serial, and nidas::dynld::raf::VCSEL_Serial.

References nidas::core::DSMSensor::getDeviceName(), nidas::core::CharacterSensor::getMessageLength(), nidas::core::CharacterSensor::getMessageSeparator(), nidas::core::DSMSensor::getName(), nidas::core::DSMSensor::getReadFd(), nidas::core::getSample(), nidas::core::DSMSensor::getWriteFd(), nidas::core::SerialSensor::initPrompting(), nidas::core::CharacterSensor::open(), and nidas::core::CharacterSensor::sendInitString().

Referenced by nidas::dynld::isff::CSAT3_Sonic::open(), nidas::dynld::isff::CSI_IRGA_Sonic::open(), nidas::dynld::isff::MOSMote::open(), nidas::dynld::ModbusRTU::open(), nidas::dynld::raf::A2D_Serial::open(), nidas::dynld::raf::AlicatSDI::open(), nidas::dynld::raf::PPT_Serial::open(), nidas::dynld::raf::UHSAS_Serial::open(), nidas::dynld::raf::VCSEL2_Serial::open(), and nidas::dynld::raf::VCSEL_Serial::open().

◆ printStatus()

void SerialSensor::printStatus	(	std::ostream &	ostr	)
throw	(	)

virtualinherited

Reimplemented from nidas::core::DSMSensor.

References nidas::core::getSample(), LOG_ERR, and nidas::core::DSMSensor::printStatus().

◆ printStatusHeader()

void DSMSensor::printStatusHeader ( std::ostream & ostr )

inherited

References nidas::core::DSMSensor::getDSMConfig(), nidas::core::DSMSensor::getLocation(), nidas::core::DSMSensor::getName(), nidas::core::getSample(), and nidas::core::DSMSensor::zebra.

Referenced by nidas::core::DSMEngineStat::run().

◆ printStatusTrailer()

void DSMSensor::printStatusTrailer ( std::ostream & ostr )

inherited

References nidas::core::getSample().

Referenced by nidas::core::DSMEngineStat::run().

◆ process()

bool WxtSensor::process	(	const Sample *	,
		std::list< const Sample * > &	result )
throw	(	)

virtual

Process a raw sample, which in this case means do a sscanf on the character string contents, creating a processed sample of binary floating point data.

Exceptions

)

Reimplemented from nidas::core::CharacterSensor.

References nidas::core::Sample::getDataLength(), and nidas::core::getSample().

◆ read() [1/2]

virtual size_t nidas::core::DSMSensor::read	(	void *	buf,
		size_t	len )

inlinevirtualinherited

Read from the device (duh).

Behaves like the read(2) system call, without a file descriptor argument, and with an IOException.

Exceptions

nidas::util::IOException

References nidas::core::DSMSensor::_iodev, len, and nidas::core::IODevice::read().

Referenced by main(), nidas::core::SampleScanner::readBuffer(), nidas::core::DatagramSampleScanner::readBuffer(), nidas::dynld::raf::PSI9116_Sensor::sendCommand(), nidas::dynld::raf::SppSerial::sendInitPacketAndCheckAck(), and nidas::dynld::raf::PSI9116_Sensor::stopStreams().

◆ read() [2/2]

virtual size_t nidas::core::DSMSensor::read	(	void *	buf,
		size_t	len,
		int	msecTimeout )

inlinevirtualinherited

Read from the device with a timeout.

Exceptions

nidas::util::IOException

References nidas::core::DSMSensor::_iodev, len, and nidas::core::IODevice::read().

◆ readBuffer() [1/2]

bool nidas::core::DSMSensor::readBuffer ( )

inlineinherited

Read into my SampleScanner's buffer.

Exceptions

nidas::util::IOException

References nidas::core::DSMSensor::_scanner, nidas::core::getSample(), and nidas::core::SampleScanner::readBuffer().

Referenced by nidas::dynld::isff::CSAT3_Sonic::dataMode(), nidas::dynld::raf::AlicatSDI::open(), nidas::dynld::isff::CSAT3_Sonic::querySonic(), nidas::dynld::raf::A2D_Serial::readConfig(), nidas::core::DSMSensor::readSample(), nidas::core::DSMSensor::readSamples(), nidas::dynld::raf::SppSerial::sendInitPacketAndCheckAck(), nidas::dynld::raf::UHSAS_Serial::sendInitString(), nidas::dynld::isff::CSAT3_Sonic::sendRateCommand(), and nidas::dynld::isff::CSAT3_Sonic::terminalMode().

◆ readBuffer() [2/2]

bool nidas::core::DSMSensor::readBuffer ( int msecTimeout )

inlineinherited

Read into my SampleScanner's buffer.

Exceptions

nidas::util::IOException

References nidas::core::DSMSensor::_scanner, nidas::core::getSample(), and nidas::core::SampleScanner::readBuffer().

◆ readSample()

Sample * DSMSensor::readSample ( )

virtualinherited

Return the next sample.

Buffer(s) will be read if necessary.

Exceptions

nidas::util::IOException

References nidas::core::getSample(), nidas::core::DSMSensor::nextSample(), and nidas::core::DSMSensor::readBuffer().

◆ readSamples()

bool DSMSensor::readSamples ( )

virtualinherited

Read samples from my associated file descriptor, and distribute() them to my RawSampleClient's.

This method is called by SensorHander, when select/poll indicates that data is available on the file descriptor returned by getReadFd(). This is a convienence method which does a readBuffer() to read available data from the DSMSensor into a buffer, and then repeatedly calls nextSample() to extract all samples out of that buffer.

Exceptions

nidas::util::IOException;

References nidas::core::DSMSensor::_rawSource, nidas::core::SampleSourceSupport::distribute(), DLOG, nidas::core::DSMSensor::getDSMConfig(), nidas::core::DSMSensor::getDSMId(), nidas::core::DSMSensor::getName(), nidas::core::getSample(), nidas::core::DSMSensor::getSensorId(), nidas::core::DSMSensor::nextSample(), and nidas::core::DSMSensor::readBuffer().

◆ receive()

bool DSMSensor::receive ( const Sample * s )

virtualinherited

A DSMSensor can be used as a SampleClient, meaning it receives its own raw samples.

In real-time operations, a DSMSensor can be added as a raw SampleClient of itself, using addRawSampleClient(). In post-processing, a DSMSensor typically receives samples with its own sample id from a SampleSorter. receive() then applies further processing via the process() method.

Implements nidas::core::SampleClient.

References nidas::core::DSMSensor::_source, nidas::core::SampleSourceSupport::distribute(), nidas::core::getSample(), and nidas::core::DSMSensor::process().

◆ removeCalFiles()

void DSMSensor::removeCalFiles ( )

inherited

Remove all CalFiles.

References nidas::core::DSMSensor::_calFiles.

Referenced by nidas::core::DSMSensor::~DSMSensor().

◆ removeSampleClient()

void nidas::core::DSMSensor::removeSampleClient	(	SampleClient *	c	)
throw	(	)

inlinevirtualinherited

Remove a SampleClient from this SampleSource This will also remove a SampleClient if it has been added with addSampleClientForTag().

Implements nidas::core::SampleSource.

References nidas::core::DSMSensor::_source, and nidas::core::SampleSourceSupport::removeSampleClient().

Referenced by nidas::core::SamplePipeline::removeSampleClient(), and nidas::core::SamplePipeline::removeSampleClientForTag().

◆ removeSampleClientForTag()

void nidas::core::DSMSensor::removeSampleClientForTag	(	SampleClient *	client,
		const SampleTag *	tag )
throw	(	)

inlinevirtualinherited

Remove a SampleClient for a given SampleTag from this SampleSource.

The pointer to the SampleClient must remain valid, until after it is removed.

Implements nidas::core::SampleSource.

References nidas::core::DSMSensor::_source, and nidas::core::SampleSourceSupport::removeSampleClientForTag().

Referenced by nidas::core::SamplePipeline::removeSampleClientForTag().

◆ removeSampleTag() [1/2]

void DSMSensor::removeSampleTag ( const SampleTag * val )

privatevirtualinherited

DSMSensor does not provide public support for SampleSource::removeSampleTag(const SampleTag* val)

Exceptions

)

Implements nidas::core::SampleSource.

References nidas::core::getSample().

◆ removeSampleTag() [2/2]

void DSMSensor::removeSampleTag ( SampleTag * val )

virtualinherited

Remove val from the list of SampleTags, and delete it.

References nidas::core::DSMSensor::_sampleTags, nidas::core::DSMSensor::_source, nidas::core::getSample(), and nidas::core::SampleSourceSupport::removeSampleTag().

Referenced by nidas::dynld::isff::WisardMote::validate().

◆ reopenOnIOException()

virtual bool nidas::core::DSMSensor::reopenOnIOException ( ) const

inlinevirtualinherited

Whether to reopen this sensor on an IOException.

The base method returns true. Over-ride if a reopen should not be attempted.

◆ scanSample()

int WxtSensor::scanSample	(	AsciiSscanf *	sscanf,
		const char *	inputstr,
		float *	data_ptr )

virtual

Reimplemented from nidas::core::CharacterSensor.

References _field_formats, DLOG, nidas::core::floatNAN, nidas::core::SampleTag::getId(), nidas::core::DSMSensor::getName(), nidas::core::AsciiSscanf::getNumberOfFields(), nidas::core::getSample(), nidas::core::AsciiSscanf::getSampleTag(), nidas::core::SampleTag::getVariables(), string_token(), VLOG, and WLOG.

◆ searchSampleScanners()

SampleT< float > * CharacterSensor::searchSampleScanners	(	const Sample *	samp,
		SampleTag **	stag_out = 0 )
throw	(	)

protectedinherited

Search through the AsciiSscanf instances attached to this sensor, looking for the next scanner which parses at least one variable from the given raw sample.

The search picks up after the last scanner which matched a sample. The parsed values are added to a new Sample, and a pointer to the new Sample is returned. If stag_out is non-null, it is set to the SampleTag pointer for the AsciiSscanf which matched. If no scanners match this sample, then this returns null. The returned Sample has a reference which must be freed by the caller or passed on. Any unparsed variables in the returned sample are filled with NaN using trimUnparsed(). The time tag of the new Sample is set to the time of raw sample samp. No other time tag adjustments or variable conversions are applied, that is up to the caller.

References nidas::core::CHAR_ST, nidas::core::AsciiSscanf::getFormat(), nidas::core::SampleTag::getId(), nidas::core::AsciiSscanf::getNumberOfFields(), nidas::core::getSample(), nidas::core::AsciiSscanf::getSampleTag(), nidas::util::LogMessage::log(), and LOG_DEBUG.

Referenced by nidas::dynld::isff::NCAR_TRH::process(), and nidas::core::CharacterSensor::process().

◆ sendInitString()

void CharacterSensor::sendInitString ( )

virtualinherited

Exceptions

nidas::util::IOException

Reimplemented in nidas::dynld::raf::BCPD_Serial, nidas::dynld::raf::CDP_Serial, nidas::dynld::raf::PIP_Serial, nidas::dynld::raf::SPP100_Serial, nidas::dynld::raf::SPP200_Serial, nidas::dynld::raf::SPP300_Serial, and nidas::dynld::raf::UHSAS_Serial.

References DLOG, nidas::core::DSMSensor::getDeviceName(), nidas::core::CharacterSensor::getInitString(), nidas::util::replaceBackslashSequences(), and nidas::core::DSMSensor::write().

Referenced by nidas::core::SerialSensor::open().

◆ setApplyVariableConversions()

virtual void nidas::core::DSMSensor::setApplyVariableConversions ( bool val )

inlinevirtualinherited

References nidas::core::DSMSensor::_applyVariableConversions, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setCatalogName()

virtual void nidas::core::DSMSensor::setCatalogName ( const std::string & val )

inlinevirtualinherited

Set the name of the catalog entry for this sensor.

References nidas::core::DSMSensor::_catalogName, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setClassName()

virtual void nidas::core::DSMSensor::setClassName ( const std::string & val )

inlinevirtualinherited

Set the class name.

In the usual usage this method is not used, and getClassName() is over-ridden in a derived class to return a constant string.

References nidas::core::DSMSensor::_className, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setDefaultMode()

virtual void nidas::core::DSMSensor::setDefaultMode ( int val )

inlinevirtualinherited

References nidas::core::DSMSensor::_defaultMode, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement(), nidas::core::SerialSensor::SerialSensor(), and nidas::dynld::raf::TwoD_USB::TwoD_USB().

◆ setDepth() [1/2]

void DSMSensor::setDepth ( const std::string & val )

inherited

Set sensor depth below ground via a string which is added to variable names.

Parameters

val	String containing sensor below and units in meters (m) or centimeters(cm), e.g. "5cm". This depth string is added to all the variable names, with a "." separator, so that a variable "Tsoil" for this sensor becomes "Tsoil.5cm".

References nidas::core::DSMSensor::_depthString, nidas::core::DSMSensor::_height, nidas::core::DSMSensor::_heightString, nidas::core::floatNAN, nidas::core::getSample(), nidas::core::DSMSensor::getSuffix(), and nidas::core::DSMSensor::setFullSuffix().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setDepth() [2/2]

void DSMSensor::setDepth ( float val )

inherited

Set sensor depth below ground.

Parameters

val	depth below ground, in meters. The depth is converted to centimeters and is added to all the variable names, with a "." separator, so that a variable "Tsoil" for this sensor becomes "Tsoil.5cm".

References nidas::core::DSMSensor::_depthString, nidas::core::DSMSensor::_height, nidas::core::DSMSensor::_heightString, nidas::core::getSample(), nidas::core::DSMSensor::getSuffix(), and nidas::core::DSMSensor::setFullSuffix().

◆ setDeviceName()

virtual void nidas::core::DSMSensor::setDeviceName ( const std::string & val )

inlinevirtualinherited

Set the name of the system device that the sensor is connected to.

Parameters

val	Name of device, e.g. "/dev/xxx0".

References nidas::core::DSMSensor::_devname, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement(), and main().

◆ setDriverTimeTagUsecs()

virtual void nidas::core::DSMSensor::setDriverTimeTagUsecs ( int val )

inlinevirtualinherited

References nidas::core::DSMSensor::_driverTimeTagUsecs, and nidas::core::getSample().

Referenced by nidas::dynld::raf::DSMArincSensor::buildIODevice(), nidas::dynld::raf::DSMMesaSensor::buildIODevice(), nidas::dynld::raf::A2DBoardTempSensor::buildSampleScanner(), nidas::dynld::raf::DSMAnalogSensor::buildSampleScanner(), nidas::dynld::raf::IRIGSensor::buildSampleScanner(), and nidas::dynld::raf::LamsSensor::buildSampleScanner().

◆ setDSMConfig()

void DSMSensor::setDSMConfig ( const DSMConfig * val )

inherited

Set the DSMConfig for this sensor.

References nidas::core::DSMSensor::_dsm, nidas::core::getSample(), and nidas::core::DSMSensor::setDSMId().

Referenced by nidas::core::DSMConfig::sensorFromDOMElement(), and nidas::core::SensorHandler::~SensorHandler().

◆ setDSMId()

void nidas::core::DSMSensor::setDSMId ( unsigned int val )

inlineinherited

References nidas::core::DSMSensor::_id, and SET_DSM_ID.

Referenced by nidas::core::DSMSensor::setDSMConfig().

◆ setDuplicateIdOK()

void nidas::core::DSMSensor::setDuplicateIdOK ( bool val )

inlineinherited

Set the duplicate ID attribute of this DSMSensor.

References nidas::core::DSMSensor::_duplicateIdOK, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setFullSuffix()

void nidas::core::DSMSensor::setFullSuffix ( const std::string & val )

inlineprotectedinherited

References nidas::core::DSMSensor::_fullSuffix, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setHeight(), nidas::core::DSMSensor::setHeight(), and nidas::core::DSMSensor::setSuffix().

◆ setHeight() [1/2]

void DSMSensor::setHeight ( const std::string & val )

inherited

Set sensor height above ground via a string which is added to variable names.

Parameters

val	String containing sensor height and units in meters (m) or centimeters(cm), e.g. "15m". This height string is added to all the variable names, with a "." separator, so that a variable "u" for this sensor becomes "u.15m".

References nidas::core::DSMSensor::_depthString, nidas::core::DSMSensor::_height, nidas::core::DSMSensor::_heightString, nidas::core::floatNAN, nidas::core::getSample(), nidas::core::DSMSensor::getSuffix(), and nidas::core::DSMSensor::setFullSuffix().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setHeight() [2/2]

void DSMSensor::setHeight ( float val )

inherited

Set sensor height above ground.

Parameters

val	height above ground, in meters. The height is added to all the variable names, with a "." separator, so that a variable "u" for this sensor becomes "u.15m".

References nidas::core::DSMSensor::_depthString, nidas::core::DSMSensor::_height, nidas::core::DSMSensor::_heightString, nidas::core::getSample(), nidas::core::DSMSensor::getSuffix(), and nidas::core::DSMSensor::setFullSuffix().

◆ setId()

void nidas::core::DSMSensor::setId ( dsm_sample_id_t val )

inlineinherited

Set the various levels of the sensor identification.

A sensor ID is a 32-bit value comprised of four parts: 6-bit sample type id (not used by DSMSensor), 10-bit DSM id, and 16-bit sensor+sample ids.

References nidas::core::DSMSensor::_id, and SET_FULL_ID.

◆ setInitString()

void nidas::core::CharacterSensor::setInitString ( const std::string & val )

inlineinherited

Set the initialization string(s) for this sensor.

The init string may contain backslash escape sequences like the prompt string.

References nidas::core::CharacterSensor::_initString, and nidas::core::getSample().

Referenced by nidas::core::CharacterSensor::fromDOMElement().

◆ setIODevice()

void nidas::core::DSMSensor::setIODevice ( IODevice * val )

inlineinherited

Set the IODevice for this sensor.

DSMSensor then owns the pointer and will delete it in its destructor.

References nidas::core::DSMSensor::_iodev, and nidas::core::getSample().

◆ setLagSecs()

virtual void nidas::core::DSMSensor::setLagSecs ( double val )

inlineprotectedvirtualinherited

Set the sampling lag for this sensor in seconds.

This lag should then used to correct the timetags of the processed samples in the process() method of derived classes. Note that this lag is not used to alter the timetags of the raw samples. Raw samples are saved with the un-altered timetag that was determined at the moment they were sampled.

The lag is stored as a signed integer of microseconds, so lags should be between += 2147 seconds. No warning or exception is given if the value exceeds that limit. If your lag is greater than that I suggest you junk your sensor! A positive lag means one should adjust the sample time tags for this sensor earlier in time to achieve a better estimate of the actual time to be associated for each sample. A fixed sample lag, in fractional seconds, can be set for a sensor in the XML:

The DSMSensor::fromDOM() method parses this parameter and calls this method to set the lag. process() methods in derived classes must apply this lag value. The DSMSensor base class does not adjust time tags of processed samples.

References nidas::core::DSMSensor::_lag, nidas::core::getSample(), and USECS_PER_SEC.

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setLatency()

virtual void nidas::core::DSMSensor::setLatency ( float val )

inlinevirtualinherited

Set desired latency, providing some control over the response time vs buffer efficiency tradeoff.

Setting a latency of 1/10 sec means buffer data in the driver for a 1/10 sec, then send the data to user space. Generally it should be set before doing a sensor open().

Parameters

val	Latency, in seconds.

Exceptions

nidas::util::InvalidParameterException

References nidas::core::DSMSensor::_latency, and nidas::core::getSample().

Referenced by nidas::dynld::A2DSensor::A2DSensor(), nidas::core::DSMSensor::fromDOMElement(), and nidas::dynld::A2DSensor::validate().

◆ setLocation()

void nidas::core::DSMSensor::setLocation ( const std::string & val )

inlineinherited

References nidas::core::DSMSensor::_location, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setMessageParameters()

void SerialSensor::setMessageParameters	(	unsigned int	len,
		const std::string &	sep,
		bool	eom )

virtualinherited

Set message separator and message length parameters, which are used to parse and time-tag samples from the IODevice.

Exceptions

nidas::util::InvalidParameterException,nidas::util::IOException

Reimplemented from nidas::core::CharacterSensor.

References len, and nidas::core::CharacterSensor::setMessageParameters().

◆ setPromptOffset()

void nidas::core::CharacterSensor::setPromptOffset ( const double val )

inlineprotectedinherited

References nidas::core::CharacterSensor::_promptOffset, and nidas::core::getSample().

Referenced by nidas::core::CharacterSensor::fromDOMElement().

◆ setPromptRate()

void nidas::core::CharacterSensor::setPromptRate ( const double val )

inlineprotectedinherited

Set the rate at which <sensor> prompts are sent to this sensor.

This will be set on a CharacterSensor if a <prompt> element is found for <sensor>, not as a sub-element of <sample>.

References nidas::core::CharacterSensor::_promptRate, and nidas::core::getSample().

Referenced by nidas::core::CharacterSensor::fromDOMElement().

◆ setPromptString()

void nidas::core::CharacterSensor::setPromptString ( const std::string & val )

inlineprotectedinherited

Set the <sensor> prompt string for this sensor.

The prompt string may contain backslash escape sequences and null characters, so be carefull when copying to a char*.

References nidas::core::CharacterSensor::_promptString, and nidas::core::getSample().

Referenced by nidas::core::CharacterSensor::fromDOMElement().

◆ setSampleScanner()

void nidas::core::DSMSensor::setSampleScanner ( SampleScanner * val )

inlineinherited

Set the SampleScanner for this sensor.

DSMSensor then owns the pointer and will delete it in its destructor.

References nidas::core::DSMSensor::_scanner, and nidas::core::getSample().

◆ setSensorId()

void nidas::core::DSMSensor::setSensorId ( unsigned int val )

inlineinherited

References nidas::core::DSMSensor::_id, and SET_SPS_ID.

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setStation()

void DSMSensor::setStation ( int val )

inherited

References nidas::core::DSMSensor::_sampleTags, nidas::core::DSMSensor::_station, nidas::core::getSample(), and nidas::core::SampleTag::setStation().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setSuffix()

void DSMSensor::setSuffix ( const std::string & val )

inherited

References nidas::core::DSMSensor::_depthString, nidas::core::DSMSensor::_heightString, nidas::core::DSMSensor::_suffix, nidas::core::getSample(), and nidas::core::DSMSensor::setFullSuffix().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setTimeoutMsecs()

virtual void nidas::core::DSMSensor::setTimeoutMsecs ( int val )

inlinevirtualinherited

Set the sensor timeout value in milliseconds.

A value of 0 means no timeout (e.g. infinite). If no data is received for this period, then the sensor is closed, and re-opened. For efficiency reasons, the system may not actually detect a sensor timeout of less than 1 second, so setting it to less than 1000 milliseconds will likely not reduce the time before a sensor timeout is detected.

References nidas::core::DSMSensor::_timeoutMsecs, and nidas::core::getSample().

Referenced by nidas::core::RemoteSerialConnection::close(), nidas::core::RemoteSerialConnection::doEscCmds(), nidas::core::DSMSensor::fromDOMElement(), and nidas::dynld::ModbusRTU::open().

◆ setTypeName()

virtual void nidas::core::DSMSensor::setTypeName ( const std::string & val )

inlinevirtualinherited

Set the type name of this sensor, e.g.: "ACME Model 99 Mach7 Particle Disambiguator".

This is meant for descriptive purposes only, and is not meant to change the behavior of a sensor object.

References nidas::core::DSMSensor::_typeName, and nidas::core::getSample().

Referenced by nidas::core::DSMSensor::fromDOMElement().

◆ setUName()

void nidas::dynld::WxtSensor::setUName ( const std::string & val )

inline

References _uName, and nidas::core::getSample().

Referenced by init().

◆ setVName()

void nidas::dynld::WxtSensor::setVName ( const std::string & val )

inline

References _vName, and nidas::core::getSample().

Referenced by init().

◆ shutdownPrompting()

void SerialSensor::shutdownPrompting ( )

protectedinherited

Shutdown prompting, typically done when a device is closed.

Exceptions

nidas::util::IOException

References nidas::core::SerialSensor::_prompters, nidas::core::getSample(), and nidas::core::SerialSensor::stopPrompting().

Referenced by nidas::core::SerialSensor::close().

◆ startPrompting()

void SerialSensor::startPrompting ( )

virtualinherited

Start the prompters.

They can be started and stopped multiple times once a SerialSensor is opened.

Exceptions

nidas::util::IOException

Reimplemented from nidas::core::CharacterSensor.

References nidas::core::SerialSensor::_prompters, nidas::core::SerialSensor::_prompting, nidas::core::DSMSensor::getLooper(), nidas::core::getSample(), and nidas::core::CharacterSensor::isPrompted().

Referenced by nidas::core::SerialSensor::initPrompting().

◆ stopPrompting()

void SerialSensor::stopPrompting ( )

virtualinherited

Exceptions

nidas::util::IOException

Reimplemented from nidas::core::CharacterSensor.

References nidas::core::SerialSensor::_prompters, nidas::core::SerialSensor::_prompting, nidas::core::DSMSensor::getLooper(), nidas::core::getSample(), and nidas::core::CharacterSensor::isPrompted().

Referenced by nidas::core::SerialSensor::shutdownPrompting().

◆ termios()

nidas::util::Termios & nidas::core::SerialSensor::termios ( )

inlineinherited

Expose the Termios.

One must call applyTermios() to apply any changes to the serial port.

References nidas::core::SerialSensor::_termios.

Referenced by nidas::core::RemoteSerialConnection::doEscCmds(), and nidas::dynld::ModbusRTU::open().

◆ toDOMElement()

xercesc::DOMElement * DSMSensor::toDOMElement	(	xercesc::DOMElement *	node,
		bool	complete ) const

virtualinherited

Exceptions

xercesc::DOMException;

Reimplemented from nidas::core::DOMable.

Referenced by nidas::core::DSMSensor::toDOMParent().

◆ toDOMParent()

xercesc::DOMElement * DSMSensor::toDOMParent	(	xercesc::DOMElement *	parent,
		bool	complete ) const

virtualinherited

Exceptions

xercesc::DOMException

Reimplemented from nidas::core::DOMable.

References nidas::core::DOMable::getNamespaceURI(), nidas::core::getSample(), nidas::core::DSMSensor::getSampleTagIterator(), nidas::core::SampleTagIterator::hasNext(), nidas::core::DSMSensor::toDOMElement(), and nidas::core::SampleTag::toDOMParent().

Referenced by nidas::core::DSMConfig::toDOMElement().

◆ togglePrompting()

virtual void nidas::core::CharacterSensor::togglePrompting ( )

inlinevirtualinherited

Exceptions

nidas::util::IOException

References nidas::core::CharacterSensor::isPrompting(), nidas::core::CharacterSensor::startPrompting(), and nidas::core::CharacterSensor::stopPrompting().

Referenced by nidas::core::RemoteSerialConnection::doEscCmds().

◆ trimUnparsed()

void DSMSensor::trimUnparsed	(	SampleTag *	stag,
		SampleT< float > *	outs,
		int	nparsed )

protectedinherited

Fill with floatNAN all the values past nparsed values in output sample outs, and trim the length of the sample to match the length of the variables in SampleTag stag.

process() methods which support partial scans of messages can use this to finalize an output sample according to the SampleTag that was matched with it and the number of values parsed.

References nidas::core::floatNAN, fp, nidas::core::getSample(), and nidas::core::SampleTag::getVariables().

Referenced by nidas::dynld::iss::WICORSensor::process().

◆ unixDevInit()

void nidas::core::SerialSensor::unixDevInit ( int flags )

protectedinherited

Exceptions

nidas::util::IOException

◆ validate()

void CharacterSensor::validate ( )

virtualinherited

Implementation of DSMSensor::validate for a Character Sensor.

Currently initializes all the prompts for this sensor.

Exceptions

nidas::util::InvalidParameterException

Reimplemented from nidas::core::DSMSensor.

References nidas::core::CharacterSensor::_prompted, nidas::core::CharacterSensor::addPrompt(), nidas::core::DSMSensor::getName(), nidas::core::CharacterSensor::getPromptOffset(), nidas::core::CharacterSensor::getPromptRate(), nidas::core::CharacterSensor::getPrompts(), nidas::core::CharacterSensor::getPromptString(), nidas::core::getSample(), nidas::core::DSMSensor::getSampleTags(), and nidas::core::DSMSensor::validate().

Referenced by nidas::dynld::isff::NCAR_TRH::validate(), nidas::dynld::raf::PSI9116_Sensor::validate(), nidas::dynld::raf::SppSerial::validate(), nidas::dynld::raf::UDPArincSensor::validate(), and nidas::dynld::raf::UDPiPMSensor::validate().

◆ validateSscanfs()

void WxtSensor::validateSscanfs ( )

virtual

Virtual method to check that the Sscanfs for this CharacterSensor are OK.

The default implementation checks that the number of parse fields in each sscanf parser matches the number of variables in the associated output sample.

Exceptions

nidas::util::InvalidParameterException

Reimplemented from nidas::core::CharacterSensor.

◆ write()

virtual size_t nidas::core::DSMSensor::write	(	const void *	buf,
		size_t	len )

inlinevirtualinherited

Write to the device (duh).

Behaves like write(2) system call, without a file descriptor argument, and with an IOException.

Exceptions

nidas::util::IOException

References nidas::core::DSMSensor::_iodev, len, and nidas::core::IODevice::write().

◆ wxtValidateSscanfs()

void WxtSensor::wxtValidateSscanfs ( )

private

References _uIndex, _uvId, _vIndex, DLOG, GET_DSM_ID, GET_SHORT_ID, nidas::core::SampleTag::getId(), nidas::core::DSMSensor::getName(), nidas::core::AsciiSscanf::getNumberOfFields(), nidas::core::getSample(), nidas::core::AsciiSscanf::getSampleTag(), nidas::core::CharacterSensor::getScanfers(), nidas::core::SampleTag::getVariables(), and WLOG.

Referenced by init().

Member Data Documentation

◆ _applyVariableConversions

bool nidas::core::DSMSensor::_applyVariableConversions

privateinherited

Referenced by nidas::core::DSMSensor::getApplyVariableConversions(), and nidas::core::DSMSensor::setApplyVariableConversions().

◆ _calFiles

std::map<std::string,CalFile*> nidas::core::DSMSensor::_calFiles

privateinherited

Referenced by nidas::core::DSMSensor::addCalFile(), nidas::core::DSMSensor::getCalFile(), nidas::core::DSMSensor::getCalFiles(), and nidas::core::DSMSensor::removeCalFiles().

◆ _catalogName

std::string nidas::core::DSMSensor::_catalogName

privateinherited

Referenced by nidas::core::DSMSensor::getCatalogName(), and nidas::core::DSMSensor::setCatalogName().

◆ _className

std::string nidas::core::DSMSensor::_className

privateinherited

Class name attribute of this sensor.

Only used here for informative messages.

Referenced by nidas::core::DSMSensor::getClassName(), and nidas::core::DSMSensor::setClassName().

◆ _constParameters

std::list<const Parameter*> nidas::core::DSMSensor::_constParameters

privateinherited

List of const pointers to Parameters for providing via getParameters().

Referenced by nidas::core::DSMSensor::addParameter(), and nidas::core::DSMSensor::getParameters().

◆ _defaultMode

int nidas::core::DSMSensor::_defaultMode

privateinherited

Referenced by nidas::core::DSMSensor::getDefaultMode(), and nidas::core::DSMSensor::setDefaultMode().

◆ _depthString

std::string nidas::core::DSMSensor::_depthString

privateinherited

Referenced by nidas::core::DSMSensor::getDepthString(), nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setHeight(), nidas::core::DSMSensor::setHeight(), and nidas::core::DSMSensor::setSuffix().

◆ _devname

std::string nidas::core::DSMSensor::_devname

privateinherited

Referenced by nidas::core::DSMSensor::getDeviceName(), and nidas::core::DSMSensor::setDeviceName().

◆ _dictionary

nidas::core::DSMSensor::MyDictionary nidas::core::DSMSensor::_dictionary

privateinherited

Referenced by nidas::core::DSMSensor::expandString(), nidas::core::DSMSensor::fromDOMElement(), nidas::core::DSMSensor::getDictionary(), and nidas::core::DSMSensor::getTokenValue().

◆ _dirIndex

int nidas::dynld::WxtSensor::_dirIndex

private

Index of wind direction in output sample.

Referenced by init().

◆ _driverTimeTagUsecs

int nidas::core::DSMSensor::_driverTimeTagUsecs

privateinherited

Referenced by nidas::core::DSMSensor::getDriverTimeTagUsecs(), and nidas::core::DSMSensor::setDriverTimeTagUsecs().

◆ _dsm

const DSMConfig* nidas::core::DSMSensor::_dsm

privateinherited

Referenced by nidas::core::DSMSensor::getDSMConfig(), nidas::core::DSMSensor::getDSMName(), nidas::core::DSMSensor::getLocation(), nidas::core::DSMSensor::getSite(), and nidas::core::DSMSensor::setDSMConfig().

◆ _duplicateIdOK

bool nidas::core::DSMSensor::_duplicateIdOK

privateinherited

Referenced by nidas::core::DSMSensor::getDuplicateIdOK(), and nidas::core::DSMSensor::setDuplicateIdOK().

◆ _emptyString

std::string nidas::core::CharacterSensor::_emptyString

privateinherited

◆ _field_formats

std::map<dsm_sample_id_t,std::vector<std::string> > nidas::dynld::WxtSensor::_field_formats

private

For each <sample> with an scanfFormat, the parse format tokenized by commas.

Referenced by init(), and scanSample().

◆ _fullSuffix

std::string nidas::core::DSMSensor::_fullSuffix

privateinherited

Concatenation of sensor suffix, and the height or depth string.

Referenced by nidas::core::DSMSensor::getFullSuffix(), and nidas::core::DSMSensor::setFullSuffix().

◆ _height

float nidas::core::DSMSensor::_height

privateinherited

Referenced by nidas::core::DSMSensor::getDepth(), nidas::core::DSMSensor::getHeight(), nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setHeight(), and nidas::core::DSMSensor::setHeight().

◆ _heightString

std::string nidas::core::DSMSensor::_heightString

privateinherited

Referenced by nidas::core::DSMSensor::getHeightString(), nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setDepth(), nidas::core::DSMSensor::setHeight(), nidas::core::DSMSensor::setHeight(), and nidas::core::DSMSensor::setSuffix().

◆ _id

dsm_sample_id_t nidas::core::DSMSensor::_id

privateinherited

Id of this sensor.

Raw samples from this sensor will have this id.

Referenced by nidas::core::DSMSensor::getDSMId(), nidas::core::DSMSensor::getId(), nidas::core::DSMSensor::getSensorId(), nidas::core::DSMSensor::setDSMId(), nidas::core::DSMSensor::setId(), and nidas::core::DSMSensor::setSensorId().

◆ _initString

std::string nidas::core::CharacterSensor::_initString

privateinherited

String that is sent once after sensor is opened.

Referenced by nidas::core::CharacterSensor::getInitString(), and nidas::core::CharacterSensor::setInitString().

◆ _iodev

IODevice* nidas::core::DSMSensor::_iodev

privateinherited

Referenced by nidas::core::DSMSensor::close(), nidas::core::DSMSensor::getBytesAvailable(), nidas::core::DSMSensor::getIODevice(), nidas::core::DSMSensor::getReadFd(), nidas::core::DSMSensor::getWriteFd(), nidas::core::DSMSensor::ioctl(), nidas::core::DSMSensor::open(), nidas::core::DSMSensor::read(), nidas::core::DSMSensor::read(), nidas::core::DSMSensor::setIODevice(), nidas::core::DSMSensor::write(), and nidas::core::DSMSensor::~DSMSensor().

◆ _lag

int nidas::core::DSMSensor::_lag

privateinherited

Referenced by nidas::core::DSMSensor::getLagSecs(), nidas::core::DSMSensor::getLagUsecs(), and nidas::core::DSMSensor::setLagSecs().

◆ _latency

float nidas::core::DSMSensor::_latency

privateinherited

Referenced by nidas::core::DSMSensor::getLatency(), and nidas::core::DSMSensor::setLatency().

◆ _location

std::string nidas::core::DSMSensor::_location

privateinherited

Referenced by nidas::core::DSMSensor::getLocation(), and nidas::core::DSMSensor::setLocation().

◆ _looper

Looper * DSMSensor::_looper = 0

staticprivateinherited

Referenced by nidas::core::DSMSensor::deleteLooper(), and nidas::core::DSMSensor::getLooper().

◆ _looperMutex

n_u::Mutex DSMSensor::_looperMutex

staticprivateinherited

Referenced by nidas::core::DSMSensor::deleteLooper(), and nidas::core::DSMSensor::getLooper().

◆ _maxScanfFields

int nidas::core::CharacterSensor::_maxScanfFields

privateinherited

Referenced by nidas::core::CharacterSensor::getMaxScanfFields(), and nidas::core::CharacterSensor::init().

◆ _messageLength

int nidas::core::CharacterSensor::_messageLength

privateinherited

Referenced by nidas::core::CharacterSensor::getMessageLength(), and nidas::core::CharacterSensor::setMessageParameters().

◆ _messageSeparator

std::string nidas::core::CharacterSensor::_messageSeparator

privateinherited

Referenced by nidas::core::CharacterSensor::getBackslashedMessageSeparator(), nidas::core::CharacterSensor::getMessageSeparator(), and nidas::core::CharacterSensor::setMessageParameters().

◆ _nextSscanfer

std::list<AsciiSscanf*>::const_iterator nidas::core::CharacterSensor::_nextSscanfer

privateinherited

Referenced by nidas::core::CharacterSensor::init().

◆ _nTimeouts

int nidas::core::DSMSensor::_nTimeouts

privateinherited

Referenced by nidas::core::DSMSensor::getTimeoutCount(), and nidas::core::DSMSensor::incrementTimeoutCount().

◆ _openable

bool nidas::core::DSMSensor::_openable

protectedinherited

Whether this sensor is allowed to be opened.

Most cases the answer is yes/true. But certain sensors should not be opened due to implementation. e.g. DSMArincSensor when used in conjunction with the UDPArincSensor for then Alta ENET appliance.

The fallout from setting this to false is that the sensor will not be added to SensorHandler.

Referenced by nidas::core::DSMSensor::allowOpen(), and nidas::dynld::raf::DSMArincSensor::fromDOMElement().

◆ _parameters

std::map<std::string,Parameter*> nidas::core::DSMSensor::_parameters

privateinherited

Map of parameters by name.

Referenced by nidas::core::DSMSensor::addParameter(), nidas::core::DSMSensor::getParameter(), and nidas::core::DSMSensor::~DSMSensor().

◆ _prompted

bool nidas::core::CharacterSensor::_prompted

privateinherited

Referenced by nidas::core::CharacterSensor::addPrompt(), nidas::core::CharacterSensor::isPrompted(), and nidas::core::CharacterSensor::validate().

◆ _prompters

std::list<Prompter*> nidas::core::SerialSensor::_prompters

privateinherited

Referenced by nidas::core::SerialSensor::initPrompting(), nidas::core::SerialSensor::shutdownPrompting(), nidas::core::SerialSensor::startPrompting(), nidas::core::SerialSensor::stopPrompting(), and nidas::core::SerialSensor::~SerialSensor().

◆ _prompting

bool nidas::core::SerialSensor::_prompting

privateinherited

Referenced by nidas::core::SerialSensor::isPrompting(), nidas::core::SerialSensor::startPrompting(), and nidas::core::SerialSensor::stopPrompting().

◆ _promptOffset

double nidas::core::CharacterSensor::_promptOffset

privateinherited

Referenced by nidas::core::CharacterSensor::getPromptOffset(), and nidas::core::CharacterSensor::setPromptOffset().

◆ _promptRate

double nidas::core::CharacterSensor::_promptRate

privateinherited

Referenced by nidas::core::CharacterSensor::getPromptRate(), and nidas::core::CharacterSensor::setPromptRate().

◆ _prompts

std::list<Prompt> nidas::core::CharacterSensor::_prompts

privateinherited

Referenced by nidas::core::CharacterSensor::addPrompt(), and nidas::core::CharacterSensor::getPrompts().

◆ _promptString

std::string nidas::core::CharacterSensor::_promptString

privateinherited

Referenced by nidas::core::CharacterSensor::getPromptString(), and nidas::core::CharacterSensor::setPromptString().

◆ _rawSampleTag

SampleTag nidas::core::DSMSensor::_rawSampleTag

privateinherited

Referenced by nidas::core::DSMSensor::fromDOMElement(), and nidas::core::DSMSensor::getRawSampleTag().

◆ _rawSource

SampleSourceSupport nidas::core::DSMSensor::_rawSource

privateinherited

Referenced by nidas::core::DSMSensor::distributeRaw(), nidas::core::DSMSensor::fromDOMElement(), nidas::core::DSMSensor::getRawSampleSource(), and nidas::core::DSMSensor::readSamples().

◆ _rts485

int nidas::core::SerialSensor::_rts485

privateinherited

Should the RTS line on this port be controled for half-duplex 485? See SerialPortIODevice.h.

Referenced by nidas::core::SerialSensor::buildIODevice(), and nidas::core::SerialSensor::fromDOMElement().

◆ _sampleTags

std::list<SampleTag*> nidas::core::DSMSensor::_sampleTags

privateinherited

Referenced by nidas::core::DSMSensor::addSampleTag(), nidas::core::DSMSensor::fromDOMElement(), nidas::core::DSMSensor::getNonConstSampleTags(), nidas::core::DSMSensor::getSampleTags(), nidas::core::DSMSensor::removeSampleTag(), nidas::core::DSMSensor::setStation(), and nidas::core::DSMSensor::~DSMSensor().

◆ _scanfFailures

int nidas::core::CharacterSensor::_scanfFailures

privateinherited

Referenced by nidas::core::CharacterSensor::getNumScanfFailures().

◆ _scanfPartials

int nidas::core::CharacterSensor::_scanfPartials

privateinherited

Referenced by nidas::core::CharacterSensor::getNumScanfPartials().

◆ _scanner

SampleScanner* nidas::core::DSMSensor::_scanner

privateinherited

◆ _separatorAtEOM

bool nidas::core::CharacterSensor::_separatorAtEOM

privateinherited

Referenced by nidas::core::CharacterSensor::getMessageSeparatorAtEOM(), and nidas::core::CharacterSensor::setMessageParameters().

◆ _serialDevice

SerialPortIODevice* nidas::core::SerialSensor::_serialDevice

privateinherited

Non-null if the underlying IODevice is a SerialPortIODevice.

Referenced by nidas::core::SerialSensor::applyTermios(), nidas::core::SerialSensor::buildIODevice(), and nidas::core::SerialSensor::getUsecsPerByte().

◆ _source

SampleSourceSupport nidas::core::DSMSensor::_source

privateinherited

Referenced by nidas::core::DSMSensor::addSampleClient(), nidas::core::DSMSensor::addSampleClientForTag(), nidas::core::DSMSensor::addSampleTag(), nidas::core::DSMSensor::getClientCount(), nidas::core::DSMSensor::getSampleStats(), nidas::core::DSMSensor::getSampleTags(), nidas::core::DSMSensor::receive(), nidas::core::DSMSensor::removeSampleClient(), nidas::core::DSMSensor::removeSampleClientForTag(), and nidas::core::DSMSensor::removeSampleTag().

◆ _speedDirId

dsm_sample_id_t nidas::dynld::WxtSensor::_speedDirId

private

ID of sample containing wind speed, direction.

Referenced by init().

◆ _speedIndex

int nidas::dynld::WxtSensor::_speedIndex

private

Index of wind speed in output sample.

Referenced by init().

◆ _sscanfers

std::list<AsciiSscanf*> nidas::core::CharacterSensor::_sscanfers

privateinherited

Referenced by nidas::core::CharacterSensor::getScanfers(), nidas::core::CharacterSensor::init(), nidas::core::CharacterSensor::validateSscanfs(), and nidas::core::CharacterSensor::~CharacterSensor().

◆ _station

int nidas::core::DSMSensor::_station

privateinherited

Referenced by nidas::core::DSMSensor::getStation(), and nidas::core::DSMSensor::setStation().

◆ _suffix

std::string nidas::core::DSMSensor::_suffix

privateinherited

Sensor suffix, which is added to variable names.

Referenced by nidas::core::DSMSensor::getSuffix(), and nidas::core::DSMSensor::setSuffix().

◆ _termios

nidas::util::Termios nidas::core::SerialSensor::_termios

privateinherited

Serial I/O parameters.

Referenced by nidas::core::SerialSensor::applyTermios(), nidas::core::SerialSensor::buildIODevice(), nidas::core::SerialSensor::fromDOMElement(), nidas::core::SerialSensor::getTermios(), nidas::core::SerialSensor::SerialSensor(), and nidas::core::SerialSensor::termios().

◆ _timeoutMsecs

int nidas::core::DSMSensor::_timeoutMsecs

privateinherited

Referenced by nidas::core::DSMSensor::getTimeoutMsecs(), and nidas::core::DSMSensor::setTimeoutMsecs().

◆ _ttadjusters

std::map<const SampleTag*, TimetagAdjuster*> nidas::core::CharacterSensor::_ttadjusters

protectedinherited

Referenced by nidas::core::CharacterSensor::adjustTimeTag(), nidas::core::CharacterSensor::init(), and nidas::core::CharacterSensor::~CharacterSensor().

◆ _typeName

std::string nidas::core::DSMSensor::_typeName

privateinherited

Referenced by nidas::core::DSMSensor::getTypeName(), and nidas::core::DSMSensor::setTypeName().

◆ _uIndex

int nidas::dynld::WxtSensor::_uIndex

private

Index of wind u component in output sample.

Referenced by init(), and wxtValidateSscanfs().

◆ _uName

std::string nidas::dynld::WxtSensor::_uName

private

Initial characters in wind U component variable name.

Referenced by getUName(), and setUName().

◆ _uvId

dsm_sample_id_t nidas::dynld::WxtSensor::_uvId

private

ID of sample containing wind U,V components.

Referenced by init(), and wxtValidateSscanfs().

◆ _uvlen

int nidas::dynld::WxtSensor::_uvlen

private

Length of output U,V sample.

Referenced by init().

◆ _vIndex

int nidas::dynld::WxtSensor::_vIndex

private

Index of wind v component in output sample.

Referenced by init(), and wxtValidateSscanfs().

◆ _vName

std::string nidas::dynld::WxtSensor::_vName

private

Initial characters in wind V component variable name.

Referenced by getVName(), and setVName().

◆ namespaceURI

XMLCh * DOMable::namespaceURI = 0

staticprivateinherited

Referenced by nidas::core::DOMable::getNamespaceURI().

◆ zebra

bool DSMSensor::zebra = false

staticprivateinherited

Referenced by nidas::core::DSMSensor::printStatus(), and nidas::core::DSMSensor::printStatusHeader().

The documentation for this class was generated from the following files:

nidas/dynld/WxtSensor.h
nidas/dynld/WxtSensor.cc

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ WxtSensor()

◆ ~WxtSensor()

Member Function Documentation

◆ addCalFile()

◆ addParameter()

◆ addPrompt()

◆ addSampleClient()

◆ addSampleClientForTag()

◆ addSampleTag() [1/2]

◆ addSampleTag() [2/2]

◆ adjustTimeTag()

◆ allowOpen()

◆ applyConversions()

◆ applyTermios()

◆ buildIODevice()

◆ buildSampleScanner()

◆ calcStatistics()

◆ clearBuffer()

◆ close()

◆ deleteLooper()

◆ distributeRaw()

◆ doesAsciiSscanfs()

◆ executeXmlRpc()

◆ expandString()

◆ findVariableIndex()

◆ flush()

◆ fromDOMElement()

◆ getApplyVariableConversions()

◆ getBackslashedMessageSeparator()

◆ getBadTimeTagCount()

◆ getBytesAvailable()

◆ getCalFile()

◆ getCalFiles()

◆ getCatalogName()

◆ getClassName() [1/2]

◆ getClassName() [2/2]

◆ getClientCount()

◆ getDefaultMode()

◆ getDepth()

◆ getDepthString()

◆ getDeviceName()

◆ getDictionary()

◆ getDriverTimeTagUsecs()

◆ getDSMConfig()

◆ getDSMId()

◆ getDSMName()

◆ getDuplicateIdOK()

◆ getFullSuffix()

◆ getHeight()

◆ getHeightString()

◆ getId()

◆ getInitString()

◆ getIODevice()

◆ getLagSecs()

◆ getLagUsecs()

◆ getLatency()

◆ getLocation()

◆ getLooper()

◆ getMaxSampleLength()

◆ getMaxScanfFields()

◆ getMessageLength()

◆ getMessageSeparator()

◆ getMessageSeparatorAtEOM()

◆ getMinSampleLength()

◆ getName()

◆ getNamespaceURI()

◆ getNonConstSampleTags()

◆ getNullTerminated()

◆ getNumScanfFailures()

◆ getNumScanfPartials()