Tuki / Robotin ohjaaminen / Home Assistant Hae ohjeista
Home Assistant: seuraa Yarboa omasta hallintanäkymästäsi
Yardstick lisää robottisi Home Assistantiin omalla integraatiollaan, jonka Home Assistant löytää verkostasi automaattisesti. Integraatio tarjoaa kuusi vain luettavaa anturia: akku, verkkoyhteys, lataus, toiminta, RTK-signaali ja vikakoodi. Mikään niistä ei voi liikuttaa robottia.
Mitä saat
Yksi laite robottia kohti, kuusi entiteettiä kussakin. Kaikki ovat vain luettavia.
sensor.<robot>_battery
Akku. Varaustaso prosentteina. Anturin laiteluokka on akku, joten Home Assistant näyttää oikean kuvakkeen ja värin.
binary_sensor.<robot>_online
Verkkoyhteys. Kertoo, saako Yardstick robotilta tietoja. Jos Yardstick itse pysähtyy, Home Assistant merkitsee automaattisesti kaikki entiteetit tilaan Ei saatavilla sen sijaan, että näyttäisi vanhentuneita lukuja.
binary_sensor.<robot>_charging
Lataus. Päällä, kun robotti on latausasemalla ja latautuu.
sensor.<robot>_activity
Toiminta. Kertoo sanallisesti, mitä robotti tekee juuri nyt.
sensor.<robot>_rtk_signal
RTK-signaali. Paikannuksen laatu. Auttaa havaitsemaan, jos tarkka paikannus katoaa pihalla.
sensor.<robot>_fault_code
Vikakoodi. Laitteen viimeksi ilmoittama numero. Katso toimintaohjeet virhekoodisivulta.
Miten yhteys toimii
Home Assistant viestii Yardstickin kanssa, ja Yardstick viestii robottisi kanssa. Ensimmäinen yhteys kulkee omassa verkossasi. Toinen kulkee Yarbo-tilisi kautta samalla tavalla kuin Yarbo-sovelluksen yhteys robottiin. Anturien tiedot ovat siis yhtä ajantasaisia kuin Yardstickin omalla sivulla, ja ne tarvitsevat saman internetyhteyden kuin Yardstick.
HACSin kautta asennettava integraatio
Yardstick-integraatio asennetaan HACSista, Home Assistantin yhteisön ylläpitämästä kaupasta. MQTT-välittäjää ei tarvitse ylläpitää, eikä configuration.yaml-tiedostoon tarvitse lisätä mitään.
Löytyy automaattisesti
Yardstick ilmoittaa itsestään verkossasi, joten Home Assistant näyttää ilmoituksen "Yardstick löydetty" aivan kuten älylampustakin. Jos verkkosi estää tämän, voit lisätä integraation käsin Yardstickin näyttämällä osoitteella.
Yksi laite robottia kohti
Jokainen Yarbo-tilisi robotti näkyy omana laitteenaan sille antamallasi nimellä. Sen alla näkyvät kuusi entiteettiä.
Käyttöönotto
Asenna HACS
Home Assistantin yhteisökauppa tarvitsee ottaa käyttöön vain kerran. Home Assistant OS -laitteessa se löytyy kohdasta Asetukset, Lisäosat, Get HACS.
Paina Lisää Home Assistantiin
Avaa Yardstickissä Asetukset → Home Assistant ja paina painiketta. Home Assistant avautuu, ja Yardstick on valmiina HACSissa. Napsauta Lataa ja käynnistä Home Assistant uudelleen, kun se pyytää sitä.
Määritä
Home Assistant näyttää ilmoituksen Yardstick löydetty. Napsauta Määritä, niin robottisi tulevat näkyviin laitteina. Jos ilmoitusta ei näy, lisää integraatio käsin kyseisellä Asetukset-sivulla näkyvällä osoitteella.
Ilmoitukset puhelimeen
Tämä on tärkein syy yhdistää Yardstick Home Assistantiin. Yardstickillä on omat hälytyksensä, jotka voi lähettää puhelimeen ntfyn kautta tai sähköpostiin. Kun robotti on Home Assistantissa tavallisina antureina, voit kuitenkin lähettää ilmoitukset Home Assistantilla. Silloin ne tavoittavat kaikki kohteet, joihin Home Assistant jo osaa lähettää ilmoituksia.
Tästä on eniten hyötyä Androidissa, sillä Home Assistantin mobiilisovellus on todennäköisesti jo puhelimessasi. Näin tarvitset yhden sovelluksen vähemmän kuin ottamalla ntfyn käyttöön. Sama toimii aivan samalla tavalla iPhonessa. Koska luot automaation itse, hälytys voi myös tehdä muutakin kuin näkyä ruudulla: kuulua kaiuttimesta, vaihtaa lampun punaiseksi, mennä kaikille kotona oleville tai ilmoittaa sinulle vain tiettyinä kellonaikoina.
Home Assistantin mobiilisovelluksen on oltava asennettuna, ja sinun on oltava kirjautuneena siihen. Silloin saat laitteen mukaan nimetyn ilmoituspalvelun, esimerkiksi notify.mobile_app_pixel_9. Löydät oman palvelusi Home Assistantin kohdasta Kehittäjätyökalut → Toiminnot.
Vikakoodi ilmestyy
Tämä kannattaa ottaa käyttöön ensimmäisenä. sensor.<robot>_fault_code on tyhjä, kun kaikki on kunnossa. Jos siihen ilmestyy jotain, robotti ilmoittaa ongelmasta.
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 }}."
Robotti ei enää vastaa
binary_sensor.<robot>_online vaihtuu pois päältä, kun Yardstick ei enää saa robotilta tietoja. Aseta ilmoitukselle muutaman minuutin viive, jotta lyhyt yhteyskatkos pihalla ei turhaan herätä puhelintasi.
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."
Työ valmistui tai akun varaus on vähissä
sensor.<robot>_activity ja sensor.<robot>_battery kattavat tavalliset arjen tarpeet. Akun varaustaso on tavallinen prosenttiluku, joten numeerinen laukaisin toimii odotetulla tavalla.
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> on robotille antamasi nimi pienillä kirjaimilla ja alaviivoilla eroteltuna. Esimerkiksi Front Yard -nimisen robotin akkuanturi on sensor.front_yard_battery. Voit myös tarkistaa nimet suoraan: avaa Home Assistantissa Asetukset → Laitteet & palvelut → Yardstick ja avaa laite. Kaikki entiteetit näkyvät luettelossa tarkoilla nimillään. Kopioi nimet sieltä.Jos jokin ei toimi
Laitetta ei tule näkyviin
Tarkista, että integraatio on ladattu HACSissa ja Home Assistant on käynnistetty uudelleen. Jos ilmoitusta "Yardstick löydetty" ei näy, lisää integraatio käsin kohdasta Asetukset → Laitteet & palvelut → Lisää integraatio. Käytä osoitetta, joka näkyy Yardstickin kohdassa Asetukset → Home Assistant. Home Assistantin ja Yardstickin on saatava yhteys toisiinsa verkossasi.
Kaikki näkyy tilassa Ei saatavilla
Home Assistant ei saa yhteyttä Yardstickiin: Yardstick ei ole käynnissä tai sen osoite on muuttunut. Tarkista osoite kohdasta Asetukset → Home Assistant.
Arvot eivät näytä päivittyvän
Tarkista, että Yardstick tallentaa edelleen ja että olet yhä kirjautuneena kohdassa Asetukset → Oma Yarbo. Home Assistant näyttää vain Yardstickin viimeksi saamat tiedot, ja Yardstick saa robotin tiedot Yarbo-tilisi kautta.