node-red-dashboard-2-byd-lvs-monitor

Dashboard widget for BYD Battery-Box LVS battery monitoring. Displays live data, cell voltages, temperatures, and historical charts using Node-RED Dashboard 2.0.

Prerequisites

• Node-RED Dashboard 2.0 (@flowfuse/node-red-dashboard)
• node-red-contrib-byd-lvs-monitor — Modbus data acquisition

Install both via the Palette Manager before installing this widget.

Installation

Install via the Node-RED Palette Manager: search for node-red-dashboard-2-byd-lvs-monitor.

Or install manually:

cd ~/.node-red
npm install node-red-dashboard-2-byd-lvs-monitor

Tabs

| Tab | Description | |-----|-------------| | Overview | SOC gauge, pack voltage, current, temperature range, module details | | Cell Voltages | Color-coded heatmap of all cell voltages per module | | Graphs | 24-hour rolling history charts with time range presets (30min–24h) | | Temps | Temperature grid per module with min/max highlighting | | Energy Throughput | Charge/discharge energy counters, estimated cycles, warranty status | | Drift Log | Cell voltage drift heatmap with relative coloring (high drift, low drift near full charge/discharge) | | Help | Built-in data interpretation guide (EN/CS/DE) |

Setup

1. Install this package and the main node-red-contrib-byd-lvs-monitor package
2. Import the example flow: Menu → Import → Examples → node-red-dashboard-2-byd-lvs-monitor
3. Configure the BYD LVS config node with your BMU IP address and port
4. Deploy and open the dashboard

History charts build up automatically from incoming scans (last 24 hours kept in memory, lost on Node-RED restart).

Compatibility

• Node-RED >= 3.0.0
• Node-RED Dashboard 2.0
• Node.js >= 14

Disclaimer

This software is NOT an official BYD diagnostic tool. It is provided "AS IS" without warranty of any kind.

The Ethernet port and its Modbus protocol on the BYD BMU are not documented in the product manual for diagnostic use by end-users or installers. Their availability and open accessibility are purely coincidental and may change with firmware updates without notice. The consequences of frequent or continuous Modbus polling on the BMU are unknown.

By using this software, you acknowledge and agree that:

• The author assumes NO liability for any damages, loss of warranty, or other consequences whatsoever
• You waive all claims for compensation arising from its use
• You accept full responsibility for any decisions made based on information provided by this software
• Incorrect readings may occur due to register misinterpretation, communication errors, or firmware differences

Data interpretation by this tool (including but not limited to warranty estimates, cycle counts, efficiency calculations, and cell drift analysis) reflects the author's understanding and may not be accurate. Always consult official BYD documentation or an authorized service partner for definitive assessments.

By your first use of this software, you irrevocably accept all of the above terms.

BYD and Battery-Box are registered trademarks of BYD Company Limited.

License

MIT