Compteur d'énergie Wi-Fi IAMMETER : API locales et interfaces ouvertes

Compteur d'énergie Wi-Fi IAMMETER : API locales et interfaces ouvertes

Les compteurs d'énergie Wi-Fi IAMMETER prennent en charge IAMMETER-Cloud ainsi que les intégrations locales et tierces.

Les interfaces disponibles incluent :

• API HTTP locale sur le LAN
• Publication MQTT et MQTTS
• Modbus TCP
• Upload TCP/TLS
• Upload HTTP/HTTPS
• Opération locale autonome

Ces interfaces permettent aux compteurs IAMMETER d'agir comme sources de données ouvertes pour :

• Home Assistant et autres plateformes domotiques
• Automatisation Node-RED
• Tableaux de bord auto-hébergés
• Systèmes PLC et SCADA
• Systèmes de gestion d'énergie (EMS) personnalisés
• Systèmes de gestion technique du bâtiment (BMS) personnalisés
• Serveurs de données tiers

Ce guide décrit d'abord le firmware actuel et la WebUI actuelle. Les captures d'écran et méthodes de configuration pour les firmwares plus anciens sont conservées dans la section Legacy finale.

Pour une application prête à l'emploi basée sur ces capacités, voir Surveillance énergétique domestique, Surveillance de l'énergie solaire, ou surveillance locale sans accès Internet.

1) Mise à jour vers le dernier firmware

Le firmware IAMMETER est mis à jour en continu. Avant de configurer une intégration, vérifiez la version actuelle et la compatibilité du modèle :

• Page des versions du firmware IAMMETER

La WebUI du dernier firmware expose directement les options de configuration les plus courantes. Les appels API de configuration manuelle conservés plus loin dans cet article sont principalement utiles lors de la maintenance d'installations anciennes.

2) Choisir le mode de fonctionnement dans la WebUI actuelle

Sélectionnez un mode de fonctionnement selon l'endroit où le compteur doit envoyer les données ou comment il doit fonctionner localement.

Le mode de fonctionnement contrôle le comportement d'upload des données. La disponibilité de l'API locale et de Modbus TCP doit être vérifiée pour le modèle de compteur, le firmware et l'intégration choisie.

3) Pourquoi les interfaces ouvertes sont importantes

Les interfaces ouvertes permettent aux utilisateurs de décider où les données électriques sont traitées et stockées.

Les raisons typiques incluent :

• Conserver les mesures au sein du réseau local
• Envoyer la télémétrie vers un serveur existant
• Connecter les données énergétiques à Home Assistant ou Node-RED
• Créer des tableaux de bord et alarmes personnalisés
• Combiner les données électriques avec la logique tarifaire, solaire ou de contrôle de charge
• Fonctionner sur un site avec un accès Internet limité ou peu fiable

L'accès Cloud et local ne sont pas nécessairement mutuellement exclusifs. L'architecture appropriée dépend du projet : rapports IAMMETER-Cloud, plateforme locale, serveur tiers, ou une combinaison.

4) Envoyer des données vers un serveur tiers

4.1 TCP et TLS

IAMMETER peut envoyer les données du compteur vers un endpoint TCP ou TLS.

Dans la WebUI actuelle :

1. Sélectionnez le mode de fonctionnement TCP.
2. Saisissez l'adresse de destination.
3. Configurez l'intervalle d'upload.
4. Enregistrez les paramètres et vérifiez les données sur le serveur récepteur.

Pour un serveur TCP, utilisez :

{domaine-ou-ip}:{port}

Exemple :

abc.com:12345

Pour un serveur TLS, utilisez :

tls://{domaine-ou-ip}:{port}

Exemple :

tls://abc.com:12345

La vue d'ensemble du firmware actuel documente un intervalle d'upload minimum de 2 secondes. Confirmez la version actuelle du firmware et la capacité du serveur récepteur avant de sélectionner un intervalle court.

4.2 MQTT et MQTTS

IAMMETER peut publier la télémétrie directement vers un broker MQTT standard ou utiliser MQTTS pour un transport chiffré sur les firmware compatibles.

Dans la WebUI actuelle :

1. Sélectionnez le mode de fonctionnement MQTT.
2. Saisissez l'adresse IP ou le domaine du broker et le port en utilisant le format MQTT ou MQTTS approprié.
3. Saisissez le nom d'utilisateur et le mot de passe du broker lorsque l'authentification est requise.
4. Configurez l'intervalle d'upload.
5. Enregistrez et vérifiez que les messages arrivent au broker.

Pour MQTT standard, saisissez l'adresse et le port du broker sans préfixe mqtt:// :

192.168.11.163:1883

Pour MQTTS, incluez le préfixe mqtts:// :

mqtts://{adresse-broker-mqtt}:{port}

Exemple :

mqtts://broker.example.com:8883

La prise en charge MQTTS documentée dans la mise à jour du firmware de novembre 2025 présente les limitations actuelles suivantes :

