Documentación

Referencia de API local

Subconjunto de API local de firmware compatible con este simulador. Las API de depuración exclusivas del simulador se documentan por separado.

API locales del firmware IAMMETER

IAMMETER admite API HTTP locales. Consulte la documentación oficial para conocer las capacidades del dispositivo real. Este simulador implementa sólo el subconjunto que se enumera a continuación.

Caminos y sesiones

Anteponga cada punto final del medidor con /WEM3080, /WEM2067 o /WEM3050T. Las páginas de dispositivos y las API admiten HTTP en el puerto 80 y HTTPS en el puerto 443. Los dispositivos físicos normalmente utilizan HTTP local.

Las solicitudes de medición públicas funcionan sin sesión y devuelven la fuente Inverter and grid predeterminada. La configuración privada requiere la cookie de página de medidor existente. Una solicitud curl independiente no hereda la fuente ni la configuración seleccionadas de su navegador.

HTTP y HTTPS utilizan sesiones de navegador independientes. Abra la página del medidor usando el mismo esquema antes de cambiar la configuración. Las lecturas anónimas utilizan la fuente predeterminada Inverter and grid.

Subconjunto de API de firmware compatible

MétodoPunto finalObjetivoModelos compatibles
GET/api/monitorLeer voltaje, corriente, potencia y energía.Todos los modelos
GET/api/monitorjson · /monitorjsonLea JSON heredado, con datos reactivos opcionales.Todos los modelos
GET/api/wifidataLea la configuración del dispositivo y de Wi-Fi virtual.Todos los modelos
POST/api/setwifiadvGuarde la configuración de Wi-Fi virtual para esta sesión y modelo.Todos los modelos
GET/api/getadvLeer configuraciones avanzadas y cargar; la contraseña está vacía.Todos los modelos
POST/api/setadvGuarde la configuración de carga, los indicadores Reactive y NEM.Todos los modelos; NEM solo en WEM3050T

Respuestas de medición

WEM3080 devuelve Data; WEM2067 y WEM3050T devuelven Datas con una fila por canal. El orden de los campos se muestra a continuación. Los ejemplos son ilustrativos, no respuestas en vivo.

ÍndiceMediciónUnidad
0TensiónV
1CorrienteA
2Potencia activaW
3Energía importadakWh
4Energía exportadakWh
5FrecuenciaHz
6Factor de potencia—

Leer mediciones públicas

curl 'https://simulator.iammeter.com/WEM3050T/api/monitor'

Forma de respuesta

{
  "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]
  ]
}

Configuración de Wi-Fi virtual

setwifiadv acepta ssid, pwd, dhcp (booleano), ip, máscara de red, gw y dns. Estos valores cambian únicamente el dispositivo virtual; no reconfiguran un adaptador de red.

Cuerpo de solicitud de ejemplo

{"ssid":"Test network","dhcp":true}

Guardado exitoso

{"successful":1,"message":"ok"}

Configuraciones avanzadas

setadv acepta actualizaciones JSON parciales. Los campos no especificados mantienen sus valores actuales. El intervalo de carga es de 10 a 3600 segundos.

Reactive agrega EA.Reactive a monitorjson y carga, no api/monitor. Cada fila es [var, kvarh inductivo, kvarh capacitivo].

NEM solo es compatible con WEM3050T. Su cuarta fila Datas suma la potencia activa, los kWh de importación y los kWh de exportación por separado; todos los demás campos son cero.

ParámetroValores aceptados
runMode1 = TCP/TLS; 2 = HTTP/HTTPS; 3 = MQTT/MQTTS; 4 = stand alone
uploadAddressDirección del destinatario; Siga la sugerencia de entrada Settings.
mqttUsername · mqttPasswordCredenciales del corredor; getadv nunca devuelve la contraseña guardada.
uploadInterval10-3600 s
reactive0 / 1
netmetering0 / 1
ntpServerSólo texto almacenado; no cambia la hora del servidor.
haDiscovery · ctcRatioSólo 0 y 1 respectivamente; Las características no están implementadas.

Habilite Reactive y NEM en WEM3050T

{"reactive":1,"netmetering":1}

Comprobando resultados

Un guardado exitoso devuelve successful=1. Los valores de configuración no válidos pueden devolver HTTP 200 con successful=0; verifique el JSON y el código de estado. Las sesiones perdidas devuelven 401; Se rechazan las escrituras de origen cruzado.

Guardar la configuración de carga no prueba la entrega. Verifique el estado de carga de depuración y confirme los mensajes en su receptor.

No implementado

Las funciones siguientes son solo de visualización o no son compatibles. No proporcionan API de escritura que funcionen.

FunciónComportamiento actual
Escaneo de Wi-Fi · reiniciar · restablecimiento de fábricaNinguna operación real.
Seguridad del dispositivo · actualización de firmwareSólo visualización.
Nube IAMMETER · HA Discovery · Enlace descendente MQTTSin carga, descubrimiento o configuración remota en la nube.

Las herramientas del simulador se documentan por separado.

Los puntos finales de depuración del simulador no son API de firmware de IAMMETER. Están excluidos de la lista de API de firmware anterior.

← Volver al simulador