Bem-víndo ao guia para adicionar dispositivos Xiaomi ao Home Assistant!
Selecione a integração utilizando o sumário abaixo:
Integração Xiaomi_miio: Gateways e Robôs Aspirador
Integração Xiaomi_aqara: Sensores
Integração Xiaomi Gateway 3
Integração Aqara Gateway/Hub
Integração Xiaomi Mi Remote
Integração Yeelight / Xiaomi Bulb
Integração Xiaomi Miot Auto
Integração por MQTT com firmware OpenWRT
Integração Xiaomi_miio: Gateways e Robôs Aspirador
A Xiaomi é uma empresa muito grande e tem várias empresas subsidiárias. A Aqara e a Mijia são subsidiárias para dispositivos IoT, então existem sensores, gateways (hubs), câmeras e outros. A Roborock, Viomi e Dreame são subsidiárias que fabricam robôs aspiradores.
Robôs aspiradores da Viomi e Dreame é feita a integração com a Xiaomi Miot Auto clicando aqui!
Gateways da Mijia e Aqara e grande parte dos robôs aspiradores da Roborock usam a integração Xiaomi Miio para serem adicionados ao Home Assistant.
Documentação no site oficial do Home Assistant:
Gateways da Aqara e Mijia com suporte a essa integração:
Xiaomi Gateway 1 e 2: existem modelos diferentes dos gateway 1 e 2, cada modelo tem suportes diferentes as integrações! Veja na tabela abaixo o suporte!
| Modelo: | Xiaomi_miio | Xiaomi_aqara |
|---|---|---|
| DGNWG02LM | Sim | Sim |
| DGNWQ05LM | Sim | Não |
| ZHWG11LM | Não testado | Não testado |
| ZNDMWG03LM | Não testado | Não testado |
| KTBL01LM | Não testado | Não testado |
| KTBL02LM | Não testado | Não testado |
| KTBL11LM | Sim | Sim |
Para conhecer os modelos:
Vamos para o tutorial:
Vá em Configurações, depois em Dispositivos e serviços.
Vá no canto direito embaixo e clique em “+ Adicionar Integração” e ache Xiaomi Miio.
Preencha com o seu e-mail e senha, selecione a região da sua conta e clique em Enviar.
Se a sua conta for uma conta com região Brasil deve selecionar “us”.
Pronto, foram adicionados ao Home Assistant.
Caso seu dispositivo não tenha suporte a essa integração tente com a Xiaomi Miot Auto clicando aqui!
Integração Xiaomi_aqara: Sensores
Para os sensores é pela integração Xiaomi Gateway Aqara!
Vá em Configurações, depois em Integrações.
Vá no canto direito embaixo e clique em “+ Adicionar Integração” e ache Xiaomi Gateway (Aqara).
Para adicionar seus sensores vamos precisar de uma senha de rede, ela era mostrada no app Mi Home mas nas versões mais recentes não é + mostrada.
Na versão nova do Mi Home tiraram a opção de ver essa senha de rede (pelo menos não achei). Então vai precisar de uma versão antiga para pegar essa senha.
Baixe o Mi Home versão antiga:
Faça o login normalmente, selecione o gateway.
Clique no menu no canto direito em cima.
Nas opções do gateway vá em About.
Clique em cima do texto “Plug-in version” algumas vezes vai aparecer uma mensagem.
Essa mensagem e continue até aparecerem novas opções.
Após aparecerem novas opções, vá em Wireless communication protocol.
Agora você vai ter acesso a senha de rede.
Preenchendo com a senha de rede é só clicar em Enviar.
Com isso conseguimos adicionar os sensores!
Video:
Recomendo esse tutorial para quem tem o gateway e sensores Xiaomi:
Integração Xiaomi Gateway 3
O gateway 3 da Xiaomi tem suporte para Zigbee e BLE.
É possível utilizar o Zigbee2mqtt ou o Zigbee Home Automation com esse gateway com os firmwares originais, mas só nos modelos ZNDMWG03LM e ZNDMWG02LM, para isso sua conta do Mi Home precisa estar na região CHINA e o gateway com o último firmware atualizado.
É necessário instalar o componente pelo HACS:
No HACS vá em Integrações.
Clique em “+ Explorar e baixar repositório” no canto direito inferior e procure Xiaomi Gateway 3.
Clique em “Baixar esse repositório com HACS”.
Clique em Baixar.
Reinicie o Home Assistant.
Com ele reiniciado vá em Configurações, Dispositivos e Serviços.
No canto direito em baixo clique em Adicionar Integração e procure na lista Xiaomi Gateway 3.
Vai ter duas opções, vá parar a segunda opção.
Selecionando a segunda vai pedir o ip, token e telnet do seu gateway 3.
Preencha com o ip e o Token. O ip e o token vai conseguir usando o token extractor, clique aqui!
Para o Telnet vai precisar colocar o seguinte código:
{"method":"set_ip_info","params":{"ssid":"\"\"","pswd":"123123 ; passwd -d admin ; echo enable > /sys/class/tty/tty/enable; telnetd"}}
Esse código foi retirado desse site aqui!
Com isso deve conseguir integrar!
Para alterar o modo de funcionamento e alterar de Mi Home para Zigbee2mqtt ou ZHA, clique em Configurar.
Vá em Mode e altere para o modo de funcionamento que preferir.
Vídeos mostrando como integrar:
Vídeo mostrando como usar Zigbee2mqtt no Gateway 3!
Vídeo mostrando como usar ZHA no Gateway 3!
Integração Aqara Gateway/Hub
A integração para os modelos G2H, M1S CN, P3 CN, M2 CN, H1 CN, E1 CN, G3 CN.
Aqara Gateway (KTBL12LM, ZHWG15LM, ZHWG12LM, ZNSXJ12LM, ZNSXJ12LM, ZNSXJ13LM)
É necessário instalar o componente pelo HACS:
No HACS vá em Integrações.
Vá no canto direito á cima, clique no menu e selecione Repositórios Personalizados.
Preencha com o link do github do componente https://github.com/niceboygithub/AqaraGateway em repositório e em categoria selecione Integração. Clique em Adicionar.
Clique em Download.
Ou clique em Explore e Download Repositories no canto direito inferior e procure o Aqara Gateway na lista de componentes.
Clique em “Download This Repository With HACS”.
Clique em Download.
Reinicie o Home Assistant.
Com ele reiniciado vá em Configurações, Dispositivos e Serviços.
No canto direito em baixo clique em Adicionar Integração e procure na lista
Em Host digite o endereço IP do gateway.
Em Password se você colocou uma senha de telnet no gateway, digite a senha. Caso contrário, ignore este campo.
Em Token digite o token xiaomi de gateway, para pegar o token vai precisar do token extractior, clique aqui!
Selecione o modelo do seu gateway e clique em Enviar.
Pronto. gateway adicionado.
Caso tenha alguma dúvida ou dificuldade verifique o github do componente.
Integração Xiaomi Mi Remote
Para adicionar o Mi Remote é necessário um Token e para consegui-lo é necessário usar o token extractor.
Entre no github dos desenvolvedores e baixe!
Com ele baixado, abra, coloque seu e-mail e senha do Mi Home.
Depois coloque o país em que a conta do Mi Home estão os dispositivos e pronto!
Vão aparecer todos os dispositivos e token deles!
Para o Brasil deve-se usar “us” como o país pois os dispositivos da região Brasil ficam no servidor americano.
Pronto, agora é só adicionar a sua integração com facilidade com o Token do seu Mi Remote.
Vá até o seu configuration.yaml e preencha dessa forma:
remote:
- platform: xiaomi_miio
name: "Nome do controle"
host: 192.168.xx.xx
token: xxxxxxxx
Integração Yeelight / Xiaomi Bulb
Além de suporte a lâmpadas Yeelight essa integração também serve para adicionar lâmpadas da Xiaomi com o Home Assistant. Ambas funcionam localmente então não precisa de internet.
Para lâmpadas Xiaomi:
Primeiro vamos começar com a parte do tutorial que só vai servir para lâmpadas Xiaomi.
Antes de tudo adicione sua lâmpada ao aplicativo Mi Home. Selecione a região no aplicativo seguindo a embalagem do produto, se é uma lâmpada região USA vai ser possível adicionar na conta Brasil, se é uma lâmpada região Europa vai ser possível adicionar na conta Alemanha e por ai vai.
Após ter adicionado vai precisar baixar uma versão antiga do aplicativo Yeelight para a sequencia do tutorial, só com essa versão vai ser possível habilitar o uso local e adicionar ao Home Assistant.
Baixe a versão 3.2.34 do aplicativo Yeelight e faça login com o mesmo usuário e senha do aplicativo Mi Home e selecione a mesma região do Mi Home.
Download do Yeelight 3.2.34: clique aqui!
Após ter instalado o aplicativo Yeelight versão 3.2.34 e ter feito o login a sequencia do tutorial é igual para quem tem lâmpadas Yeelight.
Para lâmpadas Yeelight:
Após ter adicionado sua lâmpada ao aplicativo, clique nela!
Nas configurações da lâmpada vá no emblema que parece um “eject”.
Vá na opção LAN Control.
Ligue a opção! Com essa opção ligada o Home Assistant vai achar automaticamente sua lâmpada na rede interna.
No Home Assistant vá em Configurações, depois em Dispositivos e serviços.
Vá no canto direito embaixo e clique em “+ Adicionar Integração” e procure Yeelight.
Se quiser pode preencher com o ip da sua lâmpada ou pode deixar em branco e clica em Enviar que o Home Assistant vai achar automaticamente sua lâmpada.
Achou um dispositivo, é só clicar em cima que ele vai aparecer.
Com o dispositivo encontrado é só clicar em Enviar.
Pronto, lâmpada adicionada.
Se o Home Assistant não achar automaticamente a sua lâmpada, no app Yeelight você pode ir em configurações e Informações do dispositivo e ver o ip.
É isso, um abraço!
Video:
Tem roteador da Xiaomi? Da uma olhada nesse tutorial:
Recomendo outros dois tutoriais para quem tem Roborock:
