API's van WPC3700
Zelfstandig naamwoord afkorting WPC: Wi-Fi power controller
API van WPC-serie Power Controller
Dit artikel introduceert voornamelijk de API's die door deWPC-serie vermogensregelaarsVia deze API's kunnen gebruikers de volgende bewerkingen uitvoeren:
- WPC-parameters configureren
- Regel het WPC-uitgangsvermogen
Voor wie is dit artikel bedoeld?
Deze sectie staat aan het begin omdat dit artikel, hoewel wij het hebben geschreven, niet relevant is voor de meeste WPC-gebruikers.
Als u een vermogensregelaar uit de WPC-serie hebt aangeschaft, zijn er een paar mogelijke werkingsmodi:
- U hebt al IAMMETER-meters aan de netzijde geïnstalleerd en maakt direct gebruik van deWPC3700in samenhang metIAMMETER-meters(WPC3700 werkt in de automatische modus), waardoor de WPC3700 continu kan werken onder invloed van de overschot aan zonne-energie, wat de IAMMETER-oplossing isPV-verwarmingsregelsysteem.
- U beschikt niet over een 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 (Schakel MQTT-detectie in Home Assistant in met de nieuwste IAMMETER-firmware (i.76.058.8)).
- U moet de API aanroepen om de WPC3700 in uw eigen systeem te integreren.
Dit artikel is alleen bedoeld voor gebruikers die de derde bedieningsmodus nodig hebben.
/api/vermogen instellen
/api/setpower?x=100
Invoering
Deze API regelt het uitgangsvermogen van de WPC.
Let op: Deze parameter kan ook worden gewijzigd via deinstellenadvAPI (HTTP POST-aanroep,setVermogenparameter).
Sinds desetVermogenOmdat de parameter mogelijk regelmatig moet worden aangepast op basis van realtime netstroommetingen, is deze extra HTTP GET API-interface beschikbaar.
URL en methode
URL:http://{{IP}}/api/setpower
Methode: HTTP GET
| Parameternaam | Voorbeeldwaarde | Eenheid | Vereist | Type | Beschrijving |
|---|---|---|---|---|---|
| X | 100 | W | Ja | int | Geeft het vermogen van de WPC weer. Dit is dezelfde parameter alssetVermogenininstellenadv. |
/api/setadv
Invoering
Deze API wordt gebruikt om de parameters van de WPC in te stellen.
Let op: Alle parameters kunnen rechtstreeks via deGebruikersinterfaceAlleen een klein aantal klanten dat WPC-serieproducten in hun eigen systemen moet integreren, zal deze API gebruiken.
URL en methode
- URL:
http://{{Lokaal IP van de WPC}}/api/setadv - Methode: HTTP POST
Aanvraagparameters
Hieronder ziet u een voorbeeld vaninstellenadvparameters.
Let op: Bij het uitvoereninstellenadv, niet alle parameters hoeven te worden ingediend. Alleen de parameters die moeten worden gewijzigd, moeten worden ingediend. Parameters die niet hoeven te worden gewijzigd, hoeven niet te worden ingediend. U kunt eerstgetadvom de huidige configuratie te lezen en vervolgens alleen de parameters te verzenden die gewijzigd moeten worden.
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"meterAdres": "10.10.30.35",
"drempel": 30,
"hysterese": 50,
"startHour": 8,
"stopHour": 18,
"tzOffset": 8,
"meterType": 0,
"meterConfig": "3,2,1",
"ntpServer": "ntp.aliyun.com",
"haDiscovery": 1,
"mqttEnabled": 1,
"mqttAdres": "10.10.30.89:1883",
"mqttGebruikersnaam": "test",
"mqttWachtwoord": "123456",
"uploadInterval": 6
}
Antwoord
{
"geslaagd": 1,
"bericht": "ok"
}
Parameterbeschrijving
| Parameternaam | Type | Eenheid | Beschrijving |
|---|---|---|---|
| maxVermogen | int | W | Het maximale vermogen van de geregelde belasting moet minder zijn dan 3700 |
| setVermogen | int | W | Het vermogen van de WPC |
| herstellenPower | int | W | Stroom na het verlaten van de automatische modus |
| setPowerMode | int | Selectie van de bedrijfsmodus: 0: Handmatig, 1: Automatisch | |
| drempelwaarde | int | W | In de automatische modus is dit de drempelwaarde voor aanpassing op basis van het netvermogen |
| hysterese | int | W | In de automatische modus is dit de hysterese voor aanpassing op basis van het netvermogen |
| startUur | int | uur | Starttijd van de automatische modus |
| stopUur | int | uur | Eindtijd van de automatische modus |
| tzVerschuiving | int | Tijdzone-offset | |
| meterType | int | Keuze van metermerk voor rastermeting in automatische modus: 0:iMeter, 1:virtualTCP | |
| meterconfiguratie | snaar | Keuze van metermodel voor netmeting in automatische modus: 3:driefase, 2:gebruik faseB, 1:verhouding | |
| ntp-server | snaar | NTP-serveradres | |
| haOntdekking | int | Schakel Home Assistant MQTT automatische detectie in: 0: uitschakelen, 1: inschakelen | |
| mqttIngeschakeld | int | MQTT inschakelen: 0: uitschakelen, 1: inschakelen | |
| meterAdres | snaar | MQTT-brokeradres, nodig bij integratie met Home Assistant: 192.168.1.22:1833 | |
| mqttGebruikersnaam | snaar | MQTT-gebruikersnaam | |
| mqttWachtwoord | snaar | MQTT-wachtwoord | |
| uploadInterval | int | S | Uploadintervaltijd |
/api/getadv
Invoering
Deze API leest alle parameters van de WPC (alle parameters van deinstellenadvAPI kan hier gelezen worden).
URL en methode
- URL:
http://{{Lokaal IP van de WPC}}/api/getadv - Methode: HTTP GET
Antwoord
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"setPowerModeList": "Handmatig,Automatisch",
"meterAdres": "10.10.30.35",
"drempel": 20,
"hysterese": 30,
"startUur": 8,
"stopUur": 18,
"tzOffset": 8,
"meterType": 0,
"meterConfig": "3,2,1",
"meterList": "iMeter,virtualTCP",
"ntpServer": "ntp.aliyun.com",
"haDiscovery": 0,
"mqttIngeschakeld": 0,
"mqttAdres": "192.168.1.22:1833",
"mqttGebruikersnaam": "test",
"mqttWachtwoord": "123456",
"uploadInterval": 60
}
Raadpleeg de beschrijving van de parameters ininstellenadv.
/api/setwifiadv
Invoering
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
Aanvraagparameters
{
"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" // Alleen nuttig als runMode niet-cloud is
}
Antwoord
{
"succesvol": waar,
"bericht": "ok"
}
Parameterbeschrijving
| Parameternaam | Type | Eenheid | Beschrijving |
|---|---|---|---|
| ssid | snaar | Wi-Fi AP-naam voor de WLAN-verbinding | |
| gedoogd | snaar | Wi-Fi-wachtwoord voor de WLAN-verbinding | |
| ik p | snaar | Statisch IP; niet vereist bij gebruik van DHCP-modus | |
| netmasker | snaar | Netmasker; niet vereist bij gebruik van de DHCP-modus | |
| gw | snaar | Gateway; niet vereist bij gebruik van de DHCP-modus | |
| dns | snaar | DNS-server; niet vereist bij gebruik van de DHCP-modus | |
| dhcp | onzin | false: DHCP uitschakelen, true: DHCP inschakelen |
Referentiedocumentatie
De "verborgen" functies in de firmware van de wifi-energiemeter
Geavanceerde functie van IAMMETER
Welkom om ons uw mening te laten weten op ons forum.https://imeter.club
Over IAMMETER
IAMMETER is een bedrijf dat zich richt op energiebeheerproducten en -diensten en slimme energiemeters, beheerapps en cloudplatforms aanbiedt.
Ons doel is om klanten te helpen energie effectief te beheren, gebruiken en besparen, en zo hun energierekening te verlagen door middel van slimme monitoring en analyse.
Oplossingen
Producten
- IAMMETER Energiemeters Overzicht
- WEM3080T – Driefasen/gesplitste fase Wi-Fi-energiemeter
- WEM3080 – Enkelfasige Wi-Fi-energiemeter
- WEM3050T – Driefasen energiemeter
- WEM3046T – Driefasen Wi-Fi-energiemeter met 5A standaard CT-ingang