Public Member Functions | Static Public Member Functions | Static Public Attributes | Protected Member Functions | Protected Attributes | Friends | List of all members
YGenericSensor Class Reference

#include <yocto_genericsensor.h>

Inheritance diagram for YGenericSensor:
Inheritance graph
[legend]

Public Member Functions

virtual int _invokeTimedReportCallback (YMeasure value)
 
virtual int _invokeValueCallback (string value)
 
double get_signalBias (void)
 
string get_signalRange (void)
 
Y_SIGNALSAMPLING_enum get_signalSampling (void)
 
string get_signalUnit (void)
 
double get_signalValue (void)
 
string get_valueRange (void)
 
YGenericSensornext (void)
 
YGenericSensornextGenericSensor (void)
 
virtual int registerTimedReportCallback (YGenericSensorTimedReportCallback callback)
 
virtual int registerValueCallback (YGenericSensorValueCallback callback)
 
int set_signalBias (double newval)
 
int set_signalRange (const string &newval)
 
int set_signalSampling (Y_SIGNALSAMPLING_enum newval)
 
int set_unit (const string &newval)
 
int set_valueRange (const string &newval)
 
int setSignalBias (double newval)
 
int setSignalRange (const string &newval)
 
int setSignalSampling (Y_SIGNALSAMPLING_enum newval)
 
int setUnit (const string &newval)
 
int setValueRange (const string &newval)
 
double signalBias (void)
 
string signalRange (void)
 
Y_SIGNALSAMPLING_enum signalSampling (void)
 
string signalUnit (void)
 
double signalValue (void)
 
string valueRange (void)
 
virtual int zeroAdjust (void)
 
 ~YGenericSensor ()
 
- Public Member Functions inherited from YSensor
virtual double _applyCalibration (double rawValue)
 
virtual double _decodeAvg (int dw)
 
virtual YMeasure _decodeTimedReport (double timestamp, vector< int > report)
 
virtual double _decodeVal (int w)
 
virtual string _encodeCalibrationPoints (vector< double > rawValues, vector< double > refValues)
 
virtual int _parserHelper (void)
 
Y_ADVMODE_enum advMode (void)
 
virtual int calibrateFromPoints (vector< double > rawValues, vector< double > refValues)
 
string calibrationParam (void)
 
double currentRawValue (void)
 
double currentValue (void)
 
Y_ADVMODE_enum get_advMode (void)
 
string get_calibrationParam (void)
 
double get_currentRawValue (void)
 
double get_currentValue (void)
 
virtual YDataLoggerget_dataLogger (void)
 
double get_highestValue (void)
 
string get_logFrequency (void)
 
double get_lowestValue (void)
 
virtual YDataSet get_recordedData (s64 startTime, s64 endTime)
 
string get_reportFrequency (void)
 
double get_resolution (void)
 
int get_sensorState (void)
 
string get_unit (void)
 
double highestValue (void)
 
virtual bool isSensorReady (void)
 
virtual int loadCalibrationPoints (vector< double > &rawValues, vector< double > &refValues)
 
string logFrequency (void)
 
double lowestValue (void)
 
YSensornext (void)
 
YSensornextSensor (void)
 
virtual int registerTimedReportCallback (YSensorTimedReportCallback callback)
 
virtual int registerValueCallback (YSensorValueCallback callback)
 
string reportFrequency (void)
 
double resolution (void)
 
int sensorState (void)
 
int set_advMode (Y_ADVMODE_enum newval)
 
int set_calibrationParam (const string &newval)
 
int set_highestValue (double newval)
 
int set_logFrequency (const string &newval)
 
int set_lowestValue (double newval)
 
int set_reportFrequency (const string &newval)
 
int set_resolution (double newval)
 
int setAdvMode (Y_ADVMODE_enum newval)
 
int setCalibrationParam (const string &newval)
 
int setHighestValue (double newval)
 
int setLogFrequency (const string &newval)
 
int setLowestValue (double newval)
 
int setReportFrequency (const string &newval)
 
int setResolution (double newval)
 
virtual int startDataLogger (void)
 
virtual int stopDataLogger (void)
 
string unit (void)
 
 ~YSensor ()
 
- Public Member Functions inherited from YFunction
void _clearDataStreamCache ()
 
string _decode_json_string (const string &json)
 
