Creates sensors for pools being managed with Trouble Free Pools's Pool Math apps (iOS/Android/Fire). Use a device like Pool Exact EZ Pool Water Tester to measure exact values and enter the data into Pool Math, and your pool, spa, or hot tub data will automatically appear in Home Assistant.
Pool Math makes swimming pool care, maintenance and management easy by tracking chlorine, pH, alkalinity and other levels to help calculate how much salt, bleach and other chemicals to add. Note: this requires a Trouble Free Pool Pool Math Premium subscription to access your pool or spa's data from the Pool Math service.
- pH
- Free Chlorine (FC)
- Combined Chlorine (CC)
- Total Chlorine (TC)
- Total Alkalinity (TA)
- Calcium Hardness (CH)
- Cyanuric Acid (CYA)
- Salt
- Borates
- Calcite Saturation Index (CSI)
- Temperature
- Pressure
- Flow Rate
- SWG Cell Percentage
-
For support, use the official Home Assistant Pool Math discussion thread. The developers are just volunteers from the community and do not provide any support, so it is best to ask the entire community for help or questions. There is no support or dedicated development for this integration, thus GitHub issue tracking has been turned off. Please submit Pull Requests with bug fixes!
-
For issues with the Pool Math apps, see forums or contact poolmath@troublefreepool.com
Make sure Home Assistant Community Store (HACS) is installed, then add the repository: rsnodgrass/hass-poolmath
-
Under Settings in the Pool Math app (iOS/Android/Fire), find the Sharing section: turn this on and save changes. Your pool's share URL will be displayed, which you'll need for setting up this integration. Anyone with the share URL will be able to view data about your pool.
-
Configure the
Pool Math (Trouble Free Pool)integration via Home Assistant integrations page, or press the blue button below:
- Enter your pool's share URL when asked during the configuration of the Pool Math integration. Multiple pools and hot tubs can be configured by adding additional integrations.
NOTE: To protect the PoolMath service this integration only updates values every 8 minutes since PoolMath's cloud service caches data for 10 minutes AND rate limits to no more than once per minute.
entities:
- entity: sensor.pool_fc
name: Free Chlorine
- entity: sensor.pool_ph
name: pH
- entity: sensor.pool_ta
name: Total Alkalinity
- entity: sensor.pool_cya
name: CYA
- entity: sensor.pool_ch
name: Hardness
type: entities
title: Pool
show_header_toggle: false
Another single line Lovelace example using multiple-entity-row:
entities:
- entity: sensor.pool_ph
type: 'custom:multiple-entity-row'
name: Pool
state_header: pH
secondary_info: last-changed
entities:
- entity: sensor.pool_fc
name: FC
- entity: sensor.pool_cc
name: CC
- entity: sensor.pool_ta
name: TA
- entity: sensor.hot_tub_ph
type: 'custom:multiple-entity-row'
name: Hot Tub
state_header: pH
secondary_info: last-changed
entities:
- entity: sensor.hot_tub_fc
name: FC
- entity: sensor.hot_tub_cc
name: CC
- entity: sensor.hot_tub_ta
name: TA
type: entities
- move all communication/interfaces to Pool Math into separate
pypoolmathpackage that can be maintained separately - add @berniedp's calculation to suggest SWG % setting See [https://community.home-assistant.io/t/custom-component-pool-math-sensors-for-pool-chemicals-and-operations/435126/17](calculations here).
Quick cheat sheet for developers testing changes on their own instance of Home Assistant:
scp -r custom_components/poolmath homeassistant.local:/config/custom_components
ssh homeassistant.local "rm /config/*.log ; ha core restart"