Integrace RichPear Home
RESTful Switch
RESTful Switch ovládá spínač přes HTTP API. Používá samostatné požadavky pro zapnutí, vypnutí a často i šablonu pro zjištění aktuálního stavu.
- Doména
rest- Kategorie
- Spínače
- Komunikace
- lokální dotazování
- Nastavení
- ruční konfigurace
Co návod pokrývá
Návod popisuje praktické zapojení integrace RESTful Switch v RichPear Home, přípravu zařízení nebo účtu, kontrolu entit a zásady bezpečného použití v automatizacích.
Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.
Hlavní témata
- Nastavení
- Použití šablon
- Příklad
- Spínač se šablonovanou hodnotou
Příprava
Připravte endpointy pro zapnutí, vypnutí a čtení stavu. Ověřte, zda zařízení potvrzuje stav, nebo jen přijímá příkazy.
Nastavení provádějte z účtu správce. Před přidáním si připravte názvy místností, očekávané entity a pravidla, kde se smí integrace používat.
Před prvním testem
Nejdřív ověřte dostupnost účtu, zařízení nebo služby mimo automatizace. Teprve potom zapojujte hodnoty do scén, notifikací nebo řízení domácnosti.
Nastavení v RichPear Home
Nastavte REST spínač v konfiguraci a ručně otestujte zapnutí i vypnutí. Potom ověřte, že stav entity odpovídá reálnému zařízení.
Po dokončení nastavení otevřete detail integrace v části Nastavení, Zařízení a služby. Zkontrolujte vytvořená zařízení, pojmenujte je podle skutečného umístění a vypněte entity, které nechcete používat.
Lokální adresa systému
Při práci v místní síti používejte http://rphome.local:8123. Pokud se lokální jméno nepřeloží, otevřete systém přes http://IP-ADRESA:8123.
Šablonovaný stav
Pokud API vrací stav, použijte šablonu a ošetřete chybovou odpověď. Pokud stav potvrdit nejde, nepoužívejte spínač pro kritické akce.
Po změně nastavení sledujte reálný stav zařízení nebo služby přímo v RichPear Home. Pokud se hodnota chová jinak, než čekáte, nejdřív opravte zdroj dat a teprve potom automatizaci.
Ovládání zařízení
Každý příkaz může ovlivnit fyzickou zátěž. Přidejte omezení podle času, přítomnosti nebo ručního potvrzení tam, kde je to potřeba.
Po změně nastavení sledujte reálný stav zařízení nebo služby přímo v RichPear Home. Pokud se hodnota chová jinak, než čekáte, nejdřív opravte zdroj dat a teprve potom automatizaci.
Síťové chyby
Při nedostupném API se spínač může chovat nejednoznačně. Automatizace musí počítat s nedostupností a nepokoušet se donekonečna opakovat příkaz.
Po změně nastavení sledujte reálný stav zařízení nebo služby přímo v RichPear Home. Pokud se hodnota chová jinak, než čekáte, nejdřív opravte zdroj dat a teprve potom automatizaci.
Kontrola po nasazení
Po nastavení integrace RESTful Switch sledujte alespoň jeden běžný provozní cyklus. U cloudových služeb počítejte se zpožděním, u lokálních zařízení ověřte chování po restartu routeru, zařízení i RichPear Home.
Do automatizací vkládejte jen hodnoty, které jste viděli v reálném provozu. Důležité akce doplňte podmínkou dostupnosti entity a rozumnou prodlevou, aby jednorázový výpadek nespustil chybnou reakci.
Před předáním běžným uživatelům ověřte názvy entit, práva uživatelů a chování při nedostupnosti služby. U zařízení, která něco fyzicky spínají nebo řídí, ponechte dostupné i ruční ovládání mimo automatizace.
Hotový provozní test
Integrace je připravená pro běžné použití, když se entity aktualizují, názvy odpovídají skutečným zařízením a automatizace mají ošetřený výpadek nebo nedostupný stav.