Intégration domotique SolarEdge, gratuite et open source

Production solaire, consommation, échanges réseau et batterie depuis SolarEdge.
Cette intégration connecte votre installation photovoltaïque SolarEdge à Gladys Assistant. Elle lit l'API SolarEdge Monitoring V2 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.
SolarEdge a arrêté l'API V1 le 3 novembre 2026. Depuis, les anciennes clés d'API (celles du portail, Admin → Accès au site → Accès API) sont refusées et les versions 1.x de l'intégration ne reçoivent plus rien. La version 2 passe par la V2 : il faut créer un compte développeur SolarEdge (gratuit) et connecter l'intégration une fois. Voir « Mise à jour depuis la version 1.x » plus bas.
Cette version a été écrite d'après la documentation officielle de la V2, sans compte V2 réel pour la tester : vos retours sont les bienvenus.
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 totale | kWh | Compteur depuis la mise en service |
La production totale est le compteur de l'onduleur (ou du compteur de production), relu une fois par jour, plus la production du jour.
Le revenu du jour des versions 1.x n'existe plus : l'API V2 ne le fournit pas.
La production du mois et de l'année ne sont pas des mesures : elles s'affichent dans le widget Production solaire. Gladys n'a pas de type pour une énergie remise à zéro chaque mois ou chaque année, et le type le plus proche est compté par Gladys comme une consommation de la maison (voir « Mise à jour depuis la version 1.1.0 »).
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 |
| Index soutiré* | kWh | Énergie achetée au réseau depuis la mise en service |
* Si le compteur SolarEdge mesure l'énergie soutirée.
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 ».
Les énergies « du jour » (consommation, autoconsommation, soutirée, injectée) sont des totaux depuis minuit, publiés avec le type index du jour de Gladys : le module énergie de Gladys ne les compte pas comme une consommation à facturer.
Le module Énergie de Gladys
Le module Énergie de Gladys (consommation et coût par demi-heure, tableau de bord énergie, contrat) lit un index : un compteur qui ne fait que monter. L'Index soutiré est cet index. C'est l'énergie que vous achetez au réseau, celle que votre fournisseur facture. Gladys lui ajoute « (consumption) » et « (cost) » et calcule votre consommation facturée avec le tarif de votre contrat. La consommation de la maison ne sert pas d'index : elle inclut le solaire autoconsommé, qui ne vous coûte rien.
L'intégration lit le compteur de soutirage du compteur SolarEdge une fois par jour et lui ajoute le soutirage du jour : il avance au rythme des rafraîchissements, et ne descend jamais.
Si vous avez déjà un compteur Linky dans Gladys comme compteur principal, il mesure la même énergie : l'Index soutiré se range sous lui par défaut, et vous pouvez désactiver son historique si vous ne voulez pas de doublon.
Un site sans compteur SolarEdge (onduleur seul) n'a pas d'Index soutiré : SolarEdge ne connaît que sa production.
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 | Niveau de charge à 10 % ou moins |
| É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.
La V2 ne donne plus l'indicateur « critique » de SolarEdge (le flux de puissance en direct est réservé aux offres développeur payantes) : Batterie faible signale désormais un niveau de charge de 10 % ou moins.
Widgets du tableau de bord
Avec Gladys 5.1 ou plus récent, l'intégration propose trois widgets (Modifier le tableau de bord → Ajouter un widget). Ils se construisent à partir de ce que l'intégration a déjà en mémoire : afficher un widget ne coûte jamais de requête SolarEdge, même sur dix tableaux de bord ouverts. Les tuiles et les graphiques sont liés aux mesures des appareils, et se mettent à jour en direct dès qu'une valeur est publiée ; le bilan du jour vient de la dernière lecture SolarEdge, dont l'heure est indiquée sous « Actualisé à ».
Les appareils doivent avoir été ajoutés depuis l'onglet Découverte : une tuile liée à une mesure qui n'existe pas dans Gladys reste vide.
- Flux d'énergie — l'installation en un coup d'œil. Jusqu'à quatre tuiles en direct : production, consommation, réseau (positive en soutirage, négative en injection) et batterie (positive en charge, négative en décharge), selon ce que votre site mesure. Une courbe des puissances (production, consommation et réseau) sur la période choisie dans les réglages du widget (24 heures ou une semaine). Puis le bilan du jour : production, consommation, autoconsommation, énergie soutirée et injectée, et niveau de la batterie avec son état. Le bouton Actualiser interroge SolarEdge immédiatement, comme le bouton Rafraîchir maintenant de la configuration : il compte dans le budget de requêtes, et quand le budget du jour est épuisé le widget le dit au lieu d'appeler l'API.
- Production solaire — la production du jour, du mois, de l'année et depuis la mise en service en tuiles (sans décimale à partir de 1000 kWh ; le mois, l'année et le total viennent de la dernière lecture SolarEdge), la courbe de puissance des panneaux sur la période choisie (24 heures, une semaine ou un mois) et l'heure de la dernière lecture.
- Batterie — la jauge du niveau de charge, la puissance de la batterie, son état (En charge en vert, En décharge en bleu, Au repos ou Désactivée en gris), l'énergie stockée et la température si la télémétrie détaillée de la batterie est activée, et une ligne rouge Batterie faible à 10 % ou moins. Sur un site sans batterie, le widget l'indique simplement.
Les widgets se rafraîchissent toutes les cinq minutes au plus, et dès qu'une nouvelle lecture SolarEdge arrive. Les valeurs ne bougent donc pas plus vite que votre intervalle de rafraîchissement : c'est le même budget de crédits SolarEdge qui s'applique.
Configuration
Il faut Gladys 5.2 ou plus récent (le bouton « Connecter » est apparu avec la 5.2).
1. Créer le compte développeur et l'application SolarEdge
C'est le chemin prévu par SolarEdge pour un particulier (guide « Homeowner and Self-Access » de la documentation SolarEdge). Il est gratuit.
- Allez sur https://developer.solaredge.com/ et connectez-vous avec vos identifiants mySolarEdge (ceux du propriétaire du site). Remplissez le profil développeur : comme nom de société, votre nom suffit (lettres sans accent et chiffres seulement) ; secteur « Other / Hobbyist », usage « Low - personal project ». L'offre Free est activée d'office : 2 000 crédits par mois.
- Cliquez sur Create Application : un nom (« Gladys », par exemple), le service Monitoring API, puis l'accès Site Access.
- Dans la configuration OAuth de l'application :
- Redirect URI : l'adresse affichée dans Gladys sous le bouton
Connecter (onglet Configuration de l'intégration), en général
https://my.gladysassistant.com/redirect/oauth; - Origin URL :
https://my.gladysassistant.com; - portées (scopes) : SITE_DATA et DEVICE_DATA (sans DEVICE_DATA, seule la production est disponible).
- Redirect URI : l'adresse affichée dans Gladys sous le bouton
Connecter (onglet Configuration de l'intégration), en général
- Copiez le Client ID et le Client Secret. Le secret n'est affiché qu'une fois.
- Notez l'identifiant de votre site : application mySolarEdge, détails du site, ou le nombre dans la barre d'adresse du portail https://monitoring.solaredge.com/.
Seul le propriétaire du site peut le connecter. Si votre compte n'est pas propriétaire, demandez à votre installateur de vous déclarer comme tel (ou utilisez le formulaire de transfert de propriété de SolarEdge).
2. Connecter l'intégration
- Ouvrez l'onglet Configuration de l'intégration dans Gladys.
- Renseignez le Client ID, le Client Secret et l'Identifiant du site, puis enregistrez.
- Appuyez sur Connecter. La page SolarEdge s'ouvre : connectez-vous avec vos identifiants mySolarEdge, choisissez le site si vous en avez plusieurs, puis autorisez. Vous revenez dans Gladys et l'état passe à « connecté ».
- Appuyez sur Tester la connexion : le message confirme le nom du site et la liste des appareils disponibles.
- Les appareils apparaissent dans l'onglet Découverte, prêts à être ajoutés.
L'autorisation se renouvelle seule toutes les deux heures. Elle n'expire qu'après 14 jours sans aucun rafraîchissement (Gladys arrêtée deux semaines, par exemple) : l'état de la connexion le dit alors, et il suffit d'appuyer de nouveau sur Connecter.
Installateurs : avec un compte installateur et une application Fleet Access, collez plutôt la clé d'API Fleet dans le champ prévu, sans « Connecter ». L'identifiant du site peut rester vide si la clé ne couvre qu'un site ; sinon, Lister mes sites donne les identifiants.
3. Le rythme de rafraîchissement
L'offre gratuite donne 2 000 crédits par mois pour tout le compte développeur, et chaque appel à l'API en coûte un. Une fois les crédits épuisés, SolarEdge refuse tout jusqu'au cycle de facturation suivant : l'intégration ne dépense donc jamais plus de 1/31 de vos Crédits mensuels par jour (64 avec l'offre gratuite), en gardant une petite réserve pour vos boutons.
Un rafraîchissement coûte :
- 2 requêtes pour un onduleur seul (le bilan du jour et la puissance) ;
- 1 de plus avec un compteur (puissances de la maison et du réseau), sauf si ce compteur mesure aussi la production ;
- 1 de plus avec une batterie, et encore 1 avec la Télémétrie détaillée de la batterie (la température) ;
- et chaque jour, 2 ou 3 requêtes pour le mois, l'année, la production totale et l'Index soutiré.
L'intégration allonge d'elle-même votre Intervalle de rafraîchissement jusqu'à tenir dans ce budget. Avec l'offre gratuite, comptez une lecture toutes les 50 minutes environ pour un onduleur seul, toutes les 80 minutes avec un compteur, toutes les 1 h 45 avec un compteur et une batterie. Le bouton Consommation de l'API donne l'intervalle réellement appliqué.
Avec une offre payante (Business Starter : 20 000 crédits), renseignez vos Crédits mensuels : l'intervalle descend jusqu'à celui que vous avez choisi, 15 minutes au plus court (la résolution la plus fine de l'API). Si d'autres applications utilisent le même compte développeur, baissez ce réglage d'autant.
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. L'intégration interroge SolarEdge d'elle-même et publie les valeurs elle-même ; un battement de Gladys se contente de la dernière lecture en cache.
Mise à jour depuis la version 1.x (API V2)
- Mettez Gladys à jour en 5.2 ou plus si besoin, puis l'intégration.
- Suivez « Configuration » ci-dessus : compte développeur, application, Connecter. L'ancienne clé d'API ne sert plus (vous pouvez vider le champ ; laissée telle quelle, elle est ignorée dès que l'application est renseignée).
- Vos appareils et leur historique sont conservés : mêmes identifiants, mêmes mesures. Si votre site avait un tarif, l'appareil Production solaire affiche Mettre à jour dans l'onglet Découverte : le cliquer supprime la mesure Revenu du jour, que la V2 ne fournit plus (avec son historique). Sans clic, elle reste simplement figée.
- Le Revenu du jour disparaît aussi des widgets, et le réglage Devise des revenus du formulaire.
Mise à jour depuis la version 1.2.0
Sur un site avec compteur, l'appareil SolarEdge — Réseau affiche Mettre à jour dans l'onglet Découverte : cliquez-le pour ajouter l'Index soutiré. Rien n'est supprimé. Sur un site sans compteur, rien ne change.
Mise à jour depuis la version 1.1.0
La version 1.1.0 publiait la production du mois, la production de l'année et les énergies soutirée et injectée du jour (et l'énergie stockée de la batterie) avec un type que Gladys 5.1 traite comme un compteur de consommation. Gladys leur ajoutait alors deux mesures à lui, « … (consumption) » et « … (cost) » : votre production et votre surplus revendu étaient comptés comme de la consommation de la maison, et facturés. Sur un site sans compteur, la 1.1.0 créait aussi un appareil Réseau toujours à 0 W et une mesure Revenu du jour toujours vide.
Après la mise à jour de l'intégration :
- Ouvrez l'onglet Découverte de l'intégration. Chaque appareil concerné
affiche Mettre à jour : cliquez-le, appareil par appareil. Gladys
applique alors la nouvelle liste de mesures :
- les mesures que l'intégration ne publie plus (production du mois, de l'année, revenu du jour sans tarif) sont supprimées, avec leur historique ;
- les mesures « (consumption) » et « (cost) » que Gladys avait ajoutées sont supprimées, avec leur historique : c'est ce qui retire la fausse consommation de vos tableaux de bord énergie ;
- les mesures qui changent seulement de type (énergies du jour, énergie stockée) restent les mêmes et gardent leur historique.
- Sur un site sans compteur de consommation, l'appareil SolarEdge — Réseau n'est plus proposé du tout (et l'intégration ne lui envoie plus rien). Supprimez-le depuis l'onglet Appareils de l'intégration : ses mesures « (consumption) » et « (cost) » partent avec lui.
- Si un widget ou une scène utilisait une mesure supprimée, reprenez-le : les widgets SolarEdge, eux, s'adaptent seuls.
Tant que vous n'avez pas cliqué « Mettre à jour », Gladys garde les anciens types en base et continue de calculer une fausse consommation à partir des énergies soutirée et injectée du jour, que l'intégration publie toujours.
Actions disponibles
- Tester la connexion — vérifie l'accès SolarEdge, résout le site et liste les appareils que votre installation sait alimenter.
- Lister mes sites — avec une clé Fleet, tous les sites qu'elle couvre et leur identifiant ; avec « Connecter », le site autorisé.
- Rafraîchir maintenant — interroge SolarEdge immédiatement, sans attendre le prochain cycle (dans le même budget).
- Consommation de l'API — requêtes utilisées aujourd'hui, part quotidienne des crédits mensuels, coût d'un rafraîchissement et intervalle réellement appliqué.
Dépannage
« SolarEdge a arrêté son API V1 » — l'intégration n'a pas encore d'application V2 : suivez « Configuration ».
« SolarEdge a refusé l'accès » — vérifiez l'Identifiant du site (il doit être celui que vous avez autorisé), et que l'application a bien la portée DEVICE_DATA. Une ancienne clé d'API V1 laissée seule dans le champ Fleet aboutit aussi ici.
« L'accès à SolarEdge a expiré ou a été refusé » — le Client Secret est faux, ou l'autorisation a expiré (14 jours sans rafraîchissement) ou a été révoquée : vérifiez le secret, enregistrez, puis appuyez sur Connecter.
« Connecter » affiche une erreur de redirection chez SolarEdge — l'adresse de redirection déclarée dans l'application SolarEdge doit être exactement celle affichée sous le bouton dans Gladys.
Les appareils Consommation et Réseau n'apparaissent pas — votre installation n'a pas de compteur (option matérielle posée par l'installateur), ou l'application n'a pas la portée DEVICE_DATA. L'intégration ne crée un appareil que pour une valeur réellement mesurée.
Une mesure reste vide alors que les autres se remplissent — 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. Seule exception, la puissance produite : un onduleur endormi (la nuit) n'envoie rien, et cela vaut 0 W.
Les valeurs ne bougent plus — le budget du jour est atteint (il repart à minuit UTC), ou les crédits du mois sont épuisés (ils repartent au cycle de facturation suivant). Consommation de l'API dit où vous en êtes ; une pastille orange apparaît sur les appareils.
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. Le Client Secret et la clé Fleet sont stockés par Gladys comme des
secrets, jamais renvoyés à l'interface ; les jetons d'accès sont gardés par
l'intégration dans sa configuration, hors du formulaire. Pendant « Connecter »,
SolarEdge renvoie votre navigateur vers la page de redirection de Gladys
(my.gladysassistant.com), qui le renvoie aussitôt vers votre instance : elle
voit passer le code d'autorisation, inutilisable sans le Client Secret. 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 | SolarEdge a arrêté son API V1 (et ses clés d'API) le 3 novembre 2026. Pour lire votre installation : 1. connectez-vous sur developer.solaredge.com avec vos identifiants mySolarEdge et créez le compte développeur gratuit ; 2. créez une application, service Monitoring API, accès « Site Access », portées SITE_DATA et DEVICE_DATA, et déclarez l'adresse de redirection affichée sous le bouton « Connecter » ci-dessous ; 3. collez son Client ID et son Client Secret, ainsi que l'identifiant de votre site (application mySolarEdge, détails du site), puis enregistrez ; 4. appuyez sur « Connecter » et autorisez avec vos identifiants mySolarEdge. L'offre gratuite donne 2 000 requêtes par mois : l'intervalle de rafraîchissement s'y adapte. |
| Client ID | string | Non | Client ID de votre application « Site Access », dans la console développeur SolarEdge. |
| Client Secret | secret | Non | Affiché une seule fois, à la création de l'application. |
| Identifiant du site | string | Non | Identifiant numérique de votre site (application mySolarEdge, détails du site ; ou barre d'adresse du portail de supervision). Obligatoire avec « Connecter » ; peut rester vide avec une clé Fleet qui ne couvre qu'un site. |
| Accès SolarEdge | oauth2 | Non | Enregistrez d'abord les champs ci-dessus, puis connectez-vous avec vos identifiants mySolarEdge (ceux du propriétaire du site). À refaire seulement si l'accès expire (14 jours sans aucun rafraîchissement). |
| Clé d'API Fleet (installateurs) | secret | Non | Seulement pour un compte installateur avec une application « Fleet Access », à la place de « Connecter ». Les anciennes clés d'API V1 ne fonctionnent plus. |
| Intervalle de rafraîchissement (s) | number | Non | Intervalle souhaité entre deux lectures. Allongé automatiquement pour tenir dans les crédits mensuels : environ toutes les 50 min pour un onduleur seul avec l'offre gratuite, davantage avec un compteur ou une batterie (voir « Consommation de l'API »). |
| Crédits mensuels | number | Non | Allocation mensuelle de votre compte développeur SolarEdge (2 000 avec l'offre gratuite, 20 000 avec Business Starter). L'intégration en dépense au plus 1/31 par jour. Baissez-la si d'autres applications partagent le compte. |
| Télémétrie détaillée de la batterie | boolean | Non | Ajoute la température de la batterie. Coûte une requête de plus par rafraîchissement (donc un intervalle plus long), et ne concerne que les sites équipés d'une batterie. |
Comment installer SolarEdge dans Gladys
- Dans Gladys, ouvrez Intégrations : SolarEdge 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/guim31/gladys-solaredge:2.0.0), 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/guim31/gladys-solaredge.
SolarEdge nécessite Gladys >=5.2.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, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation