Contrôleurs ESP32
Les contrôleurs se gèrent dans Configuration › Contrôleurs. Pour le choix de la carte et le câblage, voir la section Matériel.
Ajouter un contrôleur
Section intitulée « Ajouter un contrôleur »- Découverte automatique : les ESP32 déjà sous ESPHome présents sur le réseau local sont détectés (mDNS).
- À la main : saisissez le nom et l’adresse IP du contrôleur. C’est le cas par défaut dans une installation Docker, où la découverte ne traverse pas le réseau des conteneurs.
Décrire les broches
Section intitulée « Décrire les broches »Pour chaque broche utilisée, indiquez son rôle :
| Mode | Usage |
|---|---|
| Sortie | Relais d’un équipement, canal PWM d’une rampe LED |
| Entrée | Capteur tout-ou-rien, comme un flotteur |
| Capteur | Bus 1-Wire (sondes de température), entrée analogique |
Pour un relais, précisez son type et le contact utilisé (NO, normalement ouvert, ou NC, normalement fermé) : AquasManager en déduit s’il faut inverser le signal.
Les formulaires remplacent l’écriture de YAML. Pour les curieux, le YAML ESPHome généré reste consultable.
Modules d’extension
Section intitulée « Modules d’extension »Chaque contrôleur peut recevoir des modules :
- PCF8574 / PCF8575 : extensions d’entrées-sorties en I²C, pour ajouter des relais ;
- horloge RTC sur pile : DS3231, DS1307, PCF8563 ou PCF85063.
L’horloge RTC est obligatoire pour les règles horaires et les programmes d’éclairage : elle garde l’heure même sans réseau.
Les modules sont numérotés (« Module 1 »…) et le bouton Scanner le bus I²C vérifie ce qui est réellement branché. Voir Modules et horloge RTC.
Noms techniques
Section intitulée « Noms techniques »Chaque équipement et chaque capteur reçoit un nom technique, au format <nom>_<aquarium> :
osmolateur_recif, niveau_decante_recif… C’est l’identifiant utilisé dans le firmware, sur MQTT et
dans les journaux du contrôleur. Il est recalculé quand vous renommez l’élément ou son aquarium.
Après un renommage, le contrôleur est à reflasher. En attendant, AquasManager continue de lui parler sous l’ancien nom : mesures et commandes fonctionnent sans interruption.
Sondes de température 1-Wire
Section intitulée « Sondes de température 1-Wire »Plusieurs sondes DS18B20 peuvent partager une broche. Dans le formulaire du capteur, le bouton de recherche interroge le contrôleur et liste les adresses des sondes présentes sur le bus : choisissez celle qui correspond. Réglez aussi l’intervalle de mesure.
Redémarrer
Section intitulée « Redémarrer »Le bouton Redémarrer de la carte du contrôleur le redémarre à distance (le firmware doit avoir été flashé une fois avec cette fonction). Pendant quelques secondes, les relais reprennent leur état de démarrage : évitez de le faire pendant un complément d’osmolation. Après le branchement d’une sonde ou d’un module, Redémarrer et rechercher et Redémarrer et scanner relancent la recherche dès son retour.
- Lancez le flash depuis la page du contrôleur, ou Tout flasher pour mettre à jour tous les contrôleurs modifiés.
- L’avancement s’affiche en direct.
Le flash passe par le réseau (OTA) : le contrôleur doit être en ligne. Une carte neuve doit d’abord recevoir un firmware ESPHome de base en USB : voir Préparer une carte neuve.
Le premier flash depuis AquasManager compile tout le firmware : comptez plusieurs minutes. Les suivants sont bien plus rapides.
Quand un automatisme de sécurité se déclenche, par exemple l’osmolateur qui dépasse sa durée maximale, un défaut s’affiche. Il reste actif tant que vous ne l’avez pas acquitté.
Home Assistant
Section intitulée « Home Assistant »Home Assistant détecte seul les contrôleurs grâce à son intégration ESPHome : équipements, intensité des canaux d’éclairage, sondes de température, capteurs de niveau et bouton de redémarrage y apparaissent sans réglage. AquasManager génère en plus le tableau de bord qui les organise, avec une vue par aquarium.
- Dans Home Assistant, ajoutez chaque contrôleur avec l’intégration ESPHome. Il demande la clé de chiffrement du contrôleur : copiez-la depuis Contrôleurs → Home Assistant (gestionnaires).
- Dans AquasManager, ouvrez Contrôleurs → Home Assistant et copiez le YAML proposé. Si le contrôleur est rangé dans une pièce de Home Assistant, indiquez-la dans le champ Pièce : Home Assistant met son nom en tête des entités.
- Dans Home Assistant : Paramètres → Tableaux de bord → Ajouter un tableau de bord (un nouveau tableau de bord, pas une vue d’un tableau existant), ouvrez-le, puis ⋮ → Modifier → ⋮ → Éditeur de configuration. Collez le YAML et enregistrez.
La clé de chiffrement est propre à chaque contrôleur et intégrée au firmware : seul un Home Assistant qui la connaît peut se connecter à l’ESP et commander ses relais. Elle n’est active qu’après un flash.
Chaque vue regroupe les équipements (interrupteurs), l’éclairage, les températures et les niveaux, avec leur courbe sur 24 heures. Une dernière vue réunit les boutons de redémarrage des contrôleurs.