Swiss public transport | RichPear Home dokumentace

01

Co integrace přidá

Swiss public transport patří mezi integrace pro doprava. Tato stránka popisuje přípravu, přidání do RichPear Home a následnou kontrolu, aby se integrace dala bezpečně používat v každodenním provozu.

V systému počítejte hlavně s oblastmi: entity podle konkrétní služby nebo zařízení. Skutečný seznam entit se vždy řídí tím, jaká zařízení, služby nebo účty jsou v instalaci připojené.

Kontrolní témata

Nastavení
Set up a connection
Akce
Defining a custom polling interval
Odebrání integrace

02

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

Před nastavením si připravte stabilní IP adresu nebo DNS jméno zařízení, správný port služby. U lokálních zařízení ověřte, že jsou ve stejné síti jako RichPear Home nebo že mezi segmenty sítě fungují potřebná pravidla. U cloudových služeb používejte samostatný servisní účet, pokud ho daná služba dovoluje.

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 a pokračujte přes stejné položky nastavení.

U názvů zařízení používejte místnost a typ zařízení. Později se tím zjednoduší dashboardy, hlasové ovládání i servisní zásahy.

03

Nastavení v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Swiss public transport a pokračujte podle zobrazeného průvodce. Pokud se zařízení objevilo automaticky mezi objevenými integracemi, otevřete ho odtud a jen doplňte požadované údaje.

Po uložení počkejte na první načtení dat. Některé služby vytvoří entity okamžitě, jiné je doplní až po prvním úspěšném dotazu, objevení zařízení v síti nebo dokončení párování.

Co zadávat pečlivě

YAML, port. Chyba v jednom z těchto údajů se obvykle projeví prázdným seznamem entit nebo opakovanou chybou v logu.

04

Kontrola entit a funkcí

Po přidání ověřte vytvořené entity a dostupné akce. U této integrace počítejte zejména s akcemi: Fetch connections. Každou akci nejdřív spusťte ručně s bezpečnými vstupy a až potom ji vložte do automatizace.

Otevřete detail integrace, projděte zařízení a přiřaďte jim oblasti. U senzorů sledujte jednotku a historii, u ovládacích entit ručně vyzkoušejte bezpečný stav zapnuto, vypnuto, otevřeno nebo zavřeno podle typu zařízení.

05

Použití v automatizacích

Automatizace stavte z malých kroků. Nejdřív použijte jednu entitu jako spouštěč, doplňte podmínky a až po ověření přidejte další akce nebo notifikace.

Začněte jednoduchou automatizací, která jen pošle oznámení nebo zapíše stav do logu. Až když se spouštění chová stabilně, přidejte akce, které něco fyzicky ovládají nebo posílají požadavky na externí službu.

06

Provoz a údržba

U cloudových služeb počítejte se změnami přihlášení, omezením počtu dotazů a výpadky mimo domácí síť. Ukládejte jen nezbytné údaje, pravidelně kontrolujte platnost tokenů a u důležitých automatizací nastavte chování pro případ, že služba krátkodobě neodpoví.

Jednou za čas otevřete detail integrace a porovnejte poslední aktualizaci entit s tím, co vidíte na zařízení nebo ve službě. Když měníte účet, token, port, síť nebo název zařízení, projděte také dashboardy a automatizace, protože mohou používat původní entity.

07

Řešení problémů

Když se integrace nepřidá nebo entity neukazují aktuální stav, ověřte dostupnost IP adresy, portu a případné blokování mezi VLAN; zkontrolujte účet, platnost tokenu a případné limity cloudové služby; po změně konfigurace zkontrolujte syntaxi a restartujte službu. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle názvu integrace swiss_public_transport.

Při opakovaných chybách integraci neodstraňujte hned. Nejdřív ověřte přístupové údaje, dostupnost služby a čas poslední aktualizace. Odebrání a nové přidání má smysl až tehdy, když je jasné, že je původní konfigurace chybná.