IAMMETER ajoute la prise en charge de SunSpec Modbus/TCP : mappage des modèles et guide d'intégration

Le firmware IAMMETER i.91.065.18 ajoute une table de modèles de compteurs SunSpec (nombres entiers), en lecture seule, au service Modbus/TCP existant. Elle offre aux logiciels qui comprennent les modèles SunSpec un moyen standard de découvrir un compteur IAMMETER et de lire certaines valeurs électriques sur le réseau local.

Il s'agit d'un ajout d'interface, et non d'un système de mesure de remplacement. Le compteur continue de collecter les données de la même manière. Les registres Modbus IAMMETER existants, l'API HTTP, les charges utiles MQTT et les réglages NEM restent inchangés.

SunSpec définit des modèles d'informations d'appareil standard qui peuvent être mappés dans des registres holding Modbus. Sa table commence par un marqueur SunS, suivi des modèles Common et spécifiques à l'appareil qu'un client peut découvrir en lisant successivement l'ID et la longueur de chaque modèle. Le package de spécifications SunSpec Modbus documente le schéma de découverte des modèles, y compris les emplacements de la table Modbus en base 0 et les règles applicables aux valeurs non implémentées. SunSpec Modbus est utilisé dans de nombreuses intégrations d'énergie distribuée, notamment pour les compteurs, les onduleurs et les équipements de stockage.

IAMMETER implémente un sous-ensemble ciblé en lecture seule pour les données du compteur. Cette implémentation n'est pas certifiée SunSpec. Ne considérez pas cette fonctionnalité comme une certification, une conformité totale à SunSpec ou une garantie que chaque client SunSpec tiers fonctionnera sans configuration.

Mappages actuels du modèle de micrologiciel

Ces lignes décrivent les mappages actuels du modèle de micrologiciel. La validation des appareils physiques rapportée ici couvre uniquement le WEM3080T ; les autres modèles répertoriés nécessitent toujours des tests de périphérique.

Pour WEM2067, le modèle 202 représente une véritable installation en phase divisée. Il ne décrit pas deux circuits monophasés non liés comme étant le même agencement électrique.

Le code du modèle 204 a une couverture de test hôte, mais le micrologiciel ne le détecte pas encore automatiquement et ne le sélectionne pas pour WEM3080TD. Cet article ne revendique donc pas la disponibilité du modèle 204. Le WEM3046TE n’a pas encore reçu de vérification d’identification de modèle dédiée. La première version fournit uniquement des modèles entiers : les modèles flottants 211 à 214 ne sont pas disponibles.

Ce qu'un client peut lire

Les modèles de compteurs entiers exposent la tension de phase, le courant de phase, la puissance active de phase, la puissance active totale, la fréquence, le facteur de puissance de phase et les accumulateurs d'énergie active d'importation/exportation par phase et totale. Le modèle commun fournit des données d'identification de l'appareil telles que le modèle, la version du micrologiciel et le numéro de série.

L'énergie est représentée en Wh sur la carte SunSpec ; le facteur de puissance est représenté sous forme de pourcentage. Les points d'énergie totale réutilisent les champs totaux existants du compteur et Sémantique NEM. IAMMETER ne recalcule pas un total triphasé en ajoutant les accumulateurs de phase dans cette cartographie. Étant donné que le paramètre NEM affecte la signification de ces accumulateurs, un client ne doit pas supposer que l'énergie totale est toujours égale à la somme de l'énergie de phase.

Certains champs sont volontairement absents dans cette première version : puissance réactive et énergie réactive, puissance apparente et énergie apparente, facteur de puissance totale multiphasé et drapeaux d'événements. Leurs emplacements standard restent dans le modèle et renvoient le marqueur indisponible approprié. Un client SunSpec doit reconnaître les valeurs indisponibles plutôt que de les interpréter comme des mesures.

L'interprétation de la tension est importante

Les valeurs de phase proviennent du compteur. Certains points de tension entre phases sont dérivés pour le mappage du modèle :

• La tension de ligne du modèle 202 correspond à UA + UB.
• La tension de ligne du modèle 203 est une approximation de la tension de phase multipliée par √3 ; il ne s'agit pas d'une mesure directe entre phases. Un système déséquilibré ou un écart d'angle de phase peut introduire une erreur.

Cette distinction est importante pour les applications qui nécessitent une tension entre phases mesurée directement. Vérifiez la définition du point du modèle et le schéma de raccordement avant d'utiliser une valeur dérivée pour des décisions de contrôle ou de conformité.

