EZO sensor circuits

The ezo sensor platform allows you to use your EZO sensor circuits with ESPHome. The I²C Bus is required to be set up in your configuration for this sensor to work. All embedded solutions from EZO can be found on their website. If a certain command is not supported directly, it can be executed with the send_custom() method call.

# Example configuration entry
sensor:

  - platform: ezo
    id: ph_ezo
    address: 99
    unit_of_measurement: "pH"
    update_interval: 10s

  - platform: ezo
    id: rtd_ezo
    name: "RTD Temperature"
    address: 102
    accuracy_decimals: 2
    unit_of_measurement: "°C"
    update_interval: 10s

Configuration variables

address (Required, int): Specify the I²C address of the sensor.
update_interval (Optional, Time): The interval to check the sensor. Defaults to 60s.
All other options from Sensor.

Automation triggers:

on_led (Optional, Action): Triggered when the result of get_led_state() is ready. The LED state is provided as a boolean variable named x.
on_device_information (Optional, Action): Triggered when the result of get_device_information() is ready. The result is provided as a std::string variable named x.
on_slope (Optional, Action): Triggered when the result of get_slope() is ready. The result is provided as a std::string variable named x.
on_calibration (Optional, Action): Triggered when the result of get_calibration() is ready. The result is provided as a std::string variable named x.
on_t (Optional, Action): Triggered when the result of get_t() is ready. The result is provided as a std::string variable named x.
on_custom (Optional, Action): Triggered when the result of get_custom() is ready. The result is provided as a std::string variable named x.

Lambda calls

From lambdas, you can interact with the sensor in various ways. For any get command a trigger will be called with the information retrieved from the sensor. For more information on the command specifics, refer to the datasheet.

set_i2c(uint8_t address) : Set I2C address of the device, must be an integer between 1 and 127

    id(ph_ezo).set_i2c(100);

get_device_information() : Sensor retrieves calibration and triggers on_device_information: once done

    id(ph_ezo).get_device_information();

set_sleep() : Put the device to sleep

    id(ph_ezo).set_sleep();

get_state() : Performs a read on the current sensor.

    id(ph_ezo).get_state();

get_slope() : Sensor retrieves slope and triggers on_slope: once done

    id(ph_ezo).get_slope();

get_t() : Sensor retrieves temperature compensation value (in Celcius) and triggers on_t: once done

    id(ph_ezo).get_t();

set_t(float value) : Send the given temperature (in Celcius) to the sensor.

    id(ph_ezo).set_t("27.00");

set_tempcomp_value(float temp) : Send the given temperature (in Celcius) to the sensor (this is an alias of set_t() for backwards compatibility)

    id(ph_ezo).set_tempcomp_value(id(rtd_ezo).state);

get_calibration() : Sensor retrieves calibration and triggers on_calibration: once done

    id(ph_ezo).get_calibration();

set_calibration_generic(float value) : Sets the calibration with no point.

    id(ph_ezo).set_calibration_generic(750.0);

set_calibration_point_low(float value) : Sets the low calibration point.

    id(ph_ezo).set_calibration_point_low(4.00);

set_calibration_point_mid(float value) : Sets the medium calibration point.

    id(ph_ezo).set_calibration_point_mid(7.00);

set_calibration_point_high(float value) : Sets the high calibration point.

    id(ph_ezo).set_calibration_point_high(10.00);

clear_calibration() : Clears all calibration points.

    id(ph_ezo).clear_calibration();

get_led_state() : Sensor LED state and triggers on_led: once done

    id(ph_ezo).get_led_state();

set_led_state(bool on) : Sensor LED on or off

    id(ph_ezo).set_led_state(true);

send_custom(const std::string &payload, uint16_t delay_ms = 300, bool response_expected = false) : Runs a custom command. This sends exactly what is in payload. Optionally you can set a delay and if a response is expected that should be parsed. Defaults to false for custom commands. Triggers on_custom: if there’s a response.

    // Run a custom command to turn on the LED
    id(ph_ezo).send_custom("L,1");