API của WPC3700

Viết tắt danh từ WPC: Bộ điều khiển công suất Wi-Fi (Wi-Fi power controller)

API của Bộ điều khiển công suất dòng WPC

Bài viết này chủ yếu giới thiệu các API do Bộ điều khiển công suất dòng WPC cung cấp. Thông qua các API này, người dùng có thể thực hiện những thao tác sau:

• Cấu hình các tham số của WPC
• Điều khiển công suất đầu ra của WPC

Ai nên đọc bài viết này

Phần này được đặt ở đầu bài vì mặc dù chúng tôi đã viết bài này, nhưng thực tế nó không liên quan đến hầu hết người dùng WPC.

Nếu bạn đã có một bộ điều khiển công suất dòng WPC, sẽ có một vài chế độ hoạt động khả thi:

1. Bạn đã lắp đặt đồng hồ IAMMETER ở phía lưới điện và đang sử dụng trực tiếp WPC3700 kết hợp với đồng hồ IAMMETER (WPC3700 hoạt động ở chế độ tự động), cho phép WPC3700 hoạt động liên tục nhờ phần điện mặt trời dư thừa — đây chính là giải pháp IAMMETER Hệ thống điều khiển bình nóng lạnh bằng điện mặt trời.
2. Bạn không có đồng hồ IAMMETER, nhưng quen thuộc với Home Assistant hoặc Node-RED và đã tích hợp WPC3700 vào hệ thống tự động hóa HA hoặc Node-RED (Bật tính năng tự phát hiện MQTT trong Home Assistant với firmware IAMMETER mới nhất (i.76.058.8)).
3. Bạn cần gọi API để tích hợp WPC3700 vào hệ thống của riêng mình.

Chỉ những người dùng cần chế độ hoạt động thứ ba mới nên đọc bài viết này.

/api/setpower

/api/setpower?x=100

Giới thiệu

API này điều khiển công suất đầu ra của WPC.

Lưu ý: Tham số này cũng có thể được sửa đổi thông qua API setadv (gọi HTTP POST, tham số setPower).

Vì tham số setPower có thể cần được sửa đổi thường xuyên dựa trên chỉ số công suất lưới theo thời gian thực, nên giao diện API HTTP GET bổ sung này được cung cấp.

URL và phương thức

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

Phương thức: HTTP GET

/api/setadv

Giới thiệu

API này được dùng để thiết lập các tham số của WPC.

Lưu ý: Tất cả các tham số đều có thể được thiết lập trực tiếp thông qua giao diện người dùng. Chỉ một số ít khách hàng cần tích hợp sản phẩm dòng WPC vào hệ thống của riêng họ mới sử dụng API này.

URL và phương thức

• URL: http://{{Local IP of the WPC}}/api/setadv
• Phương thức: HTTP POST

Tham số yêu cầu

Dưới đây là một ví dụ về các tham số của setadv.

Lưu ý: Khi thực hiện setadv, không cần gửi tất cả các tham số. Chỉ nên gửi những tham số cần sửa đổi. Các tham số không cần sửa đổi thì không cần gửi. Bạn có thể dùng getadv để đọc cấu hình hiện tại trước, sau đó chỉ gửi những tham số cần sửa đổi.

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

Phản hồi

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

Mô tả tham số

/api/getadv

Giới thiệu

API này đọc tất cả các tham số của WPC (mọi tham số từ API setadv đều có thể đọc được ở đây).

URL và phương thức

• URL: http://{{Local IP of the WPC}}/api/getadv
• Phương thức: HTTP GET

Phản hồi

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

Tham khảo phần mô tả các tham số trong setadv.

/api/setwifiadv

Giới thiệu

API này cấu hình các tham số Wi-Fi cho thiết bị WPC/WEM.

URL và phương thức

• URL: http://{{Local IP of the WPC}}/api/setwifiadv
• Phương thức: HTTP POST

Tham số yêu cầu

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

Phản hồi

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

Mô tả tham số

Tài liệu tham khảo

Những tính năng "ẩn" trong firmware của đồng hồ điện Wi-Fi

Tính năng nâng cao của IAMMETER

Hãy cho chúng tôi biết suy nghĩ của bạn trên diễn đàn của chúng tôi. https://imeter.club

Về IAMMETER

IAMMETER là công ty tập trung vào các sản phẩm và dịch vụ quản lý năng lượng, cung cấp đồng hồ đo năng lượng thông minh, ứng dụng quản lý và nền tảng đám mây.

Mục tiêu của chúng tôi là giúp khách hàng quản lý, sử dụng và tiết kiệm năng lượng hiệu quả, giảm hóa đơn tiền điện thông qua giám sát và phân tích thông minh.

Giải pháp

• Hướng dẫn nhanh về các giải pháp của IAMMETER
• Tích hợp IAMMETER với các hệ thống khác

Sản phẩm

• Tổng quan về đồng hồ đo năng lượng IAMMETER
• WEM3080T – Đồng hồ đo năng lượng Wi-Fi ba pha / hai pha
• WEM3080 – Đồng hồ đo năng lượng Wi-Fi một pha
• WEM3050T – Đồng hồ đo năng lượng ba pha
• WEM3046T – Đồng hồ đo năng lượng Wi-Fi ba pha với đầu vào CT chuẩn 5A

Hệ thống

• Dịch vụ tự lưu trữ (Self-Hosting)