Home Assistant Modbus TCP 에너지 미터 통합

Home Assistant Modbus TCP 에너지 미터 통합

Modbus TCP는 에너지 미터를 Home Assistant에 연결하는 가장 빠른 방법 중 하나입니다. 로컬 네트워크에서 작동하며 인터넷 연결에 의존하지 않으므로 실시간 전력 모니터링, 태양광 잉여 자동화, 부하 제어 및 Home Assistant Energy Dashboard에 적합합니다.

현재 모든 IAMMETER 에너지 미터는 Modbus TCP를 지원합니다. 두 가지 방법으로 Home Assistant에 통합할 수 있습니다:

1. IAMMETER HACS Modbus 통합 — UI 구성, 자동 생성된 엔터티 및 구성 가능한 스캔 간격.
2. Home Assistant 내장 Modbus 통합 — 레지스터 및 센서를 직접 제어하는 YAML 구성.

이 가이드는 두 방법의 차이점을 설명하고 올바른 방법을 구성하는 데 도움을 줍니다.

HACS Modbus 또는 내장 Home Assistant Modbus?

두 방법 모두 미터에서 동일한 로컬 Modbus TCP 데이터를 읽습니다. 주요 차이점은 Home Assistant 엔터티가 구성되는 방식입니다.

대부분의 사용자에게 HACS Modbus 통합이 더 간단한 옵션입니다. 맞춤 레지스터 목록, 엔터티 명명 체계, 스케일링 규칙 또는 개별 센서별 폴링 간격이 필요한 경우 Home Assistant의 내장 Modbus 통합을 사용하세요.

빠른 업데이트가 필요하지 않다면, HTTP 및 MQTT 대안을 Home Assistant 에너지 미터 통합 개요에서 비교해보세요.

시작하기 전에

다음이 필요합니다:

• Home Assistant와 동일한 LAN에 연결된 IAMMETER 에너지 미터;
• 미터의 로컬 IP 주소;
• Home Assistant와 미터 간에 접근 가능한 TCP 포트 502;
• 최신 미터 펌웨어 버전;
• IAMMETER HACS 통합을 선택하는 경우 HACS가 설치되어 있어야 합니다.

라우터에서 미터의 IP 주소를 예약하는 것이 좋습니다. DHCP 주소 변경은 작동 중인 Modbus 통합이 나중에 사용 불가능해지는 일반적인 원인입니다.

방법 1: HACS를 통해 IAMMETER Modbus 구성

IAMMETER HACS Modbus 통합은 YAML에서 각 레지스터를 수동으로 정의하지 않고 빠른 로컬 데이터를 원하는 사용자를 위해 설계되었습니다.

1단계: 통합 설치

1. Home Assistant에서 HACS를 엽니다.
2. IamMeter Modbus를 검색합니다.
3. 최신 릴리스를 설치합니다.
4. 메시지가 표시되면 Home Assistant를 다시 시작합니다.

프로젝트 및 릴리스 정보:

• IAMMETER HACS Modbus 저장소
• IAMMETER HACS Modbus 릴리스

사용 가능한 최신 릴리스를 사용하세요. 업데이트된 통합에서 스캔 간격 설정이 지원되며 DataUpdateCoordinator에 전달됩니다.

2단계: Home Assistant에 미터 추가

1. 설정 → 기기 및 서비스로 이동합니다.
2. 통합 추가를 선택합니다.
3. IamMeter Modbus를 검색합니다.
4. 미터의 IP 주소와 Modbus TCP 포트를 입력합니다.
5. 적절한 미터 유형 또는 위상 구성을 선택합니다.
6. 스캔 간격을 설정하거나 기본값인 3초를 유지합니다.
7. 양식을 제출하고 기기와 엔터티가 생성되었는지 확인합니다.

통합은 단상, 이중 채널 및 삼상 미터에 대해 각기 다른 수의 엔터티를 생성합니다. 엔터티 목록이 짧다고 단상 모델의 Home Assistant 지원이 제한적이라는 의미는 아닙니다.

3단계: 엔터티 확인

설정 → 기기 및 서비스에서 IAMMETER 기기를 엽니다. 모델에 따라 사용 가능한 엔터티는 다음을 포함할 수 있습니다:

• 전압;
• 전류;
• 유효 전력;
• 역률;
• 수입 에너지;
• 수출 에너지;
• 해당 미터 및 레지스터 세트에서 노출되는 경우 무효 전력 또는 무효 에너지.

수입 및 수출 에너지 엔터티는 kWh를 사용하며 Energy Dashboard에 필요한 Home Assistant 에너지 메타데이터를 포함합니다.

4단계: 적절한 스캔 간격 선택

기본 스캔 간격은 3초입니다. 이는 라이브 대시보드 및 전력 기반 자동화를 위한 실용적인 시작점입니다.

권장 시작점:

1초 설정은 폴링 요청일 뿐, 모든 Home Assistant 대시보드가 초당 한 번씩 표시되리라는 보장은 아닙니다. 네트워크 지연, 레지스터 수, 레코더 부하 및 프론트엔드 새로고침 동작도 결과에 영향을 미칩니다.

불필요하게 과도한 폴링은 피하세요. 대부분의 자동화에서 안정적인 2-5초 업데이트가 가능한 가장 짧은 간격보다 더 유용합니다.

방법 2: Home Assistant의 내장 Modbus 통합 사용

Home Assistant에는 표준 Modbus 통합이 포함되어 있습니다. 이 방법은 완전히 로컬에서 작동하며 HACS가 필요하지 않지만, 연결 및 센서는 YAML로 정의됩니다.

다음 예제는 단상 미터에서 전압과 유효 전력을 읽습니다:

modbus:
  - name: iammeter_hub
    type: tcp
    host: 192.168.1.6
    port: 502
    sensors:
      - name: IAMMETER Voltage
        slave: 1
        address: 0
        input_type: holding
        data_type: uint16
        scale: 0.01
        precision: 1
        unit_of_measurement: V
        device_class: voltage
        state_class: measurement
        scan_interval: 5

      - name: IAMMETER Active Power
        slave: 1
        address: 2
        input_type: holding
        data_type: int32
        unit_of_measurement: W
        device_class: power
        state_class: measurement
        scan_interval: 5

192.168.1.6를 미터의 실제 IP 주소로 바꾸세요. 더 많은 센서를 추가하기 전에 해당 레지스터 맵을 확인하세요:

• IAMMETER Modbus TCP 레지스터 맵
• Home Assistant Modbus 문서

일반적인 IAMMETER Modbus 레지스터

다음 주소는 일반적인 IAMMETER 미터에서 사용하는 표준 위상 블록을 보여줍니다. 항상 최신 레지스터 문서를 권위 있는 참조로 사용하세요.

각 레지스터에 대해 문서화된 스케일, 정밀도 및 워드 순서를 사용하세요. 전압 예제에서 에너지 스케일링을 추론하지 마세요.

YAML 편집 후:

1. Home Assistant의 구성 검사를 실행합니다;
2. Home Assistant를 다시 시작합니다;
3. 개발자 도구 → 상태를 엽니다;
4. 새 엔터티에 합리적인 값과 단위가 있는지 확인합니다.

수입 및 수출 에너지를 Energy Dashboard에 추가

Home Assistant Energy Dashboard에는 순간 전력이 아닌 누적 에너지 엔터티가 필요합니다.

수동으로 구성된 Modbus 에너지 센서의 경우 적절한 메타데이터를 포함하세요:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

그런 다음 설정 → 대시보드 → 에너지로 이동하여 수입 에너지 엔터티를 그리드 소비로, 수출 에너지 엔터티를 그리드 반환으로 선택하세요.

와트 단위의 유효 전력 엔터티를 Energy Dashboard 에너지 필드에 선택하지 마세요. 전력은 현재 속도를 표시하고, 수입/수출 kWh는 누적 에너지를 기록합니다.

지원되는 IAMMETER 모델

현재 모든 IAMMETER 에너지 미터는 HACS Modbus 및 Home Assistant의 내장 Modbus 통합을 모두 지원합니다.

WEM3046T 및 WEM3046TE는 외부 변류기의 5A 2차 출력을 측정합니다. 실제 1차 측 전류, 전력 및 에너지를 얻으려면 올바른 CT 비율을 적용해야 합니다. 이는 Home Assistant 또는 Modbus 호환성 제한이 아닌 5A CT 계량 시스템의 특성입니다.

Modbus와 IAMMETER Cloud를 동시에 사용할 수 있습니까?

네. Home Assistant가 로컬에서 Modbus TCP를 읽는 동안 미터는 IAMMETER Cloud에 계속 업로드할 수 있습니다. Modbus를 사용하기 위해 미터를 MQTT 업로드 모드로 변경할 필요가 없습니다.

이를 통해 두 가지 상호 보완적인 뷰를 얻을 수 있습니다:

• Home Assistant에서 빠른 로컬 데이터 및 자동화;
• IAMMETER Cloud에서 장기 보고서, 전기 요금 분석, 태양광 분석 및 원격 액세스.

여러 개의 고주파 Modbus 클라이언트 방지

미터당 하나의 활성 Modbus TCP 폴링 클라이언트를 안전한 배포 모델로 사용하세요. Home Assistant, Node-RED, PLC 및 다른 로거가 동일한 미터를 독립적으로 고주파 폴링하도록 구성하지 마세요.

여러 시스템이 동일한 실시간 측정값을 필요로 하는 경우, 하나의 시스템이 Modbus를 읽고 데이터를 재분배하도록 하거나 여러 소비자가 브로커를 구독하는 MQTT 아키텍처를 사용하세요.

문제 해결

Home Assistant가 포트 502에 연결할 수 없음

• Home Assistant와 미터가 동일한 연결 가능한 네트워크에 있는지 확인하세요.
• 미터 IP 주소를 확인하고 라우터에서 예약하세요.
• TCP 포트 502가 방화벽 또는 VLAN 규칙에 의해 차단되지 않았는지 확인하세요.
• 다른 Modbus 클라이언트가 연결을 유지하거나 반복적으로 다시 열고 있지 않은지 확인하세요.

엔터티를 사용할 수 없거나 값이 변경되지 않음

• HACS 통합에서 선택한 미터/위상 유형을 확인하세요.
• YAML의 경우 슬레이브 ID, 레지스터 주소, 데이터 유형, 스케일 및 워드 순서를 확인하세요.
• 일시적으로 스캔 간격을 늘려 과도한 폴링이 원인이 아님을 확인하세요.
• 미터의 IP 주소를 변경한 후 통합을 다시 시작하세요.

값이 비현실적으로 높거나 낮음

• 레지스터 스케일링 및 데이터 유형을 확인하세요.
• WEM3046T/WEM3046TE의 경우 외부 CT 비율을 확인하세요.
• 엔터티가 예상된 위상 또는 측정 채널에 해당하는지 확인하세요.

에너지 엔터티가 Energy Dashboard에 표시되지 않음

• kWh 단위의 누적 수입/수출 에너지를 사용하세요.
• device_class: energy를 확인하세요.
• state_class: total_increasing을 확인하세요.
• 와트 단위의 전력 엔터티를 사용하지 마세요.

실시간 전력 데이터로 자동화 구축

Modbus 엔터티가 작동하면 Home Assistant는 유효 전력 또는 그리드 수출 전력을 사용하여 다른 기기를 제어할 수 있습니다. 예를 들면:

• 실시간 Modbus 전력 데이터로 릴레이 제어;
• 태양광 수출이 임계값을 초과할 때 EV 충전;
• 사용 가능한 태양광 잉여로 물 가열;
• 가정 수요가 한도를 초과할 때 사용자에게 알림;
• 비싼 최대 부하 전력을 수입하기 전에 제어 가능한 부하 감소.

통합 가이드는 먼저 안정적인 데이터 확보에 초점을 맞추세요. 부호 규칙, 단위, 업데이트 간격 및 미터를 사용할 수 없을 때의 동작을 확인한 후에만 제어 로직을 추가하세요.

관련 Home Assistant 가이드

• 모든 IAMMETER-Home Assistant 통합 방법 비교
• MQTT 서버로 에너지 미터 구성
• 에너지 미터용 Home Assistant MQTT Discovery
• Home Assistant 태양광 에너지 모니터링
• Home Assistant 및 Grafana