Home Assistant는 Zigbee2MQTT를 Core와 어떻게 조정하나요?

에바 왕

IceWhale author

에바 왕 는 기술 작가 그리고 이자 ZimaSpace의 상주 장인입니다. 평생을 기술에 열정을 가진 사람으로서 홈랩과 오픈소스 소프트웨어에 열정을 가지고 있으며,복잡한 기술 개념을 쉽게 이해할 수 있는 실습 가이드로 번역하는 데 전문성을 가지고 있습니다.에바는 셀프 호스팅이 어렵지 않고 재미있어야 한다고 믿습니다. 그녀의 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 신비를 풀도록돕고 있습니다. 첫 NAS 구축부터 Docker 컨테이너 마스터링까지.

How Does Home Assistant Coordinate Zigbee2MQTT With Core?

Home Assistant는 Zigbee2MQTT를 Home Assistant Core의 일부로 취급하는 대신 MQTT를 통해 조정합니다. Zigbee2MQTT는 Zigbee 코디네이터와 메시 네트워크 상호작용을 담당하고, MQTT 브로커는 메시지를 전달하며, Home Assistant의 MQTT 통합은 디스커버리 및 상태 토픽을 자동화에서 사용할 수 있는 엔티티로 변환합니다.

이러한 분리는 Zigbee 전송, 메시지 브로커링, 홈 자동화 로직을 서로 독립적으로 재시작하거나 이동할 수 있다는 점에서 강력합니다. 하지만 동시에 세 서비스로 구성된 의존성 체인도 만듭니다. Zigbee 장치가 정상이어도 Zigbee2MQTT, 브로커, 디스커버리 또는 가용성 메시징에 문제가 있으면 Home Assistant에는 해당 장치를 사용할 수 없는 것으로 표시될 수 있습니다.

Zigbee2MQTT는 무선 측 장치 통신을 담당합니다

Zigbee2MQTT는 코디네이터와 통신하고, Zigbee 장치 정의를 유지하며, 메시 네트워크에서 보고를 수신하고, 이를 MQTT 메시지로 변환합니다. Zigbee2MQTT가 코디네이터를 관리하는 경우 Home Assistant가 코디네이터에 직접 접근할 필요는 없습니다.

Zigbee2MQTT Home Assistant 통합 가이드에서는 MQTT 디스커버리가 Zigbee2MQTT 장치와 엔티티를 Home Assistant에서 자동으로 생성하는 표준 방식이라고 설명합니다.

이러한 담당 범위의 구분은 복구 과정에서 중요합니다. Home Assistant를 재시작한다고 해서 Zigbee 메시 네트워크를 다시 페어링할 필요는 없어야 하며, Zigbee2MQTT를 재시작해도 안정적인 엔티티 ID를 참조하는 Home Assistant 자동화가 삭제되어서는 안 됩니다.

MQTT 브로커는 두 서비스 사이의 메시지 경계입니다

Zigbee2MQTT는 장치 상태와 브리지 정보를 MQTT 토픽에 게시합니다. Home Assistant는 관련 토픽을 구독하고, 자동화나 사용자가 장치를 변경하면 명령을 다시 게시합니다.

MQTT 브로커가 메시지 경계인 이유는 Zigbee2MQTT가 토픽에 메시지를 게시하고, Home Assistant가 필요한 토픽을 구독한 뒤 같은 브로커를 통해 명령을 다시 게시하기 때문입니다. 최신 MQTT 아키텍처 가이드에서는 브로커가 토픽 기반 메시지를 양쪽 사이에서 라우팅하는 동안 게시자와 구독자가 서로 분리된 상태로 유지되는 방식을 설명합니다.

브로커에 장애가 발생해도 Zigbee 메시 네트워크 자체는 계속 유지될 수 있지만 Home Assistant 화면의 업데이트는 중단될 수 있습니다. 브로커 문제는 코디네이터 및 Core 문제와 별도로 진단해야 합니다.

디스커버리는 엔티티를 정의하고, 상태 토픽은 최신 상태를 유지합니다

