mbillow/localthings
Samsung 스마트홈 기기를 로컬 네트워크에서 제어하는 Home Assistant 연동 도구
원제 mbillow/localthings
스타 1,096당일 +186Python
Key Point
클라우드 계정 없이 로컬 네트워크만으로 Samsung 스마트 가전을 제어할 수 있는 방식으로, 프라이버시 우려가 있거나 클라우드 의존성을 피하고 싶은 사용자들에게 실질적인 대안을 제공한다.
핵심 요약
- LocalThings는 Home Assistant에서 Samsung 세탁기, 건조기, 냉장고, 에어컨 등을 SmartThings 클라우드 계정 없이 로컬 네트워크로 제어하는 오픈소스 도구다.
- 푸시를 지원하는 기기는 변화를 실시간으로 전송하고, 나머지는 30초마다 폴링되며, 인터넷 연결 후에는 Samsung 서버에 접속하지 않아 데이터가 가정 내에만 머문다.
- 2022년 이후 대부분의 Samsung 연결 기기와 구형 세탁기, 에어컨, 벽면 오븐 등을 지원하며, OCF(Open Connectivity Foundation) 표준과 CoAP over DTLS 프로토콜을 사용한다.
- 세팅은 기기 IP 주소만 입력하면 자동으로 기기 타입과 모델을 인식하고 적절한 컨트롤과 센서를 생성한다.
- 일부 구형 기기(TCP 8888)는 추가로 디바이스 토큰이 필요하며, 증명서 거부 시 사전 공유 키(PSK)를 입력해야 한다.
- 각 기기별로 원격 제어 비활성화 중 명령 허용 여부, 완료 시간 최소 변화량, 기억된 모드 유지 등의 설정을 조정할 수 있다.
- Home Assistant 재시작 중 기기가 꺼져 있으면 엔티티는 unavailable 상태가 되었다가 기기 답변 후 복구된다.
- 기기 IP 주소 변경 시 절반의 Samsung 기기는 DHCP 디스커버리로 자동 감지되고, 나머지는 재설정이 필요하다.
- 오븐, 레인지, 전자레인지는 모드, 온도, 조리 시간이 함께 도착할 때만 시작되며, 시작 가능한 모드 목록과 온도·시간 범위는 기기에서 보고되는 내용을 따른다.
- 다중 실내기 에어컨 시스템은 하나의 IP 주소에서 여러 실내기를 관리하며, LocalThings가 첫 연결 후 추가 유닛을 자동 검색한다.
- 기기 미지원 또는 누락된 기능은 Home Assistant 수리 메뉴에 알림으로 표시되고, 진단 다운로드로 개인 정보와 네트워크 세부 사항이 자동 제거된다.
- HACS(Home Assistant Community Store)에서 설치하거나 수동으로 custom_components에 복사하여 설정할 수 있다.
저장소 보기 ↗github.com