Návod jak pracovat v Node Red pro Home Assistant

Stručně: Node-RED je vizuální nástroj pro automatizace v Home Assistantu – propojováním bloků (nodů) bez psaní kódu. Základní kameny: Events: State (spouštěč), Debug (ladění), Switch (filtrování), Call Service (akce) a Delay (zpoždění). Pro podmínky slouží Current State, pro testování Inject. Zigbee zařízení se ovládají přes Entity nod nebo přímo přes MQTT In.

Michal Chaláni natočil sérii tří videí, kde krok za krokem ukazuje, jak pracovat s Node-RED v Home Assistant. Videa jsou česko-slovensky, určená pro úplné začátečníky – žádné programátorské zkušenosti nepotřebujete. Stačí mít nainstalovaný Home Assistant s Node-RED add-onem a aspoň jedno IoT zařízení.

Ke každému dílu je níže textový souhrn a pár tipů navíc.

Díl I – Základní notky: Events State, Debug, Switch, Delay

https://www.youtube.com/watch?v=ASN4JKPHkjY

Michal začíná s nejzákladnějším scénářem – dveřní senzor ovládá lampičku. Otevře se okno, rozsvítí se světlo. Zavře se okno, zhasne. Jednoduché, ale na tomhle příkladu předvede pět klíčových notek:

  • Events: State – spouštěč automatizace. Reaguje na změnu stavu entity (senzor, světlo, přepínač). Každá změna vyšle zprávu do dalšího nodu.
  • Debug – nepostradatelný pomocník. Vypisuje, co z nodu odchází. Pravidlo číslo jedna: vždycky nejdřív debug, pak teprve akce.
  • Switch – filtruje zprávy podle payloadu. Pokud payload = ON, jde výstupem 1. Pokud OFF, jde výstupem 2. Funguje jako rozcestník.
  • Call Service – volá službu Home Assistantu. Například light.turn_on nebo light.turn_off. Entitu vyberete přímo v nastavení nodu.
  • Delay – podrží zprávu o nastavený čas. Hodí se na automatické vypnutí světla po určité době – kontrolní automatizace, která zabrání tomu, aby světlo zůstalo zapnuté celou noc.

Důležitý detail: notka Events: State má dva výstupy. Horní prochází, když je splněna podmínka (např. stav ON). Spodním jde všechno ostatní – nejen opačný stav, ale i „unavailable“ (nedostupný). Michal na to přímo upozorňuje – u světel, která občas vypadnou ze sítě, to může způsobit nechtěné chování automatizace.

Nastavit se dá i prodleva – okno musí být otevřené minimálně 10 sekund, teprve pak se akce spustí. To je užitečné, když nechcete reagovat na krátké otevření dveří.

Díl II – Podmínky a testování: Current State, Poll State, Inject

https://www.youtube.com/watch?v=Cn0Hh_1P27s

Druhý díl přidává nástroje pro složitější logiku:

  • Poll State – podobný Events: State, ale kontroluje stav entity v pravidelných intervalech (např. každých 60 sekund). Hodí se tam, kde potřebujete periodicky ověřovat stav.
  • Current State – funguje jako podmínka (if). Zkontroluje aktuální stav entity a podle výsledku pustí tok dál, nebo ho zastaví. Michal to používá jako „klopný obvod“ – jedním tlačítkem zapne i vypne světlo, protože si nejdřív zjistí aktuální stav a udělá přesný opak.
  • Inject – manuální spouštěč. Kliknutím vyšlete zprávu do flow. Nenahraditelné při testování – nemusíte pokaždé fyzicky otvírat okno nebo mačkat tlačítko.
  • Call Service s parametry – při zapínání světla můžete rovnou nastavit jas (brightness_pct: 25), barvu nebo jiné atributy. Michal ukazuje, jak v noci zapínat světlo jen na 5 %, aby neoslnilo.

Zmíněni jsou i Helpers (Pomocníci) v Home Assistantu – virtuální přepínače, posuvníky, časovače. Entity, které fyzicky neexistují, ale ovládají se přes Node-RED stejně jako reálná zařízení. Michal jim chce věnovat samostatné video.

Praktický tip z videa: komentujte si flow. Dvojklik na plátno → komentář. Dnes víte, co ten flow dělá. Za měsíc ne. Michal sám přiznává, že dlouho nekomentoval a pak se v tom ztrácel.

Díl III – MQTT a ovládání IKEA tlačítka přes Zigbee2MQTT

https://www.youtube.com/watch?v=cCRjRkwl1b4

Třetí díl ukazuje práci s MQTT – protokolem, přes který komunikuje většina Zigbee zařízení napojených přes Zigbee2MQTT.

Michal napáruje IKEA tlačítko (obdélníkový ovladač) a předvede dva přístupy:

Přes Entity nod – jednodušší varianta. Vyberete entitu tlačítka, debug ukáže payload (ON, OFF, brightness_move_up, brightness_stop…). Pak stačí Switch s více výstupy a na každý navěsit akci.

Přes MQTT In nod – univerzálnější. V MQTT Exploreru nebo v logách Zigbee2MQTT najdete topic tlačítka, vložíte ho do MQTT In nodu a pracujete se surovými zprávami. Výsledek je stejný, ale máte větší kontrolu nad daty.

Zajímavý vzor z videa: podržení tlačítka generuje zprávu brightness_move_up, puštění brightness_stop. Mezi těmito dvěma signály se dá spustit smyčka, která každých 100 ms přidá kousek jasu – a puštění tlačítka ji zastaví. Podobný princip se dá použít pro jakékoliv plynulé ovládání.

