Podpora / Ovládání robota / Home Assistant Hledat v nápovědě
Home Assistant: sledujte Yarbo na vlastním přehledovém panelu
Yardstick přidá vašeho robota do Home Assistant pomocí vlastní integrace, kterou Home Assistant ve vaší síti sám najde. Nabízí šest senzorů pouze pro čtení: baterie, online, nabíjení, činnost, signál RTK a kód poruchy. Nic z toho nedokáže robota uvést do pohybu.
Co získáte
Jeden robot se zobrazí jako jedno zařízení se šesti entitami. Všechny jsou pouze pro čtení.
sensor.<robot>_battery
Baterie. Úroveň nabití v procentech. Má přiřazenou třídu zařízení baterie, takže Home Assistant zobrazuje správnou ikonu a barvu.
binary_sensor.<robot>_online
Online. Udává, zda Yardstick dostává zprávy od robota. Pokud přestane běžet samotný Yardstick, Home Assistant automaticky označí všechny entity jako nedostupné, aby nezobrazoval zastaralé hodnoty.
binary_sensor.<robot>_charging
Nabíjení. Zapnuto, když je robot ve stanici a nabíjí se.
sensor.<robot>_activity
Činnost. Slovní popis toho, co robot právě dělá.
sensor.<robot>_rtk_signal
Signál RTK. Kvalita určování polohy. Pomůže vám zjistit, že robot na zahradě ztratil přesnou polohu.
sensor.<robot>_fault_code
Kód poruchy. Číslo, které robot naposledy nahlásil. Jak s ním naložit, zjistíte na stránce chybových kódů.
Jak připojení funguje
Home Assistant komunikuje s aplikací Yardstick a Yardstick komunikuje s vaším robotem. První spojení probíhá ve vaší místní síti. Druhé vede přes váš účet Yarbo, stejně jako se k robotovi připojuje aplikace Yarbo. Údaje senzorů jsou tedy stejně aktuální jako údaje na stránce Yardstick a vyžadují stejné připojení k internetu jako samotný Yardstick.
Integrace instalovaná přes HACS
Integraci Yardstick získáte v HACS, komunitním obchodě pro Home Assistant. Nemusíte provozovat MQTT broker ani nic přidávat do configuration.yaml.
Automatické vyhledání
Yardstick se ohlásí ve vaší síti, takže Home Assistant zobrazí „Nalezen Yardstick“, podobně jako u chytré žárovky. Pokud to vaše síť blokuje, přidáte integraci ručně pomocí adresy zobrazené v aplikaci Yardstick.
Jedno zařízení pro každého robota
Každý robot ve vašem účtu Yarbo se zobrazí jako samostatné zařízení se jménem, které jste mu dali, a se šesti entitami.
Jak integraci zapnout
Nainstalujte HACS
Komunitní obchod pro Home Assistant stačí nastavit jednou. Na zařízení se systémem Home Assistant OS ho najdete v části Nastavení, Doplňky, Get HACS.
Stiskněte Přidat do Home Assistant
V aplikaci Yardstick otevřete Nastavení → Home Assistant a stiskněte tlačítko. Otevře se váš Home Assistant s integrací Yardstick připravenou v HACS. Klikněte na Stáhnout a po výzvě restartujte Home Assistant.
Nastavit
Home Assistant zobrazí Nalezen Yardstick. Klikněte na Nastavit a vaši roboti se zobrazí jako zařízení. Pokud se integrace neobjeví, přidejte ji ručně pomocí adresy uvedené na této stránce Nastavení.
Oznámení na telefonu
Právě kvůli tomu lidé Yardstick s Home Assistant propojují nejčastěji. Yardstick má vlastní upozornění, která mohou přes ntfy přijít na telefon nebo do e-mailu. Jakmile je ale robot v Home Assistant dostupný jako běžné senzory, můžete oznámení posílat přímo z Home Assistant, kamkoli je už umí doručovat.
To oceníte hlavně na systému Android, kde už nejspíš máte doprovodnou aplikaci Home Assistant v telefonu. Oproti nastavení ntfy tak potřebujete o jednu aplikaci méně. Na iPhonu to funguje úplně stejně. A protože si automatizaci vytváříte sami, upozornění nemusí jen vyskočit na obrazovce: může zaznít z reproduktoru, rozsvítit lampu červeně, přijít všem v domácnosti nebo vás vyrušit jen v určitých hodinách.
Musíte mít nainstalovanou doprovodnou aplikaci a být v ní přihlášeni. Tím získáte službu pro oznámení pojmenovanou podle zařízení, například notify.mobile_app_pixel_9. Tu svou najdete v Home Assistant v části Vývojářské nástroje → Akce.
Objeví se kód poruchy
Toto oznámení se vyplatí nastavit jako první. Když je vše v pořádku, sensor.<robot>_fault_code je prázdný. Jakákoli hodnota v něm tedy znamená, že robot hlásí problém.
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 }}."
Robot se odmlčel
Senzor binary_sensor.<robot>_online se vypne, když Yardstick přestane dostávat zprávy od robota. Nastavte před odesláním oznámení prodlevu několika minut, aby krátký výpadek spojení na zahradě zbytečně nerozsvěcel telefon.
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."
Robot dokončil práci nebo má slabou baterii
Senzory sensor.<robot>_activity a sensor.<robot>_battery pokryjí běžné každodenní situace. Stav baterie je běžná procentní hodnota, takže číselný spouštěč funguje tak, jak byste čekali.
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> je jméno, které jste robotovi dali, převedené na malá písmena s podtržítky. Robot pojmenovaný Front Yard tedy má entitu sensor.front_yard_battery. Názvy ale nemusíte odhadovat: v Home Assistant přejděte do Nastavení → Zařízení & služby → Yardstick a otevřete zařízení. Uvidíte seznam všech entit s přesnými názvy, které odtud můžete zkopírovat.Když něco nefunguje správně
Nezobrazuje se žádné zařízení
Zkontrolujte, že jste integraci stáhli v HACS a restartovali Home Assistant. Pokud se „Nalezen Yardstick“ vůbec neobjeví, přidejte integraci ručně v části Nastavení → Zařízení & služby → Přidat integraci pomocí adresy zobrazené v aplikaci Yardstick v části Nastavení → Home Assistant. Home Assistant a Yardstick musí mít možnost spolu ve vaší síti komunikovat.
Vše se zobrazuje jako nedostupné
Home Assistant se nemůže spojit s aplikací Yardstick: buď neběží, nebo se změnila její adresa. Zkontrolujte adresu v části Nastavení → Home Assistant.
Hodnoty se zřejmě neaktualizují
Zkontrolujte, zda Yardstick stále pořizuje záznam a zda jste v části Nastavení → Vaše Yarbo stále přihlášeni. Home Assistant zobrazuje vždy jen poslední údaje, které Yardstick přijal. Yardstick je od robota získává přes váš účet Yarbo.