Ne pare rău, browserul dvs. nu acceptă JavaScript!
Autentificare

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:

  1. 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.
  2. 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)).
  3. 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

Funcția avansată a IAMMETER

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

Sistem

Sus