OpenWrt (ubus)

Co integrace přidá

OpenWrt (ubus) patří do oblasti detekce přítomnosti. Návod popisuje přípravu, přidání do RichPear Home a kontrolu výsledných entit.

V RichPear Home počítejte hlavně s oblastmi: detekce přítomnosti. Skutečný rozsah entit se řídí konkrétním zařízením, účtem, firmwarem, verzí služby a oprávněním.

This is a presence detection scanner for OpenWrt using ubus .

The integration should be configured on OpenWrt devices providing wireless access points, not on devices acting only as routers.

Before this scanner can be used, you have to install the ubus RPC packages on OpenWrt (versions older than 18.06.x do not require the uhttpd-mod-ubus package):

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

Před přidáním si připravte IP adresu, název hostitele, lokální síť, firewall a stabilní DHCP rezervaci, cloudový účet, token, API klíč nebo OAuth autorizaci. U zařízení, která ovládají fyzický stav domácnosti, si předem rozmyslete bezpečné názvy a oblasti.

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

Tato integrace se nastavuje ručně v konfiguraci. Doplňte požadované položky, restartujte RichPear Home a potom ověřte integraci v Nastavení → Zařízení a služby.

apk update apk add rpcd-mod-file uhttpd-mod-ubus

Po uložení počkejte na první načtení dat. Některé entity vzniknou hned, jiné až po prvním dotazu, probuzení zařízení, dokončení autorizace nebo restartu služby.

Kontrola entit a funkcí

Po přidání zkontrolujte vytvořená zařízení, entity, dostupné atributy a čas poslední aktualizace. Každou ovládací entitu nejdřív otestujte ručně.

Otevřete detail integrace, projděte zařízení a přiřaďte je do správných oblastí. U senzorů sledujte jednotku a historii, u ovládacích entit ručně vyzkoušejte bezpečný stav.

Použití v automatizacích

Začněte oznámením nebo zápisem stavu. Akce, které mění stav zařízení, přidejte až po ručním ověření chování.

Pokud integrace nabízí akce nebo služby, spusťte je nejdřív ručně v bezpečném kontextu a až potom je vložte do automatizace.

Provoz a údržba

Po změně účtu, tokenu, firmware, sítě nebo konfigurace zkontrolujte detail integrace, názvy entit, dashboardy a navazující automatizace.

U cloudových služeb sledujte limity API a platnost autorizace. U lokálních zařízení pravidelně kontrolujte dostupnost v síti, kvalitu spojení, stav baterií a čas poslední aktualizace.

Řešení problémů

Když integrace nefunguje podle očekávání, ověřte IP adresu, port, DNS, mDNS, VLAN, firewall a dostupnost zařízení ze stejné sítě, platnost účtu, tokenu, API klíče, OAuth autorizace a dostupnost cloudové služby, syntaxi konfigurace, odsazení, restart a chyby v logu po startu. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény ubus.

Integraci neodstraňujte jako první krok. Nejdřív ověřte přístupové údaje, síťovou dostupnost, podporovaný model, logy a poslední úspěšnou aktualizaci.