miIO 및 MIoT 프로토콜을 통해 Xiaomi 스마트홈 기기를 제어하는 Python 라이브러리와 miiocli 명령줄 도구입니다.
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 통계는 매일 갱신됩니다.
관련 프로젝트
mijiaAPI 라이브러리 기반의 Windows 데스크톱 클라이언트로, GUI와 시스템 트레이, 데스크톱 위젯을 통해 Xiaomi Mijia 스마트홈 기기를 제어합니다.
집을 실시간 3D 모델로 보여주고 Smart Life, Home Assistant, Hue, Apple Home을 통해 조명과 에어컨을 제어하는 메뉴 막대 및 iPhone 앱입니다.
로컬에서 실행되며 제어권과 개인정보 보호를 우선하는 오픈소스 홈 자동화 플랫폼으로, Raspberry Pi나 로컬 서버에서 자주 사용됩니다.
Zigbee 스마트 홈 기기를 MQTT에 연결해 제조사 전용 허브나 게이트웨이 없이 사용할 수 있게 해주는 브리지입니다.
WiFi로 주소 지정형 RGB LED 스트립, 2D 매트릭스와 HUB75 패널을 제어하는 오픈소스 ESP32 펌웨어입니다.