string _download (const string &url)
 
YDataStream_findDataStream (YDataSet &dataset, const string &def)
 
string _get_json_path (const string &json, const string &path)
 
vector< string > _json_get_array (const string &json)
 
string _json_get_key (const string &json, const string &data)
 
string _json_get_string (const string &json)
 
int _parseEx (yJsonStateMachine &j)
 
string _parseString (yJsonStateMachine &j)
 
string _request (const string &request)
 
string _requestEx (int tcpchan, const string &request, yapiRequestProgressCallback callback, void *context)
 
void _throw (YRETCODE errType, string errMsg)
 
YRETCODE _upload (const string &path, const string &content)
 
YRETCODE _uploadWithProgress (const string &path, const string &content, yapiRequestProgressCallback callback, void *context)
 
string advertisedValue (void)
 
void clearCache ()
 
string describe (void)
 
string errMessage (void)
 
string errorMessage (void)
 
YRETCODE errorType (void)
 
YRETCODE errType (void)
 
YFUN_DESCR functionDescriptor (void)
 
string get_advertisedValue (void)
 
string get_errorMessage (void)
 
YRETCODE get_errorType (void)
 
virtual string get_friendlyName (void)
 
YFUN_DESCR get_functionDescriptor (void)
 
string get_functionId (void)
 
string get_hardwareId (void)
 
string get_hubSerial ()
 
string get_logicalName (void)
 
YModuleget_module (void)
 
void * get_userData (void)
 
bool isOnline (void)
 
YRETCODE load (int msValidity)
 
virtual string loadAttribute (string attrName)
 
string logicalName (void)
 
YModulemodule (void)
 
virtual int muteValueCallbacks (void)
 
YFunctionnext (void)
 
YFunctionnextFunction (void)
 
virtual int registerValueCallback (YFunctionValueCallback callback)
 
int set_advertisedValue (const string &newval)
 
int set_logicalName (const string &newval)
 
void set_userData (void *data)
 
int setAdvertisedValue (const string &newval)
 
int setLogicalName (const string &newval)
 
void setUserData (void *data)
 
virtual int unmuteValueCallbacks (void)
 
void * userData (void)
 
virtual ~YFunction ()
 

Static Public Member Functions

static YGenericSensorFind (string func)
 
static YGenericSensorFindGenericSensor (string func)
 
static YGenericSensorFirst (void)
 
static YGenericSensorFirstGenericSensor (void)
 
- Static Public Member Functions inherited from YSensor
static YSensorFind (string func)
 
static YSensorFindSensor (string func)
 
static YSensorFirst (void)
 
static YSensorFirstSensor (void)
 
- Static Public Member Functions inherited from YFunction
static void _ClearCache (void)
 
static YFunctionFind (string func)
 
static YFunctionFindFunction (string func)
 
static YFunctionFirst (void)
 
static YFunctionFirstFunction (void)
 

Static Public Attributes

static const double SIGNALBIAS_INVALID = YAPI_INVALID_DOUBLE
 
static const string SIGNALRANGE_INVALID = YAPI_INVALID_STRING
 
static const Y_SIGNALSAMPLING_enum SIGNALSAMPLING_HIGH_RATE = Y_SIGNALSAMPLING_HIGH_RATE
 
static const Y_SIGNALSAMPLING_enum SIGNALSAMPLING_HIGH_RATE_FILTERED = Y_SIGNALSAMPLING_HIGH_RATE_FILTERED
 
static const Y_SIGNALSAMPLING_enum SIGNALSAMPLING_INVALID = Y_SIGNALSAMPLING_INVALID
 
static const Y_SIGNALSAMPLING_enum SIGNALSAMPLING_LOW_NOISE = Y_SIGNALSAMPLING_LOW_NOISE
 
static const Y_SIGNALSAMPLING_enum SIGNALSAMPLING_LOW_NOISE_FILTERED = Y_SIGNALSAMPLING_LOW_NOISE_FILTERED
 
static const string SIGNALUNIT_INVALID = YAPI_INVALID_STRING
 
static const double SIGNALVALUE_INVALID = YAPI_INVALID_DOUBLE
 
static const string VALUERANGE_INVALID = YAPI_INVALID_STRING
 
- Static Public Attributes inherited from YSensor
static const Y_ADVMODE_enum ADVMODE_IMMEDIATE = Y_ADVMODE_IMMEDIATE
 
