Atlas EZO-pH module

Sensor Datasheet

Documentation on the probe and measurement circuit are found here: https://www.atlas-scientific.com/ph.html

Sensor Constructors

Example Code

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

#include <sensors/AtlasScientificpH.h>

// NOTE: Use -1 for any pins that don't apply or aren't being used.
const int8_t AtlaspHPower    = sensorPowerPin;  // Power pin
uint8_t      AtlaspHi2c_addr = 0x63;            // Default for pH is 0x63 (99)
// 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 pH sensor object
// AtlasScientificpH atlaspH(AtlaspHPower, AtlaspHi2c_addr);
AtlasScientificpH atlaspH(AtlaspHPower);

// Create a pH variable pointer for the pH sensor
Variable* atlaspHpH =
    new AtlasScientificpH_pH(&atlaspH, "12345678-abcd-1234-ef00-1234567890ab");

Classes

class AtlasScientificpH

The Sensor sub-class for the Atlas Scientific pH sensor.

class AtlasScientificpH_pH

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

Defines

#define ATLAS_PH_I2C_ADDR = 0x63

Default I2C address is 0x63 (99)

#define ATLAS_PH_NUM_VARIABLES = 1

Sensor::_numReturnedValues; the Atlas EZO pH circuit can report 1 value.

#define ATLAS_PH_INC_CALC_VARIABLES = 0

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

Sensor Timing

The sensor timing for an Atlas pH sensor

#define ATLAS_PH_WARM_UP_TIME_MS = 850

Sensor::_warmUpTime_ms; the Atlas EZO pH circuit warms up in 850ms.

846 in SRGD Tests

#define ATLAS_PH_STABILIZATION_TIME_MS = 0

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

#define ATLAS_PH_MEASUREMENT_TIME_MS = 1660

Sensor::_measurementTime_ms; the Atlas EZO pH circuit takes 1660ms to complete a measurement.

pH

The pH variable from an Atlas pH sensor

• Accuracy is ± 0.002
• Range is 0.001 − 14.000 (ATLAS_PH_RESOLUTION = 3)
• Reported as dimensionless pH units

#define ATLAS_PH_RESOLUTION = 3

Decimals places in string representation; pH should have 3 - resolution is 0.001.

#define ATLAS_PH_VAR_NUM = 0

Sensor variable number; pH is stored in sensorValues[0].

#define ATLAS_PH_VAR_NAME = "pH"

Variable name in ODM2 controlled vocabulary; "pH".

#define ATLAS_PH_UNIT_NAME = "pH"

Variable unit name in ODM2 controlled vocabulary; "pH" (dimensionless pH units)

#define ATLAS_PH_DEFAULT_CODE = "AtlaspH"

Default variable short code; "AtlaspH".