Apoio / Controlar o robô / Home Assistant Pesquisar na ajuda
Home Assistant: acompanhar o Yarbo no seu próprio painel
O Yardstick adiciona o seu robô ao Home Assistant através de uma integração própria, que o Home Assistant encontra automaticamente na sua rede. São seis sensores apenas de leitura: bateria, ligação, carregamento, atividade, sinal RTK e código de avaria. Nada aqui permite mover o robô.
O que inclui
Um dispositivo por robô, com seis entidades. Todas são apenas de leitura.
sensor.<robot>_battery
Bateria. Nível de carga, em percentagem. Tem a classe de dispositivo de bateria, para que o Home Assistant apresente o ícone e a cor corretos.
binary_sensor.<robot>_online
Ligado. Indica se o Yardstick está a receber dados do robô. Se o próprio Yardstick parar, o Home Assistant marca automaticamente todas as entidades como indisponíveis, em vez de mostrar valores desatualizados.
binary_sensor.<robot>_charging
A carregar. Ativo enquanto o robô está na base a carregar.
sensor.<robot>_activity
Atividade. O que está a fazer neste momento, descrito por palavras.
sensor.<robot>_rtk_signal
Sinal RTK. Qualidade do posicionamento. Útil para detetar uma perda de posicionamento no jardim.
sensor.<robot>_fault_code
Código de avaria. O último número comunicado pela máquina. Consulte a página de códigos de erro para saber o que fazer.
Como se estabelece a ligação
O Home Assistant comunica com o Yardstick e o Yardstick comunica com o seu robô. A primeira ligação faz-se na sua rede local. A segunda passa pela sua conta Yarbo, da mesma forma que a aplicação Yarbo chega ao robô. Por isso, os sensores estão tão atualizados como a própria página do Yardstick e precisam da mesma ligação à Internet que o Yardstick.
Uma integração instalada através do HACS
A integração Yardstick está disponível no HACS, a loja da comunidade do Home Assistant. Não é necessário executar um intermediário MQTT nem acrescentar nada ao configuration.yaml.
Detetado automaticamente
O Yardstick anuncia a sua presença na rede, pelo que o Home Assistant apresenta "Yardstick detetado", tal como faz com uma lâmpada inteligente. Se a sua rede bloquear essa deteção, adicione-o manualmente com o endereço apresentado pelo Yardstick.
Um dispositivo por robô
Cada robô da sua conta Yarbo aparece como um dispositivo próprio, com o nome que lhe atribuiu e as seis entidades associadas.
Como ativar
Ter o HACS instalado
A loja da comunidade do Home Assistant, que só precisa de configurar uma vez. Num equipamento com Home Assistant OS, encontra-se em Definições, Complementos, Obter HACS.
Premir Adicionar ao Home Assistant
No Yardstick, abra Definições → Home Assistant e prima o botão. Este abre o seu Home Assistant com o Yardstick pronto no HACS. Clique em Transferir e reinicie o Home Assistant quando lhe for pedido.
Configurar
O Home Assistant apresenta Yardstick detetado. Clique em Configurar e os seus robôs aparecem como dispositivos. Se não aparecer, adicione a integração manualmente com o endereço apresentado nessa página das Definições.
Receber notificações no telemóvel
Esta é a principal razão para ligar o Yardstick ao Home Assistant. O Yardstick tem os seus próprios alertas, que podem chegar ao telemóvel através do ntfy ou à sua caixa de email. Mas, assim que o robô aparece no Home Assistant como sensores normais, pode enviar a notificação através do Home Assistant, para qualquer destino que este já consiga alcançar.
Isto é especialmente útil no Android, onde é muito provável que a aplicação complementar do Home Assistant já esteja no seu telemóvel, poupando a instalação de mais uma aplicação para configurar o ntfy. Funciona exatamente da mesma forma num iPhone. E, como é o utilizador que cria a automação, o alerta pode fazer mais do que aparecer num ecrã: ser anunciado numa coluna, tornar uma lâmpada vermelha, chegar a todas as pessoas da casa ou incomodar apenas em determinados horários.
É necessário ter a aplicação complementar instalada e com sessão iniciada, o que disponibiliza um serviço de notificação com o nome do dispositivo, como notify.mobile_app_pixel_9. O Home Assistant apresenta o seu em Ferramentas de programador → Ações.
Surge um código de avaria
É a primeira notificação que vale a pena configurar. sensor.<robot>_fault_code está vazio quando tudo está bem, pelo que qualquer valor que apareça significa que o robô está a comunicar um problema.
automation:
- alias: "Yarbo reported a fault"
trigger:
- platform: state
entity_id: sensor.<robot>_fault_code
condition:
- condition: template
value_template: "{{ trigger.to_state.state not in ['', 'unknown', 'unavailable', 'none'] }}"
action:
- action: notify.mobile_app_<your_phone>
data:
title: "Yarbo has stopped"
message: "Fault code {{ trigger.to_state.state }}."
O robô deixou de comunicar
binary_sensor.<robot>_online fica inativo quando o Yardstick deixa de receber dados do robô. Configure um intervalo de alguns minutos antes de receber o aviso, para que uma breve falha no jardim não faça o telemóvel tocar.
automation:
- alias: "Yarbo went offline"
trigger:
- platform: state
entity_id: binary_sensor.<robot>_online
to: "off"
for: "00:10:00"
action:
- action: notify.mobile_app_<your_phone>
data:
message: "No word from Yarbo for ten minutes."
O robô terminou ou a bateria está fraca
sensor.<robot>_activity e sensor.<robot>_battery abrangem as situações do dia a dia. A bateria é uma percentagem normal, pelo que um acionador numérico funciona como seria de esperar.
automation:
- alias: "Yarbo battery is low"
trigger:
- platform: numeric_state
entity_id: sensor.<robot>_battery
below: 20
action:
- action: notify.mobile_app_<your_phone>
data:
message: "Yarbo is down to {{ states('sensor.<robot>_battery') }} percent."
<robot> é o nome que atribuiu ao robô, em minúsculas e com sublinhados, pelo que um robô chamado Front Yard dá origem a sensor.front_yard_battery. Ou evite adivinhar: no Home Assistant, aceda a Definições → Dispositivos & serviços → Yardstick, abra o dispositivo e verá todas as entidades listadas com o nome exato. Copie os nomes a partir daí.Se algo não estiver bem
Não aparece nenhum dispositivo
Verifique se a integração foi transferida no HACS e se o Home Assistant foi reiniciado. Se "Yardstick detetado" nunca aparecer, adicione a integração manualmente em Definições → Dispositivos & serviços → Adicionar integração, com o endereço apresentado no Yardstick em Definições → Home Assistant. O Home Assistant e o Yardstick têm de conseguir comunicar entre si na sua rede.
Tudo aparece como indisponível
O Home Assistant não consegue comunicar com o Yardstick: este não está em execução ou o seu endereço mudou. Verifique o endereço em Definições → Home Assistant.
Os valores parecem não atualizar
Verifique se o próprio Yardstick continua a gravar e se a sessão continua iniciada em Definições → O seu Yarbo. O Home Assistant apenas apresenta os últimos dados recebidos pelo Yardstick, e o Yardstick recebe os dados do robô através da sua conta Yarbo.