Repolode
XiaoMi

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