Présentation

Netatmo Energie pour Jeedom Plugin permettant de contrôler les thermostats et vannes Netatmo par pièce.

Ce plugin vous donne la possibilité de :

• Connaitre la plupart des informations (consigne, températures…)
• Choisir le mode de fonctionnement du thermostat (Programme, Consigne manuelle, Absent, Hors gel)
• Connaître et changer le planning en cours
• Connaître le profil de température en cours/suivant
• Définir le jour et l’heure de fin des modes (manuel/absent/hors gel)
• …etc

*(1) : plugin testé en configuration “thermostat + chaudière compatible” *(2) : selon votre équipement, certaines fonctions ne seront pas disponibles.

Aperçu du plugin

Page du plugin

Installation d’un plugin

Configuration

Comment installer ce plugin ?

1. Rendez-vous sur la page du market Jeedom et téléchargez la dernière version du plugin.

1. Une fois le plugin installé, renseignez vos informations de connexion Netatmo :

• Client ID : client ID (obtenu sur https://dev.netatmo.com/apps)
• Client secret : client secret (obtenu sur https://dev.netatmo.com/apps)
• email : adresse mail de votre compte Netatmo
• Mot de passe : mot de passe de votre compte Netatmo

(*) Pour accéder à l’API Netatmo, il est indispensable d’avoir un compte Netatmo et de créer une application sur https://dev.netatmo.com/apps/createanapp#form. Vous devez simplement remplir un formulaire pour générer ces informations (Client ID, Client secret).

Si vous n’y parvenez pas, demandez de l’aide à vos amis.

Cliquez sur le bouton “Sauvegarder” puis sur “Synchroniser” : ceci permet de synchroniser Jeedom avec votre compte Netatmo pour découvrir automatiquement vos équipements. Actualisez la page (touche F5) pour faire apparaitre les équipements.

Configuration

Configuration des équipements

Préalable : vous avez déjà renseigné les paramètres d’authentification et synchronisé le plugin avec les serveurs Netatmo. (Voir section 2 “Comment installer ce plugin ?”)

La configuration des équipements Netatmo Energie est accessible à partir du menu Plugin => Confort => naEnergie :

Une fois que vous cliquez sur un équipement, vous obtenez :

Vous retrouvez ici toute la configuration de votre équipement :

• Nom de l’équipement : nom de votre équipement (vous pouvez le modifier librement).
• Objet parent : objet parent auquel appartient l’équipement; c’est là que la tuile apparait.
• Activer : active l’équipement et synchronise ses informations périodiquement.
• Visible : rend l’équipement visible sur le dashboard.
• Identifiant : identifiant unique de l’équipement.
• Type : type d’équipement (Thermostat pour pièces avec thermostat / Valve pour vannes seulement).

Configuration des commandes infos et actions

Les commandes disponibles pour votre équipement sont accessibles depuis l’onglet Commandes. Elles sont classées par type : infos ou actions.

• Afficher : active l’affichage de la commande sélectionnée (uniquement pour tuiles core).
• Historiser : historise la donnée de la commande info sélectionnée.
• Configuration avancée (petite roue crantée) : affiche la configuration avancée de la commande (méthode d’historisation, widget…)
• Evaluer : retourne la valeur de la commande info sélectionnée.
• Tester : teste la commande action sélectionnée.

Ce paramètre est disponible dans la page de l’équipement “Type de la tuile” :

• Default : le plugin utilise la tuile personnalisée (conseillé).
• Core : la tuile est gérée par le core Jeedom.

WIDGET

Voici le widget standard pour un thermostat :

Widget mobile :

Lors du changement de mode de widget, il est conseillé de cliquer sur synchroniser pour voir le résultat immédiatement.

layout: default title: Changelog naEnergie lang: fr_FR pluginId: naEnergie —

Changelog

Netatmo-Energie - Plugin pour Jeedom (Intégration des thermostats et vannes NETATMO).

• Installation du plugin Netatmo-Energie.
• Topic dédié au plugin Topic community.
• Documentation du plugin.

Liste des évolutions majeures de la version courante :

Liste non exhaustive. Les changements mineurs et/ou corrections de bugs ne figurent pas forcément ici.

Version 29/03/2026 (Beta)

Architecture/Fiabilité

• Réécriture complète du code
• Extraction de class naEnergieCmd dans naEnergieCmd.php
• Découpage de naEnergie : naEnergieTherm (actions thermostat) et naEnergieSync (cron/webhook/sync) *…

Webhook

• Correction bug critique wbhook_last qui cassait silencieusement la chaîne.
• Nouvel événement boiler_status : mise à jour directe de la commande sans refresh complet.
• Événement schedule : mise à jour directe de nowplanid/nowplanning sans attendre le refresh.

Gestion des erreurs & logs

• Nouveau helper naEnergie::logErr() : bascule les logs error en warning selon la config.
• Option “Logs discrets” (log_error_as_warning) dans la page de configuration.
• Compteur naEnergie_nbRequest : incrémenté dans NA_ApiClient::api(), alerte à 50 req, reset en cronDaily.
• Correction initialisation manquante de $eqErr_Ar dans errMgmt().
• Logs warning exhaustifs dans NA_ApiClient::wRequest() avec trace de l’appelant.

Sécurité

• naEnergie.ajax.php : validation du paramètre type avant construction du chemin de fichier (prévention path traversal).

API Client

• Correction de bugs divers.

Frontend

• naEnergie.js : remplacement total de jQuery par vanilla JS + domUtils.ajax / jeedomUtils.showAlert.

Version 25/02/2024 (Beta)

• Ajout des thermostats (Smarther with Netatmo)
• Améliorations de la page de configuration des équipements
• …

Version 21/08/2023 (Beta/Stable)

• Améliorations des widgets Météo
• Améliorations de la gestion/déclaration des erreurs liées aux équipements Météo
• Améliorations des alertes (Batterie) liées aux équipements
• Bug-Fix Divers.
• …

Version 14/08/2023 (Beta/Stable)

• Intégration Prévisions météo “partie Météo”
• Bug-Fix Divers.

Version 06/08/2023 (Beta/Stable)

• Bug-Fix Divers sur la partie Météo.

Version 05/08/2023 (Stable)

• Passage de Beta en Stable (voir 03/08/2023).

Version 03/08/2023 (Beta)

• Bug-Fix modules « Commande Intelligente de Climatiseur ».
• Widgets personnalisés et personnalisables (isoTile, isoLine) pour les équipements Météo
• …

Version 15/07/2023 (Beta)

• Mise à jour majeure.
• Prise en charge des nouveaux modules « Commande Intelligente de Climatiseur ».
• Prise en charge des modules « Netatmo-Météo ».
• …

Version 23/12/2022

• Bug-Fix Perte Auto-Adapt.
• Bug-Fix Disparition des tuiles Custom suite à une mise à jour.
• …

Version 23/10/2022

• Amélioration du protocole AuthFlow pour pallier aux manquements des utilisateurs
• Conformité de la présentation des commandes pour Jeedom v4.3 (Affichage des valeurs)

Version 23/09/2022

• Amélioration du protocole AuthFlow pour une meilleure interactivité

Version 17/09/2022

• Prise en charge du protocole AuthFlow pour l’authentification (nécessite d’obtenir une autorisation depuis le site Netatmo)

Version 20/10/2021 (Beta)

• !!!! Mise à jour majeure !!!!
• Intégration des thermostats intelligents (Netatmo OpenTherm) y compris gestion ECS
• Importantes modifications dans le code du plugin
• Optimisations globales du traitement des données API
• Optimisations de la gestion des erreurs
• Optimisations des tuiles (dashboard)
• Panel (en version beta)

Version 01/12/2020

• Optimisations diverses (error logs,…)
• Correction et amélioration des tuiles (dashboard, mobile)
• Modification commande action “consigne” de type slider à type message avec endtime
• Amélioration de la prise en charge de la commande “endtime” saisie en minutes/format date/timestamp

Version 09/10/2020

• Arrêt du support pour le plugin en Jeedom V3. Donc pour Jeedom V4:
  • Optimisations diverses (error logs,…)
  • Mise à jour des commandes (Type Generic)
  • Compatibilité avec l’app mobile Jeedom
  • Prise en charge des retours Webhook
  • …

Version 1.0 27/04/2020

• Correction et amélioration mineures des tuiles (dashboard, mobile)
  • Signalement et affichage des alertes “error” sur la tuile.

Version 25/03/2020

• Installation de plugins
• Mise à jour de plugins