Victron Energy Nodes for Node-RED

!Node palette

Custom Node-RED nodes for Victron Energy products. Makes it easy to create automations for Victron systems.

The recommended way to use these nodes is through Venus OS Large, where they come pre-installed with Node-RED.

For manual installation and advanced setup, see our Installation Guide.

Documentation

• User Guide - How to use the nodes
• Example Flows
• Developer Guide - Contributing and development setup

Available Nodes

Input Nodes

• Device selector with available Victron equipment
• Measurement selector showing available data points
• Custom labeling options

Output Nodes

• Device selector
• Measurement selector (showing writable services)
• Initial value settings
• Custom labeling options

Virtual Devices

• Battery
• Generator
• GPS
• Grid meter
• Indicator
• Meteo
• Motor drive
• PV inverter
• Switch
• Tank sensor
• Temperature sensor

Utility Nodes

• Inject Notification - Send a pop-up notification to the Venus OS GUI
• Inject Event - Send an event to the VRM portal Event logs tab (Warning, Critical, Info)

Support

This library is community-supported. For help:

• Visit Victron Community
• Check our Wiki
• File issues on GitHub

Contributing

Contributions are welcome! See our Contributing Guide for details.

Development

Setup

TBD

Testing

Unit tests can be run with npm test, see ./package.json for details.

Black box testing, currently experimental, can be run with npm run test:e2e. To run it with live-reload, use npm run test:e2e -- --live.

To run an individual e2e / black box test, against Chrome, with live-reload:

npx testcafe chrome e2etest/switches-config-test.js --live

To run e2e tests against a local installation (without running via VRM), define NODE_RED_ENDPOINT:

VRM_PORTAL_ID=my-portal-id LOCAL_MQTT_ENDPOINT=mqtt://localhost:1883 NODE_RED_ENDPOINT=http://localhost:1880 npm run test:e2e

License

MIT