Integrace RichPear Home

Airthings

Airthings načítá cloudová měření kvality vzduchu ze senzorů Airthings. V RichPear Home se používá pro radon, teplotu, vlhkost, CO₂, VOC a další veličiny podle toho, co konkrétní zařízení v Airthings API publikuje.

Připravit API klienta Přehled integrací

Doména: airthings
Nastavení: Průvodce v UI, možné objevení v síti
Komunikace: cloud-polling
Platforma: sensor
Přístup: Airthings Dashboard ID a Secret

Připravte hardware a Airthings Dashboard

Integrace vyžaduje fyzický hardware Airthings a platné přihlášení do Airthings Dashboardu. Airthings nabízí různé senzory kvality vzduchu a často se používá hlavně pro sledování radonu.

SmartLink hub není pro integraci povinný, ale s hubem dostáváte živější aktualizace dat. Bez hubu se hodnoty spoléhají na synchronizaci přes mobilní aplikaci Airthings přes Bluetooth a následné nahrání do cloudu.

Co musí být připravené

Airthings zařízení přiřazené v Airthings účtu.
Přístup do Airthings Dashboardu na dashboard.airthings.com.
API klient s vygenerovaným ID a Secret.
Internetové připojení RichPear Home.
Volitelně Airthings SmartLink hub pro častější aktualizace.

Vytvořte API klienta v Airthings

Přihlaste se do Airthings Dashboardu, v levém menu otevřete Integrations a zvolte Request API Client. Vyplňte název připojení, například RichPear Home, a krátký popis.

V průvodci Airthings nastavte Resource Scope, Access Type zvolte jako Confidential, vyberte flow type podle nabídky Airthings API, přepněte Enable na zapnuto a nastavení uložte. Po uložení se zobrazí vygenerované ID a Secret, které zadáte do RichPear Home.

Secret z Airthings Dashboardu berte jako heslo. Nepište ho do veřejných poznámek, screenshotů ani automatizací; patří jen do průvodce integrace.

Vyhledejte Airthings v RichPear Home

Otevřete Nastavení → Zařízení a služby, klikněte na Přidat integraci a vyhledejte Airthings. Pokud RichPear Home v síti objeví Airthings hub nebo View zařízení, může se nabídnout jako objevená integrace k dokončení nastavení.

Ve vyhledání značky se může zobrazit i Airthings BLE. Pro cloudový postup s Airthings Dashboard ID a Secret vyberte položku Airthings, ne BLE variantu.

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

Vyberte cloudovou integraci Airthings

Po výběru značky zvolte Airthings. Tato položka odpovídá cloudové integraci a vyžaduje internetové připojení. Položka Airthings BLE je samostatná integrace pro jiný způsob komunikace.

Volba mezi Airthings a Airthings BLE v českém RichPear Home — Pro tento návod vyberte cloudovou položku Airthings.

Zadejte ID a Secret

Do průvodce zadejte ID a Secret z Airthings Dashboard API integrace. RichPear Home údaje ověří u Airthings a po úspěchu založí integraci.

Formulář v českém rozhraní označuje pole Secret jako Tajné. Pokud se ověření nepovede, vraťte se do Airthings Dashboardu a zkontrolujte, že je API klient zapnutý a že kopírujete hodnoty bez mezer navíc.

Formulář Airthings pro ID a Secret v českém RichPear Home — Cloudová integrace Airthings používá ID a Secret z Airthings Dashboardu.

Zkontrolujte vytvořené senzory

Integrace vytváří pouze entity typu sensor. Konkrétní seznam závisí na typu zařízení a na tom, které hodnoty Airthings API u daného zařízení publikuje.

Podporované typy senzorů zahrnují radon, teplotu, vlhkost, tlak, zvukovou hladinu, baterii, CO₂, VOC, světlo, osvětlení v luxech, riziko virů, plíseň, RSSI a částice PM1/PM2.5. Diagnostický RSSI senzor je ve výchozím stavu vypnutý.

Typické skupiny hodnot

Vzduch: radon v Bq/m³, CO₂ v ppm, VOC v ppb, PM1 a PM2.5 v µg/m³.
Prostředí: teplota v °C, vlhkost v %, tlak v mbar, světlo nebo luxy.
Stav zařízení: baterie a volitelně diagnostický signál RSSI.
Odvozené hodnoty: riziko virů a plíseň, pokud je daný typ zařízení v Airthings datech poskytuje.

Použijte senzory v automatizacích

Airthings nepřidává vlastní speciální akce. Automatizace stavte nad běžnými stavy senzorů, například při zvýšené hodnotě CO₂, radonu nebo vlhkosti.

Integrace dotazuje data přibližně každých šest minut. U pravidel pro větrání proto používejte rozumnou hysterzi a nečekejte reakci v řádu sekund, hlavně pokud zařízení nemá SmartLink hub.

Příklad upozornění na CO₂

triggers:
  - trigger: numeric_state
    entity_id: sensor.pracovna_airthings_co2
    above: 1200
    for: "00:10:00"
actions:
  - action: notify.mobile_app_telefon
    data:
      message: "V pracovně je vysoké CO₂. Vyvětrejte."

Řešení problémů

Když Airthings neukazuje očekávané hodnoty

Radonový senzor se nezobrazil

U nového nebo právě spuštěného zařízení nemusí Airthings API radon zpočátku publikovat, protože hodnota může být dočasně neznámá. Počkejte, až se hodnota v API objeví, a potom zkontrolujte entity znovu.

Ověření ID a Secret selže

Zkontrolujte, že API klient v Airthings Dashboardu existuje, je zapnutý a používáte přesné ID i Secret. Pokud jste Secret ztratili, vytvořte nebo obnovte API klienta v Dashboardu.

Hodnoty se aktualizují pomalu

Integrace je cloud polling. Bez SmartLink hubu se data dostávají do cloudu přes Bluetooth synchronizaci mobilní aplikace Airthings, takže interval a čerstvost hodnot závisí na tom, kdy aplikace zařízení synchronizuje.

Některé senzory chybí

Ne každé Airthings zařízení měří všechny veličiny. RichPear Home vytváří jen senzory pro typy hodnot, které dané zařízení vrací přes Airthings API.

Odebrání integrace

Odebrání nevyžaduje zvláštní postup. Otevřete Nastavení → Zařízení a služby, vyberte Airthings, otevřete položku integrace nebo zařízení a v nabídce se třemi tečkami zvolte odstranění.

Po odebrání projděte dashboardy a automatizace, které používaly senzory Airthings. V Airthings Dashboardu můžete podle potřeby zneplatnit API klienta vytvořeného pro RichPear Home.

Odebrání z RichPear Home nemaže zařízení z Airthings účtu ani Airthings Dashboardu.

URL

Lokální adresa systému

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