Integrace RichPear Home

AirGradient

AirGradient připojuje lokální monitory kvality vzduchu do RichPear Home. Integrace čte hodnoty přímo ze zařízení v síti, umí pracovat s automatickým nalezením přes zeroconf a při ručním přidání potřebuje hostitele nebo IP adresu zařízení.

Začít nastavení Zpět na integrace

Doména: airgradient
Komunikace: local-polling
Nastavení: UI průvodce, zeroconf nebo hostitel
Firmware: 3.1.1 nebo novější

Připravte zařízení AirGradient

Zařízení AirGradient musí být zapnuté, připojené do stejné sítě jako RichPear Home a dostupné z instance RichPear Home na adrese http://rphome.local:8123 nebo http://IP-ADRESA:8123. Pokud se zařízení nenajde automaticky, připravte si jeho lokální IP adresu nebo DNS jméno.

RichPear Home Core odmítá firmware starší než 3.1.1. Při starší verzi průvodce skončí hlášením, že firmware není podporovaný, a zařízení je potřeba nejdřív aktualizovat.

Před přidáním zkontrolujte

AirGradient je ve stejné síti nebo v routované síti dostupné z RichPear Home.
Zařízení odpovídá na lokální adrese, kterou zadáte do pole Hostitel.
Firmware je verze 3.1.1 nebo novější.
Pokud zařízení používá cloudové řízení konfigurace, počítejte s tím, že lokální konfigurační entity budou dostupné až při přepnutí zdroje konfigurace na local.

Vyhledejte AirGradient

Otevřete Nastavení → Zařízení a služby → Přidat integraci a vyhledejte AirGradient. Pokud RichPear Home zařízení najde automaticky přes síťové zjišťování, nabídne potvrzení nalezeného modelu. Při ručním přidání pokračujte formulářem s hostitelem.

Vyhledání integrace AirGradient v českém RichPear Home — Vyhledání značky AirGradient v dialogu Přidat integraci.

Zadejte hostitele

Do pole Hostitel zadejte IP adresu nebo název hostitele zařízení AirGradient. RichPear Home se k zařízení připojí, přečte aktuální měření a podle sériového čísla zabrání duplicitnímu přidání stejného monitoru.

Pokud zařízení ještě nemá nastavený zdroj konfigurace, integrace ho při přidání nastavuje na lokální řízení, aby bylo možné ovládat podporované parametry přímo z RichPear Home.

Formulář AirGradient s polem Hostitel v RichPear Home — Ruční přidání AirGradient vyžaduje hostitele nebo IP adresu zařízení.

Zkontrolujte měření a konfigurační entity

Po úspěšném přidání zkontrolujte detail zařízení a vytvořené entity. Základní měření se obnovují lokálně v minutovém intervalu a závisí na konkrétním modelu a osazených senzorech.

Integrace nepřidává vlastní akce typu airgradient.*. Ovládání probíhá přes entity zařízení: tlačítka, přepínače, číselné hodnoty a výběry.

Typické entity

Senzory částic PM1, PM2.5, PM10 a počet částic PM0.3, pokud je zařízení poskytuje.
Senzory teploty, vlhkosti, CO2, VOC indexu, NOx indexu a síly signálu.
Diagnostické nebo volitelně vypnuté surové hodnoty, například raw PM2.5, raw VOC a raw NOx.
Konfigurační prvky pro zdroj konfigurace, sdílení dat do AirGradient, jas displeje, jas LED lišty, režim LED lišty, jednotku teploty a standard PM zobrazení.
Tlačítka pro kalibraci CO2 a u podporovaných modelů test LED lišty.

Použijte data v automatizacích

Pro dashboardy použijte hlavně PM2.5, CO2, teplotu, vlhkost a VOC nebo NOx index. Pro automatizace nejdřív nechte zařízení několik minut běžet a ověřte, že hodnoty pravidelně přibývají.

Aktualizační entita sleduje dostupnost novějšího firmware. Podle aktuální dokumentace umí na novější verzi upozornit, ale instalaci firmware neprovádí automaticky. Aktualizaci zařízení řešte postupem výrobce a po instalaci aktualizace zařízení ručně restartujte.

Příklad použití

alias: Upozornění na vyšší CO2
triggers:
  - trigger: numeric_state
    entity_id: sensor.airgradient_co2
    above: 1200
actions:
  - action: notify.mobile_app
    data:
      message: "AirGradient hlásí vyšší CO2, je čas vyvětrat."

Řešení problémů

Když se průvodce nepřipojí, ověřte IP adresu, DNS jméno, firewall mezi VLAN sítěmi a firmware zařízení. Chyba starého nebo nepodporovaného firmware se neřeší v RichPear Home, ale aktualizací zařízení AirGradient.

Pokud se vytvoří jen část entit, nemusí jít o chybu. Některé entity vzniknou až ve chvíli, kdy zařízení začne danou hodnotu skutečně vracet, a některé diagnostické surové hodnoty jsou vypnuté ve výchozím stavu.

Časté příčiny

Nelze se připojit: špatná IP adresa, jiné VLAN, blokovaný lokální přístup nebo vypnuté zařízení.
Nepodporovaný firmware: aktualizujte AirGradient alespoň na verzi 3.1.1.
Duplicitní zařízení: RichPear Home rozpozná stejné sériové číslo a nedovolí založit druhý záznam.
Chybí konfigurační ovládání: zkontrolujte entitu zdroje konfigurace a přepněte zařízení na lokální řízení, pokud chcete měnit podporované parametry z RichPear Home.