O HASS.Agent é um programa para Windows que tem várias funcionalidades, segue a lista:
-
Notificações: receba notificações, mostre-as usando pop-ups do Windows e, opcionalmente, anexe imagens.
-
Ações: você pode controlar as entidades do Home Assistant por um atalho no teclado do seu PC como ligar uma luz, executar um script ou automação do “automations”.
-
Comandos: controle seu PC (ou outro dispositivo baseado em Windows) através do Home Assistant usando comandos personalizados ou integrados, como reiniciar, desligar ou hibernação.
-
Sensores: envie os sensores do seu PC para o Home Assistant para monitorar seu sistema como uso de webcam, volume do SSD/HD e contadores de desempenho.
Todas as entidades são adquiridas do seu Home Assistant.
Comandos e sensores são adicionados automaticamente no seu Home Assistant pelo MQTT, é necessário ter instalado o MQTT no Home Assistant para isso.
Não tem ainda o MQTT? Clique aqui!
Github do programa: https://github.com/LAB02-Research/HASS.Agent/
Bora pro tutorial!
Edit: Agora o HASS.Agent tem tradução para Português do Brasil! Ela foi feita por mim, espero que gostem!
Antes de tudo baixe o programa no seu Windows.
Download aqui: https://github.com/LAB02-Research/HASS.Agent/releases/latest/download/HASS.Agent.Installer.exe
Com ele baixado, clique 2x e vamos configurar.
Selecione o idioma para Português do Brasil!
Marque em aceitar os termos e clique em Install para instalar.
Clique em Next.
Clique em “yes, enable launch-on-login” para que o programa abra junto com o Windows.
Pronto, agora ele vai ser aberto junto com o Windows, clique em Next.
Essa tela são as opções de notificações, deixe tudo como está e clique em Next.
Clique em Next.
Nessa tela você vai precisar preencher com o endereço do acesso externo ao seu Home Assistant e um token, vou mostrar como criar o token.
Vá no seu Perfil no Home Assistant e desça até achar a parte de criar Tokens de longa duração.
Achando a parte de criar Tokens de longa duração clique em Criar Token.
Coloque um nome e clique em Ok.
Vai ser criado um Token, copie ele e cole lá no HASS.Agent
Com o endereço do seu acesso externo preenchido e o token clique em “test connection” para testar o acesso ao seu Home Assistant.
Se estiver tudo certo vai ter essa tela mostrando que está OK. Clique em Next.
Nessa tela vamos configurar com as informações do MQTT.
Coloque o ip do seu Home Asssistant: 192.168.1.xxx
Coloque o usuário e senha do seu MQTT do Home Assistant.
Clique em Next.
Clique em Next.
Clique em Next.
Pronto, já está instalado, clique em Finish.
Com o programa instalado repare que em notification api, home assistant api e mqtt estão com um “ok” verde ao lado, se em algum deles não estiver vá em configuration e faça novamente a configuração.
Agora vamos criar atalhos para ações do Home Assistant usando o teclado do PC. Clique em quick actions.
Vá em add new.
Aqui podemos escolher ações para serem feitas quando apertamos algum botão do teclado.
Em domain temos os domínios que podemos chamar no Home Assistant, temos como opções:
Automations: podemos executar alguma automação do “automations” do Home Assistant.
Script: podemos executar algum script já configurado no Home Assistant.
InputBoolean: podemos ligar, desligar ou toogle (alternar) algum input_boolean do Home Assistant.
Scene: podemos chamar uma cena criada no Home Assistant.
Switch: podemos ligar, desligar ou toogle (alternar) algum switch do Home Assistant.
Light: podemos ligar, desligar ou toogle (alternar) alguma lâmpada / fita LED do Home Assistant.
Em entity vamos selecionar alguma entidade do domínio que escolhemos.
Em action você vai escolher a ação a ser executada, pode ser ligar, desligar ou toogle (alternar).
Em hotkey combination você vai apertar no seu teclado qual botão vai ser usado para executar aquela ação no Home Assistant.
Para confirmar alguma configuração é só clicar em store quick action.
Como exemplo eu selecionei um Switch que é a luz do meu quarto, coloquei em Toogle para ligar ou desligar quando apertado o botão. Como botão escolhi o botão 1 do teclado numérico do meu teclado.
Para confirmar é só clicar em store quick action.
Pronto, criamos um atalho para uma ação no Home Assistant.
Pode perceber que agora em quick actions estão com um “OK” verde.
Vamos para a opção de sensores, clique em local sensors.
Clique em add new.
Em type você pode selecionar quais sensores vão aparecer no seu MQTT no Home Assistant, selecione um por um e clique em store sensor.
Temos várias opções de sensores como quantidade de memória usada, qual janela está ativa no PC ou temperatura do processador.
Após ter selecionado quais sensores do seu PC quer adicionar ao Home Assistant clque em store anda activate sensors (se apresentar algum erro faça com um sensor de cada vez).
Em sensors agora está com um “OK” verde.
Vamos para as opções de comandos que você pode dar para o seu PC pelo Home Assistant, clique em commands.
Clique em add new.
Em type tem a lista de comandos que é possível dar para o seu PC usando o Home Assistant. Para adicionar clique em store command.
Aqui temos a lista, podemos desligar, reiniciar ou colocar em modo de hibernação o PC.
Após ter selecionado é só clicar em store and activite commands.
Agora todas as opções estão com “OK” ver e é só clicar em hide para minimizar o programa.
Fica assim no Home Asssitant na integração com MQTT.
Pronto, já tem os sensores do seu PC no Home Assistant.
Os próximos passos são opcionais!
HASS.Agent Notifier
Agora vamos para as notificações!
Para isso vamos baixar um componente no HACS.
No HACS vá em Integrações.
Clique em “+ Explorar e baixar repositório” no canto direito inferior e procure hass.agent.
Ache o HASS.Agent Notifier
Clique em “Baixar esse repositório com HACS”.
Clique em Baixar.
Reinicie o Home Assistant.
Com ele reiniciado vá no configuration.yaml, nele vamos criar um notify para as notificações serem enviadas do seu Home Assistant para o seu PC. Em resource coloque o ip do seu computador, pode verificar no seu roteador o ip dele.
notify:
- name: "hass agent test device"
platform: hass_agent_notifier
resource: http://192.168.1.xxx:5115/notify
Reinicie o seu Home Assistant.
Com ele reiniciado vamos para o Node-RED para configurar as notificações!
Em Domain selecione notify.
Em Service selecione hass_agent_test_device
Em Data preencha dessa forma:
{
"message": "Escreva aqui sua mensagem!"
}
No seu Windows vai aparecer uma notificação.
É possível enviar imagens na notificação no PC, com a dica do colega @danielsaraujo consegui fazer da seguinte forma:
Em Data preencha dessa forma.
Lembrando que depois de “local” se deve colocar o caminho da imagem no config do seu Home Assistant.
{
"message": "Leandro, alguém chegou ou saiu!",
"title": "Aviso!",
"data": {
"image": "https://exemplo.duckdns.org:8123/local/imgs/cameras/camera_sala2.png"
}
}
No Windows vai aparecer assim:
HASS.Agent Media Player
Se quiser ter o seu pc como media player no Home Assistant é só seguir os passos abaixo!
Para isso vamos baixar um componente no HACS.
No HACS vá em Integrações.
Clique em “+ Explorar e baixar repositório” no canto direito inferior e procure hass.agent.
Ache o HASS.Agent Media Player.
Clique em “Baixar esse repositório com HACS”.
Clique em Baixar.
Reinicie o Home Assistant.
Com ele reiniciado vá no configuration.yaml, nele vamos criar um media player para visualizar do seu PC no seu Home Assistant. Na parte media_player coloque o código abaixo e em host coloque o ip do seu PC.
media_player:
- platform: hass_agent_mediaplayer
name: "hass agent"
host: 192.168.1.xxx
port: 5115
Reinicie o seu Home Assistant.
Pronto, agora vai ter um media player do seu PC no Home Assistant. Vídeos, músicas e outros vão aparecer nele.
Também é possível usar o TTS (text-to-speech) nele como nesse exemplo colocando ele no node-red!
Pronto, é isso.
Um abraço!