static const Y_ADVMODE_enum ADVMODE_INVALID = Y_ADVMODE_INVALID
 
static const Y_ADVMODE_enum ADVMODE_PERIOD_AVG = Y_ADVMODE_PERIOD_AVG
 
static const Y_ADVMODE_enum ADVMODE_PERIOD_MAX = Y_ADVMODE_PERIOD_MAX
 
static const Y_ADVMODE_enum ADVMODE_PERIOD_MIN = Y_ADVMODE_PERIOD_MIN
 
static const string CALIBRATIONPARAM_INVALID = YAPI_INVALID_STRING
 
static const double CURRENTRAWVALUE_INVALID = YAPI_INVALID_DOUBLE
 
static const double CURRENTVALUE_INVALID = YAPI_INVALID_DOUBLE
 
static const double HIGHESTVALUE_INVALID = YAPI_INVALID_DOUBLE
 
static const string LOGFREQUENCY_INVALID = YAPI_INVALID_STRING
 
static const double LOWESTVALUE_INVALID = YAPI_INVALID_DOUBLE
 
static const string REPORTFREQUENCY_INVALID = YAPI_INVALID_STRING
 
static const double RESOLUTION_INVALID = YAPI_INVALID_DOUBLE
 
static const int SENSORSTATE_INVALID = YAPI_INVALID_INT
 
static const string UNIT_INVALID = YAPI_INVALID_STRING
 
- Static Public Attributes inherited from YFunction
static const string ADVERTISEDVALUE_INVALID = YAPI_INVALID_STRING
 
static const string FRIENDLYNAME_INVALID = YAPI_INVALID_STRING
 
static const YFUN_DESCR FUNCTIONDESCRIPTOR_INVALID = Y_FUNCTIONDESCRIPTOR_INVALID
 
static const string FUNCTIONID_INVALID = YAPI_INVALID_STRING
 
static const string HARDWAREID_INVALID = YAPI_INVALID_STRING
 
static const string LOGICALNAME_INVALID = YAPI_INVALID_STRING
 

Protected Member Functions

virtual int _parseAttr (YJSONObject *json_val)
 
 YGenericSensor (const string &func)
 
- Protected Member Functions inherited from YSensor
 YSensor (const string &func)
 
- Protected Member Functions inherited from YFunction
YRETCODE _buildSetRequest (const string &changeattr, const string *changeval, string &request, string &errmsg)
 
string _escapeAttr (const string &changeval)
 
YRETCODE _getDescriptor (YFUN_DESCR &fundescr, string &errMsg)
 
YRETCODE _getDevice (YDevice *&dev, string &errMsg)
 
YRETCODE _load_unsafe (int msValidity)
 
YRETCODE _nextFunction (string &hwId)
 
int _parse (YJSONObject *j)
 
YRETCODE _setAttr (string attrname, string newvalue)
 
 YFunction (const string &func)
 

Protected Attributes

double _signalBias
 
string _signalRange
 
Y_SIGNALSAMPLING_enum _signalSampling
 
string _signalUnit
 
double _signalValue
 
YGenericSensorTimedReportCallback _timedReportCallbackGenericSensor
 
YGenericSensorValueCallback _valueCallbackGenericSensor
 
string _valueRange
 
- Protected Attributes inherited from YSensor
Y_ADVMODE_enum _advMode
 
yCalibrationHandler _calhdl
 
string _calibrationParam
 
vector< int > _calpar
 
vector< double > _calraw
 
vector< double > _calref
 
int _caltyp
 
double _currentRawValue
 
double _currentValue
 
double _decexp
 
double _highestValue
 
double _iresol
 
bool _isScal
 
bool _isScal32
 
string _logFrequency
 
double _lowestValue
 
double _offset
 
double _prevTimedReport
 
string _reportFrequency
 
double _resolution
 
double _scale
 
int _sensorState
 
YSensorTimedReportCallback _timedReportCallbackSensor
 
string _unit
 
YSensorValueCallback _valueCallbackSensor
 
- Protected Attributes inherited from YFunction
string _advertisedValue
 
u64 _cacheExpiration
 
string _className
 
std::map< string, YDataStream * > _dataStreams
 
string _func
 
YFUN_DESCR _fundescr
 
string _funId
 
