Integrace RichPear Home
MQTT
MQTT je základní integrační vrstva pro zařízení a služby komunikující přes MQTT broker. V RichPear Home slouží pro discovery, ručně definované entity, publish, dump, dostupnost a stavové zprávy.
- Doména
mqtt- Kategorie
- hub, aktualizace
- Komunikace
- local-push
- Kvalita
- platinum
Příprava
Připravte MQTT broker, uživatelské jméno, heslo, případně TLS certifikáty a síťový přístup. Broker může běžet lokálně nebo mimo RichPear Home, ale musí být stabilně dostupný.
Navrhněte strukturu topiců, pravidla pro retain, birth a last will zprávy. Dobrá struktura topiců je zásadní pro servis celé instalace.
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í
V Nastavení -> Zařízení a služby přidejte MQTT a nastavte broker. Po připojení otestujte publish a subscribe na testovacím topicu.
Zapněte nebo upravte discovery podle toho, zda zařízení posílají discovery zprávy. Ručně konfigurované entity držte odděleně a dokumentované.
Broker
Broker je centrální bod MQTT komunikace. Pokud vypadne, MQTT zařízení mohou přestat posílat stav i přijímat příkazy.
Pro produkční instalaci nastavte autentizaci, zálohy konfigurace brokeru a sledování dostupnosti.
Discovery
MQTT discovery umožňuje zařízením vytvořit entity automaticky. Discovery topic musí obsahovat správnou konfiguraci a dostupnost.
Chybné discovery zprávy mohou vytvořit duplicitní nebo špatně pojmenované entity; testujte je na odděleném zařízení.
State a command topics
State topic nese stav zařízení, command topic příkazy ze systému. U ovládaných zařízení používejte oba, pokud to zařízení umí.
Retain používejte promyšleně. Starý retained command může po restartu způsobit nečekanou akci.
Availability
Availability topic ukazuje, zda je zařízení online. Bez něj může dashboard vypadat funkčně, i když zařízení dávno nereaguje.
Last will zprávy nastavte tak, aby se offline stav objevil při výpadku zařízení nebo spojení.
Publish a dump
Akce publish slouží k odeslání MQTT zprávy, dump pomáhá ladit příchozí komunikaci.
Dump a podrobné logování používejte dočasně, protože velké množství MQTT zpráv rychle zaplní logy.
Kontrola po nasazení
Po prvním dni provozu projděte historii entit integrace MQTT. Sledujte, zda se hodnoty aktualizují podle typu komunikace local-push 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.