APIs van WPC3700
Afkorting WPC: Wi-Fi-vermogensregelaar
API van WPC-serie Vermogensregelaars
Dit artikel behandelt voornamelijk de API's die worden aangeboden door de WPC-serie Vermogensregelaars. Via deze API's kunnen gebruikers de volgende bewerkingen uitvoeren:
- WPC-parameters configureren
- WPC-uitgangsvermogen regelen
Voor wie is dit artikel bedoeld
Deze sectie staat aan het begin omdat, hoewel we dit artikel hebben geschreven, het eigenlijk niet relevant is voor de meeste WPC-gebruikers.
Als u in het bezit bent van een WPC-serie vermogensregelaar, zijn er een aantal mogelijke gebruiksmodi:
- U hebt al IAMMETER-meters geïnstalleerd aan de netzijde en gebruikt direct de WPC3700 in combinatie met IAMMETER-meters (WPC3700 werkt in automatische modus), zodat de WPC3700 continu kan werken onder invloed van zonne-energieoverschot. Dit is de IAMMETER-oplossing PV Heater Control System.
- U hebt geen IAMMETER-meter, maar u bent bekend met Home Assistant of Node-RED en hebt de WPC3700 geïntegreerd in het HA- of Node-RED-automatiseringssysteem (MQTT-discover inschakelen in Home Assistant met de nieuwste IAMMETER-firmware (i.76.058.8)).
- U moet de API aanroepen om de WPC3700 te integreren in uw eigen systeem.
Alleen gebruikers die de derde modus nodig hebben, moeten dit artikel lezen.
/api/setpower
/api/setpower?x=100
Introductie
Deze API regelt het uitgangsvermogen van de WPC.
Opmerking: Deze parameter kan ook worden gewijzigd via de setadv-API (HTTP POST-aanroep, parameter setPower).
Aangezien de setPower-parameter mogelijk vaak moet worden aangepast op basis van realtime netvermogenmetingen, wordt deze extra HTTP GET API-interface aangeboden.
URL en methode
URL: http://{{IP}}/api/setpower
Methode: HTTP GET
| Parameternaam | Voorbeeldwaarde | Eenheid | Verplicht | Type | Beschrijving |
|---|---|---|---|---|---|
| x | 100 | W | Ja | int | Geeft het uitgangsvermogen van de WPC aan. Dit is dezelfde parameter als setPower in setadv. |
/api/setadv
Introductie
Deze API wordt gebruikt om de parameters van de WPC in te stellen.
Opmerking: Alle parameters kunnen direct worden ingesteld via de UI. Slechts een klein aantal klanten die WPC-serie producten in hun eigen systemen moeten integreren, zullen deze API gebruiken.
URL en methode
- URL:
http://{{Lokaal IP van de WPC}}/api/setadv - Methode: HTTP POST
Parameterverzoek
Hieronder staat een voorbeeld van setadv-parameters.
Opmerking: Bij het uitvoeren van setadv hoeven niet alle parameters te worden ingediend. Alleen de parameters die moeten worden gewijzigd, moeten worden ingediend. Parameters die niet gewijzigd hoeven te worden, hoeven niet te worden ingediend. U kunt eerst getadv gebruiken om de huidige configuratie uit te lezen en vervolgens alleen de te wijzigen parameters indienen.
{
"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
}
Reactie
{
"successful": 1,
"message": "ok"
}
Parameterbeschrijving
| Parameternaam | Type | Eenheid | Beschrijving |
|---|---|---|---|
| maxPower | int | W | Het maximale vermogen van de geregelde belasting, moet kleiner zijn dan 3700 |
| setPower | int | W | Het uitgangsvermogen van de WPC |
| restorePower | int | W | Vermogen na het verlaten van de automatische modus |
| setPowerMode | int | Moduskeuze: 0: Handmatig, 1: Automatisch | |
| threshold | int | W | In de automatische modus is dit de drempel voor aanpassing op basis van netvermogen |
| hysteresis | int | W | In de automatische modus is dit de hysteresis voor aanpassing op basis van netvermogen |
| startHour | int | uur | Starttijd van de automatische modus |
| stopHour | int | uur | Eindtijd van de automatische modus |
| tzOffset | int | Tijdzone-offset | |
| meterType | int | Metermerkkeuze voor netmeting in automatische modus: 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Metermodelkeuze voor netmeting in automatische modus: 3:driefasen, 2:gebruik faseB, 1:verhouding | |
| ntpServer | string | NTP-serveradres | |
| haDiscovery | int | Home Assistant MQTT automatische discover inschakelen: 0:uitschakelen, 1:inschakelen | |
| mqttEnabled | int | MQTT inschakelen: 0: uitschakelen, 1: inschakelen | |
| meterAddress | string | MQTT-brokeradres, nodig bij integratie met Home Assistant: 192.168.1.22:1833 | |
| mqttUsername | string | MQTT-gebruikersnaam | |
| mqttPassword | string | MQTT-wachtwoord | |
| uploadInterval | int | s | Uploadintervaltijd |
/api/getadv
Introductie
Deze API leest alle parameters van de WPC uit (alle parameters van de setadv-API kunnen hier worden uitgelezen).
URL en methode
- URL:
http://{{Lokaal IP van de WPC}}/api/getadv - Methode: HTTP GET
Reactie
{
"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
}
Raadpleeg de beschrijving van parameters in setadv.
/api/setwifiadv
Introductie
Deze API configureert de Wi-Fi-parameters voor WPC/WEM-apparaten.
URL en methode
- URL:
http://{{Lokaal IP van de WPC}}/api/setwifiadv - Methode: HTTP POST
Parameterverzoek
{
"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
}
Reactie
{
"successful": true,
"message": "ok"
}
Parameterbeschrijving
| Parameternaam | Type | Eenheid | Beschrijving |
|---|---|---|---|
| ssid | string | Wi-Fi-AP-naam voor de WLAN-verbinding | |
| pwd | string | Wi-Fi-wachtwoord voor de WLAN-verbinding | |
| ip | string | Statisch IP; niet nodig bij DHCP-modus | |
| netmask | string | Subnetmasker; niet nodig bij DHCP-modus | |
| gw | string | Gateway; niet nodig bij DHCP-modus | |
| dns | string | DNS-server; niet nodig bij DHCP-modus | |
| dhcp | bool | false: DHCP uitschakelen, true: DHCP inschakelen |
Referentiedocumentatie
De "verborgen" functies in de firmware van de Wi-Fi-energiemeter
Geavanceerde functie van IAMMETER
Laat ons uw mening weten op ons forum. https://imeter.club
Over IAMMETER
IAMMETER is een bedrijf gespecialiseerd in energiebeheerproducten en -diensten, en biedt slimme energiemeters, beheerapps en cloudplatforms.
Ons doel is om klanten te helpen energie effectief te beheren, te gebruiken en te besparen, en de elektriciteitsrekening te verlagen door middel van slimme monitoring en analyse.
Oplossingen
Producten
- IAMMETER Energiemeters Overzicht
- WEM3080T – Driefasen/Split-Fase Wi-Fi Energiemeter
- WEM3080 – Enkelfase Wi-Fi Energiemeter
- WEM3050T – Driefasen Energiemeter
- WEM3046T – Driefasen Wi-Fi Energiemeter met 5A Standaard CT-ingang