Narada Batteries

Purpose

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