[스마트홈 구축기 17] Home Assistant(HA)에 Zigbee2MQTT(Z2M) 설치하기

총 4단계로 나누어서 설치를 한다.
MQTT 전용 계정을 생성한 후, 하드웨어에서 지그비 동글이 연결된 시리얼 포트 ID를 확인한다. 그리고 MQTT 통신에 필요한 broker 설치를 한 후 마지막으로 Z2M을 설치하고 간단한 설정을 해주면 끝이 난다.
 
MQTT 전용 계정 정보는 MQTT broker 및 Z2M 설정 화면에서 필요한 정보이고, 지그비 동글이 연결된 시리얼 포트 정보 또한 Z2M 설정 시 필요한 정보이다.
 
Z2M Install 관련 참고 자료 : https://github.com/zigbee2mqtt/hassio-zigbee2mqtt#installation 

GitHub - zigbee2mqtt/hassio-zigbee2mqtt: Official Zigbee2MQTT Home Assistant add-on

 

1단계: 계정 생성하기

좌측 사이드바에서 settings을 누른 후 우측 상단에서 User를 클릭한다.

우측 하단에서 ADD USER를 클릭한다.

새로 생긴 팝업에서 Display name을 넣어주면 자동으로 Username이 똑같이 기입이 되고, 이어서 password를 입력한 후 CREATE를 클릭하면 새로 생성된 계정을 확인할 수 있다.

 

2단계: 지그비 동글이 연결된 시리얼 포트 정보 확인하기

하드웨어 정보를 확인하기 전에 먼저 지그비 코디네이터를 HA 설치 기기의 USB 포트에 연결해줘야하는데, 나는 많이 사용하는 Sonoff Zigbee 3.0 USB Dongle Plus의 모델 ZBDongle-P를 알리에서 구입해서 연결하였다.
Sonoff Zigbee 3.0 USB Dongle Plus

1307.0₩ 87% OFF|소노프 지그비 3.0 Usb Dongle | 지그비 3 0 Usb Dongle | 지그비 프로 Usb stick-Zbdongle-p-Aliexpre

 

좌측 사이드바에서 Settings를 누르고 우측에서 Hardware를 선택한다.

ALL HARDWARE를 누른다.

새로 팝업이 뜨는데 검색창에 Zigbee라고 검색을 하면 관련 정보가 뜨고 표시된 "아래 화살표"를 클릭한다.(키워드가 반드시 zigbee인 것은 아니다. 내 경우에 해당하는 것이고 케이스마다 다르다.)

"Device path" 부분에 표기된 정보가 지그비 코디네이터가 설치된 USB 시리얼 포트의 ID이다(/dev/ttyUSB0). 드래그해서 복사하기가 가능한데 복사해서 메모장에 적어둔다.

3단계 : Mosquitto broker 설치 및 설정하기

HA에서 Addon 항목에서 mosquitto broker를 찾아 설치한 후에 configuration항목에서 login에 필요한 username과 password를 1단계에서 생성했던 MQTT 전용 계정 정보로 입력해주면 된다. 이어서 MQTT라는 구성요소가 발견이 되는데 이것을 HA에 통합시켜주면 완료된다.
 

좌측 사이드바에서 Settings를 클릭하고 우측에서 Add-ons를 클릭한다.

우측 하단에 ADD-ON STORE를 클릭한다.

Mosquitto broker를 찾아 클릭한다.

Install을 눌러 설치한다.

상단에 Configuration을 클릭한다.

Logins 부분이 원래 빈칸인데 위와 같이 타이핑을 해준다. 이때 username 및 콜론에 이어서 들어갈 정보는 1단계에서 생성한 계정의 username을 써줘야한다. 마찬가지로 password 및 콜론에 이어서 들어갈 정보도 1단계에서 생성한 계정의 password를 써줘야한다.

broker를 설치해주면 통합구성요소에 mqtt가 활성화가 되는데 그부분을 진행하기 위해서, 좌측 사이드바에 settings를 클릭한 후 우측에 Devices & services를 클릭한다.

MQTT라는 구성요소가 발견이 되고 configure를 클릭해서 통합구성요소로 편입시켜준다.

submit을 누른다.

Finish를 눌러준다.

MQTT라는 구성요소가 HA에 통합되었다.

 

4단계: Z2M 설치 및 설정하기

이부분은 처음에 링크했던 Z2M 공식 사이트의 메뉴얼을 따라가면 된다.
 
Z2M Install 관련 참고 자료 : https://github.com/zigbee2mqtt/hassio-zigbee2mqtt#installation 

GitHub - zigbee2mqtt/hassio-zigbee2mqtt: Official Zigbee2MQTT Home Assistant add-on

좌측 사이드바에서 settings를 누른 후 우측에서 Add-ons를 누른다.

화면 하단에서 Add-on store를 누른다.

우측 상단에서 점 세개를 클릭해주면 3가지 메뉴가 뜨는데 그중에 Repositories를 누른다.

새로운 창이 뜨고 거기에 "https://github.com/zigbee2mqtt/hassio-zigbee2mqtt" 를 타이핑한 후 ADD를 눌러준다.

위와 같이 한개 항목이 추가되면 close를 누른다.

화면을 아래로 내려보면 그림과 같이 Z2M이 3개 추가가 되는데 그중에 가장 좌측의 것을 눌러준다.

install을 눌러준다.

install이 끝나면 상단에 configuration을 눌러준다.

2가지 항목을 타이핑해 넣어야 하는데 mqtt란에는 아까 3단계에서 mqtt broker가 설치된 HA의 네트워크 주소 및 1단계에서 생성했던 mqtt 전용 계정 정보가 필요하고, Serial란에는 2단계에서 확인한 지그비 코디네이터가 연결된 usb 포트 정보가 필요하다.

나의 경우에는, MQTT broker가 설치된 HA 기기의 내부 네트워크 주소가 192.168.1.10이고 mqtt 전용 계정의 username 및 password는 모두 mqtt이다. 그리고 지그비 코디네이터가 연결된 usb port 정보는 /dev/ttyUSB0 이다.

configure 설정이 끝나면 Z2M을 시작하기 위해서 일단 상단에 info를 눌른 후 start를 눌러 준다. 잠시 CPU와 램 사용량이 업데이트 되고 상단에서 Log를 눌러주면 위와 같이 로그창이 올라오면 이상없이 작동을 하는 것이다.

상단 info 창을 누른 후 open web ui를 눌러준다.

문제가 없을 경우 이와 같은 창들이 보인다. (참고: 위의 이미지는 초기화면이 아니라 이미 많은 기기가 등록되어 있는 화면이다.)