IAMMETER Wi-Fi 에너지 미터: 로컬 API 및 오픈 인터페이스

IAMMETER Wi-Fi 에너지 미터: 로컬 API 및 오픈 인터페이스

IAMMETER Wi-Fi 에너지 미터는 IAMMETER-Cloud 뿐만 아니라 로컬 및 타사 통합을 지원합니다.

사용 가능한 인터페이스는 다음과 같습니다:

• LAN을 통한 로컬 HTTP API
• MQTT 및 MQTTS 발행
• Modbus TCP
• TCP/TLS 업로드
• HTTP/HTTPS 업로드
• 독립형 로컬 운영

이러한 인터페이스를 통해 IAMMETER 미터는 다음과 같은 용도의 개방형 데이터 소스로 작동할 수 있습니다:

• Home Assistant 및 기타 스마트 홈 플랫폼
• Node-RED 자동화
• 자체 호스팅 대시보드
• PLC 및 SCADA 시스템
• 맞춤형 EMS(에너지 관리 시스템)
• 맞춤형 BMS(건물 관리 시스템)
• 타사 데이터 서버

이 가이드는 최신 펌웨어 및 WebUI를 먼저 설명합니다. 이전 펌웨어의 스크린샷 및 구성 방법은 마지막 레거시 섹션에 보관되어 있습니다.

이러한 기능을 기반으로 구축된 바로 사용 가능한 애플리케이션에 대해서는 Home Energy Monitoring, Solar Energy Monitoring 또는 인터넷 없는 로컬 모니터링을 참조하세요.

1) 최신 펌웨어로 업데이트

IAMMETER 펌웨어는 지속적으로 업데이트됩니다. 통합을 구성하기 전에 현재 릴리스 및 모델 호환성을 확인하세요:

• IAMMETER 펌웨어 릴리스 페이지

최신 펌웨어 WebUI는 일반적으로 사용되는 구성 옵션을 직접 노출합니다. 이 문서의 뒷부분에 보관된 수동 구성 API 호출은 주로 기존 설치를 유지 관리할 때 유용합니다.

2) 현재 WebUI에서 실행 모드 선택

미터가 데이터를 전송할 위치 또는 로컬에서 작동할 방식에 따라 실행 모드를 선택합니다.

실행 모드는 데이터 업로드 동작을 제어합니다. 로컬 API 및 Modbus TCP 가용성은 미터 모델, 펌웨어 및 선택한 통합에 대해 확인해야 합니다.

3) 오픈 인터페이스가 중요한 이유

오픈 인터페이스를 통해 사용자는 전기 데이터가 처리 및 저장되는 위치를 결정할 수 있습니다.

일반적인 이유는 다음과 같습니다:

• 측정값을 로컬 네트워크 내에 유지
• 기존 서버로 텔레메트리 전송
• 에너지 데이터를 Home Assistant 또는 Node-RED와 연결
• 맞춤형 대시보드 및 알람 구축
• 전기 데이터와 요금제, 태양광 또는 부하 제어 로직 결합
• 인터넷 접속이 제한적이거나 불안정한 사이트에서 운영

클라우드와 로컬 접근은 반드시 상호 배타적인 것은 아닙니다. 적합한 아키텍처는 프로젝트에 IAMMETER-Cloud 보고서, 로컬 플랫폼, 타사 서버 또는 이들의 조합이 필요한지에 따라 달라집니다.

4) 타사 서버로 데이터 푸시

4.1 TCP 및 TLS

IAMMETER는 TCP 또는 TLS 엔드포인트로 미터 데이터를 푸시할 수 있습니다.

현재 WebUI에서:

1. TCP 실행 모드를 선택합니다.
2. 대상 주소를 입력합니다.
3. 업로드 간격을 구성합니다.
4. 설정을 저장하고 수신 서버에서 데이터를 확인합니다.

TCP 서버의 경우 다음 형식을 사용합니다:

{도메인-또는-IP}:{포트}

예시:

abc.com:12345

TLS 서버의 경우 다음 형식을 사용합니다:

tls://{도메인-또는-IP}:{포트}

예시:

tls://abc.com:12345

현재 펌웨어 개요 문서에는 최소 업로드 간격이 2초로 명시되어 있습니다. 짧은 간격을 선택하기 전에 현재 펌웨어 및 수신 서버 용량을 확인하세요.

4.2 MQTT 및 MQTTS

IAMMETER는 일반 MQTT 브로커에 직접 텔레메트리를 발행하거나, 지원되는 펌웨어에서 암호화된 전송을 위해 MQTTS를 사용할 수 있습니다.

현재 WebUI에서:

1. MQTT 실행 모드를 선택합니다.
2. 적절한 MQTT 또는 MQTTS 형식을 사용하여 브로커 IP 주소 또는 도메인과 포트를 입력합니다.
3. 인증이 필요한 경우 브로커 사용자 이름과 비밀번호를 입력합니다.
4. 업로드 간격을 구성합니다.
5. 저장하고 메시지가 브로커에 도착하는지 확인합니다.

일반 MQTT의 경우 mqtt:// 접두사 없이 브로커 주소와 포트를 입력합니다:

192.168.11.163:1883

MQTTS의 경우 mqtts:// 접두사를 포함합니다:

mqtts://{mqtt-broker-address}:{포트}

예시:

mqtts://broker.example.com:8883

2025년 11월 펌웨어 업데이트에 문서화된 MQTTS 지원에는 다음과 같은 현재 제한 사항이 있습니다:

• TLS 1.2 이하를 지원합니다.
• 사용자 정의 CA 인증서 업로드는 지원되지 않습니다.
• 호스트 이름 확인은 지원되지 않습니다.
• 상호 TLS 인증을 위한 클라이언트 측 인증서는 지원되지 않습니다.

이러한 제한 사항은 브로커를 선택하고 배포의 보안 요구 사항을 평가할 때 중요합니다.

현재 펌웨어 개요 문서에는 최소 업로드 간격이 2초로 명시되어 있습니다.

Home Assistant MQTT Discovery는 추가적인 Home Assistant 검색 기능입니다. 모든 MQTT 통합에 필요한 것은 아닙니다. 참조:

• IAMMETER MQTT 통합 가이드
• Home Assistant의 MQTT Discovery

MQTT/MQTTS를 통해 원격으로 uploadInterval 변경

2025년 11월 업데이트에 설명된 펌웨어에서 MQTT 모드로 실행되는 미터는 자동으로 다음 토픽을 구독합니다:

device/{sn}/config

다른 MQTT 클라이언트에서 다음 JSON을 발행하여 업로드 간격을 원격으로 변경합니다:

{"uploadInterval": 10}

10을 필요한 간격(초)으로 바꾸고 토픽의 {sn}을 미터 일련번호로 바꾸세요.

이 원격 MQTT 구성은 레거시 섹션에 보관된 기존 로컬 /api/uploadinterval 방식과 다릅니다.

4.3 HTTP 및 HTTPS

IAMMETER는 맞춤형 HTTP/HTTPS 서버에 데이터를 전송할 수 있습니다.

현재 WebUI에서:

1. HTTP 실행 모드를 선택합니다.
2. 서버 주소와 포트를 입력합니다.
3. 업로드 간격을 구성합니다.
4. 저장하고 서버에서 요청을 확인합니다.

현재 펌웨어는 기본 HTTPS 포트와 사용자 정의 HTTPS 포트를 모두 지원합니다.

다음 형식 중 하나를 사용합니다:

• 명시적 포트가 없는 일반 HTTP: {주소} — 기본적으로 포트 80을 사용합니다.
• 사용자 정의 포트가 있는 일반 HTTP: {주소}:{포트}.
• 명시적 포트가 없는 HTTPS: https://{주소} — 기본적으로 포트 443을 사용합니다.
• 사용자 정의 포트가 있는 HTTPS: https://{주소}:{포트} — 지정된 포트를 사용합니다.

https:// 접두사가 HTTPS를 선택합니다. 포트 443은 더 이상 HTTPS에 사용할 수 있는 유일한 포트가 아닙니다.

예시:

api.example.com
api.example.com:8080
https://api.example.com
https://api.example.com:8443

펌웨어 릴리스 노트는 새 펌웨어: MQTTS, 원격 구성 및 사용자 정의 HTTPS 포트 추가를 참조하세요.

서버 측 페이로드 처리에 대해서는 타사 서버와 IAMMETER 통합도 참조하세요.

5) HTTP를 통한 로컬 데이터 읽기

미터를 LAN에 연결하고 로컬 IP 주소로 데이터를 요청합니다. 이러한 요청에는 IAMMETER-Cloud가 필요하지 않습니다.

API를 대화형으로 테스트: IAMMETER 로컬 API 탐색기를 열고 미터의 로컬 IP 주소를 입력한 후 WEM API 테스트 페이지를 선택하세요. Swagger 스타일 탐색기는 사용 가능한 로컬 API를 나열하고 브라우저에서 직접 테스트 요청을 보낼 수 있습니다. 브라우저와 IAMMETER 미터는 동일한 LAN에 있어야 합니다.

5.1 GET /api/monitorjson

실시간 전기 측정값을 반환합니다.

표준 데이터에는 다음과 같은 값이 포함됩니다:

• Voltage
• Current
• Active power
• Forward/import kWh
• Reverse/export kWh
• Frequency
• Power factor

응답 예시:

{
  "method": "uploadsn",
  "mac": "B0F8933C4F94",
  "version": "i.75.97.9",
  "server": "em",
  "SN": "3E0BAF87",
  "Datas": [
    [220.0, 9.99, 2198, 11.337, 11.201, 49.99, 1.00],
    [222.5, 9.99, 1100, 11.039, 10.908, 49.99, 0.50],
    [263.5, 9.99, 1213, 10.975, 10.846, 49.99, 0.55]
  ]
}

측정 배열의 수는 미터 모델 및 채널 수에 따라 다릅니다.

지원되는 모델/펌웨어에서 무효 전력 측정이 활성화된 경우 응답 형식에 추가 필드가 포함될 수 있습니다. 무효 전력 측정 데이터 형식을 참조하세요.

5.2 GET /api/monitor

Wi-Fi 정보도 포함하는 확장된 실시간 응답을 반환합니다:

• ssid — 연결된 액세스 포인트 이름
• sig — Wi-Fi 신호 강도

통합에 전기 측정값과 기본 Wi-Fi 상태가 모두 필요한 경우 이 엔드포인트를 사용하세요.

5.3 GET /api/wifidata

펌웨어, 장치 및 네트워크 구성 정보를 반환합니다.

예시:

{
  "version": "i.75.97.9",
  "SN": "3E0BAF87",
  "mac": "B0F8933C4F94",
  "type": "PM",
  "ssid": "example-wifi",
  "ip": "192.168.11.62",
  "netmask": "255.255.255.0",
  "gw": "192.168.11.1",
  "dns": "192.168.11.1",
  "dhcp": 1,
  "runMode": "tcp",
  "uploadinterval": 60
}

장치 일련번호, MAC 주소, 내부 주소 또는 Wi-Fi 정보가 포함된 응답을 게시하지 마세요. 값이 삭제되지 않은 경우 특히 주의하십시오.

6) 업로드 모드 간 JSON 형식

IAMMETER는 HTTP, TCP, MQTT 및 로컬 API에서 일관된 핵심 JSON 측정 구조를 사용합니다. 이는 하나의 수신 시스템이 여러 전송 방법을 지원할 때 필요한 작업을 줄여줍니다.

전송 방법과 봉투 형식은 여전히 수신자가 연결, 인증 또는 메시지 프레임 방식에 영향을 줄 수 있습니다. 선택한 모드에 대해 문서화된 형식에 따라 수신 시스템을 구현하세요.

• IAMMETER 에너지 미터 JSON 데이터 정의

7) Modbus TCP

IAMMETER 미터는 호환 클라이언트와의 직접 LAN 통합을 위해 Modbus TCP를 지원합니다.

일반적인 클라이언트는 다음과 같습니다:

• Home Assistant
• PLC
• SCADA 시스템
• 산업용 게이트웨이
• 맞춤형 Modbus 애플리케이션

참고 자료:

• IAMMETER Modbus TCP 개요
• Home Assistant 통합 개요

배포 전에 미터 모델, 펌웨어, 레지스터 정의, 폴링 간격 및 클라이언트 동작을 확인하세요.

