API-urile WPC3700
Abrevieri WPC: controler de putere Wi-Fi
API-ul controloarelor de putere din seria WPC
Acest articol prezintă în principal API-urile oferite de Controlerele de putere din seria WPC. Prin intermediul acestor API-uri, utilizatorii pot efectua următoarele operațiuni:
- Configurarea parametrilor WPC
- Controlul puterii de ieșire a WPC
Cine ar trebui să citească acest articol
Această secțiune este plasată la început deoarece, deși am scris acest articol, el nu este de fapt relevant pentru majoritatea utilizatorilor WPC.
Dacă ați obținut un controler de putere din seria WPC, există câteva moduri de operare posibile:
- Ați instalat deja contoare IAMMETER pe partea rețelei și utilizați direct WPC3700 împreună cu contoarele IAMMETER (WPC3700 funcționează în modul automat), permițând WPC3700 să funcționeze continuu sub impulsul excedentului solar, ceea ce reprezintă soluția IAMMETER Sistem de control al încălzitorului PV.
- Nu aveți un contor IAMMETER, dar sunteți familiarizat cu Home Assistant sau Node-RED și ați integrat WPC3700 în sistemul de automatizare HA sau Node-RED (Activarea descoperirii MQTT în Home Assistant cu cel mai recent firmware IAMMETER (i.76.058.8)).
- Trebuie să apelați API-ul pentru a integra WPC3700 în propriul sistem.
Doar utilizatorii care necesită al treilea mod de operare ar trebui să citească acest articol.
/api/setpower
/api/setpower?x=100
Introducere
Acest API controlează puterea de ieșire a WPC.
Notă: Acest parametru poate fi modificat și prin API-ul setadv (apel HTTP POST, parametrul setPower).
Deoarece parametrul setPower poate necesita modificări frecvente în funcție de citirile în timp real ale puterii rețelei, este oferită această interfață API suplimentară HTTP GET.
URL și metodă
URL: http://{{IP}}/api/setpower
Metodă: HTTP GET
| Nume parametru | Valoare exemplu | Unitate | Obligatoriu | Tip | Descriere |
|---|---|---|---|---|---|
| x | 100 | W | Da | int | Reprezintă puterea de ieșire a WPC. Acesta este același parametru ca setPower din setadv. |
/api/setadv
Introducere
Acest API este utilizat pentru a seta parametrii WPC.
Notă: Toți parametrii pot fi setați direct prin intermediul interfeței UI. Doar un număr mic de clienți care trebuie să integreze produsele din seria WPC în propriile sisteme vor utiliza acest API.
URL și metodă
- URL:
http://{{IP local al WPC}}/api/setadv - Metodă: HTTP POST
Parametri de cerere
Mai jos este un exemplu de parametri setadv.
Notă: La executarea setadv, nu este necesar să fie trimiși toți parametrii. Trebuie trimiși doar parametrii care necesită modificare. Parametrii care nu necesită modificare nu trebuie trimiși. Puteți utiliza mai întâi getadv pentru a citi configurația curentă, apoi trimiteți doar parametrii care necesită modificare.
{
"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
}
Răspuns
{
"successful": 1,
"message": "ok"
}
Descrierea parametrilor
| Nume parametru | Tip | Unitate | Descriere |
|---|---|---|---|
| maxPower | int | W | Puterea maximă a sarcinii controlate, trebuie să fie mai mică de 3700 |
| setPower | int | W | Puterea de ieșire a WPC |
| restorePower | int | W | Puterea după ieșirea din controlul modului automat |
| setPowerMode | int | Selectarea modului de operare: 0: Manual, 1: Automat | |
| threshold | int | W | În modul automat, acesta este pragul de ajustare în funcție de puterea rețelei |
| hysteresis | int | W | În modul automat, aceasta este histereza de ajustare în funcție de puterea rețelei |
| startHour | int | oră | Ora de început a modului automat |
| stopHour | int | oră | Ora de sfârșit a modului automat |
| tzOffset | int | Decalajul fusului orar | |
| meterType | int | Alegerea mărcii contorului pentru măsurarea rețelei în modul automat: 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Alegerea modelului de contor pentru măsurarea rețelei în modul automat: 3:trifazat, 2:utilizare faza B, 1:raport | |
| ntpServer | string | Adresa serverului NTP | |
| haDiscovery | int | Activează descoperirea automată MQTT pentru Home Assistant: 0: dezactivat, 1: activat | |
| mqttEnabled | int | Activează MQTT: 0: dezactivat, 1: activat | |
| meterAddress | string | Adresa brokerului MQTT, necesară la integrarea cu Home Assistant: 192.168.1.22:1833 | |
| mqttUsername | string | Numele de utilizator MQTT | |
| mqttPassword | string | Parola MQTT | |
| uploadInterval | int | s | Intervalul de încărcare a datelor |
/api/getadv
Introducere
Acest API citește toți parametrii WPC (toți parametrii din API-ul setadv pot fi citiți aici).
URL și metodă
- URL:
http://{{IP local al WPC}}/api/getadv - Metodă: HTTP GET
Răspuns
{
"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
}
Consultați descrierea parametrilor din setadv.
/api/setwifiadv
Introducere
Acest API configurează parametrii Wi-Fi pentru dispozitivele WPC/WEM.
URL și metodă
- URL:
http://{{IP local al WPC}}/api/setwifiadv - Metodă: HTTP POST
Parametri de cerere
{
"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
}
Răspuns
{
"successful": true,
"message": "ok"
}
Descrierea parametrilor
| Nume parametru | Tip | Unitate | Descriere |
|---|---|---|---|
| ssid | string | Numele AP Wi-Fi pentru conexiunea WLAN | |
| pwd | string | Parola Wi-Fi pentru conexiunea WLAN | |
| ip | string | IP static; nu este necesar dacă se utilizează modul DHCP | |
| netmask | string | Mască de rețea; nu este necesară dacă se utilizează modul DHCP | |
| gw | string | Gateway; nu este necesar dacă se utilizează modul DHCP | |
| dns | string | Server DNS; nu este necesar dacă se utilizează modul DHCP | |
| dhcp | bool | false: dezactivează DHCP, true: activează DHCP |
Documentație de referință
Funcțiile „ascunse" din firmware-ul contorului de energie Wi-Fi
Vă invităm să ne împărtășiți părerile pe forumul nostru. https://imeter.club
Despre IAMMETER
IAMMETER este o companie axată pe produse și servicii de management al energiei, care oferă contoare de energie inteligente, aplicații de gestionare și platforme cloud.
Obiectivul nostru este să ajutăm clienții să gestioneze, să utilizeze și să economisească energia în mod eficient, reducând facturile la electricitate prin monitorizare și analiză inteligentă.
Soluții
Produse
- Prezentare generală a contoarelor de energie IAMMETER
- WEM3080T – Contor de energie Wi-Fi trifazat/cu faze divizate
- WEM3080 – Contor de energie Wi-Fi monofazat
- WEM3050T – Contor de energie trifazat
- WEM3046T – Contor de energie Wi-Fi trifazat cu intrare CT standard de 5A