Victron Energy

User Tools

Site Tools

You are here: Documentation » Victron GX product range » Venus OS Large image: Signal K and Node-RED
venus-os:large

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
venus-os:large [2025-08-18 12:01] – Added 5.12 Node-RED files, folders & settings warwickchapmanvenus-os:large [2026-04-15 21:51] (current) – [5.9 Node-RED Dashboard] dfaber
Line 26: Line 26:
 ===== 2. Where to find support ===== ===== 2. Where to find support =====
  
-Victron maintains the integration of Node-RED and SignalK into Venus OS for GX-devices.  However, Victron does not provide support for systems which make use of these extended features to implement advanced solutions.+Node-RED and SignalK are a stable and reliable features in Venus OS Large for GX devices.  There are tens of thousands of systems running Node-RED or SignalK in the field.  However, Victron does not provide support for systems which make use of these extended features to implement advanced solutions.
  
 **Node-RED support** **Node-RED support**
Line 235: Line 235:
 The only charger which has a relay that is controllable is the Smart IP43 Charger. To use that for remote control, set its mode, using the VictronConnect app, to be remote controllable. Note that its use is limited: the relay is only powered (and thus only controllable) when the charger is switched on. It doesn't work when it's turned off with AC connected. This limitation applies to the 230V models as well as the later 120V/240V models. The only charger which has a relay that is controllable is the Smart IP43 Charger. To use that for remote control, set its mode, using the VictronConnect app, to be remote controllable. Note that its use is limited: the relay is only powered (and thus only controllable) when the charger is switched on. It doesn't work when it's turned off with AC connected. This limitation applies to the 230V models as well as the later 120V/240V models.
  
-==== 5.8 Node-RED Dashboard ====+==== 5.8 Virtual devices ====
  
-Besides the flow and automation functionally, Node-RED also offers a fully customisable dashboard. Including graphs, indicators as well as controls such as switches and sliders.+Virtual devices make it possible to connect equipment and data sources that are not natively supported by Victron to a GX device. Once created in Node-RED, these devices appear on the GX-device and behave like real Victron-supported hardware, becoming part of the larger Victron-based solution.
  
-It is viewable in a web browser - both locally as well as remote, via the VRM Servers. See chapter 6.2 for how to see it remotely.+=== Purpose and Examples ===
  
