Integrace RichPear Home

Kaiterra

Kaiterra připojuje senzory kvality vzduchu Laser Egg a Sensedge přes Kaiterra REST API. V RichPear Home se používá pro sledování vzduchu, částic, CO2 a dalších měření podle modelu zařízení.

Doména
kaiterra
Kategorie
zdraví
Komunikace
cloud-polling
Kvalita
legacy
01

Připravte přístup a síť

Před přidáním integrace si připravte účet, IP adresu, token, párovací režim nebo API klíč podle typu zařízení. U lokálních zařízení ověřte, že jsou ve stejné síti jako RichPear Home.

U této integrace počítejte hlavně s: cloudový účet, token nebo API přístup, třídu komunikace cloud-polling.

Lokální adresa

Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

02

Přidejte integraci v RichPear Home

Otevřete Konfigurační soubory a následná kontrola v Nastavení → Zařízení a služby, vyhledejte Kaiterra a projděte průvodce nastavením.

Dokumentace integrace zmiňuje YAML nebo ruční konfiguraci. V RichPear Home proto počítejte s kontrolou konfigurace a restartem služby, pokud průvodce není dostupný.

Pokud integrace vyžaduje cloudový účet, používejte samostatný servisní účet, kde to dává smysl. U zařízení v domácí síti nejdřív ověřte pevnou IP adresu nebo spolehlivé mDNS jméno.
03

Zkontrolujte entity, funkce a akce

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

Pokud integrace vytvoří akce nebo služby, otestujte je nejdřív ručně a teprve potom je použijte v automatizaci.

10

API klíč

Nejdřív vytvořte účet v Kaiterra dashboardu, zaregistrujte zařízení a v profilu pro vývojáře vytvořte API klíč. Bez API klíče RichPear Home nedokáže číst hodnoty ze služby.

Poznamenejte si UUID zařízení, typ zařízení a preferované jednotky. Tyto údaje patří do konfigurace a musí odpovídat skutečnému zařízení.

11

Konfigurace

Integrace se nastavuje přes konfiguraci. Vyberte AQI standard us, in nebo cn, nastavte interval čtení a jednotky pro hodnoty jako procenta, stupně, mg/m3, ug/m3, ppm nebo ppb.

Nastavte rozumný interval čtení. Příliš časté dotazy zatěžují API a pro kvalitu vzduchu obvykle nepřinášejí lepší rozhodování.

12

Dashboard a prahy

Na dashboard dejte hlavní hodnoty, které uživatel chápe: CO2, částice, VOC nebo AQI podle konkrétního modelu. Vedle nich zobrazte čas poslední aktualizace.

Prahy pro upozornění nastavte podle místnosti. Ložnice, kancelář a technická místnost mají jiné očekávané hodnoty i jiné reakce.

13

Automatizace vzduchu

Automatizace mohou spouštět větrání, rekuperaci, čističku nebo upozornění. U každé reakce přidejte zpoždění, aby krátká špička nespouštěla zbytečný zásah.

Při výpadku API nechte systém v konzervativním režimu. Externí data nesmí být jediným zdrojem pro kritické řízení ventilace.