스마트홈 - 스마트싱스 엣지 드라이버 원리, 설치, 개념


    이 글에서는 스마트싱스 엣지 드라이버가 무엇인지, 왜 등장했는지, 어떻게 설치하고 직접 만들 수 있는지를 실제 사용자 경험과 함께 정리했습니다.

    스마트싱스


    1. 스마트싱스 엣지 드라이버란?


    스마트싱스 엣지 드라이버는 삼성 스마트싱스 생태계에서 허브에 연결된 기기(Zigbee, Z-Wave, LAN, Matter)를 제어하고 자동화를 처리하는 차세대 드라이버 아키텍처입니다. 과거 클라우드 기반의 Groovy DTH(Device Type Handler) 방식을 대체하기 위해 도입되었으며, 스마트홈의 반응 속도·안정성·보안성을 크게 끌어올린 핵심 기술로 평가받습니다.

    쉽게 말해, 스마트싱스가 IoT 제품의 종류와 기능(Capability)을 인식해 허브에 붙여주는 소프트웨어 조각으로, 100% Lua 스크립트로 작성됩니다. 인터넷 연결 없이도 허브에서 직접 로컬로 동작한다는 점이 가장 큰 특징입니다.


    2. 엣지 드라이버 도입 배경 - Groovy DTH vs Edge Driver


    과거 스마트싱스는 클라우드 의존도가 매우 높은 구조였습니다. 모든 기기 제어 로직이 삼성 서버에서 처리되다 보니, 인터넷이 끊기면 집안의 조명 하나 켜는 것도 불가능했습니다. 이런 한계를 해결하기 위해 등장한 것이 바로 엣지 드라이버입니다.

    구분 기존 방식 (Groovy DTH) 엣지 드라이버 (Smartthings Edge)
    개발 언어 Groovy Lua (루아)
    실행 위치 스마트싱스 클라우드 서버 스마트싱스 허브 (로컬 실행)
    인터넷 연결 끊기면 제어 불가 오프라인에서도 제어 / 자동화 동작 가능
    반응 속도 클라우드를 거쳐 딜레이 발생 실시간에 가까운 즉각 반응
    개발 방식 IDE 웹 콘솔 기반 CLI 기반, 커뮤니티 채널 공유 가능


    3. 엣지 드라이버의 핵심 특징


    1) 완벽한 로컬 실행

    제어 명령이나 센서 데이터 처리가 허브 내부에서 즉시 실행됩니다. 집안 인터넷이 끊겨도 허브와 로컬 네트워크(Zigbee/Z-Wave/Matter/LAN)만 살아있으면 동작과 루틴 자동화가 그대로 유지됩니다.

    2) 가벼운 프로그래밍 언어, Lua

    게임엔진이나 임베디드 기기에서 널리 쓰이는 Lua 샌드박스 환경에서 동작하기 때문에, 적은 메모리와 가벼운 CPU 자원만으로도 허브가 다수의 드라이버를 안정적으로 구동할 수 있습니다.

    3) Matter 및 최신 표준 지원

    차세대 스마트홈 통합 표준인 Matter 프로토콜을 기본적으로 지원해, 서로 다른 제조사의 기기도 하나의 생태계 안에서 관리할 수 있습니다.

    4) 사용자 친화적인 공유, 설치 방식

    과거에는 소스코드를 복사해 IDE 웹에 직접 붙여넣어야 했지만, 지금은 개발자가 공유한 채널 링크(Channel Link) 에 접속해 'Enroll(등록)' 버튼만 누르면 스마트싱스 앱에서 곧바로 드라이버를 설치할 수 있습니다.


    4. 엣지 드라이버가 지원하는 프로토콜 범위


    • Zigbee / Z-Wave - 허브와 직접 소통하며 명령을 로컬에서 변환·처리합니다.
    • LAN 기기 - 필립스 휴 브리지, Shelly 등 같은 와이파이·이더넷 네트워크에 있는 기기와 TCP/UDP 소켓 통신으로 로컬 직접 연결합니다.
    • Matter - Matter over Thread, Matter over Wi-Fi 기기를 로컬에서 제어합니다.
    2026년 상반기 기준으로도 삼성은 허브 펌웨어 업데이트와 함께 엣지 드라이버 릴리스 노트를 꾸준히 배포하고 있어, 엣지 아키텍처는 여전히 스마트싱스의 핵심 축으로 유지되고 있습니다.


    5. 엣지 드라이버 설치 방법


    공식 인증(Works With SmartThings) 제품은 기기를 추가하는 순간 클라우드에 저장된 공식 엣지 드라이버가 자동으로 허브에 설치됩니다. 

    하지만 알리익스프레스 등에서 구매한 비인증 지그비 제품은 연결은 되어도 아무 기능도 뜨지 않는 경우가 흔합니다. 이럴 때는 커뮤니티가 만든 커스텀 엣지 드라이버를 직접 설치해야 합니다.

    • 개발자가 공유한 SmartThings Edge Driver 채널 URL 접속 (삼성 계정 로그인 필요)
    • 본인의 허브를 등록하고, 원하는 드라이버를 선택해 Install 클릭
    • 스마트싱스 앱에서 기기 검색(Add Device) 을 실행하면 방금 설치한 엣지 드라이버로 자동 매칭

    국내에서는 '모두의 스마트홈' 네이버 카페의 Edge Driver 게시판이 대표적인 커스텀 드라이버 공유처로 통합니다. 제품명이나 모델명(예: SNZB-02, Tuya Shade 등)으로 검색하면 관련 드라이버 채널 초대 링크를 쉽게 찾을 수 있습니다.

    엣지드라이버


    6. 커스텀 드라이버 제작 과정


    스마트싱스가 공식 지원하지 않는 기기이거나 특수 기능이 필요하다면 직접 드라이버를 만들 수도 있습니다.
    • Lua 스크립트 작성 - `init.lua`(동작 로직)와 `fingerprints.yml`(기기 식별 정보) 작성
    • SmartThings CLI 활용 - `smartthings edge:drivers:package` 명령으로 패키징 후 개인 채널에 업로드
    • 로그 확인 - `smartthings edge:drivers:logcat` 명령으로 허브의 실시간 동작 로그를 모니터링하며 디버깅

    댓글 쓰기

    0 댓글