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.

Vain luku, tarkoituksella Yardstick tarjoaa Home Assistantille kuusi anturia eikä muuta. Mukana ei ole kytkimiä, painikkeita eikä numeroarvojen säätimiä. Voit seurata robottiasi Home Assistantista, mutta et ohjata sitä sieltä. Näiden kuuden anturin avulla voit luoda hallintanäkymiä ja ilmoituksia.

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.

Jos etsit kytkimiä Tämän sivun aiemmissa versioissa lueteltiin entiteettejä muun muassa terille, valoille, kameralle, puhaltimen nopeudelle ja leikkuukorkeudelle. Niitä ei koskaan julkaistu. Sivu kuvasi integraatiota, jota ei ollut toteutettu, ja teksti on nyt korjattu. Integraatio sisältää vain yllä mainitut kuusi anturia.

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

Asetusten Home Assistant -osio: Lisää Home Assistantiin -painike, kolme HACSin käyttöönottovaihetta, tämän tietokoneen osoite ja maininta siitä, että integraatio on vain luettava.
Asetukset → Home Assistant. Painike lisää Yardstickin HACSiin. Sen alla olevaa osoitetta voi käyttää, jos integraatio täytyy lisätä käsin.
  • 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.

Turvallisuus ja robotin hallinta Mikään tässä integraatiossa ei voi käynnistää, pysäyttää tai liikuttaa robottia. Luo ilmoituksia anturien perusteella. Integraatio ei tarjoa robotin ohjauskomentoja.

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."
Omien entiteettien nimien löytäminen <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ä.
Kaksi hälytysjärjestelmää Jos luot nämä automaatiot, harkitse Yardstickin omien ntfy- tai sähköpostihälytysten poistamista käytöstä samoissa tilanteissa. Muuten saat samasta asiasta kaksi ilmoitusta. Yardstickin hälytykset ja Home Assistant -automaatiosi eivät tiedä toisistaan. Myös niiden häiriötilanteet eroavat toisistaan, mistä on joskus hyötyä: Yardstickin hälytykset toimivat edelleen, kun Home Assistant ei ole käytettävissä, ja nämä automaatiot toimivat edelleen, jos Yardstickin sähköpostitili lakkaa hyväksymästä kirjautumisia.
Robottia ei edelleenkään voi liikuttaa Kaikki tällä sivulla on vain luettavaa, myös ilmoitukset. Automaatio voi kertoa robotin olevan jumissa, mutta se ei voi hakea robottia pois.

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.

Yardstick on riippumaton työkalu Yarbo-roboteille. Se ei ole sidoksissa Yarbo Inc. -yhtiöön eikä yhtiön suosittelema. · © 2026 Yardstick Technologies LLC.