Ho sentim, el teu navegador no admet JavaScript!
Inicia sessió

API del WPC3700

Abreviació del substantiu WPC: controlador de potència Wi-Fi

API del controlador de potència de la sèrie WPC

Aquest article presenta principalment les API que ofereixen els controladors de potència de la sèrie WPC. Mitjançant aquestes API, els usuaris poden dur a terme les operacions següents:

  • Configurar els paràmetres del WPC
  • Controlar la potència de sortida del WPC

Qui hauria de llegir aquest article

Aquesta secció es troba a l'inici perquè, tot i que hem escrit aquest article, en realitat no és rellevant per a la majoria d'usuaris del WPC.

Si heu adquirit un controlador de potència de la sèrie WPC, hi ha uns quants modes de funcionament possibles:

  1. Ja teniu instal·lats comptadors IAMMETER al costat de la xarxa i feu servir directament el WPC3700 conjuntament amb els comptadors IAMMETER (el WPC3700 funciona en mode automàtic), cosa que permet que el WPC3700 treballi de manera contínua impulsat per l'excedent solar; aquesta és la solució d'IAMMETER Sistema de control de calefactors fotovoltaics.
  2. No teniu cap comptador IAMMETER, però coneixeu Home Assistant o Node-RED i heu integrat el WPC3700 al sistema d'automatització d'HA o Node-RED (Activa la descoberta MQTT a Home Assistant amb el darrer firmware d'IAMMETER (i.76.058.8)).
  3. Necessiteu cridar l'API per integrar el WPC3700 al vostre propi sistema.

Només els usuaris que necessiten el tercer mode de funcionament haurien de llegir aquest article.


/api/setpower

/api/setpower?x=100

Introducció

Aquesta API controla la potència de sortida del WPC.

Nota: aquest paràmetre també es pot modificar mitjançant l'API setadv (crida HTTP POST, paràmetre setPower).

Com que el paràmetre setPower pot necessitar modificacions freqüents segons les lectures de potència de la xarxa en temps real, es proporciona aquesta interfície API addicional HTTP GET.

URL i mètode

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

Mètode: HTTP GET

Nom del paràmetre Valor d'exemple Unitat Obligatori Tipus Descripció
x 100 W Sí int Representa la potència de sortida del WPC. És el mateix paràmetre que setPower a setadv.

/api/setadv

Introducció

Aquesta API serveix per configurar els paràmetres del WPC.

Nota: tots els paràmetres es poden configurar directament mitjançant la interfície d'usuari. Només un nombre reduït de clients que necessiten integrar els productes de la sèrie WPC als seus propis sistemes faran servir aquesta API.

URL i mètode

  • URL: http://{{IP local del WPC}}/api/setadv
  • Mètode: HTTP POST

Paràmetres de la sol·licitud

A continuació hi ha un exemple de paràmetres de setadv.

Nota: en executar setadv, no cal enviar tots els paràmetres. Només s'han d'enviar els paràmetres que es volen modificar. Els paràmetres que no cal modificar no s'han d'enviar. Primer podeu fer servir getadv per llegir la configuració actual i després enviar només els paràmetres que cal modificar.

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

Resposta

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

Descripció dels paràmetres

Nom del paràmetre Tipus Unitat Descripció
maxPower int W Potència màxima de la càrrega controlada; ha de ser inferior a 3700
setPower int W Potència de sortida del WPC
restorePower int W Potència després de sortir del control en mode automàtic
setPowerMode int Selecció del mode de funcionament: 0: manual, 1: automàtic
threshold int W En mode automàtic, és el llindar per ajustar segons la potència de la xarxa
hysteresis int W En mode automàtic, és la histèresi per ajustar segons la potència de la xarxa
startHour int hora Hora d'inici del mode automàtic
stopHour int hora Hora de finalització del mode automàtic
tzOffset int Desplaçament del fus horari
meterType int Elecció de la marca del comptador per mesurar la xarxa en mode automàtic: 0: iMeter, 1: virtualTCP
meterConfig string Elecció del model de comptador per mesurar la xarxa en mode automàtic: 3: trifàsic, 2: fes servir la fase B, 1: ràtio
ntpServer string Adreça del servidor NTP
haDiscovery int Activa la descoberta automàtica MQTT de Home Assistant: 0: desactivat, 1: activat
mqttEnabled int Activa MQTT: 0: desactivat, 1: activat
meterAddress string Adreça del broker MQTT; necessària per integrar-se amb Home Assistant: 192.168.1.22:1833
mqttUsername string Nom d'usuari MQTT
mqttPassword string Contrasenya MQTT
uploadInterval int s Interval de temps de pujada de dades

/api/getadv

Introducció

Aquesta API llegeix tots els paràmetres del WPC (aquí es poden llegir tots els paràmetres de l'API setadv).

URL i mètode

  • URL: http://{{IP local del WPC}}/api/getadv
  • Mètode: HTTP GET

Resposta

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

Consulteu la descripció dels paràmetres a setadv.


/api/setwifiadv

Introducció

Aquesta API configura els paràmetres de Wi-Fi per als dispositius WPC/WEM.

URL i mètode

  • URL: http://{{IP local del WPC}}/api/setwifiadv
  • Mètode: HTTP POST

Paràmetres de la sol·licitud

{
    "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" // Useful only if runMode is non-cloud
}

Resposta

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

Descripció dels paràmetres

Nom del paràmetre Tipus Unitat Descripció
ssid string Nom del punt d'accés Wi-Fi per a la connexió WLAN
pwd string Contrasenya del Wi-Fi per a la connexió WLAN
ip string IP estàtica; no cal si s'utilitza el mode DHCP
netmask string Màscara de xarxa; no cal si s'utilitza el mode DHCP
gw string Porta d'enllaç; no cal si s'utilitza el mode DHCP
dns string Servidor DNS; no cal si s'utilitza el mode DHCP
dhcp bool false: desactiva DHCP, true: activa DHCP

Documentació de referència

Les funcions "amagades" del firmware del comptador d'energia Wi-Fi

Funció avançada d'IAMMETER

Us convidem a fer-nos saber la vostra opinió al nostre fòrum. https://imeter.club

Sobre IAMMETER

IAMMETER és una empresa centrada en productes i serveis de gestió energètica, que ofereix comptadors d'energia intel·ligents, aplicacions de gestió i plataformes al núvol.

El nostre objectiu és ajudar els clients a gestionar, utilitzar i estalviar energia de manera eficient, reduint les factures elèctriques mitjançant el monitoratge i l'anàlisi intel·ligents.

Solucions

Productes

Sistema

Amunt