Integrace RichPear Home

File

File ukládá zprávy do souboru a umí vytvořit senzor, který čte hodnotu z textového souboru.

Začít nastavení Zpět na integrace

Doména: file
Typ: Soubor, oznámení a senzor
Komunikace: lokální souborový systém
Nastavení: průvodce nebo konfigurace

Screenshoty z RichPear Home

Snímky ukazují dostupný a bezpečný krok v českém rozhraní RichPear Home pro tuto integraci.

Vyhledání integrace File v RichPear Home.

Volba mezi oznámením do souboru a senzorem založeným na souboru.

Co integrace přidá

File ukládá zprávy do souboru a umí vytvořit senzor, který čte hodnotu z textového souboru.

Výsledek v systému

oznamovací entita pro zápis zpráv do souboru
senzor, který čte poslední řádek textového souboru
akce file.read_file pro načtení obsahu souboru v automatizaci nebo skriptu

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

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa neodpoví, použijte http://IP-ADRESA:8123.

Předem vytvořte složku, do které bude RichPear Home zapisovat nebo ze které bude číst. Samotný soubor může vzniknout automaticky, ale cílová složka musí existovat.

Cestu k souboru povolte v nastavení povolených externích složek. Bez toho RichPear Home soubor z bezpečnostních důvodů nepřečte ani nezapíše.

Rozmyslete si formát dat. Pro jednoduchý text stačí poslední řádek, pro strukturovaná data použijte JSON nebo CSV a připravte šablonu hodnoty.

Nastavení v RichPear Home

Otevřete Nastavení -> Zařízení a služby -> Přidat integraci, vyhledejte File a zvolte, zda chcete oznámení zapisovat do souboru, nebo číst soubor jako senzor.

U oznámení nastavte cílový soubor a podle potřeby zapněte časové razítko. U senzoru vyplňte cestu k souboru a šablonu, pokud nechcete používat celý poslední řádek.

action: notify.send_message
target:
  entity_id: notify.provozni_log
data:
  message: "Zapsat provozni udalost"

Kontrola po přidání

Po dokončení nastavení otevřete detail integrace, zkontrolujte vytvořená zařízení a entity, pojmenujte je česky a přiřaďte je do oblastí.

Ověřte hlavně

pošlete zkušební zprávu do oznamovací entity a ověřte zápis v souboru
u senzoru ověřte, že se zobrazuje poslední řádek nebo správně vytažená hodnota z JSON/CSV
při použití file.read_file zkontrolujte, že soubor není větší, než dává pro automatizaci smysl

Řešení problémů

Když integrace nefunguje podle očekávání, otevřete Nastavení -> Systém -> Logy a hledejte chyby podle domény file. Integraci neodstraňujte jako první krok; nejdřív ověřte přístup, síť, podporovaný model a poslední úspěšnou aktualizaci.

Typické kontroly

chyba oprávnění nebo zakázané cesty znamená, že složka není povolená pro čtení či zápis
senzor ukazuje jen poslední řádek, takže starší hodnoty v souboru se do stavu entity nepromítnou
u JSON nebo CSV ověřte šablonu hodnoty na reálném obsahu souboru