https://github.com/mzakharo/tubby

Hot Tub & Pool Water Quality Sensor
https://github.com/mzakharo/tubby

esp32 esphome homeassistant hottub iot orp ph pool spa tensorflow tflite-micro

Last synced: about 2 months ago
JSON representation

Hot Tub & Pool Water Quality Sensor

• Host: GitHub
• URL: https://github.com/mzakharo/tubby
• Owner: mzakharo
• License: mit
• Created: 2023-02-12T13:46:29.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-03-02T21:25:12.000Z (10 months ago)
• Last Synced: 2024-03-03T01:28:12.505Z (10 months ago)
• Topics: esp32, esphome, homeassistant, hottub, iot, orp, ph, pool, spa, tensorflow, tflite-micro
• Language: C
• Homepage:
• Size: 25.6 MB
• Stars: 30
• Watchers: 6
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Hot Tub/Spa & Pool Water Quality Sensor

- Solar powered

- ORP & pH Sensors

- Estimates Sanitizer ppm

- [Home Assistant](https://www.home-assistant.io/) Integration

- [Firmware](https://github.com/mzakharo/tubby/blob/main/tubby.yaml) is using [esphome](https://esphome.io/index.html)

 

## Hardware  

 - [UM FeatherS2](https://unexpectedmaker.com/shop/feathers2-esp32-s2) ESP32 board from [here](https://www.adafruit.com/product/4769) 

 - [2500 mAh](https://www.adafruit.com/product/328)

 - Atlas Scientific Gravity Analog [ORP](https://atlas-scientific.com/kits/gravity-analog-orp-kit/) and [pH](https://atlas-scientific.com/kits/gravity-analog-ph-kit/) Kits

 - Enclosure: [DS-AT-0811-S](https://www.adafruit.com/product/3931)

 - [2x100 kΩ resistors](https://www.adafruit.com/product/2787) for battery monitoring (optional)

### Solar Panel Components

 - [Adafruit Universal USB / DC / Solar Lithium Ion/Polymer charger - bq24074](https://www.adafruit.com/product/4755)

 - [3.5mm / 1.1mm to 5.5mm / 2.1mm DC Jack Adapter](https://www.adafruit.com/product/4287)

 - [Small 6V 1W Solar Panel](https://www.adafruit.com/product/3809)

 - [JST-PH 2-pin Jumper Cable](https://www.adafruit.com/product/4714)

 

 ## Wiring

  - [Diagram](https://raw.githubusercontent.com/mzakharo/tubby/main/pictures/tubby_wiring.png)

  - NOTE: You can skip the ambient sensor removal step

 

## [Firmware](https://github.com/mzakharo/tubby/blob/main/tubby.yaml)

  - Install [esphome](https://esphome.io/guides/installing_esphome) (Tested Version: 2023.12.5)

  - copy `wifi_example.yaml` to `wifi.yaml` and edit the new file

  - Connect the board via USB and enter `esphome run tubby.yaml` on the command line. This will build and upload firmware to the board.

  - In Home Assistant, create a helper switch `input_boolean.ota`. Enable this switch, it will prevent device `Deep` sleep.

  - Power cycle the board, Device then enters `Light` sleep for `15 minutes` before it shows up in Home Assistant

  - Once your esphome device is added to Home Assistant, Use Device's page, Diagnostics section to calibrate the probes:

     - `ORP Cal` : mV ORP calibration offset from raw ADC value. Note: `ORP` mV Sensor value has calibration applied

     - `pH 10 Cal`: mV reading from `pH Raw` sensor while submerged in pH 10 calibration solution

     - `pH 7 Cal`: mV reading from `pH Raw` sensor while submerged in pH 7 calibration solution

     - `pH 4 Cal`: mV reading from `pH Raw` sensor while submerged in pH 4 calibration solution

     - `ppm Factor`: 1 - Chlorine, 3 - Bromine

  - Turn off `input_boolean.ota` to allow the device to save some power.

  - Place the probes in the water, and enjoy!

## Sanitizer ppm Model

- pH + ORP -> Chlorine ppm [Conversion Table](https://github.com/mzakharo/tubby/blob/main/charts/servovendi.png)

- [Machine Learning Notebook](https://github.com/mzakharo/tubby/blob/main/fc_model.ipynb)

- Generate .h file from .tflite: `xxd -i model_fc.tflite > model_fc.h`