Integrace RichPear Home

AirVisual Pro

AirVisual Pro připojuje měřicí jednotku AirVisual Node/Pro do RichPear Home přes lokální síť. Integrace se zařízení dotazuje přímo, bez cloudového účtu, a vytváří senzory kvality vzduchu, teploty, vlhkosti a stavu zařízení.

Doména
airvisual_pro
Komunikace
local-polling
Nastavení
UI průvodce
Požadavek
IP adresa a Samba heslo
01

Připravte AirVisual Node/Pro

Jednotka AirVisual Node/Pro musí být zapnutá a dostupná ze stejné lokální sítě jako RichPear Home. Před nastavením si připravte její IP adresu nebo název hostitele a Samba heslo, které se podle dokumentace RichPear Home získává přímo z uživatelského rozhraní zařízení.

Uživatelé obvykle otevírají RichPear Home na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123 podle adresy vaší instalace.

Co zkontrolovat předem

  1. AirVisual Node/Pro je připojený k síti a RichPear Home na něj dosáhne.
  2. Máte známou IP adresu nebo stabilní DNS jméno zařízení.
  3. Máte Samba heslo ze zařízení AirVisual Pro.
  4. Firewall, oddělené VLAN nebo hostovaná síť neblokují lokální komunikaci mezi RichPear Home a měřicí jednotkou.
02

Přidejte integraci přes UI průvodce

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte AirVisual Pro a spusťte průvodce. Integrace se v aktuálním RichPear Home Core nastavuje přes config flow v UI.

Průvodce vyžaduje pole Hostitel nebo IP adresu zařízení a Heslo. Po odeslání RichPear Home ověří připojení, přečte ze zařízení sériové číslo a podle něj zabrání duplicitnímu přidání stejné jednotky.

03

Zkontrolujte vytvořené senzory

Po úspěšném přidání otevřete detail zařízení a zkontrolujte entity typu senzor. RichPear Home Core pro AirVisual Pro načítá data lokálně v minutovém intervalu a zařízení v registru pojmenuje podle údajů, které vrátí měřicí jednotka.

Integrace nemá vlastní akce typu airvisual_pro.*. V automatizacích se používají stavy vytvořených senzorů, například CO2, PM2.5, AQI nebo vlhkost.

Senzory z dokumentace a Core zdrojů

  1. Index kvality vzduchu AQI a venkovní index kvality vzduchu, pokud ho zařízení vrátí v historii.
  2. Stav baterie v procentech jako diagnostická entita.
  3. Oxid uhličitý CO2 v ppm.
  4. Vlhkost v procentech a teplota ve stupních Celsia.
  5. Částice PM0.1, PM1.0, PM2.5 a PM10 v mikrogramech na metr krychlový.
  6. Těkavé organické látky VOC v mikrogramech na metr krychlový.
04

Použijte lokální měření v automatizacích

Nechte integraci několik minut běžet a ověřte, že se hodnoty senzorů pravidelně obnovují. Pro dashboardy bývá praktické sledovat AQI, PM2.5, CO2, teplotu a vlhkost; pro upozornění používejte prahové hodnoty vhodné pro vaši domácnost.

Integrace podporuje diagnostická data config entry. Citlivé údaje jako heslo, MAC adresa a sériové číslo se při diagnostice redigují.

Příklad automatizace

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

Řešení problémů

Pokud průvodce skončí chybou připojení, ověřte IP adresu nebo hostitele, zapnutí zařízení a síťovou dostupnost mezi RichPear Home a AirVisual Pro. Při chybě ověření znovu zkontrolujte Samba heslo přímo v rozhraní zařízení.

Když zařízení po nastavení přestane odpovídat, RichPear Home Core označí aktualizaci dat jako neúspěšnou a pokusí se integrační záznam znovu načíst. V takové situaci zkontrolujte napájení, Wi-Fi a případné změny IP adresy.

Časté příčiny

  1. Neplatné heslo: Samba heslo je opsané špatně nebo bylo v zařízení změněné; RichPear Home může vyžádat znovuověření.
  2. Nelze se připojit: špatná IP adresa, nedostupné DNS jméno, vypnutá jednotka nebo síťové pravidlo mezi VLAN.
  3. Duplicitní zařízení: stejné sériové číslo už je v RichPear Home nastavené.
  4. Neznámá chyba zařízení: zkontrolujte protokoly RichPear Home a stav samotné jednotky AirVisual Pro.