API-er for WPC3700
Forkortelser WPC: Wi-Fi effektkontroller
API for WPC-seriens effektkontrollere
Denne artikkelen introduserer hovedsakelig API-ene som tilbys av WPC-seriens effektkontrollere. Gjennom disse API-ene kan brukere utføre følgende operasjoner:
- Konfigurere WPC-parametere
- Styring av WPCs utgangseffekt
Hvem bør lese denne artikkelen
Denne delen er plassert i begynnelsen fordi selv om vi skrev denne artikkelen, er den faktisk ikke relevant for de fleste WPC-brukere.
Hvis du har anskaffet en effektkontroller i WPC-serien, finnes det noen mulige bruksmåter:
- Du har allerede installert IAMMETER-målere på nettsiden og bruker WPC3700 direkte sammen med IAMMETER-målere (WPC3700 kjører i automatisk modus), slik at WPC3700 kan arbeide kontinuerlig drevet av solenergioverskudd – dette er IAMMETER-løsningen PV-varmeovnstyringssystem.
- Du har ikke en IAMMETER-måler, men du er kjent med Home Assistant eller Node-RED og har integrert WPC3700 i HA- eller Node-RED-automasjonssystemet (Aktiver MQTT-discovery i Home Assistant med den nyeste IAMMETER-fastvaren (i.76.058.8)).
- Du må kalle på API-et for å integrere WPC3700 i ditt eget system.
Bare brukere som trenger den tredje bruksmåten, bør lese denne artikkelen.
/api/setpower
/api/setpower?x=100
Introduksjon
Dette API-et styrer utgangseffekten til WPC.
Merk: Denne parameteren kan også endres gjennom setadv-API-et (HTTP POST-kall, parameteren setPower).
Siden parameteren setPower kan måtte endres ofte basert på sanntidsmålinger av netteffekten, tilbys dette ekstra HTTP GET-API-et.
URL og metode
URL: http://{{IP}}/api/setpower
Metode: HTTP GET
| Parameternavn | Eksempelverdi | Enhet | Påkrevd | Type | Beskrivelse |
|---|---|---|---|---|---|
| x | 100 | W | Ja | int | Angir utgangseffekten til WPC. Dette er samme parameter som setPower i setadv. |
/api/setadv
Introduksjon
Dette API-et brukes til å angi parametrene til WPC.
Merk: Alle parametere kan angis direkte gjennom UI-et. Bare et lite antall kunder som trenger å integrere WPC-seriens produkter i egne systemer, vil bruke dette API-et.
URL og metode
- URL:
http://{{Local IP of the WPC}}/api/setadv - Metode: HTTP POST
Forespørselsparametere
Nedenfor er et eksempel på setadv-parametere.
Merk: Når setadv kjøres, er det ikke nødvendig å sende inn alle parametere. Bare parametrene som skal endres, bør sendes inn. Parametere som ikke trenger endring, trenger ikke sendes inn. Du kan først bruke getadv til å lese gjeldende konfigurasjon, og deretter bare sende inn parametrene som skal endres.
{
"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
}
Svar
{
"successful": 1,
"message": "ok"
}
Parameterbeskrivelse
| Parameternavn | Type | Enhet | Beskrivelse |
|---|---|---|---|
| maxPower | int | W | Maksimal effekt for den styrte lasten, må være mindre enn 3700 |
| setPower | int | W | Utgangseffekten til WPC |
| restorePower | int | W | Effekt etter å ha avsluttet automatisk modus-styring |
| setPowerMode | int | Valg av driftsmodus: 0: Manuell, 1: Auto | |
| threshold | int | W | I automatisk modus er dette terskelen for justering basert på netteffekt |
| hysteresis | int | W | I automatisk modus er dette hysteresen for justering basert på netteffekt |
| startHour | int | hour | Starttidspunkt for automatisk modus |
| stopHour | int | hour | Sluttidspunkt for automatisk modus |
| tzOffset | int | Tidssoneavvik | |
| meterType | int | Valg av måler-merke for nettmåling i automatisk modus: 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Valg av måler-modell for nettmåling i automatisk modus: 3:tre-fase, 2:bruk faseB, 1:forhold | |
| ntpServer | string | NTP-serveradresse | |
| haDiscovery | int | Aktiver Home Assistant MQTT auto-discovery: 0: deaktiver, 1: aktiver | |
| mqttEnabled | int | Aktiver MQTT: 0: deaktiver, 1: aktiver | |
| meterAddress | string | MQTT-brokeradresse, nødvendig ved integrering med Home Assistant: 192.168.1.22:1833 | |
| mqttUsername | string | MQTT-brukernavn | |
| mqttPassword | string | MQTT-passord | |
| uploadInterval | int | s | Opplastingsintervall (tid) |
/api/getadv
Introduksjon
Dette API-et leser alle parametrene til WPC (alle parametere fra setadv-API-et kan leses her).
URL og metode
- URL:
http://{{Local IP of the WPC}}/api/getadv - Metode: HTTP GET
Svar
{
"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
}
Se parameterbeskrivelsen i setadv.
/api/setwifiadv
Introduksjon
Dette API-et konfigurerer Wi-Fi-parametrene for WPC/WEM-enheter.
URL og metode
- URL:
http://{{Local IP of the WPC}}/api/setwifiadv - Metode: HTTP POST
Forespørselsparametere
{
"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
}
Svar
{
"successful": true,
"message": "ok"
}
Parameterbeskrivelse
| Parameternavn | Type | Enhet | Beskrivelse |
|---|---|---|---|
| ssid | string | Wi-Fi-tilgangspunktets navn for WLAN-tilkoblingen | |
| pwd | string | Wi-Fi-passord for WLAN-tilkoblingen | |
| ip | string | Statisk IP; ikke nødvendig hvis DHCP-modus brukes | |
| netmask | string | Nettmaske; ikke nødvendig hvis DHCP-modus brukes | |
| gw | string | Gateway; ikke nødvendig hvis DHCP-modus brukes | |
| dns | string | DNS-server; ikke nødvendig hvis DHCP-modus brukes | |
| dhcp | bool | false: deaktiver DHCP, true: aktiver DHCP |
Referansedokumentasjon
De "skjulte" funksjonene i fastvaren til Wi-Fi-energimåleren
Avanserte funksjoner i IAMMETER
Vi setter pris på at du deler dine tanker på forumet vårt. https://imeter.club
Om IAMMETER
IAMMETER er et selskap som fokuserer på produkter og tjenester for energistyring, og tilbyr smarte energimålere, administrasjonsapper og skyplattformer.
Vårt mål er å hjelpe kunder med å administrere, utnytte og spare energi effektivt, og redusere strømregningen gjennom smart overvåking og analyse.
Løsninger
Produkter
- Oversikt over IAMMETER-energimålere
- WEM3080T – tre-fase/delt-fase Wi-Fi-energimåler
- WEM3080 – enfase Wi-Fi-energimåler
- WEM3050T – tre-fase energimåler
- WEM3046T – tre-fase Wi-Fi-energimåler med 5A standard CT-inngang