Biblioteca Python y herramienta de línea de comandos miiocli para controlar dispositivos Xiaomi de hogar inteligente mediante los protocolos miIO y MIoT.
XiaoMi/ha_xiaomi_home
Integración oficial de Xiaomi que incorpora dispositivos inteligentes Xiaomi IoT a Home Assistant mediante Xiaomi Cloud o una pasarela central local.
Alternativa open source a:Mi Home
- Estrellas
- 22,240
- Forks
- 1,193
- Issues abiertos
- 157
- Último commit
- hace 26 días
¿Qué es?
Xiaomi Home Integration es un componente personalizado para Home Assistant, mantenido por Xiaomi, que incorpora dispositivos Xiaomi IoT a Home Assistant. Los usuarios inician sesión con su cuenta Xiaomi mediante OAuth 2.0, eligen una vivienda y los dispositivos que contiene se crean como entidades de Home Assistant.
Los dispositivos se asignan según la especificación MIoT-Spec-V2. Las propiedades que permiten escritura se convierten en entidades Switch, Number, Select o Text; las propiedades de solo lectura, en entidades Sensor; los eventos, en entidades Event; y las acciones, en entidades Button o Notify. Las reglas de conversión de entidades se pueden personalizar con archivos locales de filtros de especificación y de varios idiomas. Se pueden añadir varias cuentas Xiaomi a una misma instancia de Home Assistant.
El control normalmente se realiza a través de Xiaomi Cloud. Si hay una pasarela central Xiaomi o un dispositivo con hub integrado, los comandos y las actualizaciones de estado pueden ejecutarse localmente mediante MQTT. Una opción de control por LAN permite gestionar algunos dispositivos conectados por IP, aunque el proyecto recomienda no usarla.
Funciones clave
- 01Incorpora dispositivos Xiaomi IoT a Home Assistant tras iniciar sesión con una cuenta Xiaomi
- 02Asigna las propiedades, los eventos y las acciones de MIoT-Spec-V2 a entidades de Home Assistant
- 03Admite el control local mediante una pasarela central Xiaomi o dispositivos con hub integrado
- 04Permite usar varias cuentas y regiones Xiaomi en una misma instancia
- 05Ofrece 13 idiomas para la interfaz y reglas de conversión de entidades personalizables
Casos de uso
- Controlar luces, enchufes y sensores Xiaomi desde un panel de Home Assistant
- Crear automatizaciones que combinen dispositivos Xiaomi con los de otras marcas de domótica
- Usar un control local prioritario con una pasarela central Xiaomi en China continental
Temas
Preguntas frecuentes
- ¿Qué es ha_xiaomi_home?
- Integración oficial de Xiaomi que incorpora dispositivos inteligentes Xiaomi IoT a Home Assistant mediante Xiaomi Cloud o una pasarela central local. Xiaomi Home Integration es un componente personalizado para Home Assistant, mantenido por Xiaomi, que incorpora dispositivos Xiaomi IoT a Home Assistant. Los usuarios inician sesión con su cuenta Xiaomi mediante OAuth 2.0, eligen una vivienda y los dispositivos que contiene se crean como entidades de Home Assistant.
- ¿ha_xiaomi_home es gratuito? ¿Qué licencia tiene?
- ha_xiaomi_home es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿ha_xiaomi_home sigue mantenido?
- Mantenimiento activo. El último commit de ha_xiaomi_home fue el 28 sept 2026.
- ¿Para qué puedo usar ha_xiaomi_home?
- Controlar luces, enchufes y sensores Xiaomi desde un panel de Home Assistant Crear automatizaciones que combinen dispositivos Xiaomi con los de otras marcas de domótica Usar un control local prioritario con una pasarela central Xiaomi en China continental
- ¿Dónde consigo ha_xiaomi_home?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/XiaoMi/ha_xiaomi_home
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Cliente de escritorio para Windows con el que controlar dispositivos domésticos inteligentes Xiaomi Mijia, desarrollado sobre la biblioteca mijiaAPI y con interfaz gráfica, bandeja del sistema y widget de escritorio.
Una app para la barra de menús y iPhone que muestra tu hogar como un modelo 3D en tiempo real y controla sus luces y aires acondicionados mediante Smart Life, Home Assistant, Hue y Apple Home.
Plataforma de domótica de código abierto que funciona localmente y prioriza el control y la privacidad, a menudo en una Raspberry Pi o un servidor local.
Un puente que conecta dispositivos Zigbee para el hogar inteligente con MQTT y permite usarlos sin el hub o gateway del fabricante.
Firmware de código abierto para ESP32 que controla tiras LED RGB direccionables, matrices 2D y paneles HUB75 por WiFi.