AnalogElecConductivity class
Class for the analog [Electrical Conductivity monitor](Conductivity via Analog Electrical Resistance)
- Reference
- Detailed Descriptions
Base classes
- class Sensor
- The "Sensor" class is used for all sensor-level operations - waking, sleeping, and taking measurements.
Constructors, destructors, conversion operators
- AnalogElecConductivity(int8_t powerPin, int8_t dataPin, float Rseries_ohms = 499, float sensorEC_Konst = 1.0, uint8_t measurementsToAverage = 1)
- Construct a new AnalogElecConductivity object.
- ~AnalogElecConductivity()
- Destroy the AnalogElecConductivity object - no action needed.
Public functions
- String getSensorLocation(void) -> String override
- Report the sensor info.
- bool addSingleMeasurementResult(void) -> bool override
- Get the results from a single measurement.
- void setEC_k(float sourceResistance_ohms)
- Set EC constants for internal calculations. Needs to be set at startup if different from defaults.
- float readEC(void) -> float
- reads the calculated EC from an analog pin using the analog pin number set in the constructor.
- float readEC(uint8_t analogPinNum) -> float
- reads the calculated EC from an analog pin.
Function documentation
AnalogElecConductivity:: AnalogElecConductivity(int8_t powerPin,
int8_t dataPin,
float Rseries_ohms = 499,
float sensorEC_Konst = 1.0,
uint8_t measurementsToAverage = 1)
Construct a new AnalogElecConductivity object.
Parameters | |
---|---|
powerPin | The port pin providing power to the EC probe. Needs to be switched, and assumed to be same V as the dataPin's ADC. |
dataPin | The processor ADC port pin to read the voltage from the EC probe. Not all processor pins can be used as analog pins. Those usable as analog pins generally are numbered with an "A" in front of the number
|
Rseries_ohms | The resistance of the resistor series (R) in the line; optional with default value of 499. |
sensorEC_Konst | The cell constant for the sensing circuit; optional with default value of 2.88 - which is what has been measured for a typical standard sized lamp-type plug. |
measurementsToAverage | The number of measurements to average; optional with default value of 1. |
String AnalogElecConductivity:: getSensorLocation(void) override
Report the sensor info.
Returns | String Text describing how the sensor is attached to the mcu. |
---|
bool AnalogElecConductivity:: addSingleMeasurementResult(void) override
Get the results from a single measurement.
Returns | bool True if the function completed successfully. |
---|
This asks the sensor for a new result, verifies that it passes sanity range checks, and then adds the value to the result array.
This also un-sets the _
void AnalogElecConductivity:: setEC_k(float sourceResistance_ohms)
Set EC constants for internal calculations. Needs to be set at startup if different from defaults.
Parameters | |
---|---|
sourceResistance_ohms | series R used in calculations for EC |
other possible K, not specified yet: float appliedV_V, uint8_t probeType
float AnalogElecConductivity:: readEC(void)
reads the calculated EC from an analog pin using the analog pin number set in the constructor.
Returns | float The electrical conductance value |
---|
float AnalogElecConductivity:: readEC(uint8_t analogPinNum)
reads the calculated EC from an analog pin.
Parameters | |
---|---|
analogPinNum | Analog port pin number |
Returns | float The electrical conductance value |