GitHub Trending오픈소스 · 도구

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에 복사하여 설정할 수 있다.
AI 요약 안내

AI가 한국어로 정리한 내용입니다. 정확한 정보는 원문을 확인해 주세요.

요약 원칙 ↗