Home Assistant MQTT Discovery를 사용한 에너지 미터

Home Assistant MQTT Discovery를 사용한 에너지 미터

Home Assistant MQTT Discovery를 사용하면 에너지 미터가 자신의 기기 및 센서 엔터티를 자동으로 생성할 수 있습니다. 미터와 Home Assistant가 동일한 MQTT 브로커에 연결되면, Home Assistant는 수동 MQTT 센서 YAML 없이 미터를 자동으로 발견할 수 있습니다.

IAMMETER는 현재 출시된 모든 에너지 미터에서 MQTT Discovery를 지원합니다. 모델에 따라 Home Assistant는 전압, 전류, 유효 전력, 수입 에너지, 수출 에너지 및 기타 사용 가능한 상 또는 채널 측정값에 대한 엔터티를 생성합니다.

이 방법은 다음과 같은 경우에 사용하십시오:

• 로컬 MQTT 에너지 모니터링이 필요한 경우;
• 자동 기기 및 엔터티 생성이 필요한 경우;
• HTTP 통합 방식보다 더 빠른 업데이트가 필요한 경우;
• Energy Dashboard와 호환되는 수입/수출 에너지 엔터티가 필요한 경우;
• 최소한의 Home Assistant 구성이 필요한 경우.

토픽, 템플릿, 엔터티 이름 및 메타데이터를 완전히 제어해야 하는 경우 수동 MQTT 에너지 미터 가이드를 대신 사용하십시오.

MQTT Discovery와 수동 MQTT 비교

두 방법 모두 MQTT 브로커가 필요하지만, Discovery만이 Home Assistant 엔터티를 자동으로 생성합니다.

동일한 측정값에 대해 Discovery를 활성화한 상태에서 수동으로 정의하지 마십시오. 두 개의 별도 엔터티 세트를 의도적으로 원하는 경우가 아니라면 권장하지 않습니다.

요구 사항

다음이 필요합니다:

• 펌웨어 i.76.058.8 이상이 설치된 IAMMETER 에너지 미터;
• 미터와 Home Assistant 모두에서 접근 가능한 MQTT 브로커;
• 브로커 주소, 포트, 사용자 이름 및 비밀번호;
• MQTT 통합이 활성화된 Home Assistant.

펌웨어 i.76.058.8은 MQTT Discovery의 안정적인 릴리스 기준입니다. 이전 i.76.02 이미지는 테스트 펌웨어였으며 더 이상 설치하거나 권장 버전으로 링크해서는 안 됩니다.

현재 수정 사항 및 최신 MQTT 옵션은 최신 IAMMETER 펌웨어로 업그레이드를 참조하십시오.

1단계: Home Assistant를 MQTT 브로커에 연결

Home Assistant가 아직 브로커에 연결되지 않은 경우:

1. 설정 → 기기 및 서비스를 엽니다.
2. 통합 추가를 선택합니다.
3. MQTT를 검색합니다.
4. 브로커 주소, 포트, 사용자 이름 및 비밀번호를 입력합니다.
5. MQTT 통합이 성공적으로 연결되었는지 확인합니다.

Home Assistant가 이미 해당 브로커를 사용 중인 경우 기존 MQTT 통합을 유지하십시오. IAMMETER 기기를 위해 두 번째 브로커 연결을 생성하지 마십시오.

MQTT Discovery는 일반적인 Home Assistant MQTT 설정에서 기본적으로 활성화되어 있습니다. Discovery가 비활성화되었거나 기본값이 아닌 접두사가 사용되는 경우, 미터와 Home Assistant가 호환되는 설정을 사용하는지 확인하십시오.

2단계: 미터 WebUI에서 MQTT Discovery 구성

미터의 로컬 WebUI를 열고 설정으로 이동합니다. 다음을 구성합니다:

설정을 저장하고 미터가 재부팅되거나 다시 연결되도록 합니다.

최신 펌웨어는 WebUI에서 필요한 설정을 제공합니다. 기존의 /api/mqttha?x=1 엔드포인트를 호출할 필요가 없습니다.

HA MQTT Discovery 옵션은 Home Assistant 자동 발견 전용입니다. 일반 브로커, 사용자 정의 시스템, Node-RED 흐름 또는 수동 MQTT 구성의 경우 이 옵션을 비활성화된 상태로 두고 미터의 표준 MQTT 게시 형식을 대신 사용하십시오.

