eWeLink 문서Home Assistant
공식 eWeLink Smart Home 애드온을 사용하여 eWeLink 기기를 Home Assistant에 연결하는 방법을 안내합니다.
I. 기능
- 현재 공식 애드온은 eWeLink 스위치 및 소켓을 지원합니다. 더 많은 eWeLink 지원 기기가 향후 버전에서 추가될 예정입니다.
- Sonoff DIY 모드를 지원합니다.
- LAN에서의 기기 제어를 우선합니다. 기기가 LAN 모드를 지원하지 않거나 LAN에 연결되지 않은 경우, 클라우드를 통해 기기를 제어할 수 있습니다.
- 기기 상태 및 설정 정보가 실시간으로 동기화됩니다. 기기 이름과 설정은 나중에 수정할 수 있습니다.
- HassOS 및 Supervisor를 통해 설치된 Home Assistant만 지원합니다.
II. 사전 조건
장기 액세스 토큰 생성
eWeLink 애드온은 Home Assistant의 REST API 및 WebSocket API를 호출하여 eWeLink 지원 기기를 연결합니다. 장기 액세스 토큰이 필요합니다.
Home Assistant Lovelace 콘솔에 로그인합니다(일반적으로 URL은 http://homeassistant.local:8123/). 사이드바 맨 아래의 사용자 이름을 클릭하여 User Profile로 이동하고, 페이지 하단의 Long-Lived Access Token 옵션을 찾아 CREATE TOKEN을 클릭합니다. Give the token a name 모달에 토큰 이름을 입력하고(eWeLink_HA_AddOn 권장) OK를 클릭합니다. 생성된 토큰을 복사하여 안전한 곳에 붙여넣습니다.
III. 설치
Home Assistant Lovelace 콘솔에 로그인합니다(일반적으로 URL은 http://homeassistant.local:8123/). 사이드바에서 Supervisor를 클릭하여 HassOS 대시보드를 열고, Add-on Store 탭으로 전환합니다. 오른쪽 상단의 세로 점 세 개를 클릭하고, 팝업 메뉴에서 Repositories를 선택합니다. Manage add-on repositories 모달에 eWeLink 공식 애드온 주소 https://github.com/CoolKit-Technologies/ha-addon을 입력하고 ADD를 클릭합니다. 모달을 닫으면 Add-on Store 페이지에서 새로 추가된 eWeLink 애드온을 확인할 수 있습니다.
eWeLink Smart Home 카드를 클릭하여 애드온 정보 페이지를 열고, INSTALL을 클릭하여 설치가 완료될 때까지 기다립니다. 설치가 완료되면 바로 START를 클릭하지 말고, Configuration 탭으로 전환하여 장기 액세스 토큰을 입력하고 Save를 클릭합니다. 그런 다음 Information 탭으로 돌아가 START를 클릭하여 "eWeLink Smart Home" 애드온을 활성화합니다.
eWeLink Smart Home 애드온에 빠르게 접근하려면 Show in sidebar 옵션을 활성화할 수 있습니다.
Docker 또는 Home Assistant OS가 아닌 다른 버전의 Home Assistant를 사용하는 경우 home_assistant_url을 변경해야 합니다.
IV. 설정
eWeLink DIY 기기 제어
LAN에서 eWeLink DIY 기기를 제어하거나, eWeLink 계정에 로그인하여 모든 eWeLink 지원 기기를 제어할 수 있습니다.
Home Assistant Lovelace 콘솔에 로그인합니다(일반적으로 URL은 http://homeassistant.local:8123/). 사이드바에서 Supervisor를 클릭하여 HassOS 대시보드를 열고, eWeLink Smart Home 카드를 클릭하여 애드온 정보 페이지로 이동합니다. OPEN WEB UI를 클릭하면, eWeLink Smart Home Web UI 페이지에 mDNS로 검색된 LAN 내 모든 DIY 기기가 표시됩니다. 왼쪽 상단의 Login 버튼을 클릭하여 eWeLink 계정에 로그인하면 모든 eWeLink 지원 기기를 연결할 수도 있습니다.
현재 베타 버전은 스위치와 소켓만 지원하며, 더 많은 기기 유형이 곧 지원될 예정입니다.
장면 및 자동화 설정
Home Assistant REST API 및 WebSocket API를 통해 연결된 기기는 기기 대신 엔티티로만 매핑되므로, Home Assistant의 장면 및 자동화에서 직접 기기를 제어할 수 없습니다.
이 문제를 해결하려면 Advanced Mode를 활성화해야 합니다(Lovelace 콘솔 > Profile > Advanced Mode).
eWeLink 지원 기기를 자동화에서 사용하려면, 먼저 기기가 포함된 장면을 생성한 다음, 자동화의 Action > Action Type에서 Activate Scenario를 선택합니다.
