Integrace RichPear Home

Template

Template vytváří vlastní entity z šablon. Umožňuje převést existující stavy na nové senzory, spínače, světla, alarmy, počasí nebo další entity podle logiky domácnosti.

Doména
template
Kategorie
alarmový panel, binární senzory, tlačítka, kryty a žaluzie, události, ventilátory, pomocník, obraz, světla, zámky, číselné entity, výběry, senzory, spínače, aktualizace, vysavače, počasí
Komunikace
lokální komunikace
Nastavení
interní komponenta nebo pomocník
Kvalita
internal
01

Co integrace přidá

Template vytváří vlastní entity z šablon. Umožňuje převést existující stavy na nové senzory, spínače, světla, alarmy, počasí nebo další entity podle logiky domácnosti.

V RichPear Home počítejte hlavně s oblastmi: alarmový panel, binární senzory, tlačítka, kryty, vrata nebo žaluzie, události, ventilátory, obrazové entity, světla, zámky, číselné prvky, výběrové prvky, senzory, spínače, aktualizace, vysavače, počasí. Skutečný rozsah se řídí konkrétním účtem, zařízením, firmwarem a oprávněním.

Kontrolní témata

  1. Nastavení
  2. Konfigurace v YAML
  3. Common Device Configuration Options
  4. Alarm Control Panel
  5. Binary Sensor
  6. Button
  7. Cover
  8. Event
  9. Fan
  10. Image
02

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

Připravte si zdrojové entity, přesný výpočet a názvy výsledných entit. Šablonu nejdřív otestujte ve vývojářských nástrojích, aby při chybě nevracela prázdný nebo neplatný stav.

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.

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

Nastavení v RichPear Home

Template se obvykle nepřidává jako samostatné fyzické zařízení. Nastavení hledejte v části, kde se funkce používá, například v pomocnících, automatizacích, hlasu, logu nebo konfiguraci navazující služby.

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

Údaje ke kontrole

YAML, port, IP adresa nebo host, webhook. Chyba v těchto údajích se obvykle projeví prázdným seznamem entit nebo opakovanou chybou v logu.

04

Kontrola entit a funkcí

Template entity používejte tam, kde opravdu zjednodušují dashboard nebo automatizaci. U měření nastavujte jednotky a stavové třídy jen tehdy, když výsledek odpovídá dlouhodobým statistikám.

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.

05

Použití v automatizacích

U ovládacích entit nejdřív ověřte ruční chování. Automatizace, které něco fyzicky spouštějí, musí mít podmínky pro čas, přítomnost nebo stav zařízení.

Začněte jednoduchou automatizací, která jen pošle oznámení nebo zapíše stav. Po ověření přidejte podmínky a až nakonec akce, které mění stav zařízení nebo volají službu.

06

Provoz a údržba

U cloudové služby pravidelně kontrolujte platnost tokenů a přístup účtu. Po změně hesla nebo oprávnění počítejte s tím, že integrace může potřebovat nové přihlášení.

Po změně účtu, tokenu, firmware, sítě nebo konfigurace zkontrolujte také dashboardy a automatizace, protože mohou používat původní entity nebo očekávat starý rozsah hodnot.

07

Řešení problémů

Když integrace nefunguje podle očekávání, ověřte adresu, port a firewall; zkontrolujte účet, token a dostupnost služby; zkontrolujte syntaxi konfigurace a restart. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle názvu integrace template.

Při opakovaných chybách integraci hned neodstraňujte. Nejdřív ověřte přístupové údaje, dostupnost služby a čas poslední aktualizace. Odebrání a nové přidání má smysl až po vyloučení těchto příčin.