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!
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 sensor de temperatura/humidade 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 “+ Explorar e baixar repositórios” no canto direito inferior e procure Passive BLE Monitor.
Clique em “Baixar esse repositório com HACS”.
Clique em Baixar.
Reinicie o Home Assistant.
Com ele reiniciado vá em Configurações, Dispositivos & 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. Verifique se o MAC address do Bluetooth do seu hardware e a opção de Descobrir dispositivos e sensores automaticamente estão marcados. Se estiver tudo certo então é só clicar para Enviar. O seu hardware vai procurar seu dispositivo BLE. Marque a opção “restore state after a restart” para manter os status dos dispositivos depois de uma reinicialização.
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 até 2 horas.
Bom, é isso. Um abraço!