Documentation
WARNING: 230V Mains Voltage
This project operates with 230V AC mains voltage and should only be built by individuals with basic electronics knowledge. Always use an RCD (residual-current device). This project is not CE/UL certified and not intended for commercial use.
🏊 Smart Swimming Pool Documentation
Everything you need to build, connect and maintain your smart pool automation. The pages are grouped in the order you will probably need them — the same grouping you see in the sidebar.
The core is the Pool Controller, an ESP32-based device that:
- ✅ Automates circulation time for cleaning the water
- ✅ Heats with solar energy and switches an additional heating circuit pump
- ✅ Works independently of a specific smart home server, and keeps running without WiFi
- ✅ Integrates with Home Assistant via MQTT Discovery (openHAB via manual MQTT configuration)
- ✅ Can be operated from a smartphone or the built-in web interface
🧭 Find Your Way
| Step | What you want to do | Pages |
|---|---|---|
| 1 · Start | Decide how to build and get a first working setup | Start Here · Quick Start · Build Guide |
| 2 · Plan & Build | Understand the system, buy parts, commission safely | Architecture · Bill of Materials · Commissioning Checklist |
| 3 · Components | Learn about each module of the system | Pool Controller · Pool Monitor · Grafana Dashboard · Water Quality Monitor |
| 4 · Smart Home Integration | Connect the controller to your smart home | Home Assistant · openHAB · openHAB Configuration |
| 5 · Operation & Support | Something is unclear, broken or needs an update | FAQ · Troubleshooting · Upgrade & Migration |
| 6 · Project | Background, contributing, media | Diagrams with Svgbob · Publications · Gallery |
New here? Read Start Here, then follow either the Quick Start (60 minutes, breadboard) or the detailed Build Guide. Run the Commissioning Checklist before connecting any pump to mains voltage.
🗂️ Repositories
Module details (purpose, difficulty, cost) are in Components and Smart Home Integration. The controller cost covers the electronics only; the Bill of Materials lists enclosure, mains wiring and tools as well.
| Repository | Purpose | Language |
|---|---|---|
| pool-controller | ESP32 firmware, web UI, hardware docs | C++ (PlatformIO) |
| monitor | Solar-powered temperature display | C++ |
| grafana-dashboard | Grafana dashboard JSON | JSON |
| water-quality-monitor | pH and chlorine monitor (in development) | — |
| openhab-config | openHAB configuration (legacy) | openHAB DSL |
| website | Project website (Hugo) | Markdown, Hugo |
💬 Need Help?
Look up the symptom in Troubleshooting, check the FAQ, or open an issue. All project repositories are on GitHub.