[IoT] Home Assistant 서버 구축 - SmartThings 연동

  서론  

  ESXi 8 위에 Home Assistant OS가 설치 및 구동 중이며, HTTPS 및 리버스 프록시 설정이 완료된 상태에서 SmartThings 연동을 해 볼 것입니다.

  제가 Home Assistant 구축한 환경은 특이합니다. 아래의 구축 과정을 확인하신 후 방문자님의 환경과 동일 또는 유사한지 확인해주세요. ( https://megastorage.tistory.com/531 )

[IoT] Home Assistant 서버 구축 - HA OS 설치 (feat. ESXi)

  자 이제 Home Assistant에 SmartThings를 연동하는 과정을 시작해봅시다.

  SmartThings 구성요소 추가(1)  

  SmartThings 구성 요소를 추가하기 위해선 '설정'의 '기기 및 서비스' 메뉴를 선택합니다.

  우측 하단의 '통합구성요소 추가하기' 버튼을 클릭한 후 SmartThings를 입력합니다. 그러면 SmartThings가 검색됩니다. 클릭합니다.

  일반적으로 위와 같은 에러가 뜰 수도 있습니다. "Home Assistant가 SmartThings에서 업데이트를 수신하도록 올바르게 구성되지 않았습니다. 웹 훅 URL이 잘못되었습니다." "안내를 참고하여 구성을 업데이트하고 Home Assistant를 다시 시작한 후 다시 시도해주세요."

  SmartThings를 사용하기 위해선 몇 가지 조건이 있습니다. 'HTTPS' 설정, 유효한 도메인 사용, 그리고 올바른 웹 훅(Webhook) URL 설정입니다. 저는 HTTPS와 도메인 설정까지 다 완료 되었으나 올바른 웹 훅 URL이 설정되지 않았습니다. 설정하기 위해선 configuration.yaml 파일을 수정해야 합니다.

  configuration.yaml 파일 수정  

  우선 '설정' → '애드온' → 'File editor' 선택 후 '웹 UI 열기'를 선택하여 파일 편집기를 실행합니다.

  그리고 configuration.yaml을 연 후 아래의 내용을 추가합니다. external_url은 도메인 주소를, internal_url은 Home Assistant가 구동 중인 내부 아이피 주소를 입력합니다. 그리고 Home Assistant를 재시작 합니다.

homeassistant:
  external_url: https://ha.yourserver.com:443
  internal_url: http://your_internal_ip:8123

  SmartThings 구성요소 추가(2)  

  Home Assistant가 성공적으로 재시작 되었다면, SmartThings 구성 요소를 추가하러 '기기 및 서비스' 페이지로 이동합니다. '설정' 메뉴에 있습니다.

  해당 메뉴 진입 후 'SmartThings'를 검색합니다. 그러면 아래와 같은 화면이 뜰 것입니다.

  "콜백 URL 확인하기" 라는 문구와 함께 에러 내용이 뜨지 않습니다. 우측 하단에 있는 '확인' 버튼을 클릭합니다.

  그러면 위와 같은 화면이 나타날 것입니다. SmartThings 계정에 있는 개인 액세스 토큰을 입력해야 합니다. 개인 액세스 토큰은 어떻게 구해야 할까요?

  SmartThings 개인 액세스 토큰(PAT) 구하기  

  SmartThings 개인 액세스 토큰을 구하려면 아래의 링크로 접속한 후 삼성 계정 로그인을 진행합니다. ( https://account.smartthings.com/tokens )

삼성계정

  성공적으로 로그인을 했다면 위와 같은 화면이 나타납니다. '새 토큰 만들기'를 클릭합니다.

  위에 보이는 항목을 체크합니다.

• 장치 (전체)
• 설치된 앱 (전체)
• 분위기 (전체)
• 앱 (전체)
• 위치 (전체)
• 일정 (전체)

  체크를 완료 했다면 '토큰 만들기' 버튼을 클릭합니다.

  본인의 SmartThings 계정에 접근할 수 있는 토큰이 생성되었습니다. 필히 복사 후 어딘가에 임시로 적어둡니다. 이 화면이 닫히면 다시 확인할 수 없기 때문입니다.

  생성된 토큰을 Home Assistant에 입력한 후 '확인' 버튼을 클릭합니다.

  SmartThings 연동 마무리  

  진행하다보면 SmartThings 권한 요청 화면이 나타납니다. 허용 버튼을 눌러서 권한을 부여합니다.

  저의 삼성 SmartThings 계정에 등록된 기기들이 떴습니다. 영역 지정 후 '완료'를 선택합니다.

  등록이 완료된 후 '둘러보기' 메뉴에 삼성 SmartThings 기기들이 표시됩니다. 로봇청소기와 벽걸이형 에어컨을 주로 사용하는데, 이제 에어컨을 원격으로 끌 때 SmartThings 앱에 접속하지 않아도 됩니다.

  마무리  

  이렇게 Home Assistant에 삼성 SmartThings을 연동하는 방법 및 결과를 보셨습니다. 이렇게 연동 해두니까 편하고 깔끔해져서 좋네요. 다음엔 샤오미 제품들을 Home Assistant에 연동해보도록 하겠습니다. 감사합니다. :)