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:
- 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.
- 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)).
- 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
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
- Visió general dels comptadors d'energia IAMMETER
- WEM3080T – Comptador d'energia Wi-Fi trifàsic/bifàsic
- WEM3080 – Comptador d'energia Wi-Fi monofàsic
- WEM3050T – Comptador d'energia trifàsic
- WEM3046T – Comptador d'energia Wi-Fi trifàsic amb entrada de TC estàndard de 5 A