Home Assistant : votre aquarium dans la maison connectée, avec la logique critique sur le contrôleur

Oquari s'intègre nativement à Home Assistant : il suffit d'activer une option dans le panneau de configuration pour que les entités de l'aquarium apparaissent automatiquement dans HA — sans écrire de code, sans passer par un cloud externe et sans plugins tiers. Ce guide explique comment configurer cette liaison, ce que vous verrez exactement dans Home Assistant et où se situe la frontière : HA supervise et ajoute du confort, mais la logique critique reste sur le contrôleur.

Qu'est-ce que Home Assistant (en deux paragraphes)

Home Assistant est la plateforme open source la plus populaire au monde pour la maison connectée : un logiciel gratuit que vous installez chez vous (sur Raspberry Pi, mini-PC ou NAS) et qui relie les appareils de différents fabricants en un seul système — avec des tableaux de bord, des historiques graphiques, des automatisations et des notifications sur smartphone.

Pour l'aquariophile, HA signifie un point central où l'aquarium rencontre le reste de la maison : courbe du pH à côté de la température du salon, notification de fuite sur le même téléphone que l'alarme domestique, bouton « alimentation » sur une tablette dans la cuisine.

Étape 1 : Broker MQTT

Oquari communique avec HA via MQTT — un protocole léger pour la maison connectée. Vous avez besoin d'un broker (intermédiaire de messages) sur votre réseau local ; en pratique, cela se résume à une seule installation :

Dans Home Assistant : Paramètres → Modules complémentaires → Boutique → Mosquitto broker → installez et lancez-le.
Créez un utilisateur pour le contrôleur dans HA (par exemple oquari) — l'extension Mosquitto utilisera les comptes HA.
Activez l'intégration MQTT dans HA (elle se propose généralement d'elle-même après le démarrage du broker).

Étape 2 : Activation depuis le panneau Oquari

Ouvrez le panneau du contrôleur (oquari-XXXX.local) → onglet Home Assistant.
Activez l'intégration et renseignez : adresse du broker (mqtt://IP-de-votre-HA:1883), identifiant et mot de passe de l'utilisateur MQTT.
Enregistrez — le contrôleur se connectera au broker et annoncera ses entités (MQTT Discovery).

Quelques instants plus tard, dans HA, sous Paramètres → Appareils et services → MQTT, apparaîtra un appareil « Oquari » avec l'ensemble des entités.

La connexion au broker n'est pas chiffrée (réseau local). Utilisez cette intégration uniquement sur votre LAN privé et attribuez un mot de passe distinct à l'utilisateur MQTT. C'est le modèle standard de fonctionnement des appareils domotiques locaux.

Ce qui apparaîtra dans HA

Les entités correspondent à votre configuration — le contrôleur les déclare automatiquement, avec les bonnes unités et classes (HA trace donc immédiatement les graphiques et comprend ce qui est une température et ce qui est de l'énergie) :

Capteurs : température, pH, ORP, salinité, niveaux, débit (L/min), puissance et énergie de chaque prise, compteurs de consommation des fluides dosés,
Capteurs binaires : sondes de niveau, capteurs d'inondation, alarmes (surchauffe, limite ATO, bouteille vide), statut « dosage en cours »,
Interrupteurs et lumières : prises mesurées en tant que switch, canaux d'éclairage en tant que light,
Champs numériques et modes : doses de dosage en tant que number, modes de fonctionnement en tant que select, alimentation en tant que button.

Ajoutez à cela l'entité de disponibilité : quand le contrôleur disparaît du réseau, HA marque immédiatement ses entités comme indisponibles — ce qui constitue en soi une excellente alarme (« aquarium hors ligne »).

Exemple : l'alimentation coupe la circulation pendant 5 minutes

Un confort classique — un bouton dans HA qui arrête la pompe de circulation pendant l'alimentation, et que HA relancera automatiquement :

alias: Alimentation — pause circulation
trigger:
  - platform: state
    entity_id: input_button.alimentation
action:
  - service: switch.turn_off
    target:
      entity_id: switch.oquari_circulation
  - delay: "00:05:00"
  - service: switch.turn_on
    target:
      entity_id: switch.oquari_circulation

En pratique, vous n'avez même pas besoin d'écrire cela — Oquari possède un mode alimentation intégré (button.oquari_alimentation) qui met automatiquement les pompes en pause et les redémarre. Mais cet exemple illustre bien le principe : les entités Oquari se comportent comme toutes les autres dans HA.

Autres automatisations utiles : notification push en cas d'alarme de température ou de fuite, rappel de changement de bouteille quand le compteur de fluide dépasse la capacité du récipient, courbe quotidienne du pH sur le tableau de bord à côté de l'état du CO₂.

Principe de séparation : HA supervise, le contrôleur protège

Le paragraphe le plus important de ce guide. La logique critique — hystérésis du chauffage, coupures d'urgence, limites ATO, changement d'eau, fenêtre CO₂, dosage — s'exécute sur le contrôleur, localement. HA est la couche de supervision et de confort : tableaux de bord, historique, notifications, scènes type alimentation.

Cette séparation n'est pas un hasard, mais un fondement de sécurité :

Si le Wi-Fi, la box internet, le serveur HA ou Internet tombent en panne — le chauffage maintient toujours la température, l'ATO surveille toujours les limites, le CO₂ se ferme toujours hors des heures d'éclairage. L'aquarium ne remarquera pas la panne réseau.
Les automatisations HA peuvent basculer les prises, mais elles ne peuvent pas contourner la couche de sécurité du contrôleur : les verrous (coupure surchauffe, blocage inondation) priment même sur les commandes MQTT.

Ne transférez pas la logique de protection vers HA, même si vous savez l'y programmer. Une automatisation « couper le chauffage à 27,5 °C » dans HA cesse d'exister avec le serveur HA. La même règle sur le contrôleur fonctionne toujours. Utilisez HA pour ce qu'il fait de mieux : voir, savoir et simplifier.

Questions fréquentes

Puis-je contrôler entièrement mon aquarium depuis Home Assistant ?

Oui, mais nous déconseillons fortement de gérer les fonctions vitales (chauffage, changement d'eau, sécurité) via HA. Le contrôleur Oquari doit garder la main sur ces processus pour garantir la stabilité biologique et la sécurité électrique, indépendamment de l'état de votre réseau local ou de votre serveur domotique.

Que se passe-t-il si je coupe le courant à mon serveur Home Assistant ?

Rien ne change pour votre aquarium. Toutes les fonctions critiques continuent d'être exécutées localement par le contrôleur Oquari. Seul le tableau de bord, l'historique et les notifications push sur votre téléphone cesseront de fonctionner jusqu'au redémarrage du serveur.

L'intégration fonctionne-t-elle si je change de box internet ou d'adresse IP ?

Oui, tant que le broker MQTT reste accessible localement. Si vous déplacez Home Assistant ou changez l'IP du broker, il suffira de mettre à jour les informations de connexion dans l'onglet Home Assistant du panneau Oquari. La communication repose sur le réseau local, pas sur un service cloud externe.

Puis-je ajouter des capteurs externes directement dans Home Assistant ?

Vous pouvez utiliser HA pour visualiser d'autres données, mais pour que la logique de sécurité (comme les coupures d'urgence) fonctionne correctement, les capteurs critiques doivent être branchés sur les entrées du contrôleur Oquari. Cela garantit que les réactions automatiques sont instantanées et ne dépendent pas de la charge processeur de votre serveur domotique.

Est-il nécessaire d'avoir une connexion internet pour utiliser cette intégration ?

Non. L'intégration MQTT fonctionne entièrement en réseau local (LAN). Une connexion internet n'est requise que si vous souhaitez accéder à Home Assistant à distance ou télécharger des mises à jour logicielles, mais elle n'est pas indispensable au bon fonctionnement de l'aquarium ni à la communication entre Oquari et HA.