Intégration SolarEdge pour Gladys Assistant

Production solaire, consommation, échanges réseau et batterie depuis SolarEdge.

• Publiée par guim31
• Appareils
• Version 1.0.4
• Nécessite Gladys >=4.62.0
• ★ 0

Voir sur GitHubToutes les intégrations externes

Cette intégration connecte votre installation photovoltaïque SolarEdge à Gladys Assistant. Elle lit l'API SolarEdge Monitoring (le même service que l'application mobile) et crée dans Gladys jusqu'à quatre appareils : la production solaire, la consommation de la maison, les échanges avec le réseau et la batterie domestique.

Aucun matériel supplémentaire n'est nécessaire : tout passe par le cloud SolarEdge, en lecture seule. L'intégration ne pilote rien sur votre onduleur.

Ce que vous obtenez

Les appareils créés dépendent de ce que votre installation sait remonter : seuls les sites équipés d'un compteur de consommation (compteur Modbus SolarEdge) exposent la consommation et le réseau, et seuls les sites équipés d'une batterie exposent l'appareil batterie. L'intégration détecte tout cela toute seule au démarrage.

SolarEdge — Production solaire

Toujours créé.

Mesure	Unité	Description
Puissance produite	W	Production instantanée des panneaux
Production du jour	kWh	Énergie produite depuis minuit
Production du mois	kWh	Énergie produite depuis le début du mois
Production de l'année	kWh	Énergie produite depuis le début de l'année
Production totale	kWh	Compteur depuis la mise en service
Revenu du jour*	€ / $	Revenu calculé par SolarEdge selon votre tarif

* Uniquement si vous avez saisi un tarif de rachat dans le portail SolarEdge (voir « Le revenu du jour » plus bas). Sans tarif, la mesure n'est pas créée du tout.

SolarEdge — Consommation

Créé si votre installation dispose d'un compteur de consommation.

Mesure	Unité	Description
Puissance consommée	W	Consommation instantanée de la maison
Consommation du jour	kWh	Énergie consommée depuis minuit
Autoconsommation du jour	kWh	Part couverte par les panneaux et la batterie

SolarEdge — Réseau

Créé si votre installation mesure les échanges avec le réseau.

Mesure	Unité	Description
Puissance réseau	W	Positive si vous soutirez, négative si vous injectez
Énergie soutirée du jour	kWh	Énergie achetée au réseau depuis minuit
Énergie injectée du jour	kWh	Surplus revendu depuis minuit

Le signe de la puissance réseau est ce qui rend les scènes intéressantes : « quand la puissance réseau descend sous −1000 W, allume le chauffe-eau » signifie exactement « utilise le surplus au lieu de le revendre ».

SolarEdge — Batterie

Créé si votre site est équipé d'une batterie (SolarEdge Energy Bank, LG RESU…).

Mesure	Unité	Description
Niveau de charge	%	État de charge de la batterie
Puissance batterie	W	Positive en charge, négative en décharge
État de la batterie	texte	En charge / En décharge / Au repos / Désactivée
Batterie faible	0-1	Indicateur « critique » remonté par SolarEdge
Énergie stockée*	kWh	Énergie réellement disponible dans la batterie
Température batterie*	°C	Température interne du pack

* Uniquement si l'option Télémétrie détaillée de la batterie est activée.

Configuration

1. Obtenir une clé d'API SolarEdge

La clé se génère depuis le portail de supervision SolarEdge, avec un compte ayant les droits d'administration sur le site :

1. Connectez-vous sur https://monitoring.solaredge.com/.
2. Ouvrez Admin → Accès au site (Site Access) → Accès API (API Access).
3. Acceptez les conditions d'utilisation, puis cliquez sur Générer une nouvelle clé et Enregistrer.
4. Copiez la clé (32 caractères en majuscules) ainsi que l'identifiant du site affiché sur la même page.

Si le menu « Accès API » n'apparaît pas, c'est que votre compte n'a pas le rôle administrateur sur l'installation : demandez-le à votre installateur.

2. Renseigner l'intégration

1. Ouvrez l'onglet Configuration de l'intégration dans Gladys.
2. Collez votre clé d'API.
3. Laissez Identifiant du site vide si votre clé ne couvre qu'un seul site : il est détecté automatiquement. Sinon, utilisez le bouton Lister mes sites pour connaître l'identifiant à saisir.
4. Enregistrez, puis appuyez sur Tester la connexion. Le message affiché sous le bouton confirme le nom du site et la liste des appareils disponibles.
5. Les appareils apparaissent dans l'onglet Découverte, prêts à être ajoutés.

