Integrace RichPear Home
MQTT Time
MQTT Time zpřístupní časový ovládací prvek zařízení přes MQTT. Typicky slouží pro lokální časovače, plánované sepnutí nebo nastavení času v jednoduchém firmware.
- Doména
mqtt- Kategorie
- Čas
- 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í
Časovou entitu nastavte s command topicem a případně state topicem. Dohodněte přesný formát času, který zařízení očekává, a otestujte chování po restartu zařízení i RichPear Home.
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.
Formát času
Zařízení musí dostat čas ve formátu, kterému rozumí. Nemíchejte lokální textové formáty s ISO hodnotami a udržujte jednu konvenci napříč všemi podobnými zařízeními.
U časů závislých na časové zóně si ověřte, zda firmware pracuje s lokálním časem nebo UTC. Chybný předpoklad se projeví hlavně při změně letního času.
Použití v automatizacích
MQTT Time není náhrada za kritický plánovač, pokud zařízení nepotvrzuje uložený stav. Pro důležité akce přidejte kontrolní senzor nebo další podmínku.
Po změně hodnoty sledujte, zda zařízení čas skutečně převzalo. Pokud jen přijme příkaz bez zpětného stavu, počítejte v automatizaci s možným rozdílem.
Ú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 Time. 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.