현대통신 월패드 HA 애드온 주방 비디오폰 설정 기능 추가

Add Configuration for Kitchen Subphone in Hyundai HT Wallpad Addon (Home Assistant)

1. 서론

오늘(6월 10일) 새벽 3시 무렵 홈어시스턴트(Home Assistant, HA)용 현대통신 RS-485 월패드 연동 애드온 베타버전 출시 관련 블로그 글에 문제 상황 공유 댓글이 달렸다

※ 은그~~~~은히 애드온 사용자가 늘어나고 있다는 점이 재미있다 ㅋㅋ 본격적으로 홍보 활동을 했으면 꽤 일거리가 많았겠구나...라는 생각이 든다

Home Assistant add-on 베타버전 릴리즈

Home Assistant add-on 베타버전 릴리즈

문제상황 댓글

 

문제 상황: 주방 비디오폰(서브폰) 연동을 위해 ESP8266 모듈을 TCP로 연동했으나, 'Device is not registered' 오류가 발생함

 

주방 비디오폰은 3840이라는 특이한 값의 baudrate를 사용하고 있기에 EW-11같은 상용 RS-485 to WiFi 컨버터를 사용할 수 없다는 단점이 있다

힐스테이트 광교산::주방 비디오폰 세대현관문/공동현관문 기능 분리 (HomeAssistant)

힐스테이트 광교산::주방 비디오폰 세대현관문/공동현관문 기능 분리 (HomeAssistant)

 

많은 홈네트워크 유저들이 EW-11을 사용하고 있기에 주방 비디오폰 연동 기능은 활용 빈도가 떨어질 것으로 내멋대로 예상해 기능 테스트를 아예 하지 않고 애드온을 출시했다..

그런데 댓글과 같이 ESP8266, ESP32 모듈 등에 RS-485 Raw 패킷을 TCP 네트워크로 전송하는 펌웨어를 얹어 내 애드온과의 연동을 고려하는 분들도 나타나기 시작(?)한 것 같다!

 

문제 원인: 코드를 분석해보니 RS-485 모듈을 parser mapping까지 완료한 뒤 애드온의 device discovery 기능까지는 구현이 되어있는데, 주방 비디오폰을 연동하려면 discovery 단계에서 세대현관문이나 공동현관문 중 하나를 최소 1번 호출을 해 월패드와 주방 비디오폰 간 RS-485 패킷이 송수신되도록 만들어야만 device entry에 SUBPHONE 객체가 추가가 되는게 문제였다

 

"애드온 device discovery가 되는 1분 내에 몸을 움직여 세대현관문이나 공동현관문을 한 번 호출하세요!"라고만 한 채 코드를 방치하면 너무나 무책임해 보일 수 있기에, 이 기회에 HA 애드온 설정을 통해 동적으로 주방 비디오폰을 추가할 수 있게 코드를 조금 수정해봤다

애드온 수정 전 config.xml 파일 매뉴얼 수정을 통해 정상적으로 동작하는 건 확인!

2. 코드 수정

애드온 설정 관련 기능을 추가하려면 현대통신 월패드 RS-485 소스코드와 홈어시스턴트 애드온 코드를 모두 수정해야 한다

파이썬 코드 실행 인자(argument) 추가와 홈어시스턴트 애드온의 config.yaml 파일 수정이 전부이기에 따로 코드 변경사항 설명없이 깃허브 커밋 링크만 아래와 같이 공유하도록 한다

https://github.com/YOGYUI/HomeNetwork/commit/52fca63b895f0c5b0d8f18430cabe11e3602a767

주방 서브폰 활성화 옵션 추가 (실행인자 - HA 애드온용) · YOGYUI/HomeNetwork@52fca63

https://github.com/YOGYUI/homeassistant-addons/commit/811be46ad4ec62ece74df6f36bd0f5f64b9b6d79

주방 비디오폰 설정 추가 · YOGYUI/homeassistant-addons@811be46

 

불과 3일전 월패드의 '감성조명' 연동때문에 애드온 버전을 업데이트했었는데, 얼마 지나지 않아 또다시 버전을 업데이트하게 됐다 ^^;;

3. 애드온 설정 방법

애드온 설치 방법은 아래 링크 참고

Home Assistant add-on 베타버전 릴리즈

Home Assistant add-on 베타버전 릴리즈

 

오늘(2024/06/10) 업데이트한 최신 버전은 1.1.0이다

 

애드온을 설치 혹은 업데이트한 뒤 애드온의 '구성' 탭으로 가면 'subphone' 항목이 추가된 것을 알 수 있다

'관련 문서' 탭에서 파라미터 설명을 확인할 수 있다

 

enable 항목을 'true'로 설정하면 별도로 device discovery를 하지 않고서도 Subphone 항목을 추가할 수 있다

이 때 중요한 것은 'RS-485 컨버터 설정'과 '패킷 파서 인덱스 매핑' 설정을 제대로 해줘야 RS-485 연동이 정상적으로 작동한다 (관련 문서 참고)

FFMPEG, FFServer를 사용한 비디오폰 영상 스트리밍은 어느정도 관련 지식이 있어야 설정할 수 있다
영상 스트리밍 연동을 하지 않을 경우 'enable_video_streaming'은 반드시 false로 설정하도록 한다

 

설정 후 애드온을 재시작하면 MQTT 구성요소에 'SUBPHONE' 관련 디바이스들이 추가된 것을 확인할 수 있다

'SUBPHONE Doorlock'은 내가 개인적으로 사용하던 기존 코드와의 호환성을 위해 남겨둔 것이므로 신경쓰지 말고 세대현관문 및 공동현관문 각각의 Lock(도어락), Ringing(호출중) 액세서리를 사용하면 된다

끝~!

애드온 사용 중 문제상황 발생, 버그 리포트, 개선사항 제시, 사용법 문의 등은 블로그 댓글, 방명록, 이메일 등 편한 경로로 전달주시면 빠른 시간 내에 답변드릴 수 있도록 노력하고 있습니다 ^^
이메일 주소: lee2002w@gmail.com