Zigbee2MQTT ? ?

공급업체의 브리지나 게이트웨이 없이도 Zigbee 장치를 사용할 수 있습니다.

이벤트를 연결하고 MQTT를 통해 Zigbee 장치를 제어할 수 있습니다. 이러한 방식으로 사용 중인 스마트 홈 인프라와 Zigbee 장치를 통합할 수 있습니다.

시작하기

설명서는 시작하고 실행하는 데 필요한 모든 정보를 제공합니다! 처음 방문하는 경우 섹션을 건너뛰지 마세요. 중요한 세부정보가 포함되어 있을 수 있습니다.

Zigbee 용어에 익숙하지 않은 경우 이 내용을 읽어 도움을 받으십시오.

통합

Zigbee2MQTT는 MQTT를 사용하기 때문에 (거의) 모든 홈 자동화 솔루션과 잘 통합됩니다. 그러나 다음과 같은 통합은 언급할 가치가 있습니다.

홈어시스턴트

홈어시스턴트 OS: 공식 애드온 사용
기타 설치: 여기 지침 사용

가정 다운

Homey 앱에 통합 구현
Homey 포럼의 문서 및 지원

도모티츠

Domoticz(문서)에서 통합이 구현되었습니다.

글래디스 어시스턴트

Gladys Assistant(문서)에서 기본적으로 통합이 구현되었습니다.

아이오브로커

IoBroker에 통합이 구현되었습니다(문서).

건축학

내부 아키텍처

Zigbee2MQTT는 각각 자체 Github 프로젝트에서 개발된 세 가지 모듈로 구성됩니다. 하드웨어(어댑터)에서 시작하여 위로 이동합니다. zigbee-herdsman은 Zigbee 어댑터에 연결하여 더 높은 수준의 스택에서 API를 사용할 수 있도록 합니다. 예를 들어 Texas Instruments 하드웨어의 경우 zigbee-herdsman은 TI zStack 모니터링 및 테스트 API를 사용하여 어댑터와 통신합니다. Zigbee-herdsman은 핵심 Zigbee 통신을 처리합니다. zigbee-herdsman-converters 모듈은 개별 장치 모델에서 지원하는 Zigbee 클러스터로의 매핑을 처리합니다. Zigbee 클러스터는 Zigbee 네트워크를 통해 조명, 센서 및 스위치가 서로 통신하는 방식 등을 정의하는 기본 프로토콜 위에 있는 Zigbee 프로토콜의 레이어입니다. 마지막으로 Zigbee2MQTT 모듈은 zigbee-herdsman을 구동하고 zigbee 메시지를 MQTT 메시지에 매핑합니다. Zigbee2MQTT는 또한 시스템 상태를 추적합니다. 이 상태를 저장하기 위해 database.db 파일을 사용합니다. 연결된 장치와 해당 기능에 대한 JSON 데이터베이스가 포함된 텍스트 파일입니다. Zigbee2MQTT는 모니터링 및 구성이 가능한 웹 기반 인터페이스를 제공합니다.

개발 중

Zigbee2MQTT는 TypeScript를 사용합니다(현재 부분적으로). 따라서 lib/ 디렉터리의 파일을 변경한 후에는 Zigbee2MQTT를 다시 컴파일해야 합니다. 이는 npm run build 실행하여 수행할 수 있습니다. npm run build 실행하는 대신 더 빠른 개발을 위해 다른 터미널 세션에서 npm run build-watch 실행할 수 있습니다. 이는 파일을 변경할 때 다시 컴파일됩니다. 빌드하기 전에 처음으로 npm install --include=dev 변경 사항을 제출하기 전에 npm run test-with-coverage , npm run pretty:check 및 npm run eslint 실행해야 합니다.