API WPC3700

Singkatan kata benda WPC: Wi-Fi power controller

API Power Controller Seri WPC

Artikel ini terutama membahas API yang disediakan oleh Power Controller Seri WPC. Melalui API tersebut, pengguna dapat melakukan operasi berikut:

• Mengonfigurasi parameter WPC
• Mengontrol daya keluaran WPC

Siapa yang Perlu Membaca Artikel Ini

Bagian ini diletakkan di awal karena, meskipun kami yang menulis artikel ini, sebenarnya artikel ini tidak relevan bagi sebagian besar pengguna WPC.

Jika Anda sudah memiliki power controller seri WPC, ada beberapa kemungkinan mode pengoperasian:

1. Anda sudah memasang meteran IAMMETER di sisi grid dan langsung menggunakan WPC3700 bersama dengan meteran IAMMETER (WPC3700 beroperasi dalam mode otomatis), sehingga WPC3700 dapat bekerja terus-menerus dengan dorongan daya surya berlebih, yaitu solusi IAMMETER Sistem Kontrol Pemanas PV.
2. Anda tidak memiliki meteran IAMMETER, tetapi Anda familiar dengan Home Assistant atau Node-RED dan telah mengintegrasikan WPC3700 ke dalam sistem otomasi HA atau Node-RED (Enable MQTT discovery in Home Assistant with the latest IAMMETER firmware (i.76.058.8)).
3. Anda perlu memanggil API untuk mengintegrasikan WPC3700 ke dalam sistem Anda sendiri.

Hanya pengguna yang memerlukan mode pengoperasian ketiga yang perlu membaca artikel ini.

/api/setpower

/api/setpower?x=100

Pengenalan

API ini mengontrol daya keluaran WPC.

Catatan: Parameter ini juga dapat diubah melalui API setadv (panggilan HTTP POST, parameter setPower).

Karena parameter setPower mungkin perlu sering diubah berdasarkan pembacaan daya grid secara real-time, antarmuka API HTTP GET tambahan ini disediakan.

URL dan Metode

URL: http://{{IP}}/api/setpower

Metode: HTTP GET

/api/setadv

Pengenalan

API ini digunakan untuk mengatur parameter WPC.

Catatan: Semua parameter dapat diatur langsung melalui UI. Hanya sebagian kecil pelanggan yang perlu mengintegrasikan produk seri WPC ke dalam sistem mereka sendiri yang akan menggunakan API ini.

URL dan Metode

• URL: http://{{Local IP of the WPC}}/api/setadv
• Metode: HTTP POST

Parameter Permintaan

Berikut adalah contoh parameter setadv.

Catatan: Saat menjalankan setadv, tidak semua parameter perlu dikirim. Hanya parameter yang perlu diubah yang harus dikirim. Parameter yang tidak perlu diubah tidak perlu dikirim. Anda dapat terlebih dahulu menggunakan getadv untuk membaca konfigurasi saat ini, lalu hanya mengirim parameter yang perlu diubah.

{
  "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
}

Respons

{
  "successful": 1,
  "message": "ok"
}

Deskripsi Parameter

/api/getadv

Pengenalan

API ini membaca semua parameter WPC (semua parameter dari API setadv dapat dibaca di sini).

URL dan Metode

• URL: http://{{Local IP of the WPC}}/api/getadv
• Metode: HTTP GET

Respons

{
  "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
}

Lihat deskripsi parameter pada setadv.

/api/setwifiadv

Pengenalan

API ini mengonfigurasi parameter Wi-Fi untuk perangkat WPC/WEM.

URL dan Metode

• URL: http://{{Local IP of the WPC}}/api/setwifiadv
• Metode: HTTP POST

Parameter Permintaan

{
    "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
}

Respons

{
    "successful": true,
    "message": "ok"
}

Deskripsi Parameter

Dokumentasi Referensi

Fitur "tersembunyi" pada firmware meteran energi Wi-Fi

Fungsi lanjutan IAMMETER

Silakan sampaikan pendapat Anda di forum kami. https://imeter.club

Tentang IAMMETER

IAMMETER adalah perusahaan yang berfokus pada produk dan layanan manajemen energi, menyediakan meteran energi pintar, aplikasi manajemen, dan platform cloud.

Tujuan kami adalah membantu pelanggan mengelola, memanfaatkan, dan menghemat energi secara efektif, mengurangi tagihan listrik melalui pemantauan dan analisis yang cerdas.

Solusi

• Panduan Singkat Solusi IAMMETER
• Integrasikan IAMMETER dengan Sistem Lain

Produk

• Ringkasan Meteran Energi IAMMETER
• WEM3080T – Meteran Energi Wi-Fi Tiga Fase/Split-Phase
• WEM3080 – Meteran Energi Wi-Fi Satu Fase
• WEM3050T – Meteran Energi Tiga Fase
• WEM3046T – Meteran Energi Wi-Fi Tiga Fase dengan Input CT Standar 5A

Sistem

• Layanan Self-Hosting