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:
- 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.
- 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)).
- 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 | Sí | 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
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
- Descripción general de los medidores de energía IAMMETER
- WEM3080T – Medidor de energía Wi-Fi trifásico/bifásico
- WEM3080 – Medidor de energía Wi-Fi monofásico
- WEM3050T – Medidor de energía trifásico
- WEM3046T – Medidor de energía Wi-Fi trifásico con entrada CT estándar de 5A