3. Régler le rythme de rafraîchissement

SolarEdge limite chaque clé d'API à 300 requêtes par jour et par site. Une fois ce quota dépassé, l'API refuse tout jusqu'au lendemain — l'intégration s'arrête donc d'elle-même avant de l'atteindre.

Le budget se lit ainsi :

• chaque cycle de rafraîchissement coûte 2 requêtes, quel que soit le nombre d'appareils créés (ils partagent tous la même lecture) ;
• le bilan quotidien (consommation, autoconsommation, énergie soutirée et injectée) coûte 1 requête à sa propre cadence, plus lente ;
• la télémétrie détaillée de la batterie, si vous l'activez, coûte 1 requête de plus à la cadence du bilan quotidien.

Avec les valeurs par défaut (15 min pour les valeurs instantanées, 30 min pour le bilan), l'intégration consomme environ 240 requêtes par jour : elle reste dans le budget avec de la marge.

Si vous descendez l'intervalle à 5 minutes, comptez environ 620 requêtes par jour : le quota sera atteint en milieu de journée et les valeurs se figeront jusqu'au lendemain. Le bouton Consommation de l'API vous dit à tout moment où vous en êtes.

Pourquoi les appareils affichent « toutes les minutes » ? Gladys ne sait réveiller une intégration qu'à des cadences prédéfinies, dont la plus lente est une minute. Ce réveil est un simple battement : il ne coûte aucune requête. C'est votre réglage Intervalle de rafraîchissement qui décide si le battement interroge réellement SolarEdge ou se contente de la dernière lecture en cache.

Le revenu du jour

Cette mesure mérite une explication, parce qu'elle est facile à mal interpréter.

SolarEdge ne connaît pas votre contrat. Le revenu qu'il affiche est un calcul que vous paramétrez vous-même dans le portail de supervision, sous Admin → Revenue (accessible avec les droits account manager sur le site). Deux modèles y sont proposés : un tarif forfaitaire au kWh, ou un tarif variable selon l'heure (time of use).

Tant que vous n'avez pas saisi ce tarif, l'API ne renvoie aucun revenu et l'intégration ne crée tout simplement pas la mesure. C'est volontaire : une mesure qui ne pourrait jamais recevoir de valeur ressemblerait à un capteur en panne, alors qu'il s'agit d'une option non configurée. Si vous saisissez le tarif plus tard, relancez une recherche depuis l'onglet Découverte : la mesure apparaîtra.

Pourquoi ce chiffre est trompeur en autoconsommation

Le calcul de SolarEdge est : tarif × énergie produite. Pas × énergie injectée.

Si votre installation est en autoconsommation avec revente de surplus, votre production se partage entre deux flux dont la valeur économique est très différente :

• l'énergie que vous consommez sur place vous évite d'acheter au réseau, au prix de votre contrat de fourniture ;
• le surplus est revendu, au tarif d'obligation d'achat, généralement bien inférieur.