디스커버리 메시지는 어떤 엔티티가 존재해야 하는지, 상태와 명령을 제공하는 토픽은 무엇인지, 어떤 장치에 속하는지, 값을 어떻게 해석해야 하는지를 Home Assistant에 알려줍니다. 엔티티가 생성되면 일반 상태 메시지가 최신 상태를 유지합니다.

다시 로드하거나 재시작하면 이 과정의 문제가 드러날 수 있습니다. Home Assistant 커뮤니티 사례에서는 예상된 재디스커버리 또는 보존 상태 경로가 올바르게 다시 구성되지 않으면 MQTT로 디스커버리된 엔티티가 계속 사용할 수 없는 상태로 남을 수 있음을 보여줍니다.

안정적인 고유 ID와 신중한 재디스커버리 전략을 사용하세요. 브리지가 변경될 때마다 새로운 ID로 엔티티를 다시 만들면 물리적인 Zigbee 장치가 바뀌지 않았더라도 대시보드, 기록의 연속성, 자동화가 손상됩니다.

-15% OFF

ZimaBoard 2 - 당신의 큰 아이디어를 위한 미니 홈 서버

Single board computer zimaboard2

가용성은 장치 상태와 별개의 신호입니다

ON과 같은 상태는 Home Assistant가 마지막으로 보고받은 값을 의미할 뿐이며, Zigbee2MQTT나 장치가 현재 연결 가능한 상태라는 뜻은 아닙니다. 가용성 토픽은 별도의 활성 상태 확인 계약을 제공합니다.

Zigbee2MQTT의 가용성 확인은 전원 연결 장치와 배터리 장치를 서로 다르게 처리합니다. 수동 장치는 요청에 따라 즉시 핑할 수 없기 때문입니다. 최신 문서에서는 활성 장치는 더 짧은 확인 간격과 핑/백오프 로직을 사용하고, 수동 장치는 훨씬 긴 확인 간격에 의존한다고 명시합니다. 따라서 가용성은 마지막으로 보존된 상태와 별도로 해석해야 합니다.

가용성을 고려하지 않은 채 오래된 상태를 기반으로 안전에 중요한 동작을 실행하지 마세요. 보존된 값은 상태 복원에 유용할 수 있지만, 현재 오프라인인 장치를 나타낼 수도 있습니다.

시작 순서는 운에 의존하지 않고 계약을 복원해야 합니다

정상적인 시작 순서는 단순히 “브로커를 먼저 시작한 다음 Zigbee2MQTT, 그다음 Home Assistant를 시작하는 것”이 아닙니다. 서비스가 서로 다른 순서로 시작될 수 있으므로 메시징 계약은 재연결을 견딜 수 있어야 합니다. Zigbee2MQTT는 브로커에 다시 연결되고, 디스커버리를 사용할 수 있게 되며, Home Assistant는 구독을 시작하고, 현재 상태는 설계에 따라 다시 게시되거나 보존되어야 합니다.

ZimaSpace의 스마트 홈 이벤트 예시에서는 MQTT를 사용하면 스마트 홈 서비스가 하나의 프로세스나 하나의 물리적 서버를 공유하지 않고도 로컬 이벤트를 주고받을 수 있음을 보여줍니다. Zigbee2MQTT는 이러한 분리의 구체적인 사례입니다.

계층	주요 책임	장애 증상
Zigbee2MQTT	Zigbee 메시 네트워크 및 장치 변환	새로운 Zigbee 메시지가 수신되지 않음
MQTT 브로커	서비스 간 메시지 전달	게시/구독 경로 실패
Home Assistant MQTT	엔티티 디스커버리 및 상태 매핑	엔티티가 없거나 사용할 수 없음
자동화/Core	규칙 및 서비스 호출	엔티티는 정상이나 동작 로직이 실패함

FAQ

Zigbee2MQTT가 Zigbee 네트워크를 계속 유지하려면 Home Assistant가 실행 중이어야 하나요?

아니요. Zigbee2MQTT가 코디네이터 측 Zigbee 네트워크를 관리합니다. Home Assistant는 MQTT를 통해 데이터를 소비하고 명령을 보내는 역할을 합니다. Zigbee2MQTT 서비스와 브로커가 계속 실행 중이라면 Home Assistant가 오프라인 상태여도 됩니다.