Intégration domotique Ecowitt, gratuite et open source
Intégrez les capteurs de votre station météo Ecowitt à Gladys, en local.
Publiée par cicoub13
- Appareils
- Version 1.1.3
- Nécessite Gladys >=4.86.0
- ★ 0
Présentation
Cette intégration fait remonter les capteurs de votre station météo Ecowitt dans Gladys : température, humidité, vent, pluie, ensoleillement, UV, pression, mais aussi les sondes déportées (humidité du sol, PM2.5, CO2, foudre, détection de fuite). Chaque capteur physique devient un appareil Gladys distinct, avec sa propre batterie et son historique, utilisable dans vos scènes.
Tout se passe en local : aucune donnée ne transite par le cloud Ecowitt.
Prérequis
- Gladys 4.86 ou supérieur.
- Une station météo, une console ou une passerelle Ecowitt sur le même réseau local que la machine qui héberge Gladys.
- Pour le mode réception : l'application WS View Plus, et une station capable de joindre la machine qui héberge Gladys sur le réseau local, sur le port indiqué dans l'écran de configuration.
- Pour le mode interrogation locale : une passerelle ou une console disposant d'une API locale (voir la liste ci-dessous), joignable à son adresse IP depuis la machine qui héberge Gladys.
Configuration
Deux modes sont proposés, selon votre matériel.
Réception (fonctionne avec presque toutes les stations)
Votre station envoie elle-même ses relevés à Gladys. C'est le mode à utiliser avec les consoles WS2910, GW1000, WN1900, WN1910, WS2320, HP2550, HP3500 et, plus généralement, avec tout modèle sauf le WS6006.
- Installez l'intégration et attendez que le conteneur de réception démarre.
- Ouvrez l'écran de configuration : l'adresse complète à recopier y est
affichée, sous la forme
http://<adresse>:<port>/data/report/. Si elle contientlocalhostou127.0.0.1— c'est le cas si vous consultez Gladys depuis la machine qui l'héberge — remplacez cette partie par l'adresse IP locale de cette machine : votre station doit la joindre sur le réseau, etlocalhostne veut rien dire pour elle. - Dans l'application WS View Plus, sélectionnez votre station, puis
Customized :
- Protocol Type Same As : Ecowitt
- Server IP / Hostname : l'adresse IP locale de la machine qui héberge Gladys
- Path :
/data/report/ - Port : le port indiqué dans Gladys
- Upload Interval :
60secondes - Activez Enable et enregistrez.
- Patientez le temps d'un premier envoi, puis cliquez sur Tester la réception pour confirmer que les relevés arrivent.
- Rendez-vous dans l'écran Découverte : vos capteurs y apparaissent.
Les capteurs ne sont connus qu'après le premier relevé reçu. Si l'écran Découverte est vide, c'est presque toujours que la station n'a encore rien envoyé : vérifiez l'adresse, le port et le chemin saisis dans WS View Plus.
Si votre console ne propose que le protocole Wunderground, il fonctionne
aussi : indiquez le chemin /weatherstation/updateweatherstation.php. Il
transporte moins de mesures (ni multi-canal, ni PM2.5, ni CO2, ni foudre).
Interrogation locale (passerelles récentes)
Les GW1100, GW1200, GW2000, GW3000 et les consoles réseau récentes (WS3800, WS3820, WS3900, WS3910, WN1700, WN1820, WN1821, WN1920, WN1980, WS6210) exposent une API locale. Gladys les interroge directement, sans aucune configuration sur la station.
- Renseignez l'adresse IP de la passerelle dans la configuration. Le bouton Rechercher les passerelles peut la trouver pour vous.
- Ajustez l'intervalle d'interrogation si besoin : 30 ou 60 secondes (60 par défaut). L'intégration lit la passerelle à ce rythme et rafraîchit les relevés de tous les appareils que vous avez créés.
- Lancez une découverte.
Ce mode a un avantage : il récupère l'identifiant matériel de chaque capteur, si bien que remplacer une pile ou changer un capteur de canal ne casse ni vos scènes ni votre historique.
Choisir le mode
Par défaut, l'intégration bascule en interrogation locale dès qu'une adresse IP est renseignée, et reste en réception sinon.
Les deux sources ne produisent pas les mêmes identifiants d'appareils : elles ne sont donc jamais combinées sur une même station. Si vous changez de mode après avoir créé vos appareils, ceux-ci apparaîtront en double dans l'écran Découverte — supprimez les anciens.
Sécurité
Le port de réception est ouvert sur votre réseau local et accepte, par
construction, tout envoi qui lui parvient. Si plusieurs stations coexistent sur
votre réseau, renseignez le champ PASSKEY pour n'accepter que la vôtre. Pour le
trouver, saisissez une valeur quelconque dans ce champ et enregistrez : le
relevé suivant est alors ignoré, et les journaux de l'intégration affichent son
PASSKEY (Relevé ignoré : PASSKEY inattendu (…)). Copiez cette valeur dans le
champ et enregistrez à nouveau.
Dépannage
| Symptôme | Piste |
|---|---|
| L'écran Découverte reste vide | Aucun relevé reçu : vérifiez l'adresse, le port et le chemin dans WS View Plus, puis cliquez sur « Tester la réception ». |
| L'adresse affichée semble fausse | Elle reprend celle par laquelle votre navigateur joint Gladys : localhost si vous êtes sur la machine elle-même, le nom du tunnel via Gladys Plus ou un reverse proxy. Remplacez-la par l'adresse IP locale de la machine qui héberge Gladys. |
| « Rechercher les passerelles » ne trouve rien | Normal pour une WS2910 ou un GW1000 : ces modèles n'ont pas d'API locale. Utilisez le mode réception. |
| Une mesure manque | Tous les capteurs ne transmettent pas toutes les mesures. Seules celles réellement reçues deviennent des fonctionnalités. |
| Aucune batterie sur un capteur solaire | Ecowitt publie une tension sans documenter de seuil pour les WS80, WS90, WH40 et WH85 : plutôt qu'un état inventé, rien n'est affiché. |
| « Passerelle injoignable à … » | Mode interrogation locale : vérifiez que la passerelle est allumée et que son adresse IP n'a pas changé (attribuez-lui une adresse fixe dans votre box), ou retrouvez-la avec « Rechercher les passerelles ». |
| « Le récepteur des relevés est injoignable (il redémarre peut-être) : nouvel essai automatique. » | Mode réception : le conteneur de réception est peut-être en train de redémarrer. L'intégration réessaie d'elle-même ; si le message persiste, redémarrez l'intégration. |
| « L'initialisation a échoué, consultez les logs de l'intégration. » | Consultez les logs de l'intégration, puis redémarrez-la. |
Les logs de l'intégration se trouvent dans l'onglet Logs de la page de l'intégration dans Gladys.
Paramètres de configuration
Voici les paramètres demandés par Ecowitt dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Envoyer les données de votre station vers Gladys | section | Non | Dans l'application WS View Plus, ouvrez votre station puis Customized : choisissez le protocole Ecowitt et un intervalle de 60 secondes, puis recopiez l'adresse ci-dessous. Les capteurs apparaissent dans l'écran Découverte après le premier relevé, ce qui peut prendre quelques minutes. |
| http://{{gladys_host}}:{{port:ecowitt}}/data/report/ | section | Non | WS View Plus demande les trois champs séparément : serveur {{gladys_host}}, port {{port:ecowitt}}, chemin /data/report/. Si l'adresse ci-dessus contient localhost, 127.0.0.1 ou un nom de domaine (Gladys Plus, reverse proxy), remplacez-la par l'adresse IP locale de la machine qui héberge Gladys : c'est votre station, sur le réseau local, qui doit la joindre — localhost ne veut rien dire pour elle. |
| PASSKEY de la station (facultatif) | string | Non | N'accepter que les relevés de cette station. Laissez vide pour accepter la première station qui se manifeste. |
| Ou interroger une passerelle récente | section | Non | Les GW1100, GW1200, GW2000, GW3000 et les consoles réseau récentes exposent une API locale : renseignez leur adresse IP et Gladys les interroge directement, sans rien configurer sur la station. Les consoles comme la WS2910 ou le GW1000 n'en disposent pas : laissez ce champ vide et utilisez la réception ci-dessus. |
| Adresse IP de la passerelle | string | Non | |
| Mode d'acquisition | select | Non | Les deux sources ne produisent pas les mêmes identifiants : elles ne sont jamais combinées sur une même station. |
| Intervalle d'interrogation (s) | number | Non | Mode polling local uniquement : fréquence de lecture de la passerelle et de rafraîchissement des relevés, 30 ou 60 secondes. |
Comment installer Ecowitt dans Gladys
- Dans Gladys, ouvrez Intégrations : Ecowitt 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/cicoub13/gladys-ecowitt:1.1.3), 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/cicoub13/gladys-ecowitt.
Ecowitt nécessite Gladys >=4.86.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
Ecowitt 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 cicoub13, 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