Connectez-vous avec Modbus/TCP

Activez le service Modbus/TCP existant du compteur, puis connectez-vous à son adresse LAN :

Les adresses de ce guide sont des adresses de requête Modbus basées sur 0. Certaines applications affichent des numéros de registre basés sur 1, alors vérifiez leur convention avant de configurer une lecture ; une adresse décalée ne renverra pas le marqueur attendu.

Utilisez le code de fonction 03 pour chaque lecture ci-dessous. Le nombre de registres inclut l'ID du modèle et la longueur, le cas échéant.

Une requête Modbus ne peut pas lire plus de 125 registres, lisez donc les modèles communs et de compteur séparément. Les clients doivent découvrir les ID et les longueurs des modèles plutôt que de coder en dur une hypothèse sur chaque séquence future du modèle.

Valeurs entières et facteurs d'échelle

Les points entiers SunSpec utilisent des facteurs d'échelle. Convertissez un entier brut avec :

valeur réelle = entier du registre × 10^facteur d'échelle

Par exemple :

W = 12345
W_SF = 1
puissance active réelle = 123450 W

Les facteurs d'échelle peuvent varier selon la plage. Lisez un modèle de compteur complet à chaque cycle d'interrogation afin que la valeur et son facteur d'échelle proviennent de la même réponse. Ne mettez pas les facteurs d'échelle en cache indéfiniment.

Validation et limites actuelles

La validation a deux portées distinctes :

• Validation de l'implémentation : tests hôtes réussis pour la présentation du modèle, la conversion, le débordement, le comportement en lecture seule et les contrôles de régression pour les registres existants. Un compteur de test WEM3080T a confirmé la découverte du modèle 203 et des lectures continues, avec une tension et une puissance vérifiées par rapport aux interfaces HTTP et Modbus existantes. D'autres modèles de compteurs et des clients tiers individuels nécessitent encore des tests physiques supplémentaires.
• Vérification du fichier de version : le firmware i.91.065.18 a été compilé, mis en ligne puis téléchargé à nouveau pour vérifier le fichier. Ce fichier de version exact n'a pas été flashé pendant ce cycle de validation ; les résultats d'implémentation ci-dessus ne doivent pas être considérés comme un test de périphérique du fichier de version téléchargé.

Le micrologiciel n'inclut pas l'amélioration du tramage TCP en attente. Il attend actuellement une requête complète dans une opération de réception. Les requêtes TCP fractionnées ou combinées peuvent fermer la connexion. Envoyez une requête et attendez sa réponse avant la requête suivante, tout en reconnaissant que cela n'élimine pas tous les risques de segmentation TCP.

Où cela s'intègre-t-il dans une installation IAMMETER

Pour la sélection de l'architecture, commencez par Solutions d'intégration et d'auto-hébergement IAMMETER. Le API locales et guide d'interface ouverte compare les interfaces de compteur disponibles.

Utilisez la carte SunSpec lorsqu'un client local est créé pour découvrir et lire les modèles de compteurs SunSpec. Utilisez la carte de registre IAMMETER Modbus/TCP lorsqu'une application a besoin de registres spécifiques à IAMMETER. Le chemin Modbus local existant reste utile pour l'intégration du compteur d'énergie Home Assistant, tandis que HTTP, MQTT et IAMMETER Cloud restent des options indépendantes.

Téléchargez le firmware : i.91.065.18.bin.

Avant la mise à jour, suivez les instructions de mise à niveau du micrologiciel IAMMETER et vérifiez le modèle de votre compteur, la méthode de connexion et l'accès au réseau local. Il s'agit d'une interface de données en lecture seule ; il ne fournit pas de contrôle de l'onduleur, d'opérations d'écriture ou de revendication d'interopérabilité complète avec SunSpec par des tiers.

Partagez votre intégration SunSpec avec IAMMETER et gagnez 5 000 à 10 000 Reward Points

Utilisez du matériel réel pour lire les données d’un compteur IAMMETER via SunSpec. Les résultats obtenus avec un simulateur ne sont pas admissibles.

Les participants qui fournissent une documentation d’intégration détaillée et la publient sur un forum public peuvent recevoir 5 000 à 10 000 Reward Points après examen par IAMMETER. Le montant dépend de la qualité et de l’exhaustivité du document.

Ouvrez la page de l’activité et cliquez sur Apply pour participer.