Integrace RichPear Home

BTHome

BTHome přidává BLE zařízení vysílající data ve formátu BTHome. Po funkčním Bluetooth přijímači se podporovaná zařízení objevují automaticky.

Začít nastavení Zpět na integrace

Doména: bthome
Kategorie: senzory, binární senzory, události
Komunikace: lokální události
Nastavení: průvodce v rozhraní
Protokol: BTHome přes Bluetooth Low Energy

Co integrace přidá

Integrace načítá BLE zařízení, která vysílají data ve formátu BTHome. Formát je úsporný a umožňuje i vlastní DIY BLE senzory.

Po funkčním Bluetooth přijímači se podporovaná zařízení objevují automaticky. Podle zařízení mohou vzniknout senzory, binární senzory a událostní entity.

Typické hodnoty zahrnují například teplotu, vlhkost, baterii, osvětlení, tlak, CO2, napětí, výkon, vodu, plyn, pohyb, otevření, přítomnost, kouř, vlhkost nebo tlačítkové a stmívací události.

Kontrolní témata

Funkční Bluetooth přijímač v RichPear Home.
BTHome zařízení v dosahu přijímače.
U šifrovaných zařízení 32znakový hexadecimální bindkey.

Příprava před přidáním

Před přidáním ověřte, že je v RichPear Home nastavený a funkční Bluetooth přijímač. BTHome zařízení musí být v jeho dosahu a musí vysílat podporovaná data.

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.

U šifrovaného BTHome zařízení budete potřebovat bindkey: 32 hexadecimálních znaků, tedy 16 bajtů klíče.

Nastavení v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte BTHome a projděte průvodce. Pokud je zařízení objevené automaticky, otevřete ho přímo z objevených zařízení.

Když průvodce nabídne výběr zařízení, zvolte konkrétní BLE zařízení podle názvu nebo adresy. U šifrovaného zařízení zadejte bindkey přesně jako 32 hexadecimálních znaků.

Po uložení počkejte na další BLE vysílání zařízení. U bateriových zařízení může první aktualizace přijít až po probuzení nebo dalším periodickém vysílání.

Kontrola entit a funkcí

Otevřete detail zařízení a zkontrolujte vytvořené senzory, binární senzory a případné událostní entity. U senzorů ověřte jednotky, historii a čas poslední aktualizace.

U binárních senzorů vyzkoušejte reálnou změnu stavu, například otevření kontaktu nebo pohyb. U tlačítek a stmívačů ověřte, jaké typy událostí zařízení vysílá.

Po nastavení

Přejmenujte entity česky a srozumitelně.
Přiřaďte zařízení do oblastí.
Ověřte dostupnost po restartu RichPear Home.
Teprve potom entity použijte ve scénách, skriptech nebo automatizacích.

Použití v automatizacích

Senzory používejte jako spouštěče až po ověření, že se aktualizují v očekávaném intervalu a nezůstávají dlouho ve starém stavu.

Událostní entity mohou hlásit například stisk, dvojitý stisk, dlouhý stisk, otočení vlevo nebo vpravo, zapnutí, vypnutí, přepnutí a krok nahoru nebo dolů. Automatizace stavte podle událostí, které vaše konkrétní zařízení opravdu vysílá.

Provoz a údržba

Po přesunu zařízení, změně Bluetooth přijímače nebo výměně baterie zkontrolujte detail integrace, názvy entit, dashboardy a navazující automatizace.

U bateriových BLE zařízení sledujte stav baterie, kvalitu signálu a čas poslední aktualizace. Pokud je zařízení šifrované a začne vyžadovat nové ověření, zadejte znovu správný bindkey.

Řešení problémů

Když integrace nefunguje podle očekávání, ověřte funkční Bluetooth přijímač, dosah zařízení, baterii, správný bindkey u šifrovaných zařízení a čas posledního BLE vysílání. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle domény bthome.

Pokud se zařízení neobjeví v průvodci, přibližte ho k přijímači, probuďte ho podle návodu výrobce a počkejte na další vysílací interval.