string _hwId
 
string _lastErrorMsg
 
YRETCODE _lastErrorType
 
string _logicalName
 
string _serial
 
yCRITICAL_SECTION _this_cs
 
void * _userData
 
YFunctionValueCallback _valueCallbackFunction
 

Friends

YGenericSensoryFindGenericSensor (const string &func)
 
YGenericSensoryFirstGenericSensor (void)
 

Additional Inherited Members

- Static Protected Member Functions inherited from YFunction
static void _AddToCache (const string &classname, const string &func, YFunction *obj)
 
static YFunction_FindFromCache (const string &classname, const string &func)
 
static void _UpdateTimedReportCallbackList (YFunction *func, bool add)
 
static void _UpdateValueCallbackList (YFunction *func, bool add)
 
- Static Protected Attributes inherited from YFunction
static std::map< string, YFunction * > _cache
 

Detailed Description

YGenericSensor Class: GenericSensor function interface

The YGenericSensor class allows you to read and configure Yoctopuce signal transducers. It inherits from YSensor class the core functions to read measurements, to register callback functions, to access the autonomous datalogger. This class adds the ability to configure the automatic conversion between the measured signal and the corresponding engineering unit.

Definition at line 84 of file yocto_genericsensor.h.

Constructor & Destructor Documentation

YGenericSensor::YGenericSensor ( const string &  func)
protected

Definition at line 51 of file yocto_genericsensor.cpp.

YGenericSensor::~YGenericSensor ( )

Definition at line 66 of file yocto_genericsensor.cpp.

Member Function Documentation

int YGenericSensor::_invokeTimedReportCallback ( YMeasure  value)
virtual

Reimplemented from YSensor.

Definition at line 536 of file yocto_genericsensor.cpp.

int YGenericSensor::_invokeValueCallback ( string  value)
virtual

Reimplemented from YSensor.

Definition at line 502 of file yocto_genericsensor.cpp.

int YGenericSensor::_parseAttr ( YJSONObject json_val)
protectedvirtual

Reimplemented from YSensor.

Definition at line 79 of file yocto_genericsensor.cpp.

static YGenericSensor* YGenericSensor::Find ( string  func)
inlinestatic

Definition at line 357 of file yocto_genericsensor.h.

YGenericSensor * YGenericSensor::FindGenericSensor ( string  func)
static

Retrieves a generic sensor for a given identifier. The identifier can be specified using several formats:

  • FunctionLogicalName
  • ModuleSerialNumber.FunctionIdentifier
  • ModuleSerialNumber.FunctionLogicalName
  • ModuleLogicalName.FunctionIdentifier
  • ModuleLogicalName.FunctionLogicalName

This function does not require that the generic sensor is online at the time it is invoked. The returned object is nevertheless valid. Use the method YGenericSensor.isOnline() to test if the generic sensor is indeed online at a given time. In case of ambiguity when looking for a generic sensor by logical name, no error is notified: the first instance found is returned. The search is performed first by hardware name, then by logical name.

If a call to this object's is_online() method returns FALSE although you are certain that the matching device is plugged, make sure that you did call registerHub() at application initialization time.

Parameters
func: a string that uniquely characterizes the generic sensor
Returns
a YGenericSensor object allowing you to drive the generic sensor.

Definition at line 451 of file yocto_genericsensor.cpp.

static YGenericSensor* YGenericSensor::First ( void  )
inlinestatic

Definition at line 381 of file yocto_genericsensor.h.

YGenericSensor * YGenericSensor::FirstGenericSensor ( void  )
static

Starts the enumeration of generic sensors currently accessible. Use the method YGenericSensor.nextGenericSensor() to iterate on next generic sensors.

Returns
a pointer to a YGenericSensor object, corresponding to the first generic sensor currently online, or a NULL pointer if there are none.

Definition at line 573 of file yocto_genericsensor.cpp.

double YGenericSensor::get_signalBias ( void  )

Returns the electric signal bias for zero shift adjustment. A positive bias means that the signal is over-reporting the measure, while a negative bias means that the signal is underreporting the measure.

Returns
a floating point number corresponding to the electric signal bias for zero shift adjustment

On failure, throws an exception or returns Y_SIGNALBIAS_INVALID.

Definition at line 334 of file yocto_genericsensor.cpp.

string YGenericSensor::get_signalRange ( void  )