• Prend en charge TLS 1.2 et versions inférieures.
• L'upload d'un certificat CA personnalisé n'est pas pris en charge.
• La vérification du nom d'hôte n'est pas prise en charge.
• Les certificats côté client pour l'authentification TLS mutuelle ne sont pas pris en charge.

Ces limitations sont importantes lors du choix d'un broker et de l'évaluation des exigences de sécurité du déploiement.

La vue d'ensemble du firmware actuel documente un intervalle d'upload minimum de 2 secondes.

Home Assistant MQTT Discovery est une fonction de découverte supplémentaire pour Home Assistant ; elle n'est pas requise pour chaque intégration MQTT. Voir :

• Guide d'intégration MQTT IAMMETER
• MQTT Discovery dans Home Assistant

Modifier uploadInterval à distance via MQTT/MQTTS

Avec le firmware décrit dans la mise à jour de novembre 2025, un compteur en mode MQTT s'abonne automatiquement à :

device/{sn}/config

Publiez le JSON suivant depuis un autre client MQTT pour modifier l'intervalle d'upload à distance :

{"uploadInterval": 10}

Remplacez 10 par l'intervalle souhaité en secondes et {sn} par le numéro de série du compteur dans le sujet.

Cette configuration MQTT à distance est différente de l'ancienne méthode locale /api/uploadinterval conservée dans la section Legacy.

4.3 HTTP et HTTPS

IAMMETER peut envoyer des données vers un serveur HTTP/HTTPS personnalisé.

Dans la WebUI actuelle :

1. Sélectionnez le mode de fonctionnement HTTP.
2. Saisissez l'adresse du serveur et le port.
3. Configurez l'intervalle d'upload.
4. Enregistrez et vérifiez les requêtes sur le serveur.

Le firmware actuel prend en charge à la fois le port HTTPS par défaut et un port HTTPS personnalisé.

Utilisez l'un de ces formats :

• HTTP standard sans port explicite : {adresse} — utilise le port 80 par défaut.
• HTTP standard avec un port personnalisé : {adresse}:{port}.
• HTTPS sans port explicite : https://{adresse} — utilise le port 443 par défaut.
• HTTPS avec un port personnalisé : https://{adresse}:{port} — utilise le port spécifié.

Le préfixe https:// sélectionne HTTPS. Le port 443 n'est plus le seul port disponible pour HTTPS.

Exemples :

api.example.com
api.example.com:8080
https://api.example.com
https://api.example.com:8443

Voir Nouveau firmware ajoute MQTTS, la configuration à distance et le port HTTPS personnalisé pour les notes de version du firmware.

Pour la gestion des données côté serveur, voir aussi Intégrer IAMMETER avec un serveur tiers.

5) Lire les données localement via HTTP

Connectez le compteur au LAN et interrogez les données depuis son adresse IP locale. Ces requêtes ne nécessitent pas IAMMETER-Cloud.

5.1 GET /api/monitorjson

Retourne les mesures électriques en temps réel.

Les données standard incluent des valeurs telles que :

• Tension
• Courant
• Puissance active
• kWh importé/consommé
• kWh exporté/généré
• Fréquence
• Facteur de puissance

Exemple de réponse :

{
  "method": "uploadsn",
  "mac": "B0F8933C4F94",
  "version": "i.75.97.9",
  "server": "em",
  "SN": "3E0BAF87",
  "Datas": [
    [220.0, 9.99, 2198, 11.337, 11.201, 49.99, 1.00],
    [222.5, 9.99, 1100, 11.039, 10.908, 49.99, 0.50],
    [263.5, 9.99, 1213, 10.975, 10.846, 49.99, 0.55]
  ]
}

Le nombre de tableaux de mesures dépend du modèle de compteur et du nombre de canaux.

Si la mesure de puissance réactive est activée sur un modèle/firmware compatible, le format de réponse peut contenir des champs supplémentaires. Voir Format des données de mesure de puissance réactive.

5.2 GET /api/monitor

Retourne une réponse étendue en temps réel qui inclut également les informations Wi-Fi telles que :

• ssid — nom du point d'accès connecté
• sig — intensité du signal Wi-Fi

Utilisez cet endpoint lorsqu'une intégration nécessite à la fois les mesures électriques et l'état Wi-Fi de base.

5.3 GET /api/wifidata

Retourne les informations de configuration du firmware, de l'appareil et du réseau.

Exemple :

{
  "version": "i.75.97.9",
  "SN": "3E0BAF87",
  "mac": "B0F8933C4F94",
  "type": "PM",
  "ssid": "example-wifi",
  "ip": "192.168.11.62",
  "netmask": "255.255.255.0",
  "gw": "192.168.11.1",
  "dns": "192.168.11.1",
  "dhcp": 1,
  "runMode": "tcp",
  "uploadinterval": 60
}

Ne publiez pas de réponses contenant des numéros de série d'appareils, des adresses MAC, des adresses internes ou des informations Wi-Fi sauf si les valeurs ont été anonymisées.

