Integrace RichPear Home
MQTT Vacuum
MQTT Vacuum umožní řídit vysavač, který komunikuje přes MQTT. Podporované příkazy a stavy závisí na firmware vysavače, například start, pauza, návrat do dokovací stanice, režim nebo rychlost ventilátoru.
- Doména
mqtt- Kategorie
- Vysavač
- Komunikace
- Není uvedeno
- 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í
Připravte command topic, state topic a případné topicy pro fan speed, režim, chyby a baterii. První test dělejte v místnosti bez překážek a bez automatizací, které by vysavač spouštěly nečekaně.
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.
Příkazy vysavače
Základní příkazy by měly jasně odpovídat funkcím firmware: start, pause, stop, return to base nebo clean spot podle podporovaných možností. Neposílejte příkaz, který zařízení nezná.
Vlastní příkazy používejte jen s dokumentovaným payloadem daného firmware. U vysavačů se starším nebo komunitním firmware si uložte přesnou verzi a popis příkazů.
Stavy a senzory
Stavový topic má odlišit úklid, pauzu, návrat do doku, nabíjení a chybu. Pokud vysavač posílá baterii nebo chybové kódy, přidejte je jako samostatné senzory nebo atributy podle možností konfigurace.
Automatizace pro úklid plánujte s ohledem na domácí provoz. Před spuštěním kontrolujte dostupnost vysavače, stav baterie a případně přítomnost osob nebo zvířat v místnosti.
Ú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 Vacuum. 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.