Węzły Victron w Node-RED

Paleta Victron

Node-RED ma własny, podstawowy zestaw węzłów. Venus OS Large dodaje do niego węzły Victron — paletę node-red-contrib-victron. Jest zainstalowana fabrycznie. Węzły działają na D-Bus, czyli na wartościach, które Venus OS udostępnia z urządzeń podłączonych do GX. W węźle wybiera się urządzenie i parametr; ścieżki z symbolami zastępczymi, np. {tracker}, edytor sam rozwija w opcje dostępne w podłączonych urządzeniach.

• Aktualizacja palety — tylko razem z nowym Venus OS Large. Palety nie da się zaktualizować ani z edytora, ani z wiersza poleceń. Gdy w sieci jest już nowsza paleta, trzeba poczekać na kolejne wydanie Venus OS Large — zwykle pojawia się niedługo po aktualizacji palety.
• Opis węzłów — każdy węzeł i jego ścieżki opisuje wiki projektu na GitHubie (strony Input nodes, Output nodes i Virtual devices). Z niej pochodzą ścieżki i wartości na tej stronie.
• Inne palety — dodatkowe węzły, np. dashboard, instaluje się z internetu na partycję danych GX, więc zostają po aktualizacji Venus OS. Wymagany zapas miejsca: pierwsze uruchomienie.

Rodzaje węzłów

Wiki dzieli węzły Victron na wejściowe, sterujące i urządzenia wirtualne, a osobno wymienia dwa węzły własne (custom).

Pełna lista węzłów urządzeń

Wszystkie 33 węzły wejściowe; 18 z nich ma też wersję sterującą (w wiki z dopiskiem „Control”). Opisy według wiki.

Kiedy węzeł wysyła wiadomość

• Przy każdej zmianie wartości — to podstawowe zachowanie węzła wejściowego.
• Z zaznaczonym „only changes” — tylko wtedy, gdy wartość się zmieni.
• Bez „only changes” — dodatkowo co 5 s węzeł wysyła bieżącą wartość, nawet jeśli się nie zmieniła.
• Wartość w stałym odstępie czasu — węzłem change zapisz msg.payload w kontekście (flow. albo global.), a węzłem inject odczytuj go co wybrany czas. Tak działa wbudowany przykład „Only Messages at Regular Intervals”.
• Kontekst po restarcie — domyślnie kontekst jest tylko w pamięci RAM i znika przy restarcie GX albo zaniku zasilania. Zapis na dysk włącza się w pliku /data/home/nodered/.node-red/settings-user.js (magazyn localfilesystem; w przykładzie z instrukcji zapis co 300 s). Nie zapisuj za często, żeby nie zużywać pamięci flash.

Jak działa węzeł sterujący

Węzeł Control zapisuje do urządzenia wartość z msg.payload. Parametry z listą wartości (enum) ustawia się liczbą — w przykładach Victron węzeł inject wysyła np. liczbę 3 do węzła Vebus Control, żeby włączyć falownik z ładowarką. Wartości każdej ścieżki są w tabeli poniżej i w wiki.

• Harmonogram — węzeł inject może wysyłać wartość o stałej godzinie, w wybrane dni albo co kilka minut w zadanym oknie czasu. Node-RED używa strefy czasowej ustawionej w Remote Console; po jej zmianie trzeba zrestartować Node-RED.
• Pilnowanie stanu — przykład „Event Based Scheduling” łączy węzeł wejściowy Vebus (/Mode) z węzłem sterującym, żeby w zaplanowanych godzinach utrzymać wybrany tryb, nawet gdy ktoś go przypadkiem zmieni.
• Nietypowe harmonogramy — dla świąt, losowego przesunięcia albo zmierzchu i świtu Victron wskazuje dodatkowy węzeł node-red-big-timer (menu Manage palette → Install).

Przydatne ścieżki

Każdy parametr ma swoją ścieżkę D-Bus. Symbole zastępcze w ścieżkach edytor rozwija w wartości dostępne w podłączonych urządzeniach:

Wybrane ścieżki z wiki — do automatyki według stanu baterii, produkcji PV i trybu falownika:

Przekaźniki — co ustawić najpierw

Żeby Node-RED mógł przełączać przekaźnik, trzeba go najpierw przestawić na sterowanie ręczne — najczęściej w VictronConnect. Potem przekaźnikiem steruje węzeł Relay Control: 1 zamyka styk (Closed), 0 go otwiera (Open).

• Przekaźnik do agregatu — ustawia się go w konsoli GX na funkcję „Generator”, a start i stop wysyła węzłem Generator Control (/Start: 1 Start, 0 Stop). Agregaty Fischer Panda węzeł Generator uruchamia bezpośrednio przez D-Bus.
• Przełącznik w dashboardzie — przykład „Relay Switching” steruje przekaźnikiem z dashboardu. Żeby przełącznik pokazywał też zmiany zrobione gdzie indziej, np. w menu GX, węzeł wejściowy Relay podłącza się dodatkowo na wejście przełącznika. Potrzebna paleta node-red-dashboard — zob. dashboard i dostęp zdalny.
• Gotowy flow — przekaźnik włączany i wyłączany według stanu baterii: przykład krok po kroku.

Urządzenia wirtualne

