SpaceAPI | RichPear Home dokumentace

01

Co integrace přidá

SpaceAPI patří mezi integrace pro sociální stav. 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í
Accessing the API
Příklady
Related topics

02

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

Před nastavením si připravte uživatelské jméno a heslo, 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

Tato integrace se typicky připravuje ručně. Upravte odpovídající konfiguraci, restartujte RichPear Home a po startu ověřte, že se vytvořily očekávané entity. Do průvodce v nastavení se vracejte jen tam, kde ho instalace skutečně nabízí.

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ě

uživatelské jméno a heslo, YAML, port, IP adresa nebo host. 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 dokončení nastavení zkontrolujte vytvořené entity podle konkrétní služby nebo zařízení. Každou důležitou entitu otevřete v detailu, ověřte aktuální stav, jednotku, oblast a historii změn. Teprve potom ji používejte jako spouštěč nebo podmínku.

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 spaceapi.

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á.