Praktické tipy pro práci s Node-RED

Pár doporučení, která ve videích nezazněla, ale ušetří čas a nervy (hlavně ty nervy):

Pojmenujte si nody. Výchozí názvy jako „events: state“ nic neříkají. Přejmenujte na „Senzor okno ložnice“ nebo „Lampička ON“ – při dvaceti automatizacích to oceníte.

Rozdělte flow do záložek. Jedna záložka pro osvětlení, další pro topení, další pro bezpečnost. Node-RED to podporuje nativně – záložky nahoře.

Subflows pro opakující se logiku. Pokud máte stejnou sekvenci nodů na pěti místech (třeba odeslání notifikace na telefon), označte je, pravý klik → Selection to Subflow. Vznikne znovupoužitelný blok, který editujete na jednom místě.

Zálohujte. Home Assistant snapshot automaticky zahrnuje i Node-RED flows. Pro ruční zálohu: Menu → Export → JSON. Soubor flows.json je přístupný i přes File Editor nebo Samba add-on. Člověk to řeší až když je pozdě – nebuďte ten člověk.

Pozor na aktualizace Home Assistantu. Občas se stane, že po aktualizaci HA přestanou fungovat entity vytvořené přes Node-RED, nebo se add-on nenačte. Než aktualizujete, mrkněte do release notes HA a na komunitní fórum, jestli někdo nehlásí problémy s Node-RED.

Node-RED vs. nativní automatizace HA

Videa vznikla v roce 2021 a od té doby se nativní automatizace v Home Assistantu výrazně posunuly. Vizuální editor zvládne většinu scénářů, které dříve vyžadovaly YAML nebo Node-RED. Blueprints umožňují sdílet a importovat hotové automatizace.

Kdy se Node-RED stále vyplatí? Tam, kde potřebujete složitější větvení (víc než 2–3 podmínky), práci s raw MQTT daty, napojení na externí API a služby mimo HA, nebo kde chcete vizuálně vidět celý tok automatizace najednou. Pro jednoduché „když X, tak Y“ scénáře je nativní editor HA rychlejší a spolehlivější – žádná závislost na dalším add-onu.

Oba přístupy se dají bez problémů kombinovat. Jednoduché věci v HA, složité v Node-RED. A nikdo neříká, že se to nedá časem přehodit.

Aktuální stav projektu (2026)

Node-RED je aktuálně ve verzi 4.1.x. Řada 4.x je v režimu údržby – opravy chyb a bezpečnostní záplaty. Nové funkce míří do připravované verze Node-RED 5.0, která přinese přepracované UX.

Home Assistant add-on je udržovaný komunitou (hassio-addons). Hlavní integrační balík node-red-contrib-home-assistant-websocket (od zachowj) zajišťuje propojení s HA přes WebSocket API.

Node-RED vyžaduje minimálně Node.js 18, doporučuje se Node.js 20.

Užitečné odkazy

Ptáte se

Co je Node-RED a k čemu slouží v Home Assistantu?

Node-RED je vizuální programovací nástroj, který umožňuje vytvářet automatizace propojováním funkčních bloků (nodů) bez psaní kódu. V Home Assistantu se instaluje jako add-on a slouží k tvorbě složitějších automatizací, než jaké zvládne nativní editor HA.

Jaké jsou základní notky (nody) pro začátečníky?

Events: State (spouštěč při změně stavu entity), Debug (výpis zpráv pro ladění), Switch (filtrování payloadu), Call Service (volání služeb HA jako zapnutí světla), Delay (časové zpoždění), Current State (kontrola podmínky) a Inject (ruční spouštění pro testování).

Kdy použít Node-RED a kdy nativní automatizace Home Assistantu?

Node-RED se vyplatí pro složitější logiku s více podmínkami, práci s raw MQTT daty a napojení na externí API. Pro jednoduché scénáře typu „když X, tak Y“ je nativní editor HA rychlejší a spolehlivejší. Oba přístupy se dají kombinovat.

Jak zálohovat Node-RED flows?

Home Assistant snapshot automaticky zahrnuje Node-RED flows. Ručně: v Node-RED Menu → Export → JSON. Soubor flows.json je přístupný i přes File Editor nebo Samba add-on.

Jaká je aktuální verze Node-RED?

Node-RED je ve verzi 4.1.x (2026). Řada 4.x je v režimu údržby, nové funkce míří do připravované verze 5.0. Vyžaduje minimálně Node.js 18, doporučuje se Node.js 20.
Sdílejte článek:
Ukaž světu,
že jsi Maker!
Koupit tričko
Kafe pro Chiptrona
Dodej energii dalšímu článku

Související články

Martin Chlebovec mi poslal další zajímavý článek.

Používání AI při bastlení už není sci-fi. Stává se z něj běžný nástroj – podobně jako datasheet, osciloskop nebo Google. Rozdíl je ale v tom, že kvalita výsledku extrémně závisí na tom, jak AI zadáte úkol. Dobře napsaný prompt vám…

Vytvořit informační displej pro ESPHome není úplně jednoduchá zábava. Každá změna znamená úpravu YAMLu, nahrání do zařízení a čekání, jestli to konečně vypadá tak, jak jste chtěli. Přesně tohle se snaží řešit nástroj ESPHome Designer.

Daniel Skopalík sdílel návod, jak použít populární jednodeskový počítač RaspberryPi jako JTAG programátor například ESP32.

Kdo by neznal Home Assistent – službu pro domácí automatizaci.

V komunitách o domácí automatizaci patří mezi nejčastější otázku to, na čem rozjet server (například HomeAssistant).

Trendy