Urządzenie wirtualne pozwala podłączyć do GX sprzęt albo źródło danych, których Victron nie obsługuje. Po utworzeniu w Node-RED pojawia się w GX i zachowuje jak prawdziwe urządzenie Victron — także w portalu VRM. Przykłady z instrukcji: pogoda z API jako wirtualna stacja meteo, wyliczony pobór i oddawanie do sieci jako wirtualny licznik sieci, pozycja z GPSd jako wirtualny GPS, czujniki LoRa albo MQTT jako wirtualny zbiornik lub czujnik temperatury.

1. Aktualny Venus OS. Zaktualizuj GX do najnowszej wersji.
2. Węzeł Virtual Device. Dodaj go do flow i wybierz typ urządzenia.
3. Dane. Podłącz źródło danych albo logikę sterowania. Do węzła wysyła się msg.payload jako obiekt: klucze to ścieżki D-Bus bez początkowego ukośnika, wartości to odczyty, np. {"Dc/0/Voltage": 48.2, "Dc/0/Current": 12.5, "Soc": 85}.

• Nazwa na D-Bus: com.victronenergy.<typ>.virtual_<id węzła>.
• Wyłączenie i powrót: msg.connected = false odłącza urządzenie i zwalnia nazwę usługi na D-Bus, msg.connected = true przywraca je.
• Wyjście: jeden port — przekazuje oryginalną wiadomość z msg.connected ustawionym na bieżący stan połączenia z D-Bus.

Wirtualny przełącznik (Virtual Switch)

Tworzy przełącznik bez fizycznego przekaźnika — np. do przełącznika IoT z oprogramowaniem Tasmota, którym flow steruje według stanu baterii. Według instrukcji pojawia się w panelu przełączników (Switch) nowego interfejsu Venus OS, można go włączać i wyłączać jak prawdziwy przełącznik, a jego stan jest zapisany w GX i może przetrwać restart.

• Sterowanie: {"SwitchableOutput/output_1/State": 1} włącza, {"SwitchableOutput/output_1/Dimming": 75} ustawia ściemnienie na 75%. msg.connected = false odłącza przełącznik.
• 11 typów: On/Off (0 wył., 1 wł.), Dimmable (wł./wył. i ściemnianie 0–100%), Temperature setpoint (suwak termostatu w °C), Stepped, Basic slider, Dropdown, Numeric input, Three state (0 Off, 1 On, 2 Auto), RGB color wheel, CCT wheel i RGB+White dimmer.
• Wyjścia: port 1 przekazuje wiadomość z msg.connected; port 2 wysyła nowy stan, gdy się zmieni; port 3 — nową wartość ściemnienia lub nastawy (typy ze ściemnianiem, krokami, liczbą i RGB).

Powiadomienia i zdarzenia

Wbudowane przykłady

W edytorze: menu w prawym górnym rogu → Import (albo Ctrl+I) → Examples → node-red-contrib-victron. Te same przykłady są w wiki, na stronie Example Flows. Część z nich wymaga dodatkowych palet — najczęściej node-red-dashboard.

Gdzie źródła się różnią

• Typy urządzeń wirtualnych. Instrukcja Venus OS Large (rozdz. 5.8) wymienia 9: Battery, Generator, GPS, Grid meter, Meteo, Motor drive, PV inverter, Tank sensor i Temperature sensor. Wiki (Virtual devices) podaje 14: dochodzą AC Load, DC Load, Electric Vehicle, Energy meter i Pulse meter, a „Motor drive” występuje jako E-drive (usługa com.victronenergy.motordrive). Które typy są dostępne u Ciebie, pokaże lista typów w węźle Virtual Device.
• Gdzie widać wirtualny przełącznik. Instrukcja: w panelu przełączników nowego interfejsu Venus OS. Wiki: Venus OS widzi go jako podłączony I/O extender Cerbo GX, a interfejs GX pozwala go obsługiwać.
• Jak często przychodzą wiadomości. FAQ Q9 i przykład „Only Messages at Regular Intervals”: przy każdej zmianie, a bez „only changes” dodatkowo co 5 s. Przykład „Event Based Scheduling”: domyślnie co 5 s, a zmiany wysyłane od razu — „około raz na sekundę”.
• Godziny w „Trigger Based Scheduling”. Opis: włączenie o 6:00, wyłączenie o 22:00. W samym flow węzeł „Trigger 'ON' at 22:00” wysyła 3 (On) o 22:00, a „Trigger 'OFF' at 6:00” wysyła 4 (Off) o 6:00. Po imporcie sprawdź godziny i wartości w węzłach inject.
• Aktualizacja palety. Rozdz. 5.3 i FAQ Q2: palety Victron nie da się zaktualizować z edytora ani z wiersza poleceń — tylko przez nowe Venus OS Large. Rozdz. 5.6 pisze ogólnie, że po zainstalowaniu nowszej wersji palety niż fabryczna Node-RED użyje nowszej. O palecie Victron instrukcja mówi wprost w Q2: tylko nowe Venus OS Large.
• Symbole zastępcze. Legenda w wiki wymienia {type}, {tracker}, {phase}, {day}, {input}, {channel} i {index}, ale w opisach ścieżek są też {relay} (/Relay/{relay}/State), {line} (/Ac/Consumption/{line}/Power w węźle System) i {historyDay} (/History/Daily/{historyDay}/Yield w węźle Solarcharger).

Urządzenia, których to dotyczy

Cerbo GXCentrum sterowania systemem i brama do portalu VRM.Ekrano GXCentrum GX z wbudowanym ekranem dotykowym 7″.

Źródła

• 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 — rozdz. 2, 5.3–5.8, FAQ Q2, Q9, Q11victronenergy.com · EN