Compteur d'énergie Wi-Fi IAMMETER : Guide d'intégration locale et d'interface ouverte
Compteur d'énergie Wi-Fi IAMMETER : Guide d'intégration locale et d'interface ouverte
Pour les développeurs et les intégrateurs de systèmes utilisant les compteurs IAMMETERsansIAMMETER-Cloud.
Les compteurs d'énergie Wi-Fi IAMMETER sont conçus pour les intégrations basées sur le cloud et locales, fournissant des API ouvertes (HTTP, MQTT, Modbus/TCP) qui permettent aux développeurs de créer leurs propres systèmes de gestion de l'énergie (EMS), systèmes de gestion de bâtiment (BMS) ou plates-formes domotiques intelligentes.
Le firmware IAMMETER est constamment mis à jour. Ce document répertorie toutes les fonctionnalités d'intégration locale et ouverte prises en charge par le dernier firmware.(Continuellement mis à jour)
1) Mise à jour du micrologiciel
Obtenez les dernières versions du firmware ici :
- Page de publication du micrologiciel (imeter.club): https://imeter.club/topic/11
2) Modes d'exécution (hors cloud)
Choisissez un mode en fonction de la façon dont vous intégrez ou utilisez l'appareil.
| Mode | La description | Utilisation typique |
|---|---|---|
| Nuage | Télécharger des données sur IAMMETER-Cloud | 🚫 Non couvert dans cet article |
| TCP | Télécharger sur des serveurs tiers viaTCP/TLSouMQTT | Serveurs locaux, courtiers en douane |
| HTTP | Télécharger sur des serveurs tiers viaHTTP/HTTPS | API REST/backends Web personnalisés |
| MQTT | Télécharger des données directement vers un courtier MQTT | Disponible uniquement dans le dernier firmware |
| Autonome | Aucun téléchargement de données ; le compteur agit comme un serveur local répondant aux API ou aux clients Modbus/TCP | Disponible uniquement dans le dernier firmware |
Interface utilisateur du micrologiciel hérité
Dernier firmwareInterface Web
(Le reste de votre document continue sans changement par rapport à votre dernière version.)
3) Intégration TCP / TLS / MQTT
3.1 TCP et TLS
Les compteurs peuvent envoyer des données directement à votre point de terminaison TCP/TLS.
🔹 Nouvelle configuration du micrologiciel
Le processus de configuration dans le dernier firmware est similaire à celui des versions précédentes.
Mode d'exécution : TCP
Adresse:
- Pour un serveur TCP — entrez
{domaine}:{port}(par exemple,abc.com:12345).
- Pour un serveur TLS — utilisez
tls://{domaine}:{port}(par exemple,tls://abc.com:12345).
Intervalle de téléchargement :L'intervalle de téléchargement minimum est2 secondes.
🔹 Configuration du micrologiciel hérité
- Guide:Intégration de serveur tiers (TCP/TLS)
- Vidéo:Télécharger les données énergétiques sur un serveur tiers
3.2 MQTT
🔹 Nouvelle configuration du micrologiciel
Mode d'exécution : MQTT
Adresse:Entrez l'adresse IP ou le domaine avec le port, par exemple,192.168.11.163:1883
Nom d'utilisateur / Mot de passe:Informations d'identification du courtier MQTT (facultatif si elles ne sont pas requises par le courtier)
Intervalle de téléchargement :L'intervalle minimum est2 secondes. Découverte HA MQTT : Activer la découverte MQTT dans Home Assistant
🔹 Configuration du micrologiciel hérité
Publiez la télémétrie sur un courtier MQTT local ou public.
- Guide:Guide d'intégration MQTT
4) Intégration HTTP / HTTPS
🔹 Configuration du micrologiciel hérité
Les compteurs peuvent publier des données directement sur votre serveur personnalisé.
- Le format de charge utile des données est identique aux modes TCP/MQTT.
- N'importe quel port peut être utilisé.
- Port443active HTTPS automatiquement.
- Détails:Téléchargement via HTTP/HTTPS
🔹 Nouvelle configuration du micrologiciel
Adresse:Le format d'entrée est le même que celui du firmware hérité.
- Si aucun port n'est spécifié, le port par défaut est80.
- Port uniquement443utilise la publication HTTPS ; tous les autres ports utilisent la publication HTTP.
5) API locale (HTTP sur LAN)
Accédez au compteur localement via son IP LAN — aucune connexion cloud requise.
5.1 OBTENIR /api/monitorjson
Renvoie des données de mesure en temps réel.Champs:Tension, courant, puissance active, kWh avant/arrière, fréquence, facteur de puissance.
Exemple:
{
« méthode » : « uploadsn »,
« mac » : « B0F8933C4F94 »,
« version » : « i.75.97.9 »,
« serveur » : « em »,
« SN » : « 3E0BAF87 »,
« données » : [
[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]
]
}📘 Extension de mesure de la puissance réactive
5.2 OBTENIR /api/monitor
Version avancée deMonitorjson, inclut les informations sur le signal Wi-Fi :
SSID(nom du point d'accès connecté)signature(intensité du signal)
5.3 OBTENIR /api/wifidata
Renvoie la configuration Wi-Fi et réseau.
{
« version » : « i.75.97.9 », « SN » : « 3E0BAF87 », « mac » : « B0F8933C4F94 »,
« type » : « PM », « ssid » : « CMCC-laohe », « ip » : « 192.168.11.62 »,
« masque de réseau » : « 255.255.255.0 », « gw » : « 192.168.11.253 »,
« dns » : « 114.114.114.114 », « dhcp » : 1, « runMode » : « tcp », « uploadinterval » : 60
}5.4 OBTENIR /api/uploadinterval?x=<secondes>
Définit l'intervalle de téléchargement (en secondes).
Fonctionne en modes non Cloud (TCP/HTTP/MQTT).
Dans leDernier firmware, ce paramètre peut désormais être configuré directement depuis leInterface WebUI, sans appeler l'API manuellement.
5.5 OBTENIR /api/mqtt
Configure les identifiants MQTT. 📘Documentation de l'API de configuration MQTT
Dans leDernier firmware, ce paramètre peut désormais être configuré directement depuis leInterface WebUI, sans appeler l'API manuellement.
5.6 OBTENIR /api/netmetring
BasculeComptage net d'énergie (NEM)mode. 📘Activer le mode NEM
Dans leDernier firmware, ce paramètre peut désormais être configuré directement depuis leInterface WebUI, sans appeler l'API manuellement.
5.7 OBTENIR /api/ctcratio
AjusteMultiplicateur de phase Cpour les scénarios à phase divisée/équilibrée.
x=2Double les relevés de la phase C (courant, puissance, kWh). 📘Explication du ratio CTC
Dans leDernier firmware, ce paramètre peut désormais être configuré directement depuis leInterface WebUI, sans appeler l'API manuellement.
5.8 OBTENIR /api/réactif
Active ou désactivePuissance réactive (Q)etÉnergie réactive (kVARh)mesure. 📘Documentation sur la puissance réactive
Dans leDernier firmware, ce paramètre peut désormais être configuré directement depuis leInterface WebUI, sans appeler l'API manuellement.
5.9 OBTENIR /api/ratio (disponible uniquement pour WEM3046T)
Depuis leWEM3046Tutilise des TC externes avecSorties secondaires 5A(par exemple, 1 000:5, 1 500:5, 2 000:5, etc.), les valeurs mesurées (courant, puissance, énergie) doivent être multipliées par le rapport du TC.
Exemple:
/api/ratio?x=400- Rapport de réglage :
/api/ratio?x={ct_ratio} - Taux de requêtes :
/api/ratio
SeulementWEM3046Tprend en charge les CT externes 5A — cette API n'est pas valide pour les autres modèles.
6) Cohérence du format JSON
Tous les modes de communication —HTTP, TCP, MQTT, API locale— utiliser la même structure JSON. 📘Définition des données JSON
7) Prise en charge Modbus/TCP
Les compteurs IAMMETER prennent en charge nativementModbus/TCP, permettant une intégration directe avecAssistante à domicile, automates programmables industriels, ouSCADAsystèmes.
8) Scénarios d'intégration pris en charge
| Système | Protocole(s) | Exemple d'utilisation | Référence |
|---|---|---|---|
| Assistante à domicile | HTTP / Modbus / MQTT | Tableau de bord et automatisation | Guide |
| Noeud-ROUGE | HTTP / Modbus / MQTT | Flux d'automatisation | Guide |
| OpenHAB / ioBroker | HTTP | Tableaux de bord locaux | L'intégration |
| ZABBIX | HTTP | Tableaux de bord de surveillance | L'intégration |
| Tableau des choses | HTTP | Visualisation IoT | L'intégration |
| Serveurs personnalisés | HTTP / MQTT / TCP | Ingestion de données d'entreprise ou locales | Créez votre propre système |
9) Ressources
- Versions du micrologiciel
- Tutoriels vidéos
- Définition JSON
- Présentation de Modbus/TCP
- Développez votre propre système
10) Résumé du développeur
| Capacité | Accès | Notes |
| --------------------- | ------------------- | ---------------------------------- |
| Données locales en temps réel | API locale |/api/monitorjson, /api/moniteur|
| Téléchargement tiers | TCP/TLS, HTTP/HTTPS | Même schéma de charge utile |
| Publication MQTT | Courtier MQTT |/api/mqttPour définir les identifiants |
| Net Metering | API locale |/api/netmetring|
| Puissance/énergie réactive | API locale |/api/réactif| | Multiplicateur de phase C | API locale |/api/ctcratio?x=1 | | Rapport CT (WEM3046T) | API locale |/api/ratio?x=` |
| Modbus/TCP | Client Modbus | Compatible avec HA/PLC/SCADA |
Dernière mise à jour : 15 octobre 2025