Returns the electric signal range used by the sensor.

Returns
a string corresponding to the electric signal range used by the sensor

On failure, throws an exception or returns Y_SIGNALRANGE_INVALID.

Definition at line 196 of file yocto_genericsensor.cpp.

Y_SIGNALSAMPLING_enum YGenericSensor::get_signalSampling ( void  )

Returns the electric signal sampling method to use. The HIGH_RATE method uses the highest sampling frequency, without any filtering. The HIGH_RATE_FILTERED method adds a windowed 7-sample median filter. The LOW_NOISE method uses a reduced acquisition frequency to reduce noise. The LOW_NOISE_FILTERED method combines a reduced frequency with the median filter to get measures as stable as possible when working on a noisy signal.

Returns
a value among Y_SIGNALSAMPLING_HIGH_RATE, Y_SIGNALSAMPLING_HIGH_RATE_FILTERED, Y_SIGNALSAMPLING_LOW_NOISE and Y_SIGNALSAMPLING_LOW_NOISE_FILTERED corresponding to the electric signal sampling method to use

On failure, throws an exception or returns Y_SIGNALSAMPLING_INVALID.

Definition at line 370 of file yocto_genericsensor.cpp.

string YGenericSensor::get_signalUnit ( void  )

Returns the measuring unit of the electrical signal used by the sensor.

Returns
a string corresponding to the measuring unit of the electrical signal used by the sensor

On failure, throws an exception or returns Y_SIGNALUNIT_INVALID.

Definition at line 167 of file yocto_genericsensor.cpp.

double YGenericSensor::get_signalValue ( void  )

Returns the current value of the electrical signal measured by the sensor.

Returns
a floating point number corresponding to the current value of the electrical signal measured by the sensor

On failure, throws an exception or returns Y_SIGNALVALUE_INVALID.

Definition at line 138 of file yocto_genericsensor.cpp.

string YGenericSensor::get_valueRange ( void  )

Returns the physical value range measured by the sensor.

Returns
a string corresponding to the physical value range measured by the sensor

On failure, throws an exception or returns Y_VALUERANGE_INVALID.

Definition at line 250 of file yocto_genericsensor.cpp.

YGenericSensor* YGenericSensor::next ( void  )
inline

Definition at line 368 of file yocto_genericsensor.h.

YGenericSensor * YGenericSensor::nextGenericSensor ( void  )

Continues the enumeration of generic sensors started using yFirstGenericSensor().

Returns
a pointer to a YGenericSensor object, corresponding to a generic sensor currently online, or a NULL pointer if there are no more generic sensors to enumerate.

Definition at line 563 of file yocto_genericsensor.cpp.

int YGenericSensor::registerTimedReportCallback ( YGenericSensorTimedReportCallback  callback)
virtual

Registers the callback function that is invoked on every periodic timed notification. The callback is invoked only during the execution of ySleep or yHandleEvents. This provides control over the time when the callback is triggered. For good responsiveness, remember to call one of these two functions periodically. To unregister a callback, pass a NULL pointer as argument.

Parameters
callback: the callback function to call, or a NULL pointer. The callback function should take two arguments: the function object of which the value has changed, and an YMeasure object describing the new advertised value.

Definition at line 523 of file yocto_genericsensor.cpp.

int YGenericSensor::registerValueCallback ( YGenericSensorValueCallback  callback)
virtual

Registers the callback function that is invoked on every change of advertised value. The callback is invoked only during the execution of ySleep or yHandleEvents. This provides control over the time when the callback is triggered. For good responsiveness, remember to call one of these two functions periodically. To unregister a callback, pass a NULL pointer as argument.

Parameters
callback: the callback function to call, or a NULL pointer. The callback function should take two arguments: the function object of which the value has changed, and the character string describing the new advertised value.

Definition at line 483 of file yocto_genericsensor.cpp.

int YGenericSensor::set_signalBias ( double  newval)

Changes the electric signal bias for zero shift adjustment. If your electric signal reads positif when it should be zero, setup a positive signalBias of the same value to fix the zero shift.

Parameters
newval: a floating point number corresponding to the electric signal bias for zero shift adjustment
Returns
YAPI_SUCCESS if the call succeeds.

On failure, throws an exception or returns a negative error code.

Definition at line 309 of file yocto_genericsensor.cpp.

