RichPear HOME DOCS Začít

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 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
lokální dotazování
Nastavení
UI průvodce, automatické nalezení nebo hostitel
Firmware
3.1.1 nebo novější
01

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.

Průvodce nepřidá zařízení s firmwarem starším než 3.1.1. Při starší verzi skončí hlášením, že firmware není podporovaný, a zařízení je potřeba nejdřív aktualizovat.

Před přidáním zkontrolujte

  1. AirGradient je ve stejné síti nebo v routované síti dostupné z RichPear Home.
  2. Zařízení odpovídá na lokální adrese, kterou zadáte do pole Hostitel.
  3. Firmware je verze 3.1.1 nebo novější.
  4. 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 lokální řízení.
02

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í značky AirGradient v dialogu Přidat integraci.
03

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.

Ruční přidání AirGradient vyžaduje hostitele nebo IP adresu zařízení.
04

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

  1. Senzory částic PM1, PM2.5, PM10 a počet částic PM0.3, pokud je zařízení poskytuje.
  2. Senzory teploty, vlhkosti, CO2, VOC indexu, NOx indexu a síly signálu.
  3. Diagnostické nebo volitelně vypnuté surové hodnoty, například surové PM2.5, VOC a NOx.
  4. 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í.
  5. Tlačítka pro kalibraci CO2 a u podporovaných modelů test LED lišty.
05

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. 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_carbon_dioxide
    above: 1200
actions:
  - action: notify.send_message
    target:
      entity_id: notify.telefon
    data:
      message: "AirGradient hlásí vyšší CO2, je čas vyvětrat."
06

Ř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

  1. Nelze se připojit: špatná IP adresa, jiné VLAN, blokovaný lokální přístup nebo vypnuté zařízení.
  2. Nepodporovaný firmware: aktualizujte AirGradient alespoň na verzi 3.1.1.
  3. Duplicitní zařízení: RichPear Home rozpozná stejné sériové číslo a nedovolí založit druhý záznam.
  4. 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.