Autoskope

Ukázka v RichPear Home

Screenshoty ukazují české rozhraní RichPear Home při vyhledání integrace a při prvním bezpečném kroku nastavení.

Co integrace přidá

Integrace načítá vozidla z účtu Autoskope a pro každé registrované vozidlo vytvoří sledovací entitu. Ta ukazuje aktuální polohu vozidla a zónu, ve které se vozidlo nachází.

Autoskope je určené pro GPS trackery a cloudové služby Autoskope. Integrace pracuje se všemi hardwarovými zařízeními nabízenými Autoskope, pokud jsou aktivní a přiřazená k účtu, kterým se přihlašujete.

V RichPear Home nejde o ovládání vozidla. Integrace nepřidává vlastní služby ani akce pro změnu stavu zařízení; slouží hlavně pro polohu, zóny a automatizace navázané na příjezd nebo odjezd.

Příprava před přidáním

Před přidáním potřebujete aktivní účet Autoskope a alespoň jedno vozidlo registrované v portálu nebo aplikaci Autoskope. Připravte si uživatelské jméno a heslo k tomuto účtu.

Pro většinu instalací ponechte výchozí API adresu https://portal.autoskope.de. Jinou adresu hostitele měňte jen tehdy, když používáte vlastní nebo white-label portál Autoskope a víte, jakou API adresu má integrace použít.

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.

Nastavení v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci a vyhledejte Autoskope. Průvodce požádá o uživatelské jméno a heslo k účtu Autoskope.

V rozšířeném nastavení je pole Host pro API endpoint. Pokud nepoužíváte zvláštní portál, ponechte výchozí hodnotu https://portal.autoskope.de.

Po odeslání formuláře RichPear Home ověří, že se k API dá připojit a že přihlašovací údaje platí. Pokud ověření projde, vytvoří se položka integrace a během prvního načtení se založí sledovací entity pro vozidla dostupná v účtu.

Entity a atributy

Pro každé vozidlo vznikne jedna entita typu device_tracker. Stav entity vychází z polohy vozidla vůči zónám: typicky home, not_home nebo název vlastní zóny. Když nejsou dostupná polohová data, entita se může zobrazit jako nedostupná.

Entita poskytuje polohové atributy latitude, longitude, gps_accuracy a source_type. RichPear Home podle nich umí vozidlo zobrazit na mapě a vyhodnocovat příchod nebo odchod ze zón.

V detailu zařízení zkontrolujte název vozidla, model a sériové označení, pokud je účet Autoskope vrací. Názvy upravujte tak, aby byly bezpečné pro automatizace, například Auto, Dodávka nebo Motorka.

Použití v automatizacích

Nejbezpečnější začátek je oznámení při změně zóny. Automatizace jen čte stav sledovací entity a nemění nic na vozidle ani v účtu Autoskope.

alias: Upozornit pri prijezdu vozidla domu
triggers:
  - trigger: state
    entity_id: device_tracker.moje_auto
    to: "home"
actions:
  - action: notify.send_message
    target:
      entity_id: notify.muj_telefon
    data:
      message: "Vozidlo dorazilo domu."

Před použitím v důležitých scénářích sledujte několik běžných jízd. Ověříte tím, jak rychle se stav zóny mění a zda poloha odpovídá skutečnému parkování.

Provoz a aktualizace dat

Integrace se na API Autoskope dotazuje přibližně každých 60 sekund. Změna polohy nebo stavu se proto v RichPear Home může projevit se zpožděním až kolem jedné minuty.

Pokud Autoskope během běžné aktualizace odmítne uložené přihlašovací údaje, RichPear Home vyžádá nové ověření hesla. Při krátkém výpadku API nebo internetu se aktualizace obnoví po návratu spojení.

Po změně hesla v účtu Autoskope, změně API hostitele nebo výměně trackeru zkontrolujte detail integrace, vytvořená vozidla a navazující automatizace.

Řešení problémů

Když průvodce hlásí chybu připojení, ověřte API adresu hostitele, dostupnost internetu, DNS a firewall. Pro běžné účty má host zůstat https://portal.autoskope.de.

Když průvodce odmítne přihlášení, ověřte uživatelské jméno a heslo přímo v portálu nebo aplikaci Autoskope. Uživatel se v integraci ukládá malými písmeny, proto se vyhněte zbytečným mezerám a překlepům.

Když se po přidání nezobrazí vozidla, zkontrolujte v účtu Autoskope, že jsou vozidla aktivní, správně registrovaná a přiřazená ke stejnému účtu. V Nastavení → Systém → Logy hledejte chyby podle domény autoskope.

Odebrání integrace

Integraci odeberete standardně v Nastavení → Zařízení a služby: otevřete kartu Autoskope, vyberte konkrétní položku integrace a v nabídce zvolte odstranění.

Vozidla, která odeberete z účtu Autoskope, se při dalším aktualizačním cyklu automaticky odstraní i z RichPear Home. Po odebrání zkontrolujte dashboardy, mapy a automatizace, které používaly staré entity device_tracker.