WPC3700 API

명사 약어 WPC: Wi-Fi 전력 제어기

WPC 시리즈 전력 제어기 API

이 문서에서는 WPC 시리즈 전력 제어기에서 제공하는 API를 주로 소개합니다. 이러한 API를 통해 사용자는 다음 작업을 수행할 수 있습니다:

• WPC 매개변수 구성
• WPC 출력 전력 제어

이 문서를 읽어야 하는 대상

이 섹션을 시작 부분에 배치한 이유는, 저희가 이 문서를 작성했지만 실제로는 대부분의 WPC 사용자와 관련이 없기 때문입니다.

WPC 시리즈 전력 제어기를 구매하셨다면, 몇 가지 가능한 작동 모드가 있습니다:

1. 이미 계통 측에 IAMMETER 계량기를 설치했고, WPC3700을 IAMMETER 계량기와 함께 직접 사용하고 있습니다(WPC3700은 자동 모드로 작동). 이를 통해 WPC3700이 태양광 잉여 전력의 구동 하에 지속적으로 작동할 수 있으며, 이것이 바로 IAMMETER 솔루션 PV 히터 제어 시스템입니다.
2. IAMMETER 계량기는 없지만 Home Assistant 또는 Node-RED에 익숙하며 WPC3700을 HA 또는 Node-RED 자동화 시스템에 통합했습니다(최신 IAMMETER 펌웨어(i.76.058.8)로 Home Assistant에서 MQTT 디스커버리 활성화).
3. API를 호출하여 WPC3700을 자체 시스템에 통합해야 합니다.

세 번째 작동 모드가 필요한 사용자만 이 문서를 읽어야 합니다.

/api/setpower

/api/setpower?x=100

개요

이 API는 WPC의 출력 전력을 제어합니다.

참고: 이 매개변수는 setadv API(HTTP POST 호출, setPower 매개변수)를 통해서도 수정할 수 있습니다.

setPower 매개변수는 실시간 계통 전력 판독값에 따라 자주 수정해야 할 수 있으므로, 이 추가 HTTP GET API 인터페이스가 제공됩니다.

URL 및 메서드

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

메서드: HTTP GET

/api/setadv

개요

이 API는 WPC의 매개변수를 설정하는 데 사용됩니다.

참고: 모든 매개변수는 UI를 통해 직접 설정할 수 있습니다. WPC 시리즈 제품을 자체 시스템에 통합해야 하는 소수의 고객만 이 API를 사용합니다.

URL 및 메서드

• URL: http://{{WPC의 로컬 IP}}/api/setadv
• 메서드: HTTP POST

요청 매개변수

다음은 setadv 매개변수의 예제입니다.

참고: setadv를 실행할 때 모든 매개변수를 제출할 필요는 없습니다. 수정이 필요한 매개변수만 제출하면 됩니다. 수정이 필요 없는 매개변수는 제출할 필요가 없습니다. 먼저 getadv를 사용하여 현재 구성을 읽은 다음, 수정이 필요한 매개변수만 제출할 수 있습니다.

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

응답

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

매개변수 설명

/api/getadv

개요

이 API는 WPC의 모든 매개변수를 읽습니다(setadv API의 모든 매개변수를 여기서 읽을 수 있습니다).

URL 및 메서드

• URL: http://{{WPC의 로컬 IP}}/api/getadv
• 메서드: HTTP GET

응답

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

setadv의 매개변수 설명을 참조하십시오.

/api/setwifiadv

개요

이 API는 WPC/WEM 장치의 Wi-Fi 매개변수를 구성합니다.

URL 및 메서드

• URL: http://{{WPC의 로컬 IP}}/api/setwifiadv
• 메서드: HTTP POST

요청 매개변수

{
    \"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\" // runMode가 cloud가 아닌 경우에만 유용
}

응답

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

매개변수 설명

참고 문서

Wi-Fi 에너지 계량기 펌웨어의 "숨겨진" 기능

IAMMETER 고급 기능

포럼에서 여러분의 의견을 알려주세요. https://imeter.club

IAMMETER 소개

IAMMETER는 에너지 관리 제품 및 서비스에 주력하는 기업으로, 스마트 에너지 계량기, 관리 앱 및 클라우드 플랫폼을 제공합니다.

당사의 목표는 고객이 에너지를 효과적으로 관리, 활용 및 절약하고, 스마트 모니터링 및 분석을 통해 전기 요금을 절감할 수 있도록 돕는 것입니다.

솔루션

• IAMMETER 솔루션 빠른 가이드
• IAMMETER를 다른 시스템과 통합

제품

• IAMMETER 에너지 계량기 개요
• WEM3080T – 3상/분할상 Wi-Fi 에너지 계량기
• WEM3080 – 단상 Wi-Fi 에너지 계량기
• WEM3050T – 3상 에너지 계량기
• WEM3046T – 5A 표준 CT 입력 지원 3상 Wi-Fi 에너지 계량기

시스템

• 자체 호스팅 서비스