Calibration

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 rinse off probe with RO or distilled water after using each calibration solution, shake well to release any air bubbles, and 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.
• If your device isn’t recognizing the EZO Circuit, open it up and make sure the white connector from the wire is properly secured. This can sometimes come loose.
• You can now send custom commands to the EZO circuit via actions (Developer Tools -> Actions). See the Atlas Scientific Documentation for each respective probe. For example, ESPHome: aquapi_XXXXXX_ec_custom_command, set command to R to read the probe, or Status to get general status of the circuit. Results will be updated via the entity sensor.aquapi_XXXXXX_ec_command_result. I may create a page with all the commands, but for now, use the documentation.

Dallas Temperature

This isn't necessary to do, but if you want more accurate results, calibrating can help. This can be a little more complicated. You will need to use ESPHome builder to edit your config. You also will need ice water and boiling water. Be careful!

Calibration Guide

You may need to change the Unit of Measurement in Home Assistant to get Celcius, otherwise convert F to C for this guide.

1. Place the temperature probe in boiling water, be careful! Wait 1 - 2 minutes for the sensor to stabilize. Record that temperature, should be closer to 100C.
2. Do the same for freezing water, in this case, a cup of ice water will work. Wait a few mins for the water to reach freezing. As long as there is a good amount of ice, the temp of the water will be near 0C. Avoid placing the probe at the very bottom of the cup, more in the middle. Wait 1 - 2 minutes for the sensor to stabilize. Record that temperature, should be closer to 0C.
3. In ESPHome builder, add/edit the corresponding subsitutions for the temperature offsent.
   Example:

substitutions:
  cal_0: "2.0"
  cal_100: "97.0"

4. Restart the AquaPi and compare results with an analog thermometer.

EZO-EC - Conductivity

Store Link
Documentation

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

Calibration Guide

1. Using Entity: EC - Command Select, select Output Units - All (Default) and send the command.
2. Calibrate 0 µS/cm, aka dry. Select Calibrate @ DRY (WILL RESET CALIBRATION).
3. Calibrate at 12,880 µS/cm, aka Low. Select Calibrate @ LOW = 12880 (WILL RESET CALIBRATION).
4. Calibrate at 80,000 µS/cm, aka High. Select Calibrate @ HIGH = 80000 (WILL RESET CALIBRATION).
5. Check calibration with command Check Calibration. The entity sensor.aquapi_XXXXXX_ec_command_result will output 2 if followed above steps.
6. RECOMMENDED: For more accurate TDS value select Set TDS Value to NaCl - 0.48 and send the command. Default is 0.54.

EZO-PH - pH

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)

EZO-DO - Dissolved Oxygen

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. ~9.09 mg/L Select Calibrate @ DRY (WILL RESET CALIBRATION).
3. Calibrate at 0 mg/L, aka Low or 0%. Select Calibrate @ 0% (WILL RESET CALIBRATION).
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).

EZO-ORP - Oxidation Reduction Potential

Store Link
Documentation

EZO-PMP - Peristaltic Dosing Pump

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

Generic Sensor Calibration Card:
Replace with your specific AquaPi device and sensor type (default below is for Salinity)

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