The purpose of this plugin is to collect data from Narada Grid Scale Batteries.
Usage
This plugin collects from Narada Grid Scale Batteries. There are three plugin configuration files, namely: narada_bms.txt, narada_bms_testing.txt and narada_rack.txt. All files use the Modbus protocol and collect data via TCP. Battery data will be collected to the ess table and will be run every 1 minute, by default. This plugin relies on the Modbus Ardexa plugin. The following data will be collected for the BMS data:
Variable Name Units
=====================================
Connection Status
Rack Status
Rack Step In
Rack Cut Out
Status
Charge Status
BAU Alarm Status
Rack Warning
Rack Alarm
Rack Critical Alarm
System Total Voltage V
System Total Current A
State of Charge %
State of Health %
System Insulation kΩ
System Charge Energy kWh
System Discharge Energy kWh
System Max Charge Current A
System Max Discharge Current A
Rack Current Difference A
Rack Voltage Difference V
System Max Vol Cell Rack ID
System Max Vol Cell Slave ID
System Max Vol Cell ID
System Max Cell Voltage mV
System Min Vol Cell Rack ID
System Min Vol Cell Slave ID
System Min Vol Cell ID
System Min Cell Voltage mV
System Average Voltage mV
System Max Temp Cell Rack ID
System Max Temp Cell Slave ID
System Max Temp Cell ID
System Max Cell Temperature °C
System Min Temp Cell Rack ID
System Min Temp Cell Slave ID
System Min Temp Cell ID
System Min Cell Temperature °C
System Average Temperature °C
The following data will also be collected for the narada_bms_testing.txt file. This data will be sent to the test table, but it is only designed to show data for the DISCOVERY action using the Modbus plugin.
Variable Name Units
=====================================
Heartbeat
Year
Month
Day
Hour
Minute
Second
The following data will be collected for the Rack data, using the file narada_rack.txt. There are usually 9 racks per BMS.
Variable Name Units
=====================================
Rack Operation State
Rack Charge Status
Rack Connection Status
Rack Alarm Info
Rack Warning
Rack Alarm
Rack Critical Alarm
Rack Voltage V
Rack Current A
Rack Charge Status
State of Charge %
State of Health %
Rack Insulation Value kΩ
Rack Positive Insulation Value kΩ
Rack Negative Insulation Value kΩ
Rack Max Charge Current A
Rack Max Discharge Current A
Rack Max Vol Cell ID
Rack Max Cell Voltage mV
Rack Min Vol Cell ID
Rack Min Cell Voltage mV
Rack Max Temperature Cell ID
Rack Max Cell Temperature °C
Rack Min Temperature Cell ID
Rack Min Cell Temperature °C
Rack Average Voltage mV
Rack Average Temperature °C
Arguments
Arguments are as follows:
endpoint. This is either a serial device like /dev/ttyS0 or an IP or DNS like 192.168.1.15
bus_addresses. The modbus address for the BMS is 1, and the racks start at 2
--port. This is an optional parameter used in an Ethernet gateway, and is the TCP port used for the gateway. Default is 502
--attempts. This is an optional parameter, and determines how many times to times to attempt to read an inverter value. Default is 1
--delay. This is the delay in seconds between inverter send and receive commands, AND if attempts > 1. Fractions like 0.3 can be used. Default is 0.05
