Biblioteca Python e ferramenta de linha de comando miiocli para controlar dispositivos Xiaomi de casa inteligente pelos protocolos miIO e MIoT.
XiaoMi/ha_xiaomi_home
Integração oficial da Xiaomi que conecta dispositivos IoT inteligentes da marca ao Home Assistant pela Xiaomi Cloud ou por um hub gateway local.
Alternativa open source a:Mi Home
- Estrelas
- 22,240
- Forks
- 1,193
- Issues abertas
- 157
- Último commit
- há 26 dias
O que é?
A Xiaomi Home Integration é um componente personalizado para o Home Assistant, mantido pela Xiaomi, que importa dispositivos IoT da Xiaomi para o Home Assistant. Os usuários entram com a conta Xiaomi usando OAuth 2.0, escolhem uma casa e os dispositivos nela são criados como entidades do Home Assistant.
Os dispositivos são mapeados a partir da especificação MIoT-Spec-V2. Propriedades graváveis viram entidades Switch, Number, Select ou Text; propriedades somente de leitura viram entidades Sensor; eventos viram entidades Event; e ações viram entidades Button ou Notify. As regras de conversão de entidades podem ser personalizadas com arquivos locais de filtros de especificação e de idiomas. É possível adicionar várias contas Xiaomi à mesma instância do Home Assistant.
O controle normalmente passa pela Xiaomi Cloud. Quando há um hub gateway central Xiaomi ou um dispositivo com hub integrado, os comandos e as atualizações de estado podem ser executados localmente via MQTT. Há uma opção de controle pela LAN para alguns dispositivos conectados por IP, embora o projeto não recomende usá-la.
Recursos principais
- 01Importa dispositivos IoT da Xiaomi para o Home Assistant após o login na conta Xiaomi
- 02Mapeia propriedades, eventos e ações do MIoT-Spec-V2 para entidades do Home Assistant
- 03Permite controle local por meio de um hub gateway central Xiaomi ou de dispositivos com hub integrado
- 04Permite usar várias contas e regiões Xiaomi em uma única instância
- 05Oferece 13 idiomas de interface e regras personalizáveis de conversão de entidades
Casos de uso
- Controlar luzes, tomadas e sensores Xiaomi pelo painel do Home Assistant
- Criar automações que integrem dispositivos Xiaomi a produtos de outras marcas de casa inteligente
- Usar controle local prioritário com um hub gateway central Xiaomi na China continental
Tópicos
Perguntas frequentes
- O que é ha_xiaomi_home?
- Integração oficial da Xiaomi que conecta dispositivos IoT inteligentes da marca ao Home Assistant pela Xiaomi Cloud ou por um hub gateway local. A Xiaomi Home Integration é um componente personalizado para o Home Assistant, mantido pela Xiaomi, que importa dispositivos IoT da Xiaomi para o Home Assistant. Os usuários entram com a conta Xiaomi usando OAuth 2.0, escolhem uma casa e os dispositivos nela são criados como entidades do Home Assistant.
- ha_xiaomi_home é gratuito? Qual é a licença?
- ha_xiaomi_home é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
- ha_xiaomi_home ainda é mantido?
- Manutenção ativa. O último commit de ha_xiaomi_home foi em 28 de set. de 2026.
- Para que posso usar ha_xiaomi_home?
- Controlar luzes, tomadas e sensores Xiaomi pelo painel do Home Assistant Criar automações que integrem dispositivos Xiaomi a produtos de outras marcas de casa inteligente Usar controle local prioritário com um hub gateway central Xiaomi na China continental
- Onde consigo ha_xiaomi_home?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/XiaoMi/ha_xiaomi_home
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Cliente desktop para Windows que controla dispositivos inteligentes Xiaomi Mijia, desenvolvido com a biblioteca mijiaAPI e com interface gráfica, bandeja do sistema e widget para a área de trabalho.
App para a barra de menus e iPhone que mostra sua casa como um modelo 3D em tempo real e controla luzes e ar-condicionados via Smart Life, Home Assistant, Hue e Apple Home.
Plataforma open source de automação residencial que roda localmente e prioriza controle e privacidade, geralmente em um Raspberry Pi ou servidor local.
Uma ponte que conecta dispositivos Zigbee de casa inteligente ao MQTT, permitindo que funcionem sem o hub ou gateway do fabricante.
Firmware open source para ESP32 que controla fitas de LED RGB endereçáveis, matrizes 2D e painéis HUB75 via Wi-Fi.