int YGenericSensor::set_signalRange ( const string &  newval)

Changes the electric signal range used by the sensor. Default value is "-999999.999...999999.999".

Parameters
newval: a string corresponding to the electric signal range used by the sensor
Returns
YAPI_SUCCESS if the call succeeds.

On failure, throws an exception or returns a negative error code.

Definition at line 227 of file yocto_genericsensor.cpp.

int YGenericSensor::set_signalSampling ( Y_SIGNALSAMPLING_enum  newval)

Changes the electric signal sampling method to use. The HIGH_RATE method uses the highest sampling frequency, without any filtering. The HIGH_RATE_FILTERED method adds a windowed 7-sample median filter. The LOW_NOISE method uses a reduced acquisition frequency to reduce noise. The LOW_NOISE_FILTERED method combines a reduced frequency with the median filter to get measures as stable as possible when working on a noisy signal.

Parameters
newval: a value among Y_SIGNALSAMPLING_HIGH_RATE, Y_SIGNALSAMPLING_HIGH_RATE_FILTERED, Y_SIGNALSAMPLING_LOW_NOISE and Y_SIGNALSAMPLING_LOW_NOISE_FILTERED corresponding to the electric signal sampling method to use
Returns
YAPI_SUCCESS if the call succeeds.

On failure, throws an exception or returns a negative error code.

Definition at line 408 of file yocto_genericsensor.cpp.

int YGenericSensor::set_unit ( const string &  newval)

Changes the measuring unit for the measured value. Remember to call the saveToFlash() method of the module if the modification must be kept.

Parameters
newval: a string corresponding to the measuring unit for the measured value
Returns
YAPI_SUCCESS if the call succeeds.

On failure, throws an exception or returns a negative error code.

Definition at line 114 of file yocto_genericsensor.cpp.

int YGenericSensor::set_valueRange ( const string &  newval)

Changes the physical value range measured by the sensor. As a side effect, the range modification may automatically modify the display resolution. Default value is "-999999.999...999999.999".

Parameters
newval: a string corresponding to the physical value range measured by the sensor
Returns
YAPI_SUCCESS if the call succeeds.

On failure, throws an exception or returns a negative error code.

Definition at line 282 of file yocto_genericsensor.cpp.

int YGenericSensor::setSignalBias ( double  newval)
inline

Definition at line 229 of file yocto_genericsensor.h.

int YGenericSensor::setSignalRange ( const string &  newval)
inline

Definition at line 188 of file yocto_genericsensor.h.

int YGenericSensor::setSignalSampling ( Y_SIGNALSAMPLING_enum  newval)
inline

Definition at line 282 of file yocto_genericsensor.h.

int YGenericSensor::setUnit ( const string &  newval)
inline

Definition at line 138 of file yocto_genericsensor.h.

int YGenericSensor::setValueRange ( const string &  newval)
inline

Definition at line 214 of file yocto_genericsensor.h.

double YGenericSensor::signalBias ( void  )
inline

Definition at line 243 of file yocto_genericsensor.h.

string YGenericSensor::signalRange ( void  )
inline

Definition at line 175 of file yocto_genericsensor.h.

Y_SIGNALSAMPLING_enum YGenericSensor::signalSampling ( void  )
inline

Definition at line 262 of file yocto_genericsensor.h.

string YGenericSensor::signalUnit ( void  )
inline

Definition at line 163 of file yocto_genericsensor.h.

double YGenericSensor::signalValue ( void  )
inline

Definition at line 151 of file yocto_genericsensor.h.

string YGenericSensor::valueRange ( void  )
inline

Definition at line 200 of file yocto_genericsensor.h.

int YGenericSensor::zeroAdjust ( void  )
virtual

Adjusts the signal bias so that the current signal value is need precisely as zero.

Returns
YAPI_SUCCESS if the call succeeds.

On failure, throws an exception or returns a negative error code.

Definition at line 554 of file yocto_genericsensor.cpp.

Friends And Related Function Documentation

YGenericSensor* yFindGenericSensor ( const string &  func)
friend

Retrieves a generic sensor for a given identifier. The identifier can be specified using several formats:

  • FunctionLogicalName
  • ModuleSerialNumber.FunctionIdentifier
  • ModuleSerialNumber.FunctionLogicalName
  • ModuleLogicalName.FunctionIdentifier
  • ModuleLogicalName.FunctionLogicalName

