Le plugin permet de lire les données de production photovoltaïque d’un site SolarEdge via l’API de monitoring v2.
Les informations disponibles sont:
Important
SolarEdge impose un accès externe à Jeedom en HTTPS avec un certificat valide.
Vous ne pourrez pas utiliser le plugin sans avoir cet accès.
| Composant | Version |
|---|---|
| Debian | Bookworm(12) & Trixie(13) |
| Jeedom | >= 4.5 |
| PHP | >= 8.2 |
Afin d’utiliser le plugin, vous devez le télécharger, l’installer et l’activer comme tout plugin Jeedom.
Important
L’API v2 utilise une authentification OAuth. L’ancienne clé API ne permet plus de configurer cette version du plugin.
Vous devez disposer d’un Client Id et d’un Client Secret pour l’accès OAuth SolarEdge. Si vous ne disposez pas encore de ces identifiants, suivez la procédure ci-dessous.
Important
SolarEdge impose un accès externe à Jeedom en HTTPS avec un certificat valide. Une adresse interne ou une adresse sans HTTPS ne peut pas être utilisée comme URL de redirection.
/plugins/onduleursolaredge/core/php/oauth.php, par exemple: https://monjeedom.mondomaine.com/plugins/onduleursolaredge/core/php/oauth.php.SITE_DATA et DEVICE_DATA. Le Client Id et le Client Secret obtenus seront à renseigner dans la configuration du plugin.Le plugin conserve les jetons d’accès et les renouvelle automatiquement. Si le statut indique qu’une autorisation est nécessaire, relancez la liaison.
Les informations du site sont chargées à la sauvegarde si la date d’installation n’est pas encore connue. Le bouton Recharger les détails du site permet de les actualiser: type, date d’installation, puissance crête, fabricant, modèle et nombre d’optimiseurs.
La commande d’action Rafraîchir est créée automatiquement.
Un même équipement peut contenir plusieurs commandes info de production, ajoutez les commandes souhaitées avec le bouton Ajouter une commande.
Pour chaque commande, renseignez un nom, la donnée à récupérer, la période et l’unité. Les commandes ajoutées sont de type information numérique. Vous pouvez choisir de les afficher et de les historiser.
| Donnée | Périodes disponibles | Unités disponibles |
|---|---|---|
| Production photovoltaïque (puissance) | Quart d’heure, heure | W, kW, MW |
| Production photovoltaïque (énergie) | Quart d’heure, heure, jour, semaine, mois, année, total | Wh, kWh, MWh |
| Production photovoltaïque totale | Total | Wh |
La commande de type Production photovoltaïque totale retourne l’énergie produite depuis la mise en service du site en lisant un compteur d’énergie cumulée intégré aux équipements, plutôt que d’additionner les mesures reçues pour chaque intervalle.
SolarEdge utilise le compteur du compteur de production si le site en possède un, ou la somme de ces compteurs s’il en possède plusieurs. À défaut, la valeur correspond à la somme des compteurs d’énergie cumulée des onduleurs.
Contrairement à la commande Production photovoltaïque (énergie) avec la période Total, cette valeur n’est pas affectée par les lacunes de l’historique de transmission: elle reflète la valeur réelle des compteurs, et non la somme des seuls intervalles reçus.
Dans la configuration de l’équipement, l’option Informations globales > Vue d’ensemble active la récupération de la synthèse du site SolarEdge. Au prochain rafraîchissement global, le plugin crée automatiquement huit commandes info: aperçu de la production, autoconsommation, énergie vers la batterie et vers le réseau, aperçu de la consommation, énergie provenant du photovoltaïque, du réseau et de la batterie.
Ces commandes sont mises à jour ensemble par la requête de vue d’ensemble. Leur fréquence se configure avec le champ Auto-actualisation de cette option, qui utilise un cron global au niveau de l’équipement; ce n’est pas le cron individuel des commandes classiques.
Contrairement aux commandes classiques, elles ne proposent pas de choix d’API, de période ou de cron individuel.
Chaque commande d’information dispose également d’un champ cron pour planifier sa propre actualisation. Le bouton ? ouvre l’assistant cron de Jeedom.
Laissez le cron d’une commande vide si vous ne souhaitez pas lui ajouter de planification individuelle. La commande Rafraîchir actualise toutes les commandes d’information de l’équipement, y compris celles qui ont leur propre cron. Elle peut aussi être appelée depuis un scénario.
Chaque commande classique actualisée effectue son propre appel à l’API. La vue d’ensemble effectue un appel API dédié qui met à jour ses huit commandes ensemble. La commande Rafraîchir déclenchant la vue d’ensemble et l’actualisation des commandes classiques, elle peut donc générer plusieurs appels.
SolarEdge impose des limites d’appels API, qui peuvent dépendre de votre accès. Paramétrez les crons individuels et le cron global de la vue d’ensemble en tenant compte de ces limites et du nombre d’équipements et de commandes; évitez également les rafraîchissements manuels trop fréquents.
Pour les commandes de puissance et d’énergie, le plugin demande les mesures depuis le début de la période précédente jusqu’au moment de la requête, puis retient la dernière valeur numérique disponible dans la réponse.
Si le dernier point vaut null, par exemple parce que le quart d’heure en cours n’est pas encore disponible, le plugin utilise le point numérique précédent. Une valeur de 0 est conservée. La valeur affichée ne correspond donc pas nécessairement à une mesure instantanée.
Si aucune valeur numérique n’est disponible, la commande n’est pas mise à jour et un avertissement est écrit dans les logs. Pour la production totale, la valeur est lue directement dans le champ d’énergie renvoyé par SolarEdge.
Attention
La migration vers l’API v2 nécessite de reconfigurer la connexion et les équipements. Les anciens équipements sont désactivés à la mise à jour; leurs anciennes tâches de rafraîchissement sont supprimées.
Si vous avez un problème, commencez par lire les derniers sujets en rapport avec le plugin sur community.
Si malgré tout vous ne trouvez pas de réponse à votre question, n’hésitez pas à créer un nouveau sujet en n’oubliant pas de mettre le tag du plugin (plugin-onduleursolaredge).
Il faudra au minimum fournir:
Texte préformaté (bouton </> sur community), pas de fichiers! Pour un problème de données, le niveau DEBUG permet de voir les réponses de l’API.Avant de publier des captures ou des logs, masquez les identifiants, les jetons OAuth et toute donnée personnelle.