3단계: Home Assistant가 미터를 발견하는지 확인

미터가 브로커에 연결된 후:

1. 설정 → 기기 및 서비스 → MQTT를 엽니다.
2. 새로 발견된 IAMMETER 기기를 찾습니다.
3. 기기를 열고 엔터티를 검토합니다.
4. 전압, 전류, 전력 및 에너지 값이 타당한지 확인합니다.
5. 예상된 수의 상 또는 측정 채널이 표시되는지 확인합니다.

Discovery 구성과 측정 상태는 서로 다른 MQTT 토픽을 통해 전송됩니다. Home Assistant는 Discovery 구성을 사용하여 엔터티를 생성한 후, 상태 메시지가 도착하면 값을 업데이트합니다.

기기가 나타나지 않으면 브로커 연결 및 토픽을 먼저 확인한 후에만 재시작하십시오. Home Assistant를 재시작해도 잘못된 브로커 주소나 거부된 MQTT 자격 증명은 해결되지 않습니다.

Energy Dashboard 지원

현재 IAMMETER MQTT Discovery 페이로드에는 수입 및 수출 에너지 엔터티에 필요한 메타데이터가 포함됩니다:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

IAMMETER는 이러한 필드에 해당하는 간결한 MQTT Discovery 키를 사용합니다:

{
  "unit_of_meas": "kWh",
  "dev_cla": "energy",
  "stat_cla": "total_increasing"
}

엔터티가 유효한 데이터를 수신한 후:

1. 설정 → 대시보드 → 에너지로 이동합니다;
2. 그리드 소비에 대한 수입 에너지 엔터티를 선택합니다;
3. 그리드 반환에 대한 수출 에너지 엔터티를 선택합니다;
4. Energy Dashboard 구성을 저장합니다.

에너지 필드에 와트 단위의 순시 유효 전력 엔터티를 선택하지 마십시오. Energy Dashboard에는 누적 kWh가 필요합니다.

단상 및 삼상 모델은 서로 다른 에너지 엔터티를 생성합니다. 미터의 배선 방식과 설치 환경이 그리드 수입/수출을 측정하는 방식에 해당하는 엔터티를 선택하십시오.

MQTT 업데이트 간격 선택

최신 IAMMETER 펌웨어는 2초까지의 MQTT 업데이트를 지원합니다. 간격이 짧을수록 Home Assistant에 더 최신의 전력 측정값이 제공되지만, 브로커 트래픽, 엔터티 업데이트 및 기록 데이터도 증가합니다.

권장 시작 지점:

자동화에 이점이 있는 경우에만 가장 짧은 간격을 사용하십시오. Energy Dashboard 총계는 일반적으로 2초 업데이트가 필요하지 않습니다.

IAMMETER Cloud 호환성

MQTT Discovery는 미터의 실행 모드를 MQTT로 변경합니다. 미터는 측정값을 구성된 브로커로 전송하며, 동시에 IAMMETER Cloud에 업로드하지 않습니다.

동일한 미터에서 Home Assistant와 IAMMETER Cloud를 모두 필요로 하는 경우, 대신 로컬 HTTP 또는 Modbus TCP 통합 방식을 선택하십시오. 이러한 방식은 미터의 정상적인 Cloud 업로드가 계속되는 동안 로컬에서 미터를 읽습니다.

옵션을 Home Assistant 에너지 미터 통합 개요에서 비교하십시오.

지원되는 IAMMETER 모델

현재 출시된 모든 IAMMETER 에너지 미터가 MQTT Discovery를 지원합니다. 주요 차이점은 상/채널 수와 그에 따라 생성되는 엔터티 수입니다.

WEM3046T 및 WEM3046TE는 외부 변류기의 5A 2차 출력을 측정합니다. 올바른 CT 비율을 적용하여 1차 측의 전류, 전력 및 에너지를 얻어야 합니다. 이는 미터링 시스템 요구 사항이며 Home Assistant 또는 MQTT Discovery의 제한 사항이 아닙니다.

단종된 WEM3162는 현재 호환 범위에 포함되지 않습니다.

MQTT Discovery 문제 해결

Home Assistant가 미터를 발견하지 못함

