Integrace RichPear Home
MQTT Select
MQTT Select vytváří v RichPear Home výběrové pole zařízení ovládané přes MQTT. Stránka řeší samostatnou MQTT platformu, která vyžaduje funkční broker a správně navržené topicy.
- Doména
mqtt- Kategorie
- výběr
- 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 Select ručně v konfiguraci nebo přes MQTT discovery, pokud ho zařízení podporuje. state a command topic přenáší jednu z povolených možností.
Po uložení konfigurace otestujte příchozí stav, odchozí příkaz a chování při restartu zařízení i brokeru.
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
Seznam možností držte přesně podle zařízení, jinak bude volba odmítnuta nebo provede jinou akci.
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 Select. 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.