Contrôleur de piscine

Installer son firmware depuis le navigateur

Recherche du firmware…

Un contrôleur de filtration pour piscine, sur un ESP32. Il pilote une pompe à vitesse variable, place chaque jour la filtration d'après la température de l'eau et le soleil, protège du gel et compte l'eau de remplissage. Il fonctionne seul ; Home Assistant, s'il est là, le suit et le règle.

ENThis page installs the pool controller's firmware on an ESP32 over USB, from Chrome or Edge on a computer. It erases the board: never use it on a controller in service, which updates itself. Then open http://pool-controller.local: the controller's own setup wizard does the rest (in French for now). Source and releases: github.com/davidterranova/pool-controller.

Installer sur une carte neuve

L'installation efface la carte

Pour une carte neuve, ou à remettre à zéro : tout ce qu'elle contient est perdu.

Jamais pour un contrôleur déjà en service : il se met à jour tout seul et garde ses réglages (voir Mises à jour).

Branchez la carte en USB, puis cliquez : le navigateur demande quel port utiliser. Pour installer, la carte seule suffit ; le câblage peut venir après.

Dans la fenêtre d'installationcelle d'ESP Web Tools, en anglais

  1. Choisissez le port de la carte (souvent « CP2102 », « CH340 » ou « USB to UART »), puis Connect. Rien dans la liste ? Un câble qui ne fait que charger, ou le pilote USB de la carte qui manque (CP210x ou CH34x). Débranchez, rebranchez, réessayez.
  2. Install Pool Controller, puis Install. La fenêtre prévient que tout sera effacé : c'est voulu, chaque installation part d'une carte vide.
  3. L'installation : deux minutes environ. Gardez la page au premier plan, ne débranchez pas.
  4. Configure Wi-Fi : le réseau de la maison et son mot de passe, puis Connect. Ils passent par le câble USB (Improv) ; le contrôleur ne les garde qu'une fois connecté. Skip : il ouvrira son point d'accès à la place (voir Après l'installation).
  5. Visit Device ouvre la page du contrôleur : la suite se fait là. Add to Home Assistant peut attendre : c'est la dernière étape de l'assistant du contrôleur.

Ce qu'il faut

Une carte ESP32De développement, à ESP32-WROOM (« ESP32 DevKit »), avec son port USB.
Un module relais 5 V, 4 canaux au moinsÀ optocoupleurs, commandé à l'état bas (les modules 8 canaux courants conviennent : 4 servent). Il ferme les entrées de la pompe.
Une pompe à vitesse variableAvec des entrées de commande à contact sec : trois vitesses et marche/arrêt (DI1 à DI4).
Des sondes DS18B20Une au moins, sur le retour vers la piscine ; deux de plus pour le local technique et l'extérieur. Une résistance de 4,7 kΩ entre la ligne de données et le 3,3 V. Des sondes d'origine : une contrefaçon peut bloquer tout le bus.
Un compteur d'eau à impulsionsfacultatifSur l'arrivée de remplissage, à contact sec, 1 impulsion par litre : le contrôleur compte l'eau ajoutée.
Une alimentation 5 VPour la carte et le module relais.
Un câble USB de donnéesPas un câble de charge seule : avec lui, la carte n'apparaît pas dans la liste des ports.
Un ordinateur avec Chrome ou EdgeWindows, macOS ou Linux. Un téléphone suffit ensuite pour régler le contrôleur.
Branchements (fixés dans le firmware publié)
BrocheVa à
GPIO26Relais 1 → DI1, vitesse 1 (lente)
GPIO25Relais 2 → DI2, vitesse 2
GPIO14Relais 3 → DI3, vitesse 3 (rapide)
GPIO27Relais 4 → DI4, marche/arrêt
GPIO4Sondes DS18B20 (bus 1-Wire), 4,7 kΩ vers le 3,3 V
GPIO33Compteur d'eau ; son autre fil à GND

Relais sur COM/NO : carte éteinte, tout s'ouvre et la pompe s'arrête. D'autres broches ? Elles sont compilées : changez-les dans pool-controller.yaml et compilez vous-même. Le détail : POOL-CONTROLLER.md

Après l'installation

  1. Le contrôleur redémarre et rejoint le Wi-Fi donné dans la fenêtre d'installation.
  2. Ouvrez http://pool-controller.local depuis un téléphone ou un ordinateur du même réseau (ou Visit Device). Si l'adresse ne répond pas : celle que votre box donne à « pool-controller ».
  3. Sa page ouvre l'assistant de configuration : cinq étapes, quelques minutes, et tout reste sur le contrôleur.
    1. 1Mot de passe
    2. 2Wi-Fi
    3. 3Position
    4. 4Sondes
    5. 5Home Assistant
    Commencez sans attendre par le mot de passe de la page : tant qu'il n'y en a pas, quiconque est sur le réseau peut l'ouvrir. Le Wi-Fi donné à l'installation y est déjà coché.
  4. Home Assistant, à la dernière étape : ajoutez-y le contrôleur (Paramètres › Appareils et services › ESPHome ; il le découvre souvent tout seul). Il crée la clé de chiffrement et la lui envoie. Sans Home Assistant, le contrôleur fonctionne aussi : « Je n'utilise pas Home Assistant ».
Pas de Wi-Fi ?

Wi-Fi passé ou refusé : le contrôleur ouvre son propre point d'accès, « pool-controller », sans mot de passe Wi-Fi. Connectez-y un téléphone et ouvrez http://192.168.4.1 : l'assistant commence là, par le mot de passe de la page puis le Wi-Fi.

Plus tard, s'il perd son réseau plus d'une minute, il rouvre ce même point d'accès.

Mises à jour

Un contrôleur installé ne repasse pas par ici.

Toutes seulesIl cherche une nouvelle version toutes les 24 h et l'installe (réglable : à la demande, 6 h, 24 h, 7 j, dans Contrôleur › Firmware). Jamais pendant une marche forcée ou un remplissage : il attend la fin.
Sur demande« Installer » sur sa page (Contrôleur › Firmware) ou dans Home Assistant (Paramètres › Mises à jour).
Les réglages restentMot de passe, Wi-Fi, position, sondes, clé Home Assistant : une mise à jour n'en touche aucun.
Compilé avec secrets.yaml (v1.3.x) ?Une seule fois, depuis le dépôt : make migrate. Il garde tous ses réglages et sa clé Home Assistant, sans assistant à refaire ; ensuite il se met à jour comme les autres.

Le code

davidterranova/pool-controllerLe firmware ESPHome, la page du contrôleur, la carte Home Assistant. Licence MIT. Questions et problèmes : les issues du dépôt.
VersionsLes notes de chaque version, et ses fichiers.
Les fichiers du firmwarePour esptool : l'image complète à l'adresse 0x0. manifest.jsonfirmware.factory.binfirmware.ota.bin