This function does not require that the generic sensor is online at the time it is invoked. The returned object is nevertheless valid. Use the method YGenericSensor.isOnline() to test if the generic sensor is indeed online at a given time. In case of ambiguity when looking for a generic sensor by logical name, no error is notified: the first instance found is returned. The search is performed first by hardware name, then by logical name.

If a call to this object's is_online() method returns FALSE although you are certain that the matching device is plugged, make sure that you did call registerHub() at application initialization time.

Parameters
func: a string that uniquely characterizes the generic sensor
Returns
a YGenericSensor object allowing you to drive the generic sensor.

Definition at line 418 of file yocto_genericsensor.h.

YGenericSensor* yFirstGenericSensor ( void  )
friend

Starts the enumeration of generic sensors currently accessible. Use the method YGenericSensor.nextGenericSensor() to iterate on next generic sensors.

Returns
a pointer to a YGenericSensor object, corresponding to the first generic sensor currently online, or a NULL pointer if there are none.

Definition at line 429 of file yocto_genericsensor.h.

Member Data Documentation

double YGenericSensor::_signalBias
protected

Definition at line 96 of file yocto_genericsensor.h.

string YGenericSensor::_signalRange
protected

Definition at line 94 of file yocto_genericsensor.h.

Y_SIGNALSAMPLING_enum YGenericSensor::_signalSampling
protected

Definition at line 97 of file yocto_genericsensor.h.

string YGenericSensor::_signalUnit
protected

Definition at line 93 of file yocto_genericsensor.h.

double YGenericSensor::_signalValue
protected

Definition at line 92 of file yocto_genericsensor.h.

YGenericSensorTimedReportCallback YGenericSensor::_timedReportCallbackGenericSensor
protected

Definition at line 99 of file yocto_genericsensor.h.

YGenericSensorValueCallback YGenericSensor::_valueCallbackGenericSensor
protected

Definition at line 98 of file yocto_genericsensor.h.

string YGenericSensor::_valueRange
protected

Definition at line 95 of file yocto_genericsensor.h.

const double YGenericSensor::SIGNALBIAS_INVALID = YAPI_INVALID_DOUBLE
static

Definition at line 119 of file yocto_genericsensor.h.

const string YGenericSensor::SIGNALRANGE_INVALID = YAPI_INVALID_STRING
static

Definition at line 117 of file yocto_genericsensor.h.

const Y_SIGNALSAMPLING_enum YGenericSensor::SIGNALSAMPLING_HIGH_RATE = Y_SIGNALSAMPLING_HIGH_RATE
static

Definition at line 120 of file yocto_genericsensor.h.

const Y_SIGNALSAMPLING_enum YGenericSensor::SIGNALSAMPLING_HIGH_RATE_FILTERED = Y_SIGNALSAMPLING_HIGH_RATE_FILTERED
static

Definition at line 121 of file yocto_genericsensor.h.

const Y_SIGNALSAMPLING_enum YGenericSensor::SIGNALSAMPLING_INVALID = Y_SIGNALSAMPLING_INVALID
static

Definition at line 124 of file yocto_genericsensor.h.

const Y_SIGNALSAMPLING_enum YGenericSensor::SIGNALSAMPLING_LOW_NOISE = Y_SIGNALSAMPLING_LOW_NOISE
static

Definition at line 122 of file yocto_genericsensor.h.

const Y_SIGNALSAMPLING_enum YGenericSensor::SIGNALSAMPLING_LOW_NOISE_FILTERED = Y_SIGNALSAMPLING_LOW_NOISE_FILTERED
static

Definition at line 123 of file yocto_genericsensor.h.

const string YGenericSensor::SIGNALUNIT_INVALID = YAPI_INVALID_STRING
static

Definition at line 116 of file yocto_genericsensor.h.

const double YGenericSensor::SIGNALVALUE_INVALID = YAPI_INVALID_DOUBLE
static

Definition at line 115 of file yocto_genericsensor.h.

const string YGenericSensor::VALUERANGE_INVALID = YAPI_INVALID_STRING
static

Definition at line 118 of file yocto_genericsensor.h.


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


yoctopuce_altimeter
Author(s): Anja Sheppard
autogenerated on Mon Jun 10 2019 15:49:13