Start Here

👋 Welcome to the Smart Swimming Pool project! This page helps you find the right path based on what you want to build.

Choose Your Path

🔰 I want the simplest possible setup

Goal: Automate pool circulation with minimal cost and effort.

• Use a breadboard or protoboard with ESP32 DevKit V1
• 2-channel relay module for pump control
• 2× DS18B20 temperature sensors
• Flash the pre-built firmware
• Control via Home Assistant

Start here: Pool Controller — Build from Zero

Cost: about 35–55 € for the controller electronics — see the Bill of Materials for parts, enclosure and mains wiring.

🏊 I have a standard pool with sand filter and solar heating

Goal: Full automation with circulation scheduling and solar heating.

• Follow the Build from Zero guide
• Use an IP65 enclosure for weather protection
• Proper mains wiring with fuse and RCD protection
• Home Assistant integration for dashboard and automation
• MQTT for reliable communication

Required reading:

• Electrical Safety
• Production Checklist
• Security Checklist

🏭 I’m building a production-ready installation

Goal: Industrial-grade, 24/7 reliable pool controller with full safety.

• Use the NORVI AE01-R or custom PCB for reliability
• IP66+ enclosure with cable glands
• DIN-rail mounted components
• Proper overcurrent protection and grounding
• Flash encryption enabled
• IoT VLAN with firewall rules
• Regular maintenance schedule

Required reading:

• Build from Zero
• Electrical Safety
• Safety Model
• Production Checklist
• Security Checklist
• Troubleshooting

How It Fits Together

Sensors and relays attach to the ESP32 pool controller, which talks MQTT to your smart home (Home Assistant, openHAB). The pin assignment, wiring diagram and data flow are documented once, in Architecture — so they cannot drift apart.

Questions?

Common questions (Do I need Home Assistant? What if I have no solar heating? Do I need an electrician?) are answered in the FAQ. If something does not work, see Troubleshooting.

Next Steps

Pick a path, follow the Quick Start or the Build Guide, order the parts from the Bill of Materials, test on a breadboard, run the Commissioning Checklist, install everything in an enclosure and connect Home Assistant or openHAB. The full overview of all repositories and pages is in the documentation.

Background on how the project started: Project History.