API locales du micrologiciel IAMMETER
IAMMETER prend en charge les API HTTP locales. Consultez la documentation officielle pour connaître les capacités réelles de l'appareil. Ce simulateur implémente uniquement le sous-ensemble répertorié ci-dessous.
Parcours et séances
Préfixez chaque point de terminaison du compteur avec /WEM3080, /WEM2067 ou /WEM3050T. Les pages des appareils et les API prennent en charge HTTP sur le port 80 ainsi que HTTPS sur le port 443. Les appareils physiques utilisent normalement le HTTP local.
Les demandes de mesures publiques fonctionnent sans session et renvoient la source Inverter and grid par défaut. Les paramètres privés nécessitent le cookie de page de compteur existant. Une requête curl distincte n’hérite pas de la source ou des paramètres sélectionnés de votre navigateur.
HTTP et HTTPS utilisent des sessions de navigateur distinctes. Ouvrez la page du compteur en utilisant le même schéma avant de modifier les paramètres. Les lectures anonymes utilisent la source Inverter and grid par défaut.
Sous-ensemble d'API de micrologiciel pris en charge
| Méthode | Point de terminaison | But | Modèles pris en charge |
|---|---|---|---|
| GET | /api/monitor | Lire la tension, le courant, la puissance et l'énergie. | Tous les modèles |
| GET | /api/monitorjson · /monitorjson | Lisez le JSON existant, avec des données réactives facultatives. | Tous les modèles |
| GET | /api/wifidata | Lisez les paramètres du Wi-Fi virtuel et de l'appareil. | Tous les modèles |
| POST | /api/setwifiadv | Enregistrez les paramètres Wi-Fi virtuels pour cette session et ce modèle. | Tous les modèles |
| GET | /api/getadv | Lire les paramètres avancés et de téléchargement ; le mot de passe est vide. | Tous les modèles |
| POST | /api/setadv | Enregistrez les paramètres de téléchargement, les indicateurs Reactive et NEM. | Tous les modèles ; NEM uniquement sur WEM3050T |
Réponses aux mesures
WEM3080 renvoie Data ; WEM2067 et WEM3050T renvoient Datas avec une ligne par canal. L’ordre des champs est indiqué ci-dessous. Les exemples sont des exemples et non des réponses en direct.
| Indice | Mesures | Unité |
|---|---|---|
| 0 | Tension | V |
| 1 | Courant | A |
| 2 | Puissance active | W |
| 3 | Énergie importée | kWh |
| 4 | Énergie exportée | kWh |
| 5 | Fréquence | Hz |
| 6 | Facteur de puissance | — |
Lire les mesures publiques
curl 'https://simulator.iammeter.com/WEM3050T/api/monitor'Forme de réponse
{
"ssid": "IAMMETER-Simulator",
"sig": 100,
"mac": "020000003050",
"version": "simulator-1.0",
"server": "em",
"SN": "1AD9B537",
"model": "WEM3050T",
"Datas": [
[230.0,1.252,270.0,2.092,0.000,50.00,0.94],
[229.5,0.487,110.0,1.280,0.000,50.00,0.98],
[229.0,0.399,90.0,0.747,0.000,50.00,0.98]
]
}Paramètres Wi-Fi virtuel
setwifiadv accepte ssid, pwd, DHCP (booléen), ip, netmask, gw et dns. Ces valeurs modifient uniquement le périphérique virtuel ; ils ne reconfigurent pas une carte réseau.
Exemple de corps de requête
{"ssid":"Test network","dhcp":true}Sauvegarde réussie
{"successful":1,"message":"ok"}Paramètres avancés
setadv accepte les mises à jour JSON partielles. Les champs non spécifiés conservent leurs valeurs actuelles. L'intervalle de téléchargement est de 10 à 3 600 secondes.
Reactive ajoute EA.Reactive à monitorjson et télécharge, pas api/monitor. Chaque ligne est [var, kvarh inductif, kvarh capacitif].
NEM est pris en charge uniquement par WEM3050T. Sa quatrième ligne Datas additionne séparément la puissance active, les kWh importés et les kWh exportés ; tous les autres champs sont nuls.
| Paramètre | Valeurs acceptées |
|---|---|
| runMode | 1 = TCP/TLS ; 2 = HTTP/HTTPS ; 3 = MQTT/MQTTS ; 4 = stand alone |
| uploadAddress | Adresse du destinataire ; suivez l'indice de saisie Settings. |
| mqttUsername · mqttPassword | Informations d'identification du courtier ; getadv ne renvoie jamais le mot de passe enregistré. |
| uploadInterval | 10 à 3 600 s |
| reactive | 0 / 1 |
| netmetering | 0 / 1 |
| ntpServer | Texte stocké uniquement ; ne change pas l'heure du serveur. |
| haDiscovery · ctcRatio | Seulement 0 et 1 respectivement ; les fonctionnalités ne sont pas implémentées. |
Activer Reactive et NEM sur WEM3050T
{"reactive":1,"netmetering":1}Vérification des résultats
Une sauvegarde réussie renvoie successful=1. Des valeurs de paramètre non valides peuvent renvoyer HTTP 200 avec successful=0 ; vérifiez le JSON ainsi que le code d'état. Les sessions manquantes renvoient 401 ; les écritures d’origine croisée sont rejetées.
La sauvegarde des paramètres de téléchargement ne prouve pas la livraison. Vérifiez l'état de téléchargement du débogage et confirmez les messages sur votre récepteur.
Non mis en œuvre
Les fonctions ci-dessous sont uniquement affichées ou ne sont pas prises en charge. Ils ne fournissent pas d’API d’écriture fonctionnelles.
| Fonction | Comportement actuel |
|---|---|
| Analyse Wi-Fi · redémarrage · réinitialisation d'usine | Pas de véritable opération. |
| Sécurité des appareils · mise à niveau du micrologiciel | Affichage uniquement. |
| IAMMETER-cloud · HA Discovery · Liaison descendante MQTT | Pas de téléchargement cloud, de découverte ou de configuration à distance. |
Les outils de simulation sont documentés séparément
Les points de terminaison de débogage du simulateur ne sont pas des API du micrologiciel IAMMETER. Ils sont exclus de la liste des API du micrologiciel ci-dessus.