Lo sentimos, tu navegador no admite JavaScript.
Iniciar sesión

APIs del WPC3700

Abreviatura de términos WPC: Controlador de potencia Wi-Fi

API del Controlador de Potencia de la Serie WPC

Este artículo presenta principalmente las APIs proporcionadas por los Controladores de Potencia de la Serie WPC. A través de estas APIs, los usuarios pueden realizar las siguientes operaciones:

  • Configurar parámetros del WPC
  • Controlar la potencia de salida del WPC

¿Quién Debería Leer Este Artículo?

Esta sección se coloca al principio porque, aunque escribimos este artículo, en realidad no es relevante para la mayoría de los usuarios del WPC.

Si ha adquirido un controlador de potencia de la serie WPC, existen algunos posibles modos de operación:

  1. Ya ha instalado medidores IAMMETER en el lado de la red y está utilizando directamente el WPC3700 en conjunto con los medidores IAMMETER (el WPC3700 opera en modo automático), permitiendo que el WPC3700 funcione continuamente impulsado por el excedente solar, que es la solución IAMMETER Sistema de Control de Calentador PV.
  2. No tiene un medidor IAMMETER, pero está familiarizado con Home Assistant o Node-RED y ha integrado el WPC3700 en el sistema de automatización de HA o Node-RED (Habilitar descubrimiento MQTT en Home Assistant con el último firmware IAMMETER (i.76.058.8)).
  3. Necesita llamar a la API para integrar el WPC3700 en su propio sistema.

Solo los usuarios que requieren el tercer modo de operación deben leer este artículo.


/api/setpower

/api/setpower?x=100

Introducción

Esta API controla la potencia de salida del WPC.

Nota: Este parámetro también se puede modificar a través de la API setadv (llamada HTTP POST, parámetro setPower).

Dado que el parámetro setPower puede necesitar modificaciones frecuentes basadas en lecturas en tiempo real de la potencia de la red, se proporciona esta interfaz API HTTP GET adicional.

URL y Método

URL: http://{{IP}}/api/setpower

Método: HTTP GET

Nombre del Parámetro Valor de Ejemplo Unidad Obligatorio Tipo Descripción
x 100 W int Representa la potencia de salida del WPC. Este es el mismo parámetro que setPower en setadv.

/api/setadv

Introducción

Esta API se utiliza para configurar los parámetros del WPC.

Nota: Todos los parámetros se pueden configurar directamente a través de la IU. Solo un pequeño número de clientes que necesitan integrar productos de la serie WPC en sus propios sistemas utilizarán esta API.

URL y Método

  • URL: http://{{IP Local del WPC}}/api/setadv
  • Método: HTTP POST

Parámetros de Solicitud

A continuación se muestra un ejemplo de los parámetros de setadv.

Nota: Al ejecutar setadv, no es necesario enviar todos los parámetros. Solo deben enviarse los parámetros que necesitan ser modificados. Los parámetros que no necesitan modificación no requieren ser enviados. Puede usar primero getadv para leer la configuración actual y luego enviar solo los parámetros que necesitan ser modificados.

{
  "maxPower": 3500,
  "setPower": 0,
  "restorePower": 0,
  "setPowerMode": 0,
  "meterAddress": "10.10.30.35",
  "threshold": 30,
  "hysteresis": 50,
  "startHour": 8,
  "stopHour": 18,
  "tzOffset": 8,
  "meterType": 0,
  "meterConfig": "3,2,1",
  "ntpServer": "ntp.aliyun.com",
  "haDiscovery": 1,
  "mqttEnabled": 1,
  "mqttAddress": "10.10.30.89:1883",
  "mqttUsername": "test",
  "mqttPassword": "123456",
  "uploadInterval": 6
}

Respuesta

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

Descripción de Parámetros