-The [[https://flows.nodered.org/node/node-red-dashboard|dashboard]] needs to be installed, just like other extra palettes, using the Manage Palette feature, on the right of the screen in the menus.+Virtual devices are ideal for integrating third-party or DIY equipment: 
 +  * **Virtual switch** – an IoT switch running Tasmota can be exposed in the GX New UI switch pane, and controlled in automation flows based on conditions such as battery state of charge. 
 +  * **Virtual meteo** – weather data from an unsupported or custom weather system with an API can be injected into a virtual meteo device. The data (e.g. wind speed, temperature, humidity) then becomes visible to the GX and in VRM. 
 +  * **Virtual grid meter** – calculated grid import/export values can be published to the GX device, allowing systems without a supported grid meter to present grid data. 
 +  * **Virtual GPS** – GPSd or another data sources can be used to provide live positional data. 
 +  * **Virtual tank/temperature sensor** – integrate LoRa, MQTT, or custom sensors.
  
-Once that is done, you can find the nodes in the palettes on the left. Once the dashboard has been configured and deployed, an extra tile will appear in the //Venus OS Large// menu on VRM, allowing to connect to the dashboard via VRM.+=== Supported Virtual Devices ===
  
-Example dashboard: +Currently supported device types include: 
-{{ :venus-os:vrm_node_red_ui_step_3.png?direct&600 |VRM Node-RED UI - Step 3}}+  * **Battery** 
 +  * **Generator** 
 +  * **GPS** 
 +  * **Grid meter** 
 +  * **Meteo** (eg. weather station data) 
 +  * **Motor drive** (eg. electric boats) 
 +  * **PV inverter** 
 +  * **Tank sensor** 
 +  * **Temperature sensor**
  
-==== 5.9 Configuration files ====+As separate Virtual Switch node is provided for the virtual switch feature. 
 + 
 +=== Virtual Switches === 
 + 
 +Virtual Switches are a special class of virtual devices: 
 +  * They appear in the **Switch pane** of the **New UI** in Venus OS. 
 +  * They can be controlled like a real digital switch — toggled on/off, queried from the GX, and automated via Node-RED flows. 
 +  * Their state is stored on the GX device and can survive reboots. 
 +  * They are useful for integrating third-party automation logic, external hardware, or remote control scenarios without requiring a physical relay. 
 + 
 +=== Setup === 
 + 
 +  - Update to the latest version of Venus OS. 
 +  - Add the relevant **Virtual Device node** in the Node-RED flow. 
 +  - Configure the device type. 
 +  - Connect it to a data source or control logic. 
 + 
 +==== 5.9 Node-RED Dashboard ==== 
 + 
 +Besides the flow and automation functionality, Node-RED also supports fully customisable dashboards, including graphs, gauges, indicators and controls such as switches and sliders. 
 + 
 +The dashboard is viewable in a web browser - both locally and remotely via VRM. See chapter 7 for remote access. 
 + 
 +**Recommended: FlowFuse Dashboard 2.0** 
 + 
 +Install [[https://flows.nodered.org/node/@flowfuse/node-red-dashboard|@flowfuse/node-red-dashboard]] via the Manage Palette menu (right side of the editor). This is the current, actively maintained dashboard package. The older ''node-red-dashboard'' package is deprecated and should no longer be used. 
 + 
 +Once installed, the dashboard nodes appear in the palette on the left. After configuring and deploying a dashboard, an extra tile appears in the Venus OS Large menu on VRM to access it remotely. 
 + 
 +Example dashboard:  
 + 
 +{{:venus-os:vrm_node_red_ui_step_3.png?600|VRM Node-RED UI - Step 3}} 
 + 
 +**Alternative: uibuilder** 
 + 
 +For users comfortable with HTML, CSS and JavaScript, [[https://flows.nodered.org/node/node-red-contrib-uibuilder|node-red-contrib-uibuilder]] is a powerful alternative that gives full control over the frontend. It does not provide ready-made widgets - you build the UI yourself using any web framework you prefer. This makes it more flexible but significantly more complex than Dashboard 2.0. 
 + 
 +==== 5.10 Configuration files ====
  
 WARNING: the vast majority of systems using Node-RED will not, and should not (!), have to modify any of the files here described. Venus OS itself, including Venus OS large and Node-RED, is made such that its not necessary to dive into the command line. WARNING: the vast majority of systems using Node-RED will not, and should not (!), have to modify any of the files here described. Venus OS itself, including Venus OS large and Node-RED, is made such that its not necessary to dive into the command line.
Line 267: Line 317:
 For more information on such Node-RED configuration customisations, see https://nodered.org/docs/user-guide/runtime/configuration. For more information on such Node-RED configuration customisations, see https://nodered.org/docs/user-guide/runtime/configuration.
  
-==== 5.10 Ready-to-use solutions ====+==== 5.11 Ready-to-use solutions ====
  
 Node-RED can also be used for doing more advanced tasks. Some examples of ready-to-use solutions are: Node-RED can also be used for doing more advanced tasks. Some examples of ready-to-use solutions are:
Line 273: Line 323:
   * [[https://flows.nodered.org/node/node-red-contrib-eskomsepush|EskomSePush]] - use Node-RED for charging the batteries before the next load shedding happens (for South African users)   * [[https://flows.nodered.org/node/node-red-contrib-eskomsepush|EskomSePush]] - use Node-RED for charging the batteries before the next load shedding happens (for South African users)
  
-==== 5.11 Using data from VRM  ====+==== 5.12 Using data from VRM  ====
  
 For some flows it can be useful to retrieve data from the VRM Portal Database. For example to retrieve de Solar irradiation or yield forecasts. For some flows it can be useful to retrieve data from the VRM Portal Database. For example to retrieve de Solar irradiation or yield forecasts.
Line 298: Line 348:
 The [[https://flows.nodered.org/node/victron-vrm-api|Victron VRM API node]] makes it easy to use the VRM API from a Node-RED flow. Alternatively take a look at above mentioned Dynamic-ESS flow. The [[https://flows.nodered.org/node/victron-vrm-api|Victron VRM API node]] makes it easy to use the VRM API from a Node-RED flow. Alternatively take a look at above mentioned Dynamic-ESS flow.
  
-==== 5.12 Node-RED files, folders & settings  ====+==== 5.13 Node-RED files, folders & settings  ====
  
 On GX devices, the ''nodered'' system user has its home in ''/data/home/nodered/''. The actual Node-RED runtime (flows, nodes, configuration, and ''settings-user.js'') lives in ''/data/home/nodered/.node-red/''. On GX devices, the ''nodered'' system user has its home in ''/data/home/nodered/''. The actual Node-RED runtime (flows, nodes, configuration, and ''settings-user.js'') lives in ''/data/home/nodered/.node-red/''.
Line 325: Line 375:
 <code>background-image: url(/image.png);</code> <code>background-image: url(/image.png);</code>
  
-NOTE: All files are stored on ''/data'', which has limited space. Do not store large media files, logs, or large images in ''/data''. Consider hosting such data externally and reference via URL or another Node-RED supported external storage mechanism (database, cloud storage, MQTT, FTP, etc). +Restart Node-RED to apply the changes:
- +
-Managing the Node-RED service:+
  
 **Stop**   **Stop**  
Line 338: Line 386:
 <code>svc -t /service/node-red-venus</code> <code>svc -t /service/node-red-venus</code>
  
-==== 5.13 Node-RED FAQ ====+NOTE: All files are stored on ''/data'', which has limited space. Do not store large media files, logs, or large images in ''/data''. Consider hosting such data externally and reference via URL or another Node-RED supported external storage mechanism (database, cloud storage, MQTT, FTP, etc). 
 + 
 +==== 5.14 Node-RED FAQ ====
  
 === Q1: Write/read file gives "Error: EACCESS: permission denied' === === Q1: Write/read file gives "Error: EACCESS: permission denied' ===
venus-os/large.1755511271.txt.gz · Last modified: by warwickchapman
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki