Uzly Victron v Node-RED

Paleta Victron

Node-RED má vlastní základní sadu uzlů. Venus OS Large k ní přidává uzly Victron — paletu node-red-contrib-victron. Je předinstalovaná. Uzly pracují přes D-Bus, tedy s hodnotami, které Venus OS zpřístupňuje ze zařízení připojených ke GX. V uzlu se vybírá zařízení a parametr; cesty se zástupnými symboly, např. {tracker}, editor automaticky rozbalí na možnosti dostupné v připojených zařízeních.

• Aktualizace palety — pouze společně s novým Venus OS Large. Paletu nelze aktualizovat ani z editoru, ani z příkazového řádku. Pokud je na internetu již novější paleta, musíte počkat na další vydání Venus OS Large — obvykle vychází krátce po aktualizaci palety.
• Popis uzlů — každý uzel a jeho cesty popisuje wiki projektu na GitHubu (stránky Input nodes, Output nodes a Virtual devices). Z ní pocházejí cesty a hodnoty uvedené na této stránce.
• Další palety — doplňkové uzly, např. dashboard, se instalují z internetu na datový oddíl GX, takže zůstanou zachovány i po aktualizaci Venus OS. Požadované volné místo: první spuštění.

Typy uzlů

Wiki dělí uzly Victron na vstupní, řídicí a virtuální zařízení a samostatně uvádí dva vlastní uzly (custom).

Úplný seznam uzlů zařízení

Všech 33 vstupních uzlů; 18 z nich má také řídicí verzi (ve wiki s dodatkem „Control“). Popisy podle wiki.

Kdy uzel odesílá zprávu

• Při každé změně hodnoty — to je základní chování vstupního uzlu.
• Se zaškrtnutým „only changes“ — pouze tehdy, když se hodnota změní.
• Bez „only changes“ — uzel navíc každých 5 s odesílá aktuální hodnotu, i když se nezměnila.
• Hodnota v pravidelných intervalech — uzlem change uložte msg.payload do kontextu (flow. nebo global.) a uzlem inject jej načítejte ve zvoleném intervalu. Tak funguje vestavěný příklad „Only Messages at Regular Intervals“.
• Kontext po restartu — ve výchozím nastavení je kontext pouze v paměti RAM a při restartu GX nebo výpadku napájení se ztratí. Ukládání na disk se zapíná v souboru /data/home/nodered/.node-red/settings-user.js (úložiště localfilesystem; v příkladu z návodu se ukládá každých 300 s). Neukládejte příliš často, abyste neopotřebovávali paměť flash.

Jak funguje řídicí uzel

Uzel Control zapisuje do zařízení hodnotu z msg.payload. Parametry se seznamem hodnot (enum) se nastavují číslem — v příkladech Victron uzel inject odesílá např. číslo 3 do uzlu Vebus Control, aby zapnul měnič/nabíječ. Hodnoty jednotlivých cest jsou uvedeny v tabulce níže a ve wiki.

• Časový plán — uzel inject může odesílat hodnotu v pevně stanovený čas, ve vybrané dny nebo každých několik minut v určeném časovém okně. Node-RED používá časové pásmo nastavené v Remote Console; po jeho změně je nutné restartovat Node-RED.
• Udržování stavu — příklad „Event Based Scheduling“ propojuje vstupní uzel Vebus (/Mode) s řídicím uzlem, aby v naplánovaných časech udržoval zvolený režim, i když jej někdo omylem změní.
• Nestandardní časové plány — pro svátky, náhodný časový posun nebo soumrak a svítání Victron doporučuje doplňkový uzel node-red-big-timer (nabídka Manage palette → Install).

Užitečné cesty

Každý parametr má svou cestu D-Bus. Zástupné symboly v cestách editor rozbalí na hodnoty dostupné v připojených zařízeních:

Vybrané cesty z wiki — pro automatizaci podle stavu baterie, výroby FV a režimu měniče napětí:

Relé — co nastavit nejdříve

Aby mohl Node-RED přepínat relé, musíte jej nejprve nastavit na ruční ovládání — nejčastěji ve VictronConnect. Poté relé ovládá uzel Relay Control: 1 kontakt sepne (Closed), 0 jej rozepne (Open).

• Relé pro elektrocentrálu — v konzoli GX se nastaví na funkci „Generator“ a povely ke spuštění a zastavení se odesílají uzlem Generator Control (/Start: 1 Start, 0 Stop). Elektrocentrály Fischer Panda spouští uzel Generator přímo přes D-Bus.
• Přepínač na dashboardu — příklad „Relay Switching“ ovládá relé z dashboardu. Aby přepínač zobrazoval i změny provedené jinde, například v nabídce GX, připojí se vstupní uzel Relay také na vstup přepínače. Je potřeba paleta node-red-dashboard — viz dashboard a vzdálený přístup.
• Hotové flow — relé zapínané a vypínané podle stavu baterie: příklad krok za krokem.

Virtuální zařízení

Virtuální zařízení umožňuje připojit k GX hardware nebo zdroj dat, které Victron nepodporuje. Po vytvoření v Node-RED se objeví v GX a chová se jako skutečné zařízení Victron — i v portálu VRM. Příklady z návodu: počasí z API jako virtuální meteorologická stanice, vypočtený odběr ze sítě a dodávka do sítě jako virtuální síťový elektroměr, poloha z GPSd jako virtuální GPS, senzory LoRa nebo MQTT jako virtuální nádrž nebo teplotní čidlo.

1. Aktuální Venus OS. Aktualizujte GX na nejnovější verzi.
2. Uzel Virtual Device. Přidejte jej do flow a vyberte typ zařízení.
3. Data. Připojte zdroj dat nebo řídicí logiku. Do uzlu se odesílá msg.payload jako objekt: klíče jsou cesty D-Bus bez úvodního lomítka, hodnoty jsou naměřené údaje, např. {"Dc/0/Voltage": 48.2, "Dc/0/Current": 12.5, "Soc": 85}.

• Název na D-Bus: com.victronenergy.<typ>.virtual_<id uzlu>.
• Odpojení a obnovení: msg.connected = false odpojí zařízení a uvolní název služby na D-Bus, msg.connected = true jej obnoví.
• Výstup: jeden port — předává původní zprávu s msg.connected nastaveným na aktuální stav připojení k D-Bus.

Virtuální přepínač (Virtual Switch)

Vytvoří přepínač bez fyzického relé — například pro IoT přepínač s firmwarem Tasmota, který flow ovládá podle stavu baterie. Podle návodu se objeví v panelu přepínačů (Switch) nového rozhraní Venus OS, lze jej zapínat a vypínat jako skutečný přepínač a jeho stav se ukládá v GX a může zůstat zachován i po restartu.

• Ovládání: {"SwitchableOutput/output_1/State": 1} zapíná, {"SwitchableOutput/output_1/Dimming": 75} nastavuje úroveň stmívání na 75%. msg.connected = false odpojí přepínač.
• 11 typů: On/Off (0 vyp., 1 zap.), Dimmable (zap./vyp. a stmívání 0–100%), Temperature setpoint (posuvník termostatu v °C), Stepped, Basic slider, Dropdown, Numeric input, Three state (0 Off, 1 On, 2 Auto), RGB color wheel, CCT wheel a RGB+White dimmer.
• Výstupy: port 1 předává zprávu s msg.connected; port 2 odesílá nový stav při jeho změně; port 3 — novou hodnotu stmívání nebo nastavenou hodnotu (typy se stmíváním, kroky, číslem a RGB).

Oznámení a události

Vestavěné příklady

V editoru: nabídka v pravém horním rohu → Import (nebo Ctrl+I) → Examples → node-red-contrib-victron. Stejné příklady jsou ve wiki na stránce Example Flows. Některé vyžadují další palety — nejčastěji node-red-dashboard.

V čem se zdroje liší

• Typy virtuálních zařízení. Návod Venus OS Large (kap. 5.8) uvádí 9: Battery, Generator, GPS, Grid meter, Meteo, Motor drive, PV inverter, Tank sensor a Temperature sensor. Wiki (Virtual devices) uvádí 14: navíc AC Load, DC Load, Electric Vehicle, Energy meter a Pulse meter, přičemž „Motor drive“ je uveden jako E-drive (služba com.victronenergy.motordrive). Které typy máte k dispozici, zjistíte ze seznamu typů v uzlu Virtual Device.
• Kde je vidět virtuální přepínač. Návod: na panelu přepínačů nového rozhraní Venus OS. Wiki: Venus OS jej rozpozná jako připojený I/O extender Cerbo GX a rozhraní GX jej umožňuje ovládat.
• Jak často přicházejí zprávy. FAQ Q9 a příklad „Only Messages at Regular Intervals“: při každé změně a bez „only changes“ navíc každých 5 s. Příklad „Event Based Scheduling“: ve výchozím nastavení každých 5 s, změny se odesílají okamžitě — „přibližně jednou za sekundu“.
• Časy v „Trigger Based Scheduling“. Popis: zapnutí v 6:00, vypnutí ve 22:00. V samotném flow uzel „Trigger 'ON' at 22:00“ odesílá 3 (On) ve 22:00 a „Trigger 'OFF' at 6:00“ odesílá 4 (Off) v 6:00. Po importu zkontrolujte časy a hodnoty v uzlech inject.
• Aktualizace palety. Kap. 5.3 a FAQ Q2: paletu Victron nelze aktualizovat z editoru ani z příkazového řádku — pouze prostřednictvím nové verze Venus OS Large. Kap. 5.6 obecně uvádí, že po instalaci novější verze palety, než je předinstalovaná, použije Node-RED novější verzi. O paletě Victron návod v Q2 výslovně říká: pouze nová verze Venus OS Large.
• Zástupné symboly. Legenda ve wiki uvádí {type}, {tracker}, {phase}, {day}, {input}, {channel} a {index}, ale v popisech cest jsou také {relay} (/Relay/{relay}/State), {line} (/Ac/Consumption/{line}/Power v uzlu System) a {historyDay} (/History/Daily/{historyDay}/Yield v uzlu Solarcharger).

Zařízení, kterých se to týká

Cerbo GXŘídicí centrum systému a brána k portálu VRM.Ekrano GXŘídicí centrum GX s vestavěným dotykovým displejem 7″.

Zdroje

• node-red-contrib-victron wiki — Available nodesgithub.com · EN
• node-red-contrib-victron wiki — Input nodesgithub.com · EN
• node-red-contrib-victron wiki — Output nodesgithub.com · EN
• node-red-contrib-victron wiki — Virtual devicesgithub.com · EN
• node-red-contrib-victron wiki — Example Flowsgithub.com · EN
• Venus OS Large image: Signal K and Node-RED — kap. 2, 5.3–5.8, FAQ Q2, Q9, Q11victronenergy.com · EN