6) Format JSON pour tous les modes d'upload

IAMMETER utilise une structure de mesure JSON centrale cohérente pour HTTP, TCP, MQTT et l'API locale. Cela réduit le travail nécessaire lorsqu'un système récepteur prend en charge plusieurs méthodes de transport.

La méthode de transport et l'enveloppe peuvent néanmoins affecter la façon dont un récepteur se connecte, s'authentifie ou formate un message. Implémentez le système récepteur conformément au format documenté pour le mode sélectionné.

• Définition des données JSON du compteur d'énergie IAMMETER

7) Modbus TCP

Les compteurs IAMMETER prennent en charge Modbus TCP pour l'intégration LAN directe avec des clients compatibles.

Les clients typiques incluent :

• Home Assistant
• Automates (PLC)
• Systèmes SCADA
• Passerelles industrielles
• Applications Modbus personnalisées

Références :

• Vue d'ensemble Modbus TCP IAMMETER
• Vue d'ensemble de l'intégration Home Assistant

Confirmez le modèle de compteur, le firmware, la définition des registres, l'intervalle d'interrogation et le comportement du client avant le déploiement.

8) Scénarios d'intégration

9) Résumé et ressources des interfaces actuelles

Ressources supplémentaires :

• Dernier firmware
• Note sur le firmware MQTTS et port HTTPS personnalisé
• Tutoriels vidéo
• Définition des données JSON
• Vue d'ensemble Modbus TCP
• Développer votre propre système
• Surveillance sans accès Internet

Les API locales et les protocoles ouverts d'IAMMETER permettent de commencer par une surveillance en temps réel, puis d'ajouter ultérieurement un EMS personnalisé, un tableau de bord auto-hébergé ou un flux d'automatisation.

10) Pages et méthodes de configuration du firmware legacy

Le contenu suivant est conservé uniquement pour les compteurs utilisant encore un firmware plus ancien ou pour les utilisateurs maintenant une intégration existante. Pour une nouvelle installation, mettez à jour vers le dernier firmware et utilisez la WebUI actuelle lorsque l'option requise est disponible.

10.1 Page de sélection du mode legacy

Les firmwares plus anciens utilisaient la page de sélection de mode suivante :

La disposition et les noms des options peuvent ne pas correspondre à la WebUI actuelle présentée plus haut dans ce guide.

10.2 Page TCP/TLS legacy

Les intégrations de firmware plus ancien peuvent faire référence à cette page de configuration TCP/TLS et au guide associé :

• Guide d'intégration serveur tiers legacy
• Vidéo d'upload vers serveur legacy

10.3 Page MQTT legacy

La documentation MQTT plus ancienne utilisait cette interface de configuration :

Pour le flux de travail actuel, utilisez les instructions de la WebUI actuelle plus haut dans cet article et le Guide d'intégration MQTT mis à jour.

10.4 Page HTTP/HTTPS legacy

Les firmwares plus anciens utilisaient la page de destination HTTP/HTTPS suivante :

Le guide d'intégration legacy est conservé dans Upload via HTTP/HTTPS.

Dans ce flux de travail plus ancien, HTTPS était associé au port par défaut 443 et ne nécessitait pas le préfixe https://. Le firmware actuel utilise plutôt le préfixe https:// pour sélectionner HTTPS et prend en charge soit le port par défaut 443, soit un port personnalisé explicitement spécifié.

10.5 API de configuration legacy

Les appels API locaux suivants apparaissaient dans les flux de configuration précédents. Dans le firmware actuel, les paramètres correspondants doivent normalement être configurés via la WebUI lorsque l'option est disponible.

/api/uploadinterval?x=<secondes>

Méthode legacy pour définir l'intervalle d'upload non-Cloud.

/api/mqtt

Méthode legacy pour configurer les identifiants MQTT.

/api/netmetring

Méthode legacy pour activer ou désactiver le mode Net Energy Metering.

• Référence Net Energy Metering

/api/ctcratio

Méthode legacy pour appliquer le multiplicateur de phase C documenté dans des scénarios spécifiques split-phase ou équilibrés.

• Référence CTC Ratio

/api/reactive

Méthode legacy pour activer ou désactiver la mesure de puissance réactive et d'énergie réactive sur les firmware/modèles compatibles.

• Référence puissance réactive

/api/ratio — WEM3046T uniquement

Le WEM3046T utilise des TC externes avec des sorties secondaires de 5 A. Les instructions de configuration plus anciennes définissent le rapport TC avec :

/api/ratio?x={rapport_tc}

Exemple :

/api/ratio?x=400

Cet endpoint est spécifique au WEM3046T et n'est pas valide pour les autres modèles IAMMETER. Pour le firmware actuel, utilisez la configuration WebUI du modèle lorsqu'elle est disponible.

Contenu legacy conservé pour référence ascendante ; les installations actuelles doivent suivre la WebUI du dernier firmware.