Integração com a Xiaomi! Aqara, Mijia, Roborock, Yeelight, Dreame, Viomi e Mi Remote!

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.

local

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

2

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.

Captura de tela 2021-12-04 084642

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!

Captura de tela 2021-12-04 084131

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.

Dispositivos Zigbee integram localmente.
Zigbeelocal

Dispositivos BLE integram via nuvem.
BLEnuvem

É 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.

5

Reinicie o Home Assistant.

6

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.

10

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!

8

Para o Telnet vai precisar colocar o seguinte código:

2

{"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.

zzz

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.

2

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.

5

Reinicie o Home Assistant.

6

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.

3

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

yeee xiaomibulb

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.

local

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.

2

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:

3 Likes

A integração Xiaomi Miot Auto é uma integração feita para adicionar os dispositivos Xiaomi que não tiveram suporte pelas integrações nativas. Só recomendo o uso se seu dispositivo não tem suporte nativo.

nuvem

Dispositivos de várias subsidiárias da Xiaomi também tem suporte por essa integração:

Segue a lista de dispositivos suportados por essa integração:

No HACS vá em Integrações.

Clique em “Explorar e baixar repositórios” no canto direito inferior e procure o Xiaomi Miot Auto.

Clique em Baixar esse repositório com HACS.

Clique em Download.

3

Com ele instalado reinicie o seu Home Assistant.

4

Com ele reiniciado vá em Configurações, Dispositivos & Serviços.

No canto direito em baixo clique em Adicionar Integração e procure na lista Xiaomi Miot Auto.

Clique em Enviar.

1

Preencha com a sua conta da Xiaomi, sua senha e selecione a região da conta. Clique em Enviar.

Selecione Include, na lista de dispositivos marque os dispositivos que quer adicionar ao Home Assistant e clique em Enviar.

3

Pronto, sucesso! Seus dispositivos foram integrados.

4

Dispositivos adicionados!

5

Agora em pt-BR essa integração, eu traduzi e fica + fácil integrar!

Pessoal, existe a possibilidade de trocar o firmware do gateway v2 da Xiaomi modelo DGNWG05LM e do gateway da Aqara modelo ZHWG11LM para o OpenWRT e habilitar comandos através de MQTT (inclusive sons TTS), e substituir o firmware do radio Zigbee para modo router. Para esse procedimento é necessário abrir o gateway e soldar cabos, além dos links dos repositórios do github seguem vídeos para auxiliar no procedimento.

local

Essa possibilidade é exclusiva para o modelo DGNWG05LM do gateway v2 da Xiaomi e o modelo ZHWG11LM do gateway da Aqara.


aqara

Gateways com OpenWrt:

  • Uso totalmente offline e local, não depende de integração da Xiaomi no Mi Home
  • Se quiser pode usar o zigbee2mtt através dele e ele usar como coordenador
  • Integração do gateway direta através do MQTT e zigbee2mqtt em modo router
  • Abre um leque de aplicações que você pode instalar no OpenWrt para rodar nele
  • Você vai poder controlar a caixa de áudio com comandos de TTS através do MQTT
  • Aparece mais um sensor de luminosidade que tem na placa e não é exposta no firmware original
  • Libera 24 IO’s que possuem pontos de soldagem na placa principal para uso diversos
  • Libera uma porta USB na placa que pode ser utilizada
  • É possível habilitar o BLE (Bluetooth low energy) no hub para uso.

Segue os links abaixo:

É só seguir os tutoriais na ordem:

1- Gaining root:

2- OpenWRT Firmware:

3- MQTT Plugin:

Se quiser utilizar o gateway no modo router siga para o tutorial 4.

4- Router Firmware:

5- Habilitando o BLE (Bluetooth Low Energy):
(em russo, precisa de tradutor)

Dica de uso no node-red:

NodeRED Plugin:

Videos:

Os vídeos estão em russo mas é possível ligar a legenda e a tradução para português, junto com o tutorial no github é possível seguir.

‎Coloque OpenWrt no gateway Xiaomi DGNWG05LM \ ZHWG11LM‎

Coloque o gateway Xiaomi DGNWG05LM ou Aqara ZHWG11LM no Home Assistant

OpenWRT para gateways Xiaomi DGNWG05LM e Aqara ZHWG11LM. Instalação, atualização e downgrade‎

Gateways Xiaomi e Aqara - OpenWRT, Home Assistant, zigbee2mqtt

Olá meus amigos.

Comprei recentemente o mijia vacuum v2 (Mi robot vacuum-mop essential MJSTG1)
Com o software “Xiaomi-cloud-tokens-extractor-master” consegui o token e o ip do robo.

Gostaria de saber algum tutorial para deixar ele em pt-br.
Agradeço muito

OBS.: Testei esse tutorial mas não conecta quando rodo o .bat

1 Like

Oi Roney, tudo bom? Então, acredito que o seu modelo não tem ainda como colocar em pt-br. Acompanha o fórum em russo sobre hacks nos Roborock e quem sabe algum dia aparece algo por lá!

Pra esses modelos tem suporte: Xiaomi Mi Robot Vacuum (Roborock v1/v2(S50/51/55)/v3(1S/S6/T6/S5E(Max)/S6 Max V)

Roborock (серия) - робот-пылесос - Прошивка и языковые пакеты - 4PDA

Tutorial atualizado! Atualizado com o tutorial do Xiaomi Miot Auto!

Adicionando a camera 360° da Xiaomi no Home Assistant pelo Miot Auto!

Tutorial do Gateway 3 da Xiaomi atualizado!

1 Like

Adicionado tutorial para lâmpadas Yeelight e lâmpadas da Xiaomi!

Muitos colegas tem tido dúvidas em relação aos modelos diferentes de Gateway Zigbee da Xiaomi, vou esclarecer essas dúvidas!

Gateway 2

Ele tem sirene e alarme. Em volta dele tem uma luz de led e tudo por ser controlado pelo Home Assistant. A luz de led é integrada como light e você pode controlar as cores, brilho e tudo mais.

No Gateway 2 só é possível utilizar dispositivos da Xiaomi.

Ele tem vários modelos, o que muda entre os modelos é o tipo de tomada e o suporte no Home Assistant.

Model numbers:
DGNWG02LM (China)
DGNWG03LM (Taiwan)
DGNWG04LM (Hong Kong)
DGNWG05LM (Europe / Brazil)

europa

O modelo DGNWG02LM (China) é integrado ao Home Assistant pela integração Xiaomi_miio para o gateway e para os sensores dele é usada a integração Xiaomi_aqara.

Esse modelo DGNWG02LM (China) acompanha esse kit com tomada, botão, sensor de porta e sensor de movimento. É o mesmo kit, só muda a caixa. O gateway é adicionado ao Mi Home na região China.

f5044d082f4362f29404c978d97287de

O modelo DGNWG05LM (Europe / Brazil) é integrado ao Home Assistant pela integração Xiaomi_miio para o gateway e para os sensores dele é usada a integração Xiaomi Miot Auto.

Esse modelo DGNWG05LM (Europe / Brazil) acompanha esse kit com botão, 2x sensores de porta e 2x sensores de movimento. O gateway é adicionado ao Mi Home na região Cingapura.

O kit com o modelo DGNWG05LM é o que está sendo vendido na Loja da VIVO pelo valor de 159 reais.

https://lojaonline.vivo.com.br/vivostorefront/Vivo/Acess%C3%B3rios/XIAOMI-KIT-SMART-HOME-SENSORES-XM351BRA/p/22019406?bestPlanCode=&bestPlpPrice=169.0000000000000000

Gateway 3

No gateway 3 além de dispositivos da Xiaomi é possível utilizar o Zigbee2mqtt ou o Zigbee Home Automation.
Além do Zigbee, o gateway 3 também tem suporte ao protocole Bluetooth low energy, o BLE. Então dispositivos Xiaomi que são BLE é possível a integração.

Nele é usada integração pelo componente instalado pelo HACS, tem tutorial aqui!

Ele é vendido em um kit que além do gateway 3 acompanha um botão, 2x sensores de porta e um sensor de movimento.


Esse é o kit que está sendo vendido na Loja da VIVO pelo valor de 199 reais.

https://lojaonline.vivo.com.br/vivostorefront/Vivo/Acess%C3%B3rios/XIAOMI-KIT-SMART-HOME-SENSORES-XM540BRA/p/22019666?bestPlanCode=&bestPlpPrice=199.0000000000000000

2 Likes

Pessoal, eu ia ate fazer um tutorial para isso, mas iria dar muito trabalho e iria ficar muito extenso.

So para complementar, quem tiver um Hub Gateway 3 da Xiaomi, modelo ZNDMWG03LM, e não estiver conseguindo faze-lo funcionar com o zigbee2mqtt dentro do home asssitant seguindo exatamente o passo a passo deste video aqui: https://www.youtube.com/watch?v=Um0cHG8zh7g&t=177s, faça o seguinte:

Abra o aplicativo Mi Home, e veja qual a versão do firmware esta instalada e se tem algum update. Caso não tenha (meu caso), exclua o hub do Mi Home, e troque a região para China. Feito isso, resete o Hub, e adicione-o novamente dentro do aplicativo.

Vc vai notar que o aplicativo quando está configurado pra região da China é muito mais completo, e tem muitas outras configurações disponiveis. E uma delas é o suporte a um firmware mais recente!

Eu atualizei o firmware do Hub para uma versão bem mais nova, e refazendo o passo a passo do video, eu consegui finalmente adicionar e reconhecer os dispositivos zigbee da sonoff que tenho aqui com ele dentro do Home Assistant!

Se ainda sim ficar confuso, me sinalizem ai, que faço o tutorial.

Um abraço!!!

1 Like

Quem pegou o kit de R$ 169 da Xiaomi na Vivo (gateway 2), e integrou via Xiaomi Miot Auto, o botão aparece no HA? Aqui aparece todos os sensores menos o botão. Já desinstalei e instalei a integração várias vezes e não aparece. No APP Mi Home aparece normalmente

Vejam se podem me ajudar: tenho esse modelo de camera e hoje uso o app Mi Home para poder ver as cameras de casa:

Hoje vendo esse post, fui tentar fazer a integração com o meu HA, mas nao du certo.
Instalei via HACs a integração “Xiaomi Miot Auto”, coloquei usuario e senha, ele localizas as minhas duas cameras conforme imagem abaixo, mas nao consigo ver a imagem pelo HA.

Mas quando eu tendo visualizar a camera, pelo dashboard do HA, só aparece essa msg:

O que será que pode esatr dando de errado?

No cartão coloca em Live!

Captura de tela 2022-04-12 170833

Refiz a integração mas ainda nao deu certo… se eu deixo na opção “live” fica tudo preto, se deixo na opção “auto” fica com uma imagem da camera, mas fica estatica, sem movimentos

Veja como estao as configurações do card:

tambem estou com o mesmo problema, a camera nao abre.
no meu caso o xiaomi miot auto criou 3 entidades referentes a camera: 1 de status, 1 de liga/desliga e outra “camera control”, esta ultima deveria ser onde reproduz a imagem, nao sei porque do “control” no nome, sera que nao teria algo a ver com ptz?
a entidade liga e desliga funciona.

Boa noite. Sou novo estusiasta no forum. Queria primeiro agradecer pq sem vcs seria muito mais difícil essa aventura no home.
Gostaria de tirar uma duvida. Fiz todo o processo de integração pelo xiaomi Miio e ficou com erro.
image

Está informando que não existe essa integração. Mas no caso, já vi alguns modelos desse sendo utilizado. O que poderia ser?

Tira a integração e faz de novo, deve resolver. Se não resolver faz a integração com o token!

Deu certo! Muito obrigado :+1: :+1:

Minto. Não deu certo. Tinha usado o Xiaomi Miot Auto pra adicionar e ele apareceu. Mas quando ia verificar a entidade, os sensores dele não apareciam. Aí voltei e tentei utilizar o token, mas msm assim apareceu o msm erro.