SolarEdge applique un tarif unique à l'ensemble. Résultat : si vous saisissez votre tarif de rachat, le revenu affiché sera nettement surestimé ; si vous saisissez votre prix d'achat, c'est l'économie qui le sera. Le calcul juste serait (kWh autoconsommés × prix d'achat évité) + (kWh injectés × tarif de rachat), ce que ce champ ne sait pas exprimer.

Notre recommandation : ne renseignez ce tarif que si vous savez précisément ce que vous voulez en faire, et gardez à l'esprit que le chiffre porte sur la production totale. Une mesure absente est plus honnête qu'un chiffre faux.

Actions disponibles

• Tester la connexion — vérifie la clé, résout le site et liste les appareils que votre installation sait alimenter.
• Lister mes sites — affiche tous les sites accessibles avec la clé et leur identifiant, à recopier dans le réglage correspondant.
• Rafraîchir maintenant — interroge SolarEdge immédiatement, sans attendre le prochain cycle.
• Consommation de l'API — nombre de requêtes utilisées aujourd'hui et nombre de rafraîchissements restants.

Dépannage

« SolarEdge a refusé la clé d'API » — la clé est invalide, a été régénérée, ou ne donne pas accès à ce site. Régénérez-la depuis le portail et collez-la à nouveau (attention aux espaces en fin de ligne, l'intégration les retire d'elle-même).

« Ce site n'est pas trouvé » ou plusieurs sites — votre clé couvre plusieurs installations : appuyez sur Lister mes sites et recopiez l'identifiant voulu dans le réglage Identifiant du site.

Les appareils Consommation et Réseau n'apparaissent pas — votre installation n'a pas de compteur de consommation. C'est une option matérielle (compteur Modbus) posée par l'installateur ; sans elle, SolarEdge ne connaît que la production.

Une mesure reste vide alors que les autres se remplissent — c'est que SolarEdge ne la remonte pas pour votre site. L'intégration ne publie jamais 0 à la place d'une valeur absente : un 0 serait indiscernable d'une vraie mesure nulle et fausserait vos graphiques et vos scènes. Les cas les plus courants sont un compteur Modbus qui ne communique plus (les énergies soutirée et injectée du jour restent vides, alors que la puissance réseau peut afficher un 0 bien réel remonté par l'onduleur), ou un tarif de rachat non configuré.

Le revenu du jour n'existe pas dans la liste des mesures — c'est normal sans tarif saisi dans le portail SolarEdge : voir « Le revenu du jour » ci-dessus. Après avoir saisi le tarif, relancez une recherche depuis l'onglet Découverte pour que la mesure apparaisse.

Les valeurs ne bougent plus dans l'après-midi — le quota quotidien est probablement atteint. Vérifiez avec Consommation de l'API et augmentez l'intervalle de rafraîchissement. Une pastille orange apparaît alors sur les appareils pour signaler que les valeurs ne sont plus rafraîchies.

Un badge « injoignable » sur les appareils — le cloud SolarEdge ne répond pas. L'intégration réessaie automatiquement ; les logs de l'intégration (LOG_LEVEL=debug pour le détail) indiquent la cause exacte.

Vie privée

L'intégration ne communique qu'avec monitoringapi.solaredge.com, en lecture seule. Votre clé d'API est stockée par Gladys comme un secret et n'est jamais renvoyée à l'interface. Aucune donnée n'est envoyée ailleurs.

Paramètres de configuration

Voici les paramètres demandés par SolarEdge dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Pour commencer	section	Non	Cette intégration lit votre installation via l'API SolarEdge Monitoring. Générez une clé d'API depuis le portail de supervision (Admin > Accès au site > Accès API), collez-la ci-dessous puis appuyez sur « Tester la connexion ». SolarEdge autorise 300 requêtes par jour et par site : l'intervalle de rafraîchissement par défaut reste largement dans ce budget.
Clé d'API	secret	Oui	Clé d'API SolarEdge Monitoring, générée dans Admin > Accès au site > Accès API.
Identifiant du site	string	Non	Identifiant numérique du site. Laissez vide si la clé ne couvre qu'un seul site : il est détecté automatiquement. Utilisez sinon le bouton « Lister mes sites ».
Intervalle de rafraîchissement (s)	number	Non	Fréquence de rafraîchissement des valeurs instantanées (flux de puissance, compteurs de production). Chaque cycle coûte 2 requêtes SolarEdge sur les 300 autorisées par jour, quel que soit le nombre d'appareils.
Intervalle du bilan quotidien (s)	number	Non	Fréquence de rafraîchissement du bilan du jour (consommation, autoconsommation, énergie soutirée et injectée). Volontairement plus lent que les valeurs instantanées : il coûte une requête supplémentaire à chaque fois.
Télémétrie détaillée de la batterie	boolean	Non	Ajoute l'énergie stockée et la température de la batterie, lues sur l'endpoint de stockage. Coûte une requête supplémentaire par cycle de bilan quotidien, et ne concerne que les sites équipés d'une batterie.
Budget de requêtes quotidien	number	Non	L'intégration cesse d'appeler SolarEdge une fois ce nombre de requêtes atteint dans la journée, pour que la clé d'API ne soit jamais bloquée. La limite SolarEdge est de 300 par jour et par site.
Devise des revenus	select	Non	Devise du revenu quotidien remonté par SolarEdge, telle que configurée sur votre site.

Comment installer SolarEdge dans Gladys

1. Dans Gladys, ouvrez Intégrations : SolarEdge apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-solaredge:1.0.4), 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).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-solaredge.

SolarEdge nécessite Gladys >=4.62.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

SolarEdge 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 guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations externes
• Découvrir les intégrations natives intégrées à Gladys
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