Integrace RichPear Home
MQTT Text
MQTT Text zpřístupní textovou hodnotu zařízení, kterou lze z RichPear Home číst a případně vzdáleně nastavovat. Používá se pro krátké textové stavy, názvy režimů nebo hodnoty, které firmware přijímá jako řetězec.
- Doména
mqtt- Kategorie
- Text
- 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, testovací MQTT klient a jasné pojmenování zařízení.
Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123. U zařízení s fyzickým dopadem testujte nové topicy nejdřív mimo ostré automatizace.
Nastavení
Textovou entitu přidejte jako MQTT zařízení nebo ručně v konfiguraci podle možností instalace. Nastavte command topic pro zápis, volitelný state topic pro čtení a limity délky textu tak, aby odpovídaly firmware zařízení.
Po uložení konfigurace zkontrolujte příchozí stav, odchozí příkaz, dostupnost zařízení a chování po restartu brokeru. Retained zprávy používejte jen tam, kde dává smysl obnovit poslední známou hodnotu.
Topic struktura
Topicy držte čitelné a stabilní, například podle lokality, typu zařízení a konkrétní entity. Oddělte stav, příkaz a dostupnost, aby bylo při servisu jasné, která zpráva stav jen hlásí a která něco skutečně ovládá.
Pokud zařízení posílá JSON, popište si význam klíčů a připravte šablony pro chybějící nebo prázdné hodnoty. Náhodné změny názvů topiců po aktualizaci firmware mohou vytvořit duplicitní entity.
Payloady a šablony
Payloady musí přesně odpovídat konfiguraci, včetně velikosti písmen, datového typu a formátu čísel. U hodnot z JSONu použijte šablonu a ošetřete stav, kdy zařízení pošle neúplnou zprávu.
Při ručním testu posílejte nejdřív bezpečné hodnoty a sledujte log. Pokud se hodnota nemění, porovnejte topic, retain příznak, QoS a payload se skutečnou zprávou z MQTT klienta.
Dostupnost
Availability topic pomáhá poznat, zda zařízení opravdu komunikuje. Bez něj může entita ukazovat poslední známou hodnotu i ve chvíli, kdy je zařízení vypnuté nebo mimo síť.
Pokud firmware podporuje Last Will and Testament, nastavte ho na offline stav. U bateriových zařízení počítejte s delší odezvou a nastavte automatizace tak, aby krátký výpadek nevyvolal zbytečnou akci.
Délka a režim
Textová entita může mít minimální a maximální délku i režim zobrazení. Limity nastavte podle zařízení, ne podle pohodlí formuláře, jinak může firmware dlouhé hodnoty odmítat nebo zkracovat.
Neposílejte přes textovou entitu hesla, tokeny ani citlivé údaje. Hodnoty se mohou objevit v historii, logu nebo v automatizacích.
Stav proti příkazu
Command topic říká zařízení, jakou textovou hodnotu má nastavit. State topic má potvrdit skutečný stav po zpracování příkazu, zejména pokud zařízení hodnotu upravuje nebo validuje.
Pokud zařízení stav neposílá, bude se entita chovat optimisticky. V takovém režimu jasně počítejte s tím, že zobrazená hodnota nemusí odpovídat skutečnému stavu po výpadku.
Údržba
Po aktualizaci firmware znovu otestujte stavové i příkazové topicy. Výrobce může změnit payload, seznam podporovaných funkcí nebo chování retained zpráv.
Uložte si popis topiců do provozní dokumentace instalace. Při pozdější výměně zařízení pak správce pozná, co se má přenést, co smazat z brokeru a které automatizace závisí na konkrétní entitě.
Kontrola po nasazení
Po prvním dni provozu projděte historii entit integrace MQTT Text. Sledujte, jestli se hodnoty aktualizují podle očekávané komunikace, zda příkazy nemají zpoždění a jestli se v logu neopakují chyby přihlášení, odmítnuté požadavky nebo výpadky dostupnosti.
U zařízení s přímým dopadem na provoz domácnosti nechte správcům jasný postup pro ruční ovládání, vypnutí automatizace a bezpečný návrat do původního stavu. Zapište také místo, kde se spravuje token, heslo, API klíč, adresa zařízení, topic struktura nebo konfigurační soubor.