Já pensou em integrar localmente dispositivos BLE (Bluetooth Low Energy) no Home Assistant? Então, é possível! Com o componente Passive BLE Monitor é possível integrar localmente dispositivos Xiaomi, Aqara, Viomi, Yeelight dentre outros!
Veja clicando aqui a lista de dispositivos compatíveis!
Para integrar dispositivos BLE ao Home Assistant não é necessário nenhum hub ou gateway, se o hardware que está usando o Home Assistant já tem Bluetooth integrado como um Raspberry Pi, Mini PC ou Notebook podemos utilizar o bluetooth deles! Caso não tenha Bluetooth no seu hardware então um pequeno dongle usb já basta.
Github do componente: clique aqui!
No meu caso uso o Home Assistant em um Mini PC e adquiri esse pequeno termostato da Xiaomi, vou usa-lo como exemplo no tutorial.
Vamos ao tutorial, o primeiro passo é adicionar o componente Passive BLE Monitor.
Adicionado o componente!
No HACS vá em Integrações.
Clique em Explore e Download Repositories no canto direito inferior e procure Passive BLE Monitor.
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 Passive BLE Monitor.
Caso não abra a integração na hora deve aparecer essa mensagem para aguardar. Aguarde que depois de alguns minutos a integração é configurada. Realmente demora um tempo, aguarde com paciência.
Com a integração configurada, vai carregar a tela de opções, repare que o MAC address do Bluetooth do seu hardware e a opção de Descobrir dispositivos e sensores automaticamente já vão estar marcados. Então é só clicar para Enviar. O seu hardware vai procurar seu dispositivo BLE.
Pegue seu dispositivo BLE e deixe perto do seu hardware que irá aparecer no seu Home Assistant automaticamente. Caso o seu Home Assistant não ache o dispositivo mais a frente no tutorial vai aprender a integrar ele de outra forma.
Com ele integrado ao Home Assistant irá perceber que as informações do dispositivo vão ficar como Desconhecido.
Na documentação do componente Passive BLE Monitor temos a informação que para sensores é obrigatório que tenhamos uma chave de encriptação para termos as informações do dispositivo. Verifique se seu dispositivo necessita.
Então vamos buscar essa chave de encriptação!
Existem duas formas de conseguirmos essa chave.
Primeira forma:
A primeira forma é adicionando o dispositivo ao aplicativo Mi Home e por ele conseguindo a chave!
Baixe o Mi Home, selecione região China. Já com o aplicativo aberto clique no “+” no canto superior direito.
Clique em Adicionar Dispositivo e ligue o Bluetooth do seu celular.
Adicione o seu dispositivo a sua conta e siga o passo a passo!
Agora temos ele adicionado.
Essa parte do tutorial é para quem o Home Assistant não achou o dispositivo. Para integra-lo vamos precisar do MAC Address do seu dispositivo e no Mi Home vamos ter essa informação.
Clique no dispositivo e vá no Menu na direito em cima. Clique em About.
E agora vai ter o seu MAC Address, guarde ele.
Com seu dispositivo adicionado ao Mi Home agora vamos conseguir a chave de encriptação!
Vamos precisar usar um programa para Windows chamdo Token Extractor.
Pode baixar o programa clicando aqui.
O windows deve indicar que é um programa malicioso, ignore e baixe mesmo assim.
Abra e clique em Executar assim mesmo.
Com ele baixado, abra, coloque seu e-mail e senha do Mi Home.
Depois coloque a região em que a conta do Mi Home está seu dispositivo, para China coloque “cn” e pronto!
Vão aparecer todos os dispositivos, token e no caso do dispositivo BLE da Xiaomi vai aparecer também a chave de encriptação (BLE KEY). Copie a chave que vamos usar.
Segunda forma:
Pareie o seu dispositivo BLE em um computador que tenha bluetooth, entre no site clicando aqui para obter a chave encriptada.
Já no site clique no botão Connect e aguarde até que ele mostre conectado.
Com ele conectado, clique no botão Do Activation e aguarde até que a chave de encriptação apareça na opção Mi Bind Key.
Seguindo com o tutorial!
Pronto, agora temos a chave encriptada e com ela em mãos vamos adicionar ao Home Assistant!
Vá em Configurações, Integrações e na integração do Passive BLE Monitor clique em Configurar.
Vá em Devices e clique no seu dispositivo se ele foi descoberto pelo Home Assistant, caso não tenha sido clique em Add device.
Preencha com a chave encriptada e clique em Enviar.
Se o seu dispositivo não tiver sido descoberto pelo Home Assistat preencha com o MAC Address e a chave encriptada, clique em Enviar.
Vai voltar para a tela anterior, clique em Enviar nela. Vai aparecer uma mensagem de sucesso.
Agora é só aguardar que as informações vão aparecer. Pode demorar muitos minutos.
Bom, é isso. Um abraço!
Outras informações:
Sobre o termostato, fiz alguns testes e funciona super bem em alguns cômodos + afastados! Coisa de 2 paredes de distância e uns 15 metros!
O Bluetooth 4.0 do mini pc tem suporte para até 61 metros.
Um dongle usb ou um hardware com Bluetooth 5.0 pode chegar a 240 metros.
O termostato atualiza + ou - a cada 10 minutos a temperatura. No momento que liguei o ar condicionado podemos ver a temperatura caindo e quando desliguei a temperatura subindo.
Integrei também um sensor de vazamento de água BLE da Xiaomi e foi integrado com sucesso!