TallyCounterI2C.h file

Implements the TallyCounterI2C sensor subclass.

Contains the TallyCounterI2C sensor subclass and variable subclasse TallyCounterI2C_Events.

This file is for NorthernWidget's Tally external event counter, which is used to measure windspeed or rainfall from reed-switch analog sensors.

Classes

class TallyCounterI2C: The Sensor sub-class for the Tally Counter I2C.
class TallyCounterI2C_Events: The Variable sub-class used for the events output from a Tally Counter I2C - shows the number of events since last read.

#define TALLY_NUM_VARIABLES = 1: Sensor::_numReturnedValues; the Tally can report 1 value.
#define TALLY_INC_CALC_VARIABLES = 0: Sensor::_incCalcValues; we don't calculate any additional values.
#define TALLY_ADDRESS_BASE = 0x33: The default address of the Tally.

The sensor timing for a Northern Widget Tally event counter

Readings transferred from the reed-switch counting device (i.e. anemometer or tipping bucket) to the logger are from past events, so there is no need to wait for stability or measuring.

#define TALLY_WARM_UP_TIME_MS = 10: Sensor::_warmUpTime_ms; Tally warms up in <10 ms.
#define TALLY_STABILIZATION_TIME_MS = 10: Sensor::_stabilizationTime_ms; Tally is stable after <10ms.
#define TALLY_MEASUREMENT_TIME_MS = 10: Sensor::_measurementTime_ms; Tally takes <10ms to complete a measurement.

The events variable from a Northern Widget Tally event counter

Range and accuracy depend on the sensor used
- For wind, we often use [Inspeed WS2R Version II Reed Switch Anemometer] (https://www.store.inspeed.com/Inspeed-Version-II-Reed-Switch-Anemometer-Sensor-Only-WS2R.htm)

Construct a new TallyCounterI2C_Events object.

Parameters
parentSense	The parent TallyCounterI2C providing the result values.
uuid	A universally unique identifier (UUID or GUID) for the variable; optional with the default value of an empty string.
varCode	A short code to help identify the variable in files; optional with a default value of "TallyCounterI2CEvents".

#define TALLY_EVENTS_RESOLUTION = 0: Decimals places in string representation; events are an integer should be 0 - resolution is 1 event.
#define TALLY_EVENTS_VAR_NUM = 0: Sensor variable number; events is stored in sensorValues[0].
#define TALLY_EVENTS_VAR_NAME = "counter": Variable name in ODM2 controlled vocabulary; "counter".
#define TALLY_EVENTS_UNIT_NAME = "event": Variable unit name in ODM2 controlled vocabulary; "event".
#define TALLY_EVENTS_DEFAULT_CODE = "TallyCounterI2CEvents": Default variable short code; "TallyCounterI2CEvents".