- 버전별 변경 사항
- 삼성SDS 월패드를 사용하는 집에서, RS485를 이용해 여러 장치들을 제어할 수 있는 애드온입니다.
- 현관 스위치를 대신하여 엘리베이터를 호출하는 기능이 있습니다.
- EW11 등의 장치를 이용해 TCP socket 통신으로 HA와 연결
- 장치가 작고 간편하지만, SDS 월패드 특성 상 타이밍 제어가 필요한 엘리베이터/현관/공동현관 기능은 제대로 동작하지 않습니다.
- USB to RS485 등의 장치를 이용해 HA 동작중인 머신과 유선으로 연결하면 모든 기능을 사용할 수 있습니다.
- HA 머신까지 유선 연결이 어려운 환경이면 별도로 라즈베리파이에 연결 후 (보조)HA와 애드온을 설정하시고, (메인)HA의 MQTT에 접속하도록 설정할수도 있습니다.
- 이 경우 보조HA는 완전히 비어있는 상태에서 오직 SDS애드온만 실행하고, 모든 장치는 메인HA에 등록됩니다.
- 라즈베리파이를 넣을 공간도 부족하다면 "라즈베리파이 제로 2W 혹은 W" 와 TTL to RS485를 조합하면 크기를 최소화할 수 있습니다.
- 다만 이 경우 보조HA를 돌리기엔 성능이 부족하므로 애드온의 파일들만 따로 받아서 리눅스 환경에서 실행하셔야 합니다 (2W는 괜찮을수도 있습니다. W는 느려서 HA 실행 사실상 불가).
- run_standalone.sh 를 한번 실행해서 options_standalone.json 을 생성한 뒤, 적절히 수정하고 다시 run_standalone.sh 를 실행하시면 됩니다. 추가 설명이 필요하면 위 Issues에 질문 남겨주세요.
- 다만 이 경우 보조HA를 돌리기엔 성능이 부족하므로 애드온의 파일들만 따로 받아서 리눅스 환경에서 실행하셔야 합니다 (2W는 괜찮을수도 있습니다. W는 느려서 HA 실행 사실상 불가).
- 해당 장치가 월패드와 연결되어 있는 경우에 사용 가능합니다.
- 지원 기능
- 전등
- 난방
- 환기 (전열교환기)
- 대기전력차단, 콘센트별 실시간 전력사용량
- 가스밸브 (상태 확인)
- 실시간 에너지 사용량 (전기, 가스, 수도)
- 동작 조건
- Configuration에서 entrance_mode를 "full" 로 변경
- 기존 현관 스위치(일괄소등, 가스차단 기능이 있는 스위치)의 RS485 연결을 분리 필요
- EW11 (소켓 통신) 사용 시 지원 불가
- EW11에서도 현관 스위치를 분리하지 않고 entrance_mode를 "minimal" 로 설정하면 엘리베이터 호출에 성공하는 경우가 있습니다.
- 성공 확률 및 소요시간은 설치 환경마다 다릅니다. 자세한 내용은 아래 항목 설명을 참고하세요.
- 디스플레이가 달린 신형 현관스위치인 경우:
- RS485 연결을 분리하기 전에 "full" 로 시도해보세요. 월패드가 구형 현관스위치도 스캔하는 경우 그대로 성공할 수 있습니다.
- 동작하지 않으면 신형 현관스위치의 RS485 연결을 분리하고 "full" 대신 "new" 로 변경해야 사용이 가능합니다.
- 지원 기능
- 엘리베이터 호출
- 가스밸브 잠금
- 동작 조건
- Configuration에서 intercom_mode를 "on" 으로 변경
- EW11 (소켓 통신) 사용 시 지원 불가
- 지원 기능
- 공동현관 출입문 열림 (초인종이 울린 상태에서만 가능)
- 현관 출입문 열림
- Mosquitto broker 설치
- 홈어시스턴트의 애드온 스토어에서 Mosquitto broker 선택합니다.
- 설치하기를 누른 후 생기는 구성 탭을 누릅니다.
- logins: [] 에 원하는 아이디와 비밀번호를 아래와 같은 형식으로 입력합니다. 저장하기를 누르면 자동으로 세 줄로 분리됩니다.
- logins: [{username: 아이디, password: 비밀번호}]
- 정보 탭으로 돌아와 시작하기를 누릅니다.
- MQTT Integration 설치
- 홈어시스턴트의 구성하기 --> 통합 구성요소에서 우하단 추가( + ) 를 누른 후 MQTT를 검색하여 선택합니다.
- "브로커" 에 HA의 IP주소 입력, "사용자 이름"과 "비밀번호"에 위 Mosquitto의 로그인 정보 입력, "기기 검색 활성화" 후 확인을 누릅니다.
- 홈어시스턴트의 Supervisor --> Add-on store에서 우상단 메뉴( ⋮ ) 를 누른 후 "repositories" 선택합니다.
- "Add repository" 영역에 아래 주소 중 한 개를 입력 후 ADD 를 누릅니다.
- 애드온 개발자 개인 저장소: https://github.com/n-andflash/ha_addons
- 하단에 나타난 "Samsung SDS RS485 Addon with Elevator Call" 을 선택합니다.
- "INSTALL" 버튼을 누른 후 "START" 가 나타날 때까지 기다립니다. (수 분 이상 걸릴 수 있습니다)
- 설치 중 오류가 발생하면 Supervisor -> System 의 System log 최하단을 확인해봐야 합니다.
- "START" 가 보이면, 시작하기 전에 "Configuration" 페이지에서 아래 설정을 구성 후 "SAVE" 를 누릅니다.
- serial_mode (EW11 사용시 socket, 그 외의 경우 serial)
- serial/port 혹은 socket/address
- mqtt/server: 위의 "브로커"와 같은 주소 입력
- "Info" 페이지로 돌아와서 "START" 로 시작합니다.
- 첫 시작 시 회전 애니메이션이 사라질 때까지 기다려주세요.
- "Log" 페이지에서 정상 동작하는지 확인합니다.
- MQTT discovery를 지원하므로, yaml 파일을 장치마다 일일이 설정할 필요가 없습니다.
- 통합 구성요소 페이지에 MQTT가 있고, [ ⋮ ] 를 클릭했을 때 "새로 추가된 구성요소를 활성화" 되어 있어야 합니다.
- MQTT 통합 구성요소에 "sds_wallpad" 기기가 생성되고 모든 엔티티가 등록됩니다.
- serial: USB to RS485 혹은 TTL to RS485를 이용하는 경우
- socket: EW11을 이용하는 경우
- 엘리베이터 호출을 위해 설정 변경 필요
- full: 현관 스위치가 없거나 연결을 끊은 경우, 이 애드온이 완전한 현관 스위치로 동작합니다.
- new: 디스플레이가 달린 신형 현관스위치인 경우 full 대신 new로 설정해야 할 수 있습니다.
- minimal: 현관 스위치가 있는 상황에서, 엘리베이터 호출이 필요한 경우만 강제로 끼워넣습니다 (nodejs 애드온과 거의 같은 방식). 성공률이 매우 낮아서 수십 초 이상 걸리는 경우도 있습니다. max_retry를 적절히 설정하세요.
- 신형 현관스위치 지원하지 않음
- off: 현관 스위치 관련 기능을 비활성화 합니다. 일반적인 월패드 애드온으로만 동작합니다.
- 현관/공동현관 문열림을 위해 설정 변경 필요
- on: 가상의 인터폰을 추가합니다. 현관문을 열거나, 공동현관 초인종이 울렸을때 공동현관을 열 수 있습니다.
- off: 인터폰 추가 기능을 비활성화합니다.
- Supervisor -> System -> HARDWARE 버튼을 눌러 serial에 적혀있는 장치 이름을 확인해서 적어주세요.
- USB to RS485를 쓰신다면 /dev/ttyUSB0, TTL to RS485를 쓰신다면 /dev/ttyAMA0 일 가능성이 높습니다.
- 단, 윈도우 환경이면 COM6 과 같은 형태의 이름을 가지고 있습니다.
- EW11의 IP를 적어주세요.
- EW11의 포트 번호를 변경하셨다면 변경한 포트 번호를 적어주세요.
- MQTT broker (Mosquitto)의 IP를 적어주세요. 일반적으로 HA가 돌고있는 서버의 IP와 같습니다.
- Mosquitto의 포트 번호를 변경하셨다면 변경한 포트 번호를 적어주세요.
- true로 수정해 주세요.
- Mosquitto의 아이디와 비밀번호를 적어주세요.
눌러서 열기...
- 0보다 큰 값을 설정하면, 애드온이 시작하기 전에 입력한 시간(초) 동안 log로 RS485 패킷 덤프를 출력합니다.
- SerialPortMon으로 RS485를 관찰하는 것과 같은 기능입니다.
- 버그/수정 제보 등 패킷 덤프가 필요할 때만 사용하세요.
- serial 방식 연결 시 현관 스위치로써 월패드에게 응답하는 타이밍을 조절합니다. 0,1,2 중 선택 (신형 현관스위치는 0,1,2,3 중 선택)
- 아마도 HA머신이 고성능인 경우 숫자를 줄여야 정상 동작하나 봅니다.
- 혹은 "minimal" 모드의 성공률에 영향이 있습니다 (큰 기대는 하지 마세요).
- 일부 환경에서 공동현관 초인종이 울렸을때 통화를 시작하자마자 문열림을 보내면 무시되는 경우가 있습니다.
- 그럴때 이 옵션을 켜면 통화 2초 유지 후 문을 엽니다.
- 실행한 명령에 대한 성공 응답을 받지 못했을 때, 몇 초 동안 재시도할지 설정합니다. 특히 "minimal" 모드인 경우 큰 값이 필요하지만, 예상치 못한 타이밍에 동작하는 상황을 막으려면 적절한 값을 설정하세요.
- 평상시 RS485 덤프에서 A15A, A25A, A35A, A45A, A55A, A65A 중 한 가지가 보여야 intercom_mode 를 사용할 수 있습니다.
- 보이는 패킷을 입력해 주세요.
눌러서 열기...
- on: 일반적인 월패드 애드온 기능
- off: 기존 애드온과 함께 쓰고 싶을 때. 이게 정상동작하는지 아직 테스트되지 않음
- 기본값으로 두시면 됩니다.
- 사용 가능한 parity: E, O, N, M, S (Even, Odd, None, Mark, Space)
- false로 변경하면 HA에 장치를 자동으로 등록하지 않습니다. 필요한 경우만 변경하세요.
- MQTT topic의 시작 단어를 변경합니다. 기본값으로 두시면 됩니다.
- false로 설정하면 로그를 파일로 남기지 않습니다.
- 로그는 매일 자정에 새 파일로 저장되며, 기존 로그는 파일명에 날짜를 붙여 7개까지 보관됩니다.
- 로그를 남길 경로와 파일 이름을 지정합니다.
- checksum fail을 로그에 몇번이나 기록할지 지정합니다.
- 관련 로그를 그냥 무시하려면 0으로 설정하시면 됩니다.
- 설정 방법 보러가기
- 월패드에 연결되지 않은 기능은 사용하실 수 없습니다.
- 문제가 있어서 글을 쓰실 때는 정확한 지원을 위해서 아래 사항들을 포함해 주세요.
- 실행 로그 (HA의 share 폴더에 최신 로그 파일 (날짜가 써있지 않은 sds_wallpad.log 파일) 이 있습니다)
- Configuration 페이지 내용 (MQTT broker password가 있으면 가려주세요)
- 집마다 패킷이나 장치 구성이 다르므로, 해결을 위해 여러 번의 추가정보 확인 요청이 필요할 수 있습니다.
HomeAssistant 네이버 카페 (질문, 수정 제안 등)
Github issue 페이지 (버그 신고, 수정 제안 등)
- 이 애드온은 무상으로 제공되므로 정확성이나 안정성 등 어떠한 보증도 제공하지 않습니다.
- 이 애드온은 오픈소스로 실행 코드와 함께 배포되므로 코드 및 동작에 대한 확인 책임은 사용자에게 있습니다.
- 기타 사항은 GPLv3를 따릅니다. 전문보기
- 카카오톡 후원 코드: https://qr.kakaopay.com/281006011000008548744237 (모바일에서만 가능)