Integrace RichPear Home

Airobot

Integrace Airobot připojí chytrý termostat Airobot Smart Thermostat TE1 k RichPear Home přes lokální REST API. Slouží pro řízení podlahového topení, sledování teploty, vlhkosti a podle výbavy také CO₂ a indexu kvality vzduchu.

Začít nastavení Zpět na audit

Doména: airobot
Kategorie: Klima
Komunikace: local-polling
Kvalita: platinum

Ověřte model a firmware

Podporovaný je Airobot Smart Thermostat TE1 s firmwarem 1.8 nebo novějším. Starší firmware nemá lokální REST API potřebné pro integraci.

Termostat je určený pro topení, ne pro chlazení. V RichPear Home proto počítejte s entitou klimatu pro režim topení, cílovou teplotu a přednastavené režimy Home, Away a Boost.

Kontrola kompatibility

Zařízení je Airobot Smart Thermostat TE1.
Firmware termostatu je verze 1.8 nebo novější.
Termostat je připojený k místní síti přes Wi-Fi nebo Ethernet.
RichPear Home a termostat jsou ve stejné síti nebo mezi nimi funguje routování.

Zapněte lokální API v termostatu

Termostat musí být nejdřív alespoň jednou připojený k internetu, aby se zaregistroval u Airobot serveru a získal své Device ID a heslo. Po tomto úvodním kroku už pro provoz s RichPear Home internet nepotřebuje.

V menu termostatu otevřete Connectivity → Local API → Enable. Lokální REST API je z bezpečnostních důvodů ve výchozím stavu vypnuté.

Údaje pro průvodce

Host: IP adresa termostatu nebo hostname.
Device ID: najdete v menu Connectivity → Mobile app, například T01XXXXXX.
Password: heslo ze stejné obrazovky Connectivity → Mobile app.
Hostname může mít tvar airobot-thermostat-t01xxxxxx, kde poslední část odpovídá Device ID malými písmeny.

Přidejte Airobot v RichPear Home

Airobot se může objevit automaticky přes DHCP, pokud je termostat ve stejné síti. V takovém případě otevřete objevenou kartu a doplňte heslo z termostatu.

Pokud se automaticky nenajde, otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Airobot a zadejte Host, Device ID a Password. RichPear Home při odeslání ověří spojení načtením stavů a nastavení z lokálního API.

Výběr integrace Airobot v českém RichPear Home — Vyhledání položky Airobot v dialogu Přidat integraci.

Vyplňte údaje z termostatu

Do pole Hostitel zadejte název hostitele nebo IP adresu termostatu. Do pole ID zařízení patří Device ID z obrazovky Mobile app v termostatu a do pole Heslo heslo ze stejné obrazovky.

Po odeslání průvodce zkusí načíst stav a nastavení termostatu. Pokud termostat neodpoví, ponechá formulář otevřený a zobrazí chybu připojení.

Formulář Airobot pro hostitele, ID zařízení a heslo v českém RichPear Home — Formulář Airobot vyžaduje hostitele, ID zařízení a heslo termostatu.

Při změně IP adresy, Device ID nebo hesla použijte na kartě integrace nabídku se třemi tečkami a volbu pro opětovné nastavení. To je vhodnější než mazání integrace, pokud jde jen o změnu spojení.

Zkontrolujte klima, senzory a ovládání

Po úspěšném připojení vznikne zařízení termostatu s entitou klimatu a dalšími entitami podle dostupné výbavy. Pokud je připojený podlahový senzor, aktuální teplota entity klimatu používá podlahovou teplotu; jinak používá teplotu vzduchu.

Cílovou teplotu lze nastavovat v rozsahu 5 až 35 °C. V režimu Home mění cílovou teplotu Home, v režimu Away cílovou teplotu Away. Boost dočasně zvýší topení na jednu hodinu a potom se vrátí na předchozí režim.

Podporované entity

climate: aktuální teplota, vlhkost, cílová teplota, akce topení/nečinnost a režimy Home, Away, Boost.
sensor: teplota vzduchu, vlhkost, počet chyb a podle výbavy teplota podlahy, CO₂ a index kvality vzduchu.
Diagnostické senzory: uptime zařízení a doba topení od posledního restartu; některé jsou ve výchozím stavu vypnuté.
number: hysterezní pásmo topení v rozsahu 0.0–0.5 °C, ve výchozím stavu vypnuté.
button: restart termostatu a podle výbavy ruční rekalibrace CO₂ senzoru.
switch: dětský zámek a volitelný spínač pro vypnutí pravidelného procvičení aktuátoru.

Použijte termostat v automatizacích

Pro běžné scénáře používejte standardní akce domény climate: nastavování cílové teploty a přepínání přednastavených režimů. Před automatizací Boost režimu ověřte, jak se místnost chová, protože Boost je dočasný režim na jednu hodinu.

Pokud má termostat CO₂ senzor, můžete na hodnoty kvality vzduchu navázat upozornění nebo větrání. Typické je upozornění při překročení nastaveného prahu kvality vzduchu.

Příklad upozornění na vzduch

alias: Airobot upozornění na kvalitu vzduchu
triggers:
  - trigger: numeric_state
    entity_id: sensor.airobot_air_quality
    above: 1000
conditions:
  - condition: template
    value_template: "{{ trigger.from_state.state | float(0) < trigger.to_state.state | float(0) }}"
actions:
  - action: notify.mobile_app
    data:
      title: "Zhoršená kvalita vzduchu"
      message: "Kvalita vzduchu v {{ area_name(trigger.entity_id) }} je {{ trigger.to_state.state }}."

Řešení problémů

Chyba připojení znamená, že RichPear Home nedokáže navázat spojení s lokálním REST API termostatu. Ověřte IP adresu nebo hostname, napájení termostatu, lokální síť a zapnuté Local API.

Chyba přihlášení znamená, že nesedí Device ID nebo heslo. Zkontrolujte údaje přímo na termostatu v menu Connectivity → Mobile app; Device ID je citlivé na přesný tvar a má začínat písmenem T.

Typické situace

Nelze se připojit: špatná IP adresa, nedostupný hostname, termostat není ve stejné síti nebo je Local API vypnuté.
Neplatné přihlášení: Device ID nebo heslo neodpovídá údajům v termostatu, případně termostat ještě neproběhl úvodní internetovou registrací.
Entita se stává nedostupnou: výpadek napájení, nestabilní Wi-Fi, změna DHCP adresy nebo vypnuté Local API.
Chybí CO₂ nebo podlahová teplota: daný hardwarový senzor není v termostatu instalovaný.
Chybí cloudové ovládání: integrace podporuje lokální REST API; ovládání přes Airobot cloud není podporované.

Chyba připojení Airobot v českém RichPear Home — Pokud termostat na zadané adrese neodpoví, průvodce zobrazí chybu připojení.

Odebrání integrace

Integraci odeberete standardně v Nastavení → Zařízení a služby. Otevřete kartu Airobot, vyberte konkrétní položku a v nabídce se třemi tečkami zvolte odstranění.

Po odebrání můžete v menu termostatu vypnout lokální API přes Connectivity → Local API → Disable, pokud už termostat nemá být přístupný z místní sítě.

Airobot aktualizuje data každých 30 sekund. Tento interval odpovídá internímu měřicímu cyklu termostatu a není potřeba ho v běžném provozu obcházet ručním znovunačítáním.

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.