• 미터와 Home Assistant가 동일한 브로커를 사용하는지 확인하십시오.
• 브로커 주소, 포트, 사용자 이름 및 비밀번호를 확인하십시오.
• 미터 WebUI에서 HA MQTT Discovery가 활성화되어 있는지 확인하십시오.
• 브로커 로그에서 연결 거부 또는 인증 오류를 확인하십시오.
• Home Assistant의 MQTT 통합이 연결되어 있는지 확인하십시오.
• MQTT 클라이언트로 브로커의 Home Assistant Discovery 접두사를 구독하고 구성 메시지가 있는지 확인하십시오.

기기는 나타나지만 엔터티를 사용할 수 없음

• Discovery 구성 후 미터가 상태 메시지를 계속 게시하는지 확인하십시오.
• 방화벽, VLAN 또는 브로커 ACL이 Discovery 및 상태 토픽을 모두 허용하는지 확인하십시오.
• 미터가 다른 브로커로 전환되지 않았는지 확인하십시오.
• 최신 펌웨어로 업그레이드하고 다시 연결하십시오.

수입/수출 에너지를 Energy Dashboard에서 선택할 수 없음

• 엔터티가 유효한 숫자 kWh 값을 수신했는지 확인하십시오.
• 개발자 도구 → 상태를 열고 단위, 기기 클래스 및 상태 클래스를 검사하십시오.
• 현재 Discovery 페이로드를 평가하기 전에 초기 테스트 펌웨어로 생성된 오래된 엔터티를 제거하십시오.
• 에너지 엔터티가 아닌 유효 전력 엔터티를 선택하고 있지 않은지 확인하십시오.

중복 MQTT 엔터티가 나타남

중복은 일반적으로 다음 경우에 발생합니다:

• 수동 MQTT YAML과 MQTT Discovery가 모두 활성화된 경우;
• 미터 일련 번호 또는 Discovery 고유 ID가 변경된 경우;
• 초기 펌웨어가 다른 Discovery 구성을 게시한 경우;
• 이전 구성의 보존된 Discovery 토픽이 브로커에 남아 있는 경우.

동일한 측정값에 대해 수동 MQTT 또는 MQTT Discovery 중 하나를 선택한 후, 오래된 구성을 제거하십시오.

오래된 보존된 Discovery 엔터티 제거

MQTT Discovery 구성 메시지는 일반적으로 브로커에 의해 보존되므로 Home Assistant가 재시작 후에도 엔터티를 다시 생성할 수 있습니다. 오래된 구성 토픽이 남아 있으면 Home Assistant UI에서만 기기를 삭제하는 것으로는 충분하지 않을 수 있습니다. 보존된 구성이 다시 수신되면 엔터티가 돌아올 수 있습니다.

안전한 정리 절차:

1. 미터에서 HA MQTT Discovery를 비활성화하거나 일시적으로 연결을 끊어 이전 구성을 즉시 다시 게시하지 않도록 합니다.
2. MQTT 클라이언트를 사용하여 Home Assistant Discovery 접두사(일반적으로 homeassistant/#)를 검사합니다.
3. 영향을 받는 IAMMETER 일련 번호/기기에 속한 구성 토픽만 식별합니다.
4. 각각의 오래된 구성 토픽에 빈 보존 페이로드를 게시합니다.
5. Home Assistant에서 오래된 기기/엔터티가 남아 있으면 제거합니다.
6. 현재 펌웨어에서 Discovery를 다시 활성화합니다.
7. 하나의 기기와 예상되는 현재 엔터티가 생성되었는지 확인합니다.

공유 브로커에서 전체 homeassistant/# 보존 토픽 트리를 삭제하지 마십시오. 다른 기기의 Discovery 구성이 제거될 수 있습니다.

수동 MQTT가 더 나은 선택인 경우

다음이 필요한 경우 수동 MQTT를 대신 사용하십시오:

• 사용자 정의 엔터티 이름 및 고유 ID;
• 사용자 정의 JSON 템플릿 또는 계산;
• 선택된 측정값의 하위 집합만;
• Home Assistant가 아닌 애플리케이션과 공유되는 토픽 구조;
• 기기 클래스 및 상태 클래스에 대한 명시적 제어;
• Home Assistant Discovery가 의도적으로 비활성화된 시스템과의 호환성.

관련 가이드

• Home Assistant를 위한 수동 MQTT 에너지 미터 구성
• IAMMETER 데이터를 MQTT 브로커에 게시
• 모든 IAMMETER–Home Assistant 통합 방법 비교
• 최신 IAMMETER 펌웨어로 업그레이드
• Home Assistant MQTT 문서

업데이트: 2026년 7월 19일.