Integrace RichPear Home
MQTT Update
MQTT Update vytvoří aktualizační entitu pro zařízení, které přes MQTT hlásí nainstalovanou a dostupnou verzi. Může také spouštět instalaci, pokud firmware poskytuje bezpečný příkazový topic.
- Doména
mqtt- Kategorie
- Aktualizace
- 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í
Nastavte topicy pro nainstalovanou verzi, dostupnou verzi a volitelně příkaz k instalaci. Aktualizace používejte pouze u zařízení, kde výrobce jasně podporuje vzdálené spuštění a návrat z neúspěšného stavu.
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.
Verze a stav
Installed a latest verze musí být srovnatelné hodnoty. Pokud zařízení posílá složený JSON, vytáhněte jen verzi a oddělte ji od changelogu, kanálu nebo interního buildu.
Aktualizační entita má dávat správci jasný signál, že je dostupný novější firmware nebo software. Nepoužívejte ji pro běžnou telemetrii, která se mění často.
Instalační příkaz
Command topic pro instalaci povolte jen tehdy, když zařízení umí aktualizaci bezpečně dokončit i při přerušení sítě. U zařízení napájených z baterie sledujte stav baterie před spuštěním.
Automatické instalace bez dozoru používejte opatrně. V provozní domácnosti je lepší nejdřív oznámit dostupnou verzi a instalaci spustit ručně po kontrole dopadu.
Ú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 Update. 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.