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

Apenas de leitura, por opção O Yardstick disponibiliza seis sensores ao Home Assistant e nada mais. Não há interruptores, botões nem controlos numéricos: pode acompanhar o seu robô no Home Assistant, mas não pode conduzi-lo a partir daí. Utilize os seis sensores para criar painéis e notificações.

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.

Se procura interruptores Versões anteriores desta página listavam entidades para lâminas, luzes, câmara, velocidade do soprador, altura das lâminas e outras funções. Essas entidades nunca foram disponibilizadas. A página descrevia uma integração que não chegou a ser desenvolvida e foi corrigida. As seis entidades acima são tudo o que existe.

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

A secção Home Assistant das Definições: um botão Adicionar ao Home Assistant, três passos de configuração do HACS, o endereço deste computador e uma nota a indicar que a integração é apenas de leitura.
Definições → Home Assistant. O botão adiciona o Yardstick ao HACS; o endereço por baixo é a alternativa para configuração manual.
  • 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.

Segurança e controlo Nada aqui permite iniciar, parar ou mover o robô. Crie notificações a partir dos sensores; esta integração não disponibiliza comandos do robô.

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."
Encontrar os nomes reais das suas entidades <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í.
Dois sistemas de alerta, não apenas um Se criar estas automações, considere desativar os alertas por ntfy ou email do Yardstick para as mesmas condições, caso contrário receberá dois avisos sobre a mesma situação. Os alertas do Yardstick e as suas automações do Home Assistant não comunicam entre si. Também falham de formas diferentes, o que por vezes é útil: os alertas do Yardstick continuam a funcionar quando o Home Assistant está indisponível, e estas automações continuam a funcionar se a conta de email do Yardstick deixar de aceitar inícios de sessão.
Continua a não ser possível mover o robô Tudo nesta página é apenas de leitura, incluindo as notificações. Uma automação pode avisar que o robô está preso; não pode ir buscá-lo.

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.

O Yardstick é uma ferramenta independente para robôs Yarbo. Não é afiliado da Yarbo Inc. nem conta com o seu aval. · © 2026 Yardstick Technologies LLC.