Integrace RichPear Home

Downloader

Downloader patří do oblasti stahování. Návod popisuje přípravu, přidání do RichPear Home a kontrolu výsledných entit.

Doména
downloader
Kategorie
stahování
Komunikace
podle konfigurace
Nastavení
průvodce nebo konfigurace podle nasazení
Kvalita
internal
01

Co integrace přidá

Downloader patří do oblasti stahování. 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: stahování. Skutečný rozsah entit se řídí konkrétním zařízením, účtem, firmwarem, verzí služby a oprávněním.

The Downloader integration provides an action to download files.

If the path is not absolute, it’s assumed to be relative to the RichPear Home configuration directory (for example, /config/downloads ).

Go to the “Developer tools”, then to “Actions”, and choose downloader.download_file from the list of available actions.

Kontrolní témata

  1. Nastavení
02

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

Před přidáním si připravte požadované přístupové údaje, podporovaný model zařízení a typ komunikace uvedený v průvodci integrace. 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.
03

Nastavení v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Downloader a projděte průvodce. Pokud vaše instalace používá ruční konfiguraci, upravte konfigurační soubor, restartujte RichPear Home a potom zkontrolujte vytvořenou integraci v nastavení.

{ "url" : "http://domain.tld/path/to/file" }

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.

04

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í

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

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.

06

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.

07

Řešení problémů

Když integrace nefunguje podle očekávání, ověřte syntaxi konfigurace, odsazení, restart a chyby v logu po startu. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény downloader.

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