Integrace RichPear Home
MQTT binary sensor
MQTT binary sensor vytváří v RichPear Home binární senzor přepínaný zprávou on/off nebo šablonou. Stránka řeší samostatnou MQTT platformu, která vyžaduje funkční broker a správně navržené topicy.
- Doména
mqtt- Kategorie
- binární senzory
- 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 a testovací MQTT klient.
Před vytvořením entity si zapište state_topic, command_topic, availability_topic a očekávané payloady. U zařízení s fyzickým dopadem testujte nejdřív mimo ostrý provoz.
Lokální adresa
Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.
Nastavení
Přidejte MQTT binary sensor ručně v konfiguraci nebo přes MQTT discovery, pokud ho zařízení podporuje. state_topic převádí příchozí payload na zapnuto, vypnuto nebo nedostupný stav.
Po uložení konfigurace otestujte příchozí stav, odchozí příkaz a chování při restartu zařízení i brokeru.
Topicy
Topicy držte čitelné a konzistentní, například podle typu zařízení, místnosti a entity. Vyhněte se náhodným názvům, které se za měsíc nedají servisovat.
State topic má popisovat skutečný stav, command topic má posílat příkaz. Nemíchejte je do jednoho směru bez jasného důvodu.
Payloady
Payloady musí přesně odpovídat konfiguraci. Pokud zařízení posílá JSON, použijte šablonu a otestujte chybějící klíče.
U ručně psaných payloadů rozlišujte velká a malá písmena, čísla jako text a lokální desetinné oddělovače.
Dostupnost
Availability topic pomáhá poznat, zda zařízení opravdu žije. Bez něj může entita ukazovat poslední známý stav i po výpadku zařízení.
Nastavte last will zprávu na brokeru nebo v zařízení, pokud to firmware podporuje.
Bezpečnost
Používejte device_class podle skutečného významu, například dveře, pohyb nebo voda.
Broker chraňte heslem, oddělte oprávnění pro čtení a zápis a nepoužívejte společný administrátorský účet pro všechna zařízení.
Discovery a YAML
Discovery je rychlé pro zařízení, která ho posílají správně. YAML je lepší tam, kde potřebujete přesnou kontrolu nad názvy, třídami a šablonami.
Po změně discovery zprávy zkontrolujte, zda nevznikly duplicitní entity nebo staré nepoužívané položky.
Údržba
Po aktualizaci firmware zařízení znovu otestujte payloady a dostupnost. Výrobce může změnit hodnoty nebo JSON strukturu.
Při potížích použijte MQTT klienta nebo dump jen dočasně, aby logy nezaplnily systém.
Kontrola po nasazení
Po prvním dni provozu projděte historii entit integrace MQTT binary sensor. Sledujte, zda se hodnoty aktualizují podle typu komunikace configurable a zda se v logu neopakují stejné chyby, odpojení nebo odmítnuté požadavky.
Pokud integrace ovládá reálné zařízení, broker, kamerový obraz, alarm, zámek nebo ruční konfiguraci, nechte správcům jasný postup pro vypnutí automatizace a návrat k ručnímu ovládání. Zapište si také místo, kde se spravuje token, heslo, topic struktura, IP adresa nebo konfigurační soubor.