Integrace RichPear Home

Custom panel

The Custom panel integration allows you to write your own panels in JavaScript and add them to RichPear Home.

Doména: panel_custom
Kategorie: rozhraní
Komunikace: podle konfigurace
Nastavení: ruční konfigurace
Kvalita: internal

Co integrace přidá

The Custom panel integration allows you to write your own panels in JavaScript and add them to RichPear Home.

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

The Custom panel integration allows you to write your own panels in JavaScript and add them to RichPear Home.

To enable customized panels in your installation, add the following to your configuration.yaml The configuration.yaml file is the main configuration file for RichPear Home.

# Example configuration.yaml entry panel_custom : - name : my-panel sidebar_title : TodoMVC sidebar_icon : mdi:work url_path : my-todomvc module_url : /local/my-panel.js config : who : world Tip

Kontrolní témata

Související témata

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

Názvy zařízení nastavujte podle místnosti a účelu. Později se tím zjednoduší dashboardy, servisní zásahy i automatizace.

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.

# Example configuration.yaml entry panel_custom : - name : my-panel sidebar_title : TodoMVC sidebar_icon : mdi:work url_path : my-todomvc module_url : /local/my-panel.js config : who : world

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.

Po nastavení

Přejmenujte entity česky a srozumitelně.
Přiřaďte zařízení do oblastí.
Ověřte dostupnost po restartu RichPear Home.
Teprve potom entity použijte ve scénách, skriptech nebo automatizacích.

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ě, syntaxi konfigurace, odsazení, restart a chyby v logu po startu. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény panel_custom.

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