Integrace RichPear Home
MQTT Valve
MQTT Valve ovládá ventil přes MQTT, například vodní nebo plynový uzávěr. Podle zařízení může pracovat jen se stavy otevřeno a zavřeno, nebo také s procentuální polohou.
- Doména
mqtt- Kategorie
- Ventil
- 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 state topic, command topic a payloady pro otevření, zavření, případně polohu. U ventilů připojených na vodu nebo plyn testujte nejdřív fyzicky u zařízení a nechte dostupný ruční způsob ovládání.
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.
Stav nebo poloha
Jednoduchý ventil hlásí otevřeno, zavřeno, otevírá se nebo zavírá se. Ventil s polohou může navíc posílat procenta, která je potřeba správně převést a omezit na bezpečný rozsah.
Pokud ventil neposílá zpětný stav, může integrace fungovat optimisticky. U bezpečnostně důležitých ventilů je vhodnější stavový kontakt nebo senzor potvrzující skutečnou polohu.
Bezpečnost provozu
Příkazy pro ventil nikdy netestujte bez znalosti fyzického dopadu. Automatizace zavírání vody, plynu nebo topného okruhu může způsobit škodu, pokud nemá podmínky a ruční override.
Po každé změně ověřte, že příkaz odpovídá směru pohybu. Zaměněné payloady open a close jsou u ventilů výrazně rizikovější než u běžného spínače.
Ú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 Valve. 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.