Repolode
XiaoMi

XiaoMi/ha_xiaomi_home

Xiaomi Cloud 또는 로컬 중앙 허브 게이트웨이를 통해 Xiaomi IoT 스마트 기기를 Home Assistant에 연동하는 Xiaomi 공식 통합 기능입니다.

대체할 수 있는 제품:Mi Home

스타
22,240
포크
1,193
열린 이슈
157
마지막 커밋
26일 전

어떤 프로젝트인가요?

Xiaomi Home Integration은 Xiaomi가 유지 관리하는 Home Assistant용 커스텀 컴포넌트로, Xiaomi IoT 기기를 Home Assistant에 가져옵니다. 사용자는 OAuth 2.0으로 Xiaomi 계정에 로그인하고 집을 선택하면, 해당 집의 기기가 Home Assistant 엔티티로 생성됩니다.

기기는 MIoT-Spec-V2 사양을 바탕으로 매핑됩니다. 쓰기 가능한 속성은 Switch, Number, Select 또는 Text 엔티티로, 읽기 전용 속성은 Sensor 엔티티로, 이벤트는 Event 엔티티로, 액션은 Button 또는 Notify 엔티티로 변환됩니다. 로컬 사양 필터 파일과 다국어 파일을 사용해 엔티티 변환 규칙을 맞춤 설정할 수 있습니다. 하나의 Home Assistant 인스턴스에 여러 Xiaomi 계정을 추가할 수도 있습니다.

일반적으로 제어 명령은 Xiaomi Cloud를 거칩니다. Xiaomi 중앙 허브 게이트웨이나 허브가 내장된 기기가 있으면 MQTT를 통해 명령과 상태 업데이트를 로컬에서 처리할 수 있습니다. 일부 IP 연결 기기는 LAN 제어 옵션을 지원하지만, 프로젝트에서는 사용을 권장하지 않습니다.

핵심 기능

  • 01Xiaomi 계정으로 로그인한 뒤 Xiaomi IoT 기기를 Home Assistant에 가져옵니다
  • 02MIoT-Spec-V2 속성, 이벤트, 액션을 Home Assistant 엔티티에 매핑합니다
  • 03Xiaomi 중앙 허브 게이트웨이 또는 허브가 내장된 기기를 통한 로컬 제어를 지원합니다
  • 04하나의 인스턴스에서 여러 Xiaomi 계정과 지역을 사용할 수 있습니다
  • 0513개 인터페이스 언어와 맞춤형 엔티티 변환 규칙을 제공합니다

활용 사례

  • Home Assistant 대시보드에서 Xiaomi 조명, 플러그, 센서를 제어합니다
  • Xiaomi 기기를 다른 스마트 홈 브랜드 기기와 연동하는 자동화를 구성합니다
  • 중국 본토에서 Xiaomi 중앙 허브 게이트웨이를 사용해 로컬 우선 제어를 구현합니다

토픽

자주 묻는 질문

ha_xiaomi_home은(는) 무엇인가요?
Xiaomi Cloud 또는 로컬 중앙 허브 게이트웨이를 통해 Xiaomi IoT 스마트 기기를 Home Assistant에 연동하는 Xiaomi 공식 통합 기능입니다. Xiaomi Home Integration은 Xiaomi가 유지 관리하는 Home Assistant용 커스텀 컴포넌트로, Xiaomi IoT 기기를 Home Assistant에 가져옵니다. 사용자는 OAuth 2.0으로 Xiaomi 계정에 로그인하고 집을 선택하면, 해당 집의 기기가 Home Assistant 엔티티로 생성됩니다.
ha_xiaomi_home은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ha_xiaomi_home은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ha_xiaomi_home은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. ha_xiaomi_home의 마지막 커밋은 2026년 9월 28일입니다.
ha_xiaomi_home은(는) 어디에 사용할 수 있나요?
Home Assistant 대시보드에서 Xiaomi 조명, 플러그, 센서를 제어합니다 Xiaomi 기기를 다른 스마트 홈 브랜드 기기와 연동하는 자동화를 구성합니다 중국 본토에서 Xiaomi 중앙 허브 게이트웨이를 사용해 로컬 우선 제어를 구현합니다
ha_xiaomi_home은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/XiaoMi/ha_xiaomi_home

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트