API regulátorů výkonu řady WPC
Zkratky názvů WPC: Wi-Fi power controller (regulátor výkonu Wi-Fi)
API regulátorů výkonu řady WPC
Tento článek seznamuje především s API poskytovanými regulátory výkonu řady WPC. Prostřednictvím těchto API mohou uživatelé provádět následující operace:
- Konfigurace parametrů WPC
- Řízení výstupního výkonu WPC
Kdo by si měl tento článek přečíst
Tato sekce je umístěna na začátku, protože i když jsme tento článek napsali, pro většinu uživatelů WPC ve skutečnosti není relevantní.
Pokud jste získali regulátor výkonu řady WPC, existuje několik možných režimů provozu:
- Již máte na straně sítě nainstalované elektroměry IAMMETER a přímo používáte WPC3700 ve spojení s elektroměry IAMMETER (WPC3700 pracuje v automatickém režimu), což umožňuje nepřetržitý provoz WPC3700 pod pohonem přebytku solární energie — toto je řešení IAMMETER PV Heater Control System.
- Nemáte elektroměr IAMMETER, ale znáte Home Assistant nebo Node-RED a integrovali jste WPC3700 do automatizačního systému HA nebo Node-RED (Povolte zjišťování MQTT v Home Assistant s nejnovějším firmwarem IAMMETER (i.76.058.8)).
- Potřebujete volat API pro integraci WPC3700 do vlastního systému.
Článek by si měli přečíst pouze uživatelé, kteří vyžadují třetí režim provozu.
/api/setpower
/api/setpower?x=100
Úvod
Toto API řídí výstupní výkon WPC.
Poznámka: Tento parametr lze také upravit prostřednictvím API setadv (volání HTTP POST, parametr setPower).
Vzhledem k tomu, že parametr setPower může být nutné často upravovat na základě hodnot výkonu sítě v reálném čase, je poskytováno toto další rozhraní API HTTP GET.
URL a metoda
URL: http://{{IP}}/api/setpower
Metoda: HTTP GET
| Název parametru | Příklad hodnoty | Jednotka | Povinný | Typ | Popis |
|---|---|---|---|---|---|
| x | 100 | W | Ano | int | Představuje výstupní výkon WPC. Jedná se o stejný parametr jako setPower v setadv. |
/api/setadv
Úvod
Toto API se používá k nastavení parametrů WPC.
Poznámka: Všechny parametry lze nastavit přímo prostřednictvím UI. Toto API použije pouze malý počet zákazníků, kteří potřebují integrovat produkty řady WPC do vlastních systémů.
URL a metoda
- URL:
http://{{Lokální IP WPC}}/api/setadv - Metoda: HTTP POST
Parametry požadavku
Níže je uveden příklad parametrů setadv.
Poznámka: Při provádění setadv není nutné odesílat všechny parametry. Odeslat by se měly pouze parametry, které je třeba upravit. Parametry, které není třeba upravovat, se odesílat nemusí. Nejprve můžete pomocí getadv přečíst aktuální konfiguraci a poté odeslat pouze parametry, které je třeba upravit.
{
"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
}
Odpověď
{
"successful": 1,
"message": "ok"
}
Popis parametrů
| Název parametru | Typ | Jednotka | Popis |
|---|---|---|---|
| maxPower | int | W | Maximální výkon řízené zátěže, musí být menší než 3700 |
| setPower | int | W | Výstupní výkon WPC |
| restorePower | int | W | Výkon po opuštění režimu automatického řízení |
| setPowerMode | int | Výběr režimu provozu: 0: Ruční, 1: Automatický | |
| threshold | int | W | V automatickém režimu je to práh pro úpravu podle výkonu sítě |
| hysteresis | int | W | V automatickém režimu je to hystereze pro úpravu podle výkonu sítě |
| startHour | int | hodina | Čas zahájení automatického režimu |
| stopHour | int | hodina | Čas ukončení automatického režimu |
| tzOffset | int | Posun časového pásma | |
| meterType | int | Výběr značky elektroměru pro měření sítě v automatickém režimu: 0:iMeter, 1:virtualTCP | |
| meterConfig | string | Výběr modelu elektroměru pro měření sítě v automatickém režimu: 3:třífázový, 2:použít fázi B, 1:poměr | |
| ntpServer | string | Adresa serveru NTP | |
| haDiscovery | int | Povolit automatické zjišťování MQTT v Home Assistant: 0: zakázat, 1: povolit | |
| mqttEnabled | int | Povolit MQTT: 0: zakázat, 1: povolit | |
| meterAddress | string | Adresa MQTT brokera, potřebná při integraci s Home Assistant: 192.168.1.22:1833 | |
| mqttUsername | string | Uživatelské jméno MQTT | |
| mqttPassword | string | Heslo MQTT | |
| uploadInterval | int | s | Čas intervalu nahrávání |
/api/getadv
Úvod
Toto API čte všechny parametry WPC (zde lze přečíst všechny parametry z API setadv).
URL a metoda
- URL:
http://{{Lokální IP WPC}}/api/getadv - Metoda: HTTP GET
Odpověď
{
"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
}
Podívejte se na popis parametrů v setadv.
/api/setwifiadv
Úvod
Toto API konfiguruje parametry Wi-Fi pro zařízení WPC/WEM.
URL a metoda
- URL:
http://{{Lokální IP WPC}}/api/setwifiadv - Metoda: HTTP POST
Parametry požadavku
{
"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" // Užitečné pouze v případě, že runMode není cloud
}
Odpověď
{
"successful": true,
"message": "ok"
}
Popis parametrů
| Název parametru | Typ | Jednotka | Popis |
|---|---|---|---|
| ssid | string | Název Wi-Fi AP pro připojení WLAN | |
| pwd | string | Heslo Wi-Fi pro připojení WLAN | |
| ip | string | Statická IP; není vyžadována při použití režimu DHCP | |
| netmask | string | Maska sítě; není vyžadována při použití režimu DHCP | |
| gw | string | Brána; není vyžadována při použití režimu DHCP | |
| dns | string | Server DNS; není vyžadován při použití režimu DHCP | |
| dhcp | bool | false: zakázat DHCP, true: povolit DHCP |
Referenční dokumentace
„Skryté“ funkce ve firmwaru Wi-Fi elektroměru
Podělte se s námi o své názory na našem fóru. https://imeter.club
O společnosti IAMMETER
IAMMETER je společnost zaměřená na produkty a služby pro správu energie, která nabízí chytré elektroměry, aplikace pro správu a cloudové platformy.
Naším cílem je pomáhat zákazníkům efektivně spravovat, využívat a šetřit energii a snižovat účty za elektřinu prostřednictvím chytrého monitoringu a analýzy.
Řešení
Produkty
- Přehled elektroměrů IAMMETER
- WEM3080T – třífázový/dvoufázový Wi-Fi elektroměr
- WEM3080 – jednofázový Wi-Fi elektroměr
- WEM3050T – třífázový elektroměr
- WEM3046T – třífázový Wi-Fi elektroměr se vstupem CT 5A