Nombre del Parámetro Tipo Unidad Descripción
maxPower int W La potencia máxima de la carga controlada, debe ser inferior a 3700
setPower int W La potencia de salida del WPC
restorePower int W Potencia después de salir del control de modo automático
setPowerMode int Selección del modo de operación: 0: Manual, 1: Automático
threshold int W En modo automático, este es el umbral para ajustar según la potencia de la red
hysteresis int W En modo automático, esta es la histéresis para ajustar según la potencia de la red
startHour int hora Hora de inicio del modo automático
stopHour int hora Hora de finalización del modo automático
tzOffset int Diferencia horaria (zona horaria)
meterType int Elección de la marca del medidor para la medición de red en modo automático: 0:iMeter, 1:virtualTCP
meterConfig string Elección del modelo de medidor para la medición de red en modo automático: 3:trifásico, 2:usar faseB, 1:relación
ntpServer string Dirección del servidor NTP
haDiscovery int Habilitar descubrimiento automático MQTT de Home Assistant: 0: deshabilitar, 1: habilitar
mqttEnabled int Habilitar MQTT: 0: deshabilitar, 1: habilitar
meterAddress string Dirección del broker MQTT, necesaria al integrar con Home Assistant: 192.168.1.22:1833
mqttUsername string Nombre de usuario MQTT
mqttPassword string Contraseña MQTT
uploadInterval int s Intervalo de tiempo de carga

/api/getadv

Introducción

Esta API lee todos los parámetros del WPC (todos los parámetros de la API setadv se pueden leer aquí).

URL y Método

  • URL: http://{{IP Local del WPC}}/api/getadv
  • Método: HTTP GET

Respuesta

{
  "maxPower": 3500,
  "setPower": 0,
  "restorePower": 0,
  "setPowerMode": 0,
  "setPowerModeList": "Manual,Auto",
  "meterAddress": "10.10.30.35",
  "threshold": 20,
  "hysteresis": 30,
  "startHour": 8,
  "stopHour": 18,
  "tzOffset": 8,
  "meterType": 0,
  "meterConfig": "3,2,1",
  "meterList": "iMeter,virtualTCP",
  "ntpServer": "ntp.aliyun.com",
  "haDiscovery": 0,
  "mqttEnabled": 0,
  "mqttAddress": "192.168.1.22:1833",
  "mqttUsername": "test",
  "mqttPassword": "123456",
  "uploadInterval": 60
}

Consulte la descripción de los parámetros en setadv.


/api/setwifiadv

Introducción

Esta API configura los parámetros Wi-Fi para dispositivos WPC/WEM.

URL y Método

  • URL: http://{{IP Local del WPC}}/api/setwifiadv
  • Método: HTTP POST

Parámetros de Solicitud

{
    "ssid":"xxxx",
    "pwd":"xxxx",
    "ip":"xxxx",
    "netmask":"xxxxx",  
    "gw":"xxxx",
    "dns":"192.168.1.1",
    "dhcp":true,
    "runMode":"cloud", // cloud, tcp, http
    "uploadAddress":"http://myserver.com/upload" // Útil solo si runMode no es cloud
}

Respuesta

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

Descripción de Parámetros

Nombre del Parámetro Tipo Unidad Descripción
ssid string Nombre de la red Wi-Fi (AP) para la conexión WLAN
pwd string Contraseña de la red Wi-Fi para la conexión WLAN
ip string IP estática; no es necesaria si se usa modo DHCP
netmask string Máscara de red; no es necesaria si se usa modo DHCP
gw string Puerta de enlace; no es necesaria si se usa modo DHCP
dns string Servidor DNS; no es necesario si se usa modo DHCP
dhcp bool false: deshabilitar DHCP, true: habilitar DHCP

Documentación de Referencia

Las funciones "ocultas" en el firmware del medidor de energía Wi-Fi

Función avanzada de IAMMETER

Bienvenido a compartir sus opiniones en nuestro foro. https://imeter.club

Acerca de IAMMETER

IAMMETER es una empresa centrada en productos y servicios de gestión energética, que ofrece medidores inteligentes de energía, aplicaciones de gestión y plataformas en la nube.

Nuestro objetivo es ayudar a los clientes a gestionar, utilizar y ahorrar energía de manera efectiva, reduciendo las facturas de electricidad mediante monitoreo y análisis inteligentes.

Soluciones

Productos

Sistema

Arriba