Integrace RichPear Home

MQTT button

MQTT button vytváří v RichPear Home tlačítko, které při stisku odešle MQTT zprávu. Stránka řeší samostatnou MQTT platformu, která vyžaduje funkční broker a správně navržené topicy.

Začít nastavení Zpět na integrace

Doména: mqtt
Kategorie: tlačítka
Komunikace: configurable
Kvalita: Není uvedeno

Příprava

Nejdřív nastavte základní MQTT integraci a ověřte připojení k brokeru. Připravte topic strukturu, retain pravidla, dostupnost a testovací MQTT klient.

Před vytvořením entity si zapište state_topic, command_topic, availability_topic a očekávané payloady. U zařízení s fyzickým dopadem testujte nejdřív mimo ostrý provoz.

Lokální adresa

Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

Nastavení

Přidejte MQTT button ručně v konfiguraci nebo přes MQTT discovery, pokud ho zařízení podporuje. command_topic spustí vzdálenou akci, například restart zařízení nebo požadavek na servis.

Po uložení konfigurace otestujte příchozí stav, odchozí příkaz a chování při restartu zařízení i brokeru.

Po přidání vždy zkontrolujte vytvořená zařízení, entity, oblasti a oprávnění uživatelů. Teprve potom integraci zapojte do automatizací.

Topicy

Topicy držte čitelné a konzistentní, například podle typu zařízení, místnosti a entity. Vyhněte se náhodným názvům, které se za měsíc nedají servisovat.

State topic má popisovat skutečný stav, command topic má posílat příkaz. Nemíchejte je do jednoho směru bez jasného důvodu.

Payloady

Payloady musí přesně odpovídat konfiguraci. Pokud zařízení posílá JSON, použijte šablonu a otestujte chybějící klíče.

U ručně psaných payloadů rozlišujte velká a malá písmena, čísla jako text a lokální desetinné oddělovače.

Dostupnost

Availability topic pomáhá poznat, zda zařízení opravdu žije. Bez něj může entita ukazovat poslední známý stav i po výpadku zařízení.

Nastavte last will zprávu na brokeru nebo v zařízení, pokud to firmware podporuje.

Bezpečnost

Tlačítka pro destruktivní akce nenechávejte na veřejném dashboardu bez potvrzení.

Broker chraňte heslem, oddělte oprávnění pro čtení a zápis a nepoužívejte společný administrátorský účet pro všechna zařízení.

Discovery a YAML

Discovery je rychlé pro zařízení, která ho posílají správně. YAML je lepší tam, kde potřebujete přesnou kontrolu nad názvy, třídami a šablonami.

Po změně discovery zprávy zkontrolujte, zda nevznikly duplicitní entity nebo staré nepoužívané položky.

Údržba

Po aktualizaci firmware zařízení znovu otestujte payloady a dostupnost. Výrobce může změnit hodnoty nebo JSON strukturu.

Při potížích použijte MQTT klienta nebo dump jen dočasně, aby logy nezaplnily systém.

Kontrola po nasazení

Po prvním dni provozu projděte historii entit integrace MQTT button. Sledujte, zda se hodnoty aktualizují podle typu komunikace configurable a zda se v logu neopakují stejné chyby, odpojení nebo odmítnuté požadavky.

Pokud integrace ovládá reálné zařízení, broker, kamerový obraz, alarm, zámek nebo ruční konfiguraci, nechte správcům jasný postup pro vypnutí automatizace a návrat k ručnímu ovládání. Zapište si také místo, kde se spravuje token, heslo, topic struktura, IP adresa nebo konfigurační soubor.