8) 통합 시나리오

9) 현재 인터페이스 요약 및 리소스

추가 리소스:

• 최신 펌웨어
• MQTTS 및 사용자 정의 HTTPS 포트 펌웨어 노트
• 비디오 튜토리얼
• JSON 데이터 정의
• Modbus TCP 개요
• 자체 시스템 개발
• 인터넷 없이 모니터링

IAMMETER의 로컬 API 및 개방형 프로토콜을 통해 실시간 모니터링으로 시작하여 나중에 맞춤형 EMS, 자체 호스팅 대시보드 또는 자동화 워크플로우를 추가할 수 있습니다.

10) 레거시 펌웨어 페이지 및 구성 방법

다음 자료는 여전히 이전 펌웨어를 실행하는 미터 또는 기존 통합을 유지 관리하는 사용자를 위해서만 보관됩니다. 새 설치의 경우 최신 펌웨어로 업데이트하고 필요한 옵션을 사용할 수 있는 곳에서는 현재 WebUI를 사용하세요.

10.1 레거시 실행 모드 페이지

이전 펌웨어에서는 다음 실행 모드 선택 페이지를 사용했습니다:

레이아웃 및 옵션 이름은 이 가이드의 앞부분에 표시된 현재 WebUI와 일치하지 않을 수 있습니다.

10.2 레거시 TCP/TLS 페이지

이전 펌웨어 통합은 다음 TCP/TLS 구성 페이지 및 관련 가이드를 참조할 수 있습니다:

• 레거시 타사 서버 통합 가이드
• 레거시 서버 업로드 비디오

10.3 레거시 MQTT 페이지

이전 MQTT 문서에서는 다음 구성 인터페이스를 사용했습니다:

현재 워크플로우의 경우 이 문서의 앞부분에 있는 현재 WebUI 지침과 업데이트된 MQTT 통합 가이드를 사용하세요.

10.4 레거시 HTTP/HTTPS 페이지

이전 펌웨어에서는 다음 HTTP/HTTPS 대상 페이지를 사용했습니다:

레거시 통합 가이드는 HTTP/HTTPS를 통한 업로드에 보관되어 있습니다.

이 이전 워크플로우에서 HTTPS는 기본 포트 443과 연결되었으며 https:// 접두사가 필요하지 않았습니다. 현재 펌웨어는 대신 https:// 접두사를 사용하여 HTTPS를 선택하고 기본 포트 443 또는 명시적으로 지정된 사용자 정의 포트를 지원합니다.

10.5 레거시 구성 API

다음 로컬 API 호출은 이전 구성 워크플로우에 나타났습니다. 현재 펌웨어에서는 해당 설정을 옵션을 사용할 수 있는 경우 일반적으로 WebUI를 통해 구성해야 합니다.

/api/uploadinterval?x=<초>

비클라우드 업로드 간격을 설정하는 레거시 방법입니다.

/api/mqtt

MQTT 자격 증명을 구성하는 레거시 방법입니다.

/api/netmetring

Net Energy Metering 모드를 활성화 또는 비활성화하는 레거시 방법입니다.

• Net Energy Metering 참조

/api/ctcratio

특정 분할상 또는 균형 시나리오에서 문서화된 Phase-C 승수를 적용하는 레거시 방법입니다.

• CTC Ratio 참조

/api/reactive

지원되는 펌웨어/모델에서 무효 전력 및 무효 에너지 측정을 활성화 또는 비활성화하는 레거시 방법입니다.

• 무효 전력 참조

/api/ratio — WEM3046T 전용

WEM3046T는 5A 2차 출력의 외부 CT를 사용합니다. 이전 구성 지침에서는 다음을 사용하여 CT 비율을 설정했습니다:

/api/ratio?x={ct_ratio}

예시:

/api/ratio?x=400

이 엔드포인트는 WEM3046T에만 해당되며 다른 IAMMETER 모델에서는 유효하지 않습니다. 현재 펌웨어의 경우 사용 가능할 때 모델의 현재 WebUI 구성을 사용하세요.

이전 자료는 하위 호환성을 위해 보관되었습니다. 현재 설치는 최신 펌웨어 WebUI를 따라야 합니다.