Home Assistant(HA)에 Xiaomi 기기를 연동할 때 현재 가장 대중적이고 가장 사용하기 좋은 방법은 HACS를 통해 Xiaomi Miot Auto 통합을 설치하는 것입니다.
Xiaomi Miot와 Xiaomi Cloud(보통 공식 통합, 또는 클라우드를 통해 정보를 가져오는 통합을 가리킴)는 본질적으로 다릅니다.
아래는 자세한 비교와 튜토리얼입니다.
1부: 두 가지의 차이
1. Xiaomi Miot Auto (권장)
중국 개발자 al-one이 만든 서드파티 플러그인으로, 현재 Xiaomi 기기를 연동하는 가장 강력하고 가장 범용적인 방법입니다.
- 원리: Xiaomi의 최신 MIoT 프로토콜(Xiaomi 사물인터넷 프로토콜)을 기반으로 합니다.
- 장점:
- 지원 기기가 매우 많음: Mi Home 앱에 연결된 거의 모든 기기를 지원합니다(Bluetooth Mesh 게이트웨이 하위 기기 포함).
- 로컬 제어: 기기가 같은 LAN에 있으면 우선 로컬 LAN 제어를 시도합니다(반응이 빠르고 인터넷이 끊겨도 사용 가능). 로컬 제어가 불가능할 때만 클라우드를 사용합니다.
- 기능이 풍부함: 기기의 각종 속성(배터리 잔량, 온습도, 상세 상태 등)을 읽을 수 있습니다.
단점: HACS(Home Assistant 커뮤니티 스토어) 설치가 필요합니다.
2. Xiaomi Miio(공식 통합) / Xiaomi Cloud
HA에는 공식 Xiaomi Miio 통합이 기본 포함되어 있으며, 사용자들이 이를 두루뭉술하게 Xiaomi Cloud 통합이라고 부르기도 합니다.
- 원리: 다소 오래된 Miio 프로토콜을 기반으로 합니다.
- 장점: 시스템에 기본 포함되어 HACS 설치가 필요 없고 안정성이 높습니다.
- 단점:
- 지원 기기가 적음: 주로 로봇청소기, 공기청정기, 구형 게이트웨이를 지원합니다. 최신 콘센트, 스위치, 센서 지원은 매우 부족합니다.
- 설정이 번거로움: 기기의 Token을 수동으로 추출해야 연동할 수 있는 경우가 많습니다.
결론: 고민하지 말고 를 선택하세요. 이것이 현재의 최종 해결책입니다.
2부: 자세한 설치 튜토리얼(Xiaomi Miot Auto) 사전 조건
- Home Assistant가 이미 설치되어 실행 중이어야 합니다.
- HACS가 반드시 필요합니다. 아직 HACS를 설치하지 않았다면 먼저 “Home Assistant HACS 설치”를 검색해 이 단계를 완료하세요(HA를 다루는 필수 코스입니다).
- Xiaomi 계정이 있어야 하고, 기기가 휴대폰의 ‘Mi Home’ 앱에 이미 추가되어 있어야 합니다.
1단계: HACS에서 통합 다운로드
- Home Assistant 왼쪽 메뉴 바의 HACS를 엽니다.
- Integrations(통합)를 클릭합니다.
- 오른쪽 아래의 Explore & Download Repositories(저장소 탐색 및 다운로드)를 클릭합니다.
- 검색창에 Xiaomi Miot Auto를 입력합니다.
- 검색 결과에서 Xiaomi Miot Auto를 클릭합니다.
- 오른쪽 아래의 Download(다운로드)를 클릭합니다.
- 다운로드가 완료되면 반드시 Home Assistant를 재시작해야 합니다(설정 -> 시스템 -> 오른쪽 위 전원 버튼 -> Home Assistant 재시작).
2단계: 통합 추가 및 로그인
- 재시작 후 왼쪽 메뉴 바의 설정(Settings)을 클릭합니다.
- 기기 및 서비스(Devices & Services)를 클릭합니다.
- 오른쪽 아래의 + 통합 추가(+ ADD INTEGRATION)를 클릭합니다.
- 검색창에 Xiaomi Miot을 입력하고 나타나는 Xiaomi Miot Auto 아이콘을 클릭합니다.
- 설정 방식을 선택합니다:
- 몇 가지 옵션이 표시되는데, 첫 번째인 계정 연동(Add devices using Mi Account)을 선택하세요. 가장 간단한 방식이며 클라우드에서 기기 목록을 자동으로 가져옵니다.
계정 정보를 입력합니다:
- Username: Xiaomi 계정(휴대폰 번호 또는 ID).
- Password: Xiaomi 계정 비밀번호.
- Server: CN(중국 본토)을 선택 — Mi Home 앱 지역을 다른 국가로 설정한 경우는 예외입니다.
- 제출(Submit)을 클릭합니다.
3단계: 기기 필터링(선택 사항)
로그인에 성공하면 통합이 Mi Home 계정의 모든 기기를 나열합니다.
- Exclude devices(기기 제외): HA에 가져오고 싶지 않은 기기가 있다면 여기서 체크합니다.
- Filter devices(기기 필터링): 보통은 기본값(Include all devices)을 그대로 두면 됩니다.
- Connection mode(연결 모드):
- Automatic(자동)을 선택하는 것을 권장합니다.
- 설명: 기기가 LAN 안에 있는지 자동으로 감지합니다. 있으면 로컬 제어(즉시 반응), 없으면(예: 블루투스 기기이거나 다른 Wi-Fi에 있는 경우) 클라우드 제어를 사용합니다.
제출(Submit)을 클릭합니다.
4단계: 완료 및 사용
- 완료를 클릭하면 ‘기기 및 서비스’ 목록에서 Xiaomi Miot Auto를 볼 수 있습니다.
- 그것을 클릭하면 ‘XX개의 기기’가 표시됩니다. 들어가면 조명, 콘센트, 센서 등을 볼 수 있습니다.
- 권장 사항:
- 특정 기기를 클릭해 그 엔터티(Entities)를 확인합니다.
- 이 엔터티들을 HA 대시보드(Lovelace)에 추가해 제어할 수 있습니다.
3부: 자주 묻는 질문과 고급 팁
1. 로컬 제어(Local)와 클라우드 제어(Cloud)에 대하여
어떻게 구분하나요? HA의 기기 페이지에서 해당 기기를 클릭해 속성을 확인합니다. sub_type 또는 연결 모드가 local로 표시되면 로컬 제어입니다.
왜 중요한가요? 로컬 제어는 인터넷에 의존하지 않고 반응 속도가 매우 빠르며 프라이버시도 보호합니다.
주의
: 로컬 제어를 구현하려면 HA 호스트와 Xiaomi 기기가 같은 LAN(같은 서브넷)에 있어야 합니다. 복잡한 VLAN 구성이라면 서브넷 간 mDNS 브로드캐스트를 켜야 할 수 있습니다.
2. 블루투스 기기(온습도계, 도어락)
블루투스 기기 자체는 Wi-Fi에 연결되지 않고 ‘블루투스 게이트웨이’를 통해 Mi Home 클라우드에 연결됩니다.
Xiaomi Miot Auto가 이런 기기를 연동할 때는 보통 클라우드(Cloud)를 경유합니다(HA가 Wi-Fi로 블루투스 기기에 직접 연결할 수 없기 때문입니다).
고급 활용
: 블루투스 기기를 로컬로 연동하려면 ESPHome을 플래싱할 수 있는 블루투스 수신기를 구매하거나, HA 호스트 내장 블루투스 기능과 Passive BLE Monitor 통합을 함께 사용해야 합니다(이는 다른 주제입니다). 다만 초보자라면 Xiaomi Miot Auto로 클라우드를 통해 온습도를 읽는 것만으로도 충분합니다.
3. 기기 엔터티 이름이 깨지거나 너무 긴 경우
- 연동 후 엔터티 ID가 매우 길어질 수 있습니다(예: switch.xiaomi_plug_v3_xxxx).
- ‘기기’ 페이지에서 해당 엔터티를 클릭하고 오른쪽 위 톱니바퀴 아이콘을 눌러 Entity ID와 이름을 수정하면 나중에 자동화에서 호출하기 편합니다.
요약
차이에 얽매이지 말고 HACS로 Xiaomi Miot Auto를 설치한 뒤 계정 로그인 방식을 선택하세요. 이것이 현재 Xiaomi 생태계 전체를 연동하는 가장 안정적이고 간단한 ‘초보자용’ 방법입니다.
