Skip to content

Calibration

Nicholas White edited this page Nov 30, 2024 · 23 revisions

AquaPi EZO Circuits Calibration Instructions

Tips:

  • These instructions assume you are using the Home Assistant UI or ESPHome Web Server. For everything mentioned below, you can use the entities in the AquaPi Device under Integrations in Home Assistant. There is a selector entity you use to select the command, and also a button to send that command. There is an entity that reads the output of that command.
  • You can also use actions under Developer Tools in Home Assistant to send specific calibration commands.
  • For probe calibration, always wait for reading to stabilize for at least 30 seconds before calibrating each step.
  • Add the cards at the end of this page for easier access to specific entities for calibration.

Store Link
Documentation

Send Commands using the button entity: button.aquapi_XXXXXX_do_command_send_selected or by using actions

Calibration Guide

  1. Using Entity: DO - Command Select, select Output Units - All (Default) and send the command.
  2. Calibrate in Air, aka dry or High. ~9.09 mg/L
  3. Calibrate at 0 mg/L, aka Low.
  4. Check calibration with command Check Calibration. The entity sensor.aquapi_XXXXXX_do_command_result will output 2 if followed above steps.
  5. For Saltwater tanks, run the Salinity Compensation Command. Salinity Compensation @ 35ppt
  6. Check salinity compensation with command Salinity Compensation Value. The entity sensor.aquapi_XXXXXX_do_command_result will output ?S,35.0,ppt if followed step 5 (saltwater tanks).

Store Link
Documentation

Send Commands using the button entity: button.aquapi_XXXXXX_ph_command_send_selected or by using actions

Calibration Guide

  1. Calibrate using Mid(7.0) Solution. Using Entity: pH - Command Select, select Calibrate @ MID = 7 (WILL RESET CALIBRATION) and send the command.
  2. Calibrate using Low(4.0) Solution. Using Entity: pH - Command Select, select Calibrate @ LOW = 4 (WILL RESET CALIBRATION) and send the command.
  3. Calibrate using High(10.0) Solution. Using Entity: pH - Command Select, select Calibrate @ HIGH = 10 (WILL RESET CALIBRATION) and send the command. (Can also use 10.01 solution and corresponding command)
  4. Check calibration with command Check Calibration. The entity sensor.aquapi_XXXXXX_ph_command_result will output 3 if followed above steps. (Can also calibrate using 2 points, and will output 2)

Datasheet
You will need a graduated cylinder and water. Assemble the Doser pump with tubes and connect to the AquaPi. You can prime the doser by using the Dose Continuously button. With graduated cylinder ready, dose a specific amount of volume into the cylinder and tell the EZO circuit what was actually dosed, then test by dosing a specific amount and see if it was expected.

Calibration Guide

  1. Input a specific amount into the Volume to Dose input number field. Example: 8, this may dose around 8 mL of liquid.
  2. Press the Dose Volume button to dose the liquid into the graduated cylinder.
  3. Input the actual amount dosed into the same Volume to Dose input number field above. Example: 6.4 mL was dosed, input 6.4 into the number field.
  4. Press the Set Calibration Volume button to save the amount for calibration. This will save it to the corresponding EZO-PMP cicuit.
  5. Test by inputting a specific amount into the Volume to Dose input number field and Dose Volume into the cylinder. Repeat steps above if inaccurate.

Example Cards for Calibration

Replace with your specific AquaPi device and sensor type (default below is for Salinity)

Generic Sensor Calibration Card:

type: entities
entities:
  - entity: sensor.aquapi_f2c1e4_conductivity
    name: Conductivity
  - entity: sensor.aquapi_f2c1e4_ec_raw_value
    name: Raw Value
  - entity: sensor.aquapi_f2c1e4_ec_command_result
    name: Command Result
  - entity: select.aquapi_f2c1e4_ec_command_select
    name: Command Select
  - entity: button.aquapi_f2c1e4_ec_command_send_selected
    name: Send Command
  - entity: button.aquapi_f2c1e4_ec_read
    name: Read Probe
header:
  type: graph
  entity: sensor.aquapi_f2c1e4_salinity
title: AquaPi Calibration for Conductivity

Read probe for about 60 seconds:

show_name: true
show_icon: true
type: button
tap_action:
  action: perform-action
  perform_action: esphome.aquapi_f2c1e4_ec_read_continous
  target: {}
icon: mdi:infinity
name: Read for 60s

Dissolved Oxygen Salinity Compensation:

show_name: true
show_icon: true
type: button
tap_action:
  action: perform-action
  perform_action: esphome.aquapi_f2c1e4_do_salinity_compensation_35ppt
  target: {}
  confirmation:
    text: Are you sure?
icon: mdi:shaker
name: Salinity Compensation