Intégration domotique EHEIM Digital, gratuite et open source
Appareils d'aquarium EHEIM Digital, en local : chauffage, filtres, pH, LED, UV, nourrisseur.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Affiche vos appareils d'aquarium EHEIM Digital dans Gladys par votre réseau local, sans cloud ni compte. Jamais testé avec un vrai appareil. Sans lien avec EHEIM.
Appareils pris en charge
| Appareil | Ce que Gladys affiche | Commandes |
|---|---|---|
| thermocontrol+e (chauffage) | température de l'eau, consigne, chauffe, marche/arrêt, mode, alerte | consigne, marche/arrêt (option) |
| classicVARIO+e (filtre) | pompe marche/arrêt, vitesse (%), mode, état, heures avant l'entretien | pompe marche/arrêt (option) |
| professionel 5e (filtre) | pompe marche/arrêt, fréquence (Hz), mode, heures avant l'entretien, temps de fonctionnement | pompe marche/arrêt (option) |
| pHcontrol+e | pH, consigne de pH, vanne CO2 ouverte, état, jours avant l'étalonnage | aucune |
| classicLEDcontrol+e | niveau de chaque canal (%) | aucune |
| reeflexUV+e | lampe allumée, actif, mode | aucune |
| autofeeder+ | poids de nourriture (g), tambour, rotation | aucune |
Les autres appareils EHEIM Digital ne sont pas encore affichés.
Installation
- Trouvez l'adresse de votre hub : l'appareil EHEIM relié à votre Wi-Fi
(les autres le rejoignent par le maillage EHEIM). Son adresse IP est dans
votre box ;
eheimdigital.localfonctionne souvent aussi. Donnez-lui une adresse fixe. - Dans Gladys, installez l'intégration, saisissez l'adresse, enregistrez.
- Ouvrez l'onglet Découverte et ajoutez les appareils.
Le statut indique combien d'appareils répondent. Tester la connexion se connecte tout de suite si besoin, et interroge à nouveau les appareils quand aucun ne répond encore.
Animaux vivants : les commandes
Un chauffage ou un filtre d'aquarium qui s'arrête peut tuer les poissons. Donc :
- Toutes les commandes sont désactivées par défaut. « Autoriser les commandes du chauffage » permet à Gladys de changer la consigne et de mettre le chauffage en marche ou à l'arrêt ; « Autoriser les commandes du filtre » lui permet de démarrer et d'arrêter la pompe du filtre. Sans son option, une commande est refusée dans les deux sens : l'arrêt du chauffage ou du filtre est refusé aussi.
- Jamais d'interrupteur : le chauffage et la pompe du filtre sont des listes (Marche/Arrêt). Un « tout éteindre » d'un assistant vocal, d'une scène ou d'un tableau de bord ne les atteint jamais.
- La consigne reste entre le plancher et le plafond de la configuration : 22 °C et 28 °C par défaut ; le plancher de 18 à 30 °C, le plafond de 20 à 32 °C. Rien hors de 18–32 °C n'est jamais envoyé, quoi qu'on saisisse. Demi-degrés seulement. Un plancher égal ou supérieur au plafond refuse toute consigne, et le statut le dit.
- « Marche » est refusée quand la consigne réglée sur le chauffage lui-même est hors des bornes. Un chauffage réglé en °F n'est jamais commandé (les valeurs sont affichées en °C).
- La commande du chauffage renvoie ses autres réglages tels qu'il les indique : elle est refusée si l'un d'eux sort des plages attendues (consigne hors 18–32 °C, hystérésis au-delà de 2 °C, décalage d'étalonnage au-delà de ±3 °C, baisse de nuit au-delà de 5 °C). En mode Bio, chauffage en marche, la consigne de nuit (consigne moins la baisse de nuit) doit rester au niveau du plancher ou au-dessus.
- Chaque commande demande d'abord ses données actuelles à l'appareil et décide sur les premières données reçues après le clic (le protocole ne dit pas à quelle demande répond un paquet), revérifie les options et les bornes juste avant l'envoi, et part dans les 3,5 s ou pas du tout. Si l'appareil ne montre pas le changement à 4,3 s, Gladys répond « Commande envoyée, sans confirmation » : vérifiez l'appareil. Tant que l'appareil ne l'affiche pas (30 s au plus), toute autre commande vers cet appareil est refusée, pour qu'une commande suivante ne la défasse jamais. Une commande à la fois, jamais rejouée.
Le contrôleur de pH, l'éclairage, le stérilisateur UV et le distributeur de nourriture sont en lecture seule.
Options
| Option | Par défaut | |
|---|---|---|
| Adresse du hub | — | adresse IPv4 ou nom d'hôte, port 80 sauf précisé |
| Autoriser les commandes du chauffage | désactivé | consigne et marche/arrêt |
| Plancher de la consigne (°C) | 22 | de 18 à 30 |
| Plafond de la consigne (°C) | 28 | de 20 à 32 (jamais plus de 32 °C) |
| Autoriser les commandes du filtre | désactivé | pompe marche/arrêt |
| Intervalle de rafraîchissement (s) | 30 | de 15 à 600 |
| Langue | français | noms des nouvelles fonctionnalités, textes, erreurs |
Sécurité et vie privée
Le protocole local n'est pas documenté par EHEIM et n'a pas de mot de passe : toute personne sur votre réseau peut parler au hub. Gardez-le sur un réseau de confiance. L'intégration ne garde aucun secret et ne lit jamais l'adresse e-mail ni le nom d'utilisateur enregistrés dans le hub. Les journaux ne contiennent jamais les adresses MAC.
Limites
- Jamais testé avec un vrai appareil : construit à partir de la bibliothèque eheimdigital (celle de Home Assistant) et de ses captures.
- Le hub doit être joignable depuis le conteneur de Gladys (même réseau).
- Vitesses du filtre, programmes d'éclairage, consignes de pH et distribution de nourriture ne sont pas commandés dans cette version.
Crédits
Protocole porté depuis eheimdigital (autinerd, MIT). Source : https://github.com/LM1LC3N7/gladys-eheim-digital.
Paramètres de configuration
Voici les paramètres demandés par EHEIM Digital dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre aquarium | section | Non | Affiche vos appareils EHEIM Digital (chauffage thermocontrol+e, filtres classicVARIO+e et professionel 5e, pHcontrol+e, classicLEDcontrol+e, reeflexUV+e, autofeeder+) dans Gladys par votre réseau local, sans cloud. Saisissez l'adresse du hub (l'appareil relié à votre Wi-Fi), enregistrez, puis ajoutez les appareils depuis l'onglet Découverte. Animaux vivants : les commandes du chauffage et du filtre sont désactivées par défaut, jamais un interrupteur, et la consigne reste entre un plancher et un plafond. Le protocole local n'est pas documenté par EHEIM et n'a pas de mot de passe : gardez le hub sur un réseau de confiance. Jamais testé avec un vrai appareil. Sans lien avec EHEIM. |
| Adresse du hub EHEIM Digital | string | Oui | Une adresse IPv4 ou un nom d'hôte (port 80 sauf si vous en ajoutez un), par exemple 192.168.1.60 ou eheimdigital.local. |
| Autoriser les commandes du chauffage | boolean | Non | Désactivé par défaut. Activé : Gladys peut changer la consigne du chauffage (entre le plancher et le plafond ci-dessous) et le mettre en marche ou à l'arrêt. Désactivé : toute commande du chauffage est refusée, arrêt compris (un aquarium froid nuit aux poissons). |
| Plancher de la consigne (°C) | number | Non | Gladys ne règle jamais le chauffage en dessous de cette température. 22 °C par défaut, de 18 à 30 °C. |
| Plafond de la consigne (°C) | number | Non | Gladys ne règle jamais le chauffage au-dessus de cette température. 28 °C par défaut, de 20 à 32 °C (jamais plus de 32 °C, la limite du chauffage, quoi qu'on saisisse). |
| Autoriser les commandes du filtre | boolean | Non | Désactivé par défaut. Activé : Gladys peut démarrer et arrêter la pompe du filtre. Désactivé : toute commande du filtre est refusée (un filtre arrêté prive l'aquarium d'oxygène). |
| Intervalle de rafraîchissement (secondes) | number | Non | Fréquence à laquelle les appareils sont interrogés. 30 s par défaut, de 15 à 600 s. |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms des fonctionnalités ajoutées désormais, aux textes d'état et aux erreurs des commandes. |
Comment installer EHEIM Digital dans Gladys
- Dans Gladys, ouvrez Intégrations : EHEIM Digital apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-eheim-digital:0.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-eheim-digital.
EHEIM Digital nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
EHEIM Digital est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation