Netatmo (intégration externe) — présentation + récap jusqu’à la v1.3.0
Bonjour à tous
Je me rends compte que je n’ai jamais ouvert de sujet dédié à l’intégration externe Netatmo, alors qu’elle existe depuis cet été (v1.0.0 le 21 juillet 2026, disponible pour tous depuis l’arrivée des intégrations externes avec Gladys 4.84). Je rattrape mon retard : voici une présentation complète et le récap des versions jusqu’à la v1.3.0, qui vient de sortir. Ce sujet servira ensuite pour annoncer les nouveautés et recueillir vos retours.
C’est quoi ?
C’est la version « intégration externe » du service Netatmo de Gladys : elle tourne dans son propre conteneur, s’installe depuis le catalogue d’intégrations et c’est là que les nouveautés Netatmo arrivent désormais (caméras, accessoires de sécurité, temps réel…).
Ce qui est pris en charge
Météo : station (NAMain) et modules extérieur, vent, pluie et intérieurs (température, min/max, humidité, CO2, bruit, pression, vent, rafales, pluie…).
Énergie : thermostat (NATherm1), relais (NAPlug) et vannes (NRV), avec consigne modifiable depuis Gladys (par pas de 0,5 °C).
Caméras intérieure (NACamera) et extérieure Presence (NOC) : image sur le tableau de bord (récupérée en local en priorité), interrupteur de surveillance, flux en direct avec la qualité de votre choix.
Accessoires de sécurité : capteur porte/fenêtre (NACamDoorTag), sirène intérieure (NIS), détecteur de fumée (NSD).
Batterie et signal de chaque module, et un badge « injoignable » quand Netatmo signale un module hors ligne (Gladys arrête alors de republier ses dernières valeurs).
Temps réel avec Gladys Plus (optionnel) : avec votre clé Open API, les changements remontent en 2-3 secondes au lieu de 2 minutes, et vous gagnez des déclencheurs de scène : mouvement, personne détectée, animal et véhicule (Presence), fumée.
Installation
Créez votre propre application sur Netatmo Connect pour obtenir un client id et un client secret (pas de scope ni d’URL de redirection à configurer).
Dans Gladys : Intégrations → cherchez Netatmo → Installer.
Onglet Configuration : collez le client id / secret, Enregistrer, puis Connecter.
Choisissez les familles d’appareils (Énergie, Météo, Sécurité), enregistrez, et créez vos appareils depuis Découverte.
Le pas-à-pas complet est dans la documentation de l’intégration (lien « Documentation » sur l’écran de configuration).
Le récap des versions
v1.0.0 (21 juillet) : connexion OAuth2, appareils Météo et Énergie, consigne du thermostat, caméras (image, surveillance, flux en direct).
v1.0.1 : fiabilisation (reprise après coupure Netatmo, délais, jetons), réglage de la qualité vidéo, plus de fausses valeurs pour les modules hors ligne.
v1.1.0 : webhooks Gladys Plus (temps réel), capteur porte/fenêtre, sirène et détecteur de fumée, documentation FR/EN.
v1.1.2 : les images de caméra trop lourdes sont réduites au lieu d’être ignorées.
v1.2.0 : détections en temps réel (mouvement, personne, animal, véhicule, fumée) utilisables dans les scènes.
v1.3.0 (16 octobre) :
tag Cloud et classement dans les catégories Climat, Sécurité et Environnement du catalogue ;
toute l’intégration en français, anglais, allemand et espagnol (configuration, messages, documentation) ;
mise à niveau technique (SDK, outillage de release, notes de version sur GitHub).
Prérequis
Gladys ≥ 4.86.0 pour la v1.3.0.
Une application Netatmo Connect à votre nom (gratuit).
Gladys Plus uniquement si vous voulez le temps réel et les détections.
Vous venez du service Netatmo intégré ? Gardez votre historique !
Les appareils de l’intégration externe ont de nouveaux identifiants (ext:netatmo:*) et sont créés comme de nouveaux appareils, mais depuis Gladys 4.84.1 vous pouvez migrer chaque ancien appareil vers son remplaçant : l’historique, les scènes et les tableaux de bord suivent.
Avant de commencer : ne supprimez pas vos anciens appareils Netatmo (la migration part d’eux), et migrez peu après avoir créé les nouveaux (si les deux ont enregistré des valeurs sur la même période, seul l’historique antérieur à la première valeur du nouvel appareil est repris, pour ne rien compter en double).
Installez l’intégration externe, connectez-la et créez vos appareils depuis l’onglet Découverte.
Choisissez l’Appareil de destination (le nouvel appareil, sous l’intégration externe Netatmo).
Vérifiez la Correspondance des fonctionnalités : elle est pré-remplie, ajustez si besoin (surtout les lignes de température des thermostats et stations). « Ne pas migrer » supprime l’historique de la fonctionnalité concernée.
Cliquez sur Migrer et supprimer l’ancien appareil.
Gladys déplace l’historique, met à jour vos scènes et tableaux de bord, reprend la pièce, puis supprime l’ancien appareil. Pour un gros historique, suivez l’avancement dans Paramètres → Tâches (une migration interrompue peut être relancée, elle ne reprend que ce qui reste).
En cours, côté cœur de Gladys
Deux demandes de @smuteau nécessitent une évolution du cœur, les PR sont proposées :
le niveau de batterie affiché sur la carte de chaque appareil (onglet Appareils) — l’intégration publie déjà la batterie ;
la photo de chaque appareil, comme avec le service intégré (les images resteront dans le conteneur de l’intégration).
Retours bienvenus
Tout remonte bien chez vous (météo, thermostats, vannes) ?
Caméras : image, flux en direct, détections avec Gladys Plus ?
Les traductions allemande / espagnole, pour ceux qui utilisent Gladys dans ces langues.
Un modèle Netatmo non reconnu (ex. sonnette, volets Bubendorff/iDiamant) ? Dites-le ici ou ouvrez une issue.
Salut @Terdious, je te proposerais une PR pour le thermostat car j’ai fait un fork de mon côté pour ajouter des infos qui me manquaient. Ou je te ferais un point sur ce que j’ai besoin.
Grosse mise à jour de l’intégration externe Netatmo, et au passage la version minimale passe à Gladys 5.2.0.
Nouveaux appareils
Volets roulants Bubendorff / iDiamant (NBR, NBO, NBS) : ouvrir / fermer / stop et position, via le nouvel interrupteur « Volets roulants ».
Sonnette vidéo : image sur le tableau de bord et déclencheur de scène « Si la sonnette sonne ».
Détecteur de monoxyde de carbone : alerte CO utilisable dans les scènes, avec pré-alarme.
Home Coach (qualité de l’air) : température, humidité, CO2, bruit, pression et indice de qualité de l’air (avec couleur sur le tableau de bord et HomeKit, plus le niveau en toutes lettres), via l’interrupteur « Qualité de l’air ».
Nouveautés Gladys 5.x
Mode de chauffage de la maison (Planning / Absent / Hors-gel) sur les thermostats et vannes. @Will_71, n’hésite pas à me dire si ça correspond à ce que tu souhaitais faire et sinon me faire une PR par dessus.
Scènes : déclencheurs « une personne connue arrive / part », « la sirène sonne » ; actions « changer le mode de chauffage », « marquer absent / présent ».
Widgets de tableau de bord : Météo Netatmo, Chauffage Netatmo, Caméras Netatmo.
Fiabilité
La météo continue de remonter même si le service météo Netatmo tombe en panne, et une panne prolongée s’affiche (badge Dégradé + message dans la configuration).
La fin d’une alerte fumée (« fumée dissipée ») ne redéclenche plus les scènes fumée.
À faire après la mise à jour
Gladys 5.2.0 minimum pour recevoir cette version.
Pour la sonnette et les volets : recliquer sur « Connecter » dans la configuration (nouvelles autorisations Netatmo ; l’écran l’indique si besoin).
Pour les appareils déjà créés : Découverte → Mettre à jour sur les thermostats / vannes (mode de chauffage).
Appel aux testeurs
Tout a été développé d’après l’API Netatmo (et vérifié avec ce que font Home Assistant / pyatmo et openHAB), mais sans tout le matériel sous la main. Si vous avez un détecteur de CO, une sonnette, des volets Bubendorff ou un Home Coach, vos retours (et un extrait de l’onglet Journaux) sont les bienvenus ici !
Nouvelle version mineure. Elle demande toujours Gladys 5.2.0 minimum (5.2.1 conseillée).
Chauffage
Thermostat modulant / OpenTherm (OTM + relais OTH) : il fonctionne comme le thermostat classique (température, consigne, mode de chauffe, état de la chaudière, batterie). Le relais remonte la température extérieure et un binaire Défaut chaudière.
BTicino Smarther avec thermostat Netatmo (BNS) : température, consigne, mode de chauffe, état de la chaudière et de la climatisation. Il faut de nouvelles autorisations Netatmo : cliquez à nouveau sur « Connecter » dans la configuration de l’intégration (l’écran vous le rappelle).
Chauffage avancé, 4 nouvelles actions de scène :
consigne d’une pièce, avec une durée optionnelle ;
boost d’une pièce ;
retour au planning ;
choix du planning de chauffe.
Le widget chauffage affiche aussi le planning actif, signale les pièces en manuel ou en boost, et propose un bouton « Changer de planning ».
Caméras et sécurité
Caméra intérieure Advance (NPC) : image sur le tableau de bord, surveillance on / off, détections de mouvement et de personne. Elle apparaît dans le widget caméras. Elle aussi demande de cliquer à nouveau sur « Connecter ».
Limite : comme la sonnette, elle ne diffuse son direct qu’en WebRTC, que Gladys ne sait pas encore lire. Pour l’instant, on a donc l’image seulement. Deux pistes sont à l’étude.
Projecteur de la caméra extérieure (NOC) : le mode allumé / éteint / auto devient deux fonctionnalités, Projecteur (une lumière : allumé = forcé) et Mode automatique du projecteur (un interrupteur). Une scène « tout éteindre » ne coupe jamais le mode auto. Sur les caméras déjà créées, faites Mettre à jour dans l’écran Découverte.
Une seule fonctionnalité « mode » est proposée côté Gladys. On migrera dès qu’elle sera disponible.
Présence des personnes connues des caméras : un appareil « - Personnes connues », avec une présence par personne nommée dans l’application Netatmo, mise à jour en temps réel par les webhooks.
Corrigé
Un rafraîchissement déclenché par un webhook repart toujours de données Netatmo fraîches.
À tester sur du vrai matériel
Si vous avez un thermostat OpenTherm, un Smarther, une caméra Advance ou une caméra extérieure, vos retours sont précieux : valeurs remontées, commandes du projecteur, défaut chaudière.
Petit point sur les limites de ces deux versions : elles sont toutes déjà réglées par des PR core et SDK qui attendent leur merge. @pierre-gilles, quand tu auras un moment pour les relire
Le Home Coach donne un niveau sur 5 crans (bon → très mauvais), pas un indice. En attendant, l’intégration convertit ce niveau en un indice approximatif, avec le libellé en français uniquement. Une fois ces PR mergées, on passe à un type standard « niveau de qualité de l’air », traduit et avec historique :
La piste retenue : le direct WebRTC négocié par le navigateur. Gladys se contente de relayer l’offre et la réponse à l’intégration, comme le fait Home Assistant pour ces caméras. Le flux va directement du cloud Netatmo au navigateur : pas de conversion, le son est conservé, très peu de latence, et ça marche aussi via Gladys Plus.
Côté intégration, je prépare le branchement pour la sonnette (NDB) et la caméra Advance (NPC) (#70). Il restera inactif tant que Gladys ne le prend pas en charge. Je pourrai le valider sur ma propre sonnette.
Le nouveau type standard « mode de fonctionnement » d’un éclairage (éteint / allumé / auto / planning) servira à toutes les lumières qui ont un mode auto : projecteurs de caméras, éclairages à détecteur, Zigbee, Matter… Une fois mergé, les deux fonctionnalités du projecteur n’en feront plus qu’une (#69).
Une fois activé, les modules de l’interphone sont découverts : poste intérieur, platine de rue, gâche, éclairage d’escalier, prise et module X. Pour l’instant, on a leur signal et l’indicateur « injoignable ».
Activer l’interrupteur demande 4 autorisations Netatmo supplémentaires : cliquez à nouveau sur « Connecter » (l’écran de configuration vous le rappelle). Si vous n’avez pas d’interphone BTicino, rien ne change pour vous, aucune reconnexion n’est nécessaire.
C’est une étape de relevé. Un journal [bticino-diagnostic] enregistre les données brutes de ces modules, en masquant les jetons, les clés et les e-mails. Si vous avez un Classe 300, vos journaux m’aideront à ajouter la sonnerie comme déclencheur de scène, l’ouvre-porte et l’éclairage d’escalier. Pensez à les relire avant de les poster.
Direct WebRTC de la sonnette et de la caméra Advance (préparé)
L’intégration sait déjà relayer le direct WebRTC de la sonnette (NDB) et de la caméra intérieure Advance (NPC). Elle ne l’active qu’une fois que Gladys le prend en charge (PR core #3215 et SDK #43). D’ici là, rien ne change : vous gardez l’image fixe.
Netatmo (intégration externe) — présentation + récap jusqu’à la v1.3.0
C’est quoi ?
Ce qui est pris en charge
Installation
Le récap des versions
Prérequis
Vous venez du service Netatmo intégré ? Gardez votre historique !
En cours, côté cœur de Gladys
Retours bienvenus
Volets roulants Bubendorff / iDiamant (NBR, NBO, NBS) : ouvrir / fermer / stop et position, via le nouvel interrupteur « Volets roulants ».
Sonnette vidéo : image sur le tableau de bord et déclencheur de scène « Si la sonnette sonne ».
Détecteur de monoxyde de carbone : alerte CO utilisable dans les scènes, avec pré-alarme.
Home Coach (qualité de l’air) : température, humidité, CO2, bruit, pression et indice de qualité de l’air (avec couleur sur le tableau de bord et HomeKit, plus le niveau en toutes lettres), via l’interrupteur « Qualité de l’air ».
Mode de chauffage de la maison (Planning / Absent / Hors-gel) sur les thermostats et vannes. 
Scènes : déclencheurs « une personne connue arrive / part », « la sirène sonne » ; actions « changer le mode de chauffage », « marquer absent / présent ».
Widgets de tableau de bord : Météo Netatmo, Chauffage Netatmo, Caméras Netatmo.
Notes de version complètes : 
Documentation : 
Caméras et sécurité
Corrigé
Direct WebRTC de la sonnette et de la caméra Advance (préparé)