Atlas EZO-DO module

Sensor Datasheet

Documentation on the probe is found here: https://www.atlas-scientific.com/probes/dissolved-oxygen-probe/

Documentation on the measurement circuit is found here: https://www.atlas-scientific.com/circuits/ezo-dissolved-oxygen-circuit/

Sensor Constructors

Example Code

The Atlas DO sensor is used in the menu a la carte example.

#include <sensors/AtlasScientificDO.h>

// NOTE: Use -1 for any pins that don't apply or aren't being used.
const int8_t AtlasDOPower    = sensorPowerPin;  // Power pin
uint8_t      AtlasDOi2c_addr = 0x61;            // Default for DO is 0x61 (97)
// All Atlas sensors have different default I2C addresses, but any of them can
// be re-addressed to any 8 bit number.  If using the default address for any
// Atlas Scientific sensor, you may omit this argument.

// Create an Atlas Scientific DO sensor object
// AtlasScientificDO atlasDO(AtlasDOPower, AtlasDOi2c_addr);
AtlasScientificDO atlasDO(AtlasDOPower);

// Create concentration and percent saturation variable pointers for the EZO-DO
Variable* atlasDOconc = new AtlasScientificDO_DOmgL(
    &atlasDO, "12345678-abcd-1234-ef00-1234567890ab");
Variable* atlasDOpct = new AtlasScientificDO_DOpct(
    &atlasDO, "12345678-abcd-1234-ef00-1234567890ab");

Classes

class AtlasScientificDO

The Sensor sub-class for the Atlas Scientific EZO dissolved oxygen circuit.

class AtlasScientificDO_DOmgL

The Variable sub-class used for the dissolved oxygen concentration output from an Atlas Scientific EZO dissolved oxygen circuit.

class AtlasScientificDO_DOpct

The Variable sub-class used for the dissolved oxygen percent of saturation output from an Atlas Scientific EZO dissolved oxygen circuit.

Defines

#define ATLAS_DO_NUM_VARIABLES = 2

Sensor::_numReturnedValues; the Atlas DO sensor can report 2 values.

#define ATLAS_DO_INC_CALC_VARIABLES = 0

Sensor::_incCalcValues; we don't calculate any additional values.

Sensor Timing

The sensor timing for an Atlas DO sensor

#define ATLAS_DO_WARM_UP_TIME_MS = 745

Sensor::_warmUpTime_ms; the Atlas DO sensor warms up in 745ms.

737-739 in tests

#define ATLAS_DO_STABILIZATION_TIME_MS = 0

Sensor::_stabilizationTime_ms; the Atlas DO sensor is stable at completion of warm up (0ms after warm-up).

#define ATLAS_DO_MEASUREMENT_TIME_MS = 600

Sensor::_measurementTime_ms; the Atlas DO sensor takes 600ms to complete a measurement.

only ~555 measurement time in tests, but keep the 600 recommended by manual

DO Concentration

The dissolved oxygen concentration from an Atlas DO sensor

• Accuracy is ± 0.05 mg/L
• Range is 0.01 − 100+ mg/L

#define ATLAS_DOMGL_RESOLUTION = 2

Decimals places in string representation; dissolved oxygen concentration should have 2 - resolution is 0.01 mg/L.

#define ATLAS_DOMGL_VAR_NUM = 0

Sensor variable number; dissolved oxygen concentration is stored in sensorValues[0].

#define ATLAS_DOMGL_VAR_NAME = "oxygenDissolved"

Variable name in ODM2 controlled vocabulary; "oxygenDissolved".

#define ATLAS_DOMGL_UNIT_NAME = "milligramPerLiter"

Variable unit name in ODM2 controlled vocabulary; "milligramPerLiter" (mg/L)

#define ATLAS_DOMGL_DEFAULT_CODE = "AtlasDOmgL"

Default variable short code; "AtlasDOmgL".

DO Percent Saturation

The dissolved oxygen percent saturation for an Atlas DO sensor

• Accuracy is ± 0.05 mg/L
• Range is 0.1 − 400+ % saturation

#define ATLAS_DOPCT_RESOLUTION = 1

Decimals places in string representation; dissolved oxygen percent should have 1 - resolution is 0.1 % saturation.

#define ATLAS_DOPCT_VAR_NUM = 1

Sensor variable number; dissolved oxygen percent is stored in sensorValues[1].

#define ATLAS_DOPCT_VAR_NAME = "oxygenDissolvedPercentOfSaturation"

Variable name in ODM2 controlled vocabulary; "oxygenDissolvedPercentOfSaturation".

#define ATLAS_DOPCT_UNIT_NAME = "percent"

Variable unit name in ODM2 controlled vocabulary; "percent" (percent saturation)

#define ATLAS_DOPCT_DEFAULT_CODE = "AtlasDOpct"

Default variable short code; "AtlasDOpct".