[include(틀:상위 문서, top1=SmartThings Edge)] [include(틀:SmartThings)] [목차] == 개요 == SmartThings Edge driver(스마트싱스 엣지 드라이버)는 [[SmartThings]]의 제품의 타입을 식별하는 [[SmartThings Edge]] 베이스의 소프트웨어 드라이버이다. == 상세 == [[SmartThings Edge]] 아키텍처를 기반으로 [[SmartThings]]에 제품의 타입과 [[SmartThings#Capability|Capability]]를 인식하고 IoT 제품을 SmartThings에 붙인다. [[SmartThings/앱|SmartThings 앱]]의 [[SmartThings#플러그인|플러그인 페이지]]를 만들 수도 있다. === 구조 === ==== Fingerprint ==== 핑거프린트(Fingerprint)는 지문이라는 뜻이 있으며, SmartThings Edge Driver에서는 제품의 모든 기능(Capability)을 정확히 [[SmartThings Hub]]에 온보딩 하는 데에 있어야 하는 [[https://smartthings-developers-user-translation.fandom.com/ko/wiki/%EA%B8%B0%EA%B8%B0%EC%9D%98_%ED%94%84%EB%A1%9C%ED%95%84|기기 프로필(Device Profile)]]이다. 엣지 드라이버에서는 fingerprints.yaml 파일에서 관리한다. ==== 채널 ==== ==== 드라이버 ==== === 공식 엣지 드라이버 === 공식 엣지 드라이버는 [[SmartThings]] 클라우드에 저장되어 있는 엣지 드라이버이다. [[Works With SmartThings]] 제품을 연결할 때 클라우드에 있는 엣지 드라이버를 [[SmartThings Hub]]에 자동으로 설치해준다. 그러므로 [[Works With SmartThings]]제품을 연결할 때 유저가 별도로 커스텀 엣지 드라이버를 찾지 않아도 된다. 공식 엣지 드라이버로 연결할 수 없는 제품이면서, [[Works With SmartThings]]제품이 아닌 제품은 커스텀 엣지 드라이버를 [[SmartThings Hub]]에 깔아서 연결해야 한다. === 커스텀 엣지 드라이버 === == 사용 방법 == Edge Driver를 쓰려면 내 삼성계정에서 쓰는 [[SmartThings]]에 [[SmartThings Hub]]가 있어야 한다. * 1. Edge Driver의 채널을 등록할 수 있는 초대 링크(Invitation)을 들어간다 * 2. 삼성계정에 로그인 한다. * 3. [ACCEPT]를 눌러서 채널에 접속한다 * 4. My Hubs에 있는 내 [[SmartThings Hub]]에 채널을 등록하기 위해 [Enroll]을 누른다. * 5. 채널이 [[SmartThings Hub]]에 등록되었다. [Available Drivers]에서 채널에 등록 된 드라이버를 볼 수 있다. * 6. 원하는 드라이버에 있는 [Install]을 눌러서 Edge Driver를 [[SmartThings Hub]]에 설치한다. === [[SmartThings Hub]]에 설치한 엣지 드라이버를 보는 법 === * 1. [[SmartThings/앱|SmartThings 앱]]에서 [[SmartThings/앱#기기|기기 탭]]에 있는 내 [[SmartThings Hub]]에 들어간다. * 2. 액션바에 있는 [더 보기] > [드라이버]에서 내 [[SmartThings Hub]]에 깔린 엣지 드라이버의 채널과 드라이버를 볼 수 있다. 이 방법으로 커스텀 엣지 드라이버를 볼 수 있다. [[SmartThings]] 클라우드에 있는 [[SmartThings]]의 공식 엣지 드라이버는 이 방법으로 보이지 않는다. == 리스트 == * 공식 엣지 드라이버 * '''[[https://bestow-regional.api.smartthings.com/invite/eGM6w1AGNm2A|SmartThings Drivers]]''' SmartThings 개발자 그룹에서 배포하는 공식 커스텀 엣지 드라이버이다. * '''[[https://api.smartthings.com/invitation-web/accept?id=450930c1-02a6-43d8-adaa-4cbc51027956|SmartThings Drivers (Beta)]]''' [[https://community.smartthings.com/t/preview-smartthings-managed-edge-device-drivers/229847|원글 : SmartThings Community]] SmartThings 개발자 그룹에서 배포하는 공식 커스텀 엣지 드라이버이다. SmartThings 커뮤니티에서 공개되었다. [[SmartThings]] 최초의 커스텀 엣지 드라이버이다. * [[https://bestow-regional.api.smartthings.com/invite/8b2AZR9b06lv|Aeotec Edge Drivers]] [[https://aeotec.freshdesk.com/support/solutions/articles/6000259599-aeotec-edge-drivers|Aeotec 홈페이지]] Aeotec에서 공식으로 만드는 커스텀 엣지 드라이버이다. Aeotec 홈페이지에 올라와 있다. == 지원 == === 지원 프로토콜 === * LAN * Thread * Matter * Zigbee * Z-Wave == 개발 == === 엣지 드라이버를 만드는 법 === ==== 노 코드 엣지 드라이버로 만들기 ==== ==== SmartThings CLI로 만들기 ==== * [[https://community.smartthings.com/t/tutorial-creating-drivers-for-zigbee-devices-with-smartthings-edge/229502]] ===== 개발하기 앞서 있어야 하는 것 ===== * 삼성 계정 * [[SmartThings Hub]] 38.x 버전 이상 * SmartThings CLI * [[https://github.com/SmartThingsCommunity/smartthings-cli/tree/main/packages/edge|SmartThings Edge CLI Plugin]] * Lua 5.3 이상 * SmartThings Lua 라이브러리 * [[https://developer.smartthings.com/console|SmartThings Console]] ===== 라이브러리 ===== * Driver 라이브러리 * Capability 라이브러리 * Matter 라이브러리 * Zigbee 라이브러리 * Z-Wave 라이브러리 ===== SmartThings CLI로 Edge Driver를 온보딩 ===== == 기타 == * SmartThings Edge Driver로 허브에 붙인 IoT 제품을 SmartThings Grovvy IDE에서 보면 Type이 placeholder로, Device가 Cloud로 잘못 나온다. 이 때 SmartThings 클라우드와 [[SmartThings Hub]]는 제품의 타입과 로컬 네트워크인지 아닌지를 잘 안다. 제품이 엣지로 붙은 것을 알아내지 못하는 SmartThings Grovvy IDE에서만 그렇게 보이는 것이다. [[https://support.smartthings.com/hc/en-us/articles/5685949017492|Why does my Edge-enabled device say it is cloud-connected in the Graph IDE? 참조]] [[분류:SmartThings]][[분류:삼성전자의 소프트웨어]][[분류:사물 인터넷]]