Huawei Luna ESS

Purpose

The purpose of this plugin is to collect data from Huawei Luna Energy Storage System (ESS).

Usage

This plugin reads the data from Huawei Luna ESS, via Modbus serial or TCP. Data will be collected to the storage table. By default, it will collect data every 5 minutes, but can collect at a minimum rate of 1 second, depending on the speed of the serial connection. The plugin will make 1 attempt (by default) to read the data. The plugin will collect from the following types of Huawei ESS:

LUNA2000-2.0MWH-1H0
LUNA2000-2.0MWH-2H0
LUNA2000-2.0MWH-1H1
LUNA2000-2.0MWH-2H1
LUNA2000-2.0MWH-4H1
LUNA2000-1.0MWH-1H1

But be aware, not all variables may be collected. Please use discover to check the data before implementing collection to the cloud. There are 2 files with this plugin. The file called luna2000c_container_subsystem.txt will collect the ESS container data. The following variables will be collected:

Variable Name                               Units
==================================================
Container Status 1                         
Container Status 2                         
Container Status 3                         
Battery Cabin Temperature 1                °C
Battery Cabin humidity 1                   %
Battery Cabin Temperature 2                °C
Battery Cabin humidity 2                   %
Battery Cabin Temperature 3                °C
Battery Cabin humidity 3                   %
Battery Cabin Temperature 4                °C
Battery Cabin humidity 4                   %
Control Unit Cabin Temperature 1           °C
Control Unit Cabin Humidity 1              %
Control Unit Cabin Dew Point Temperature   °C
Battery Cabin Dew Point Temperature        °C
Battery SOC                                 %
Daily Energy Charged                        kWh
Daily Energy Discharged                     kWh
Total Auxiliary Energy Consumption          kWh
Charge Discharge Power                      kW
Chargeable Capacity                         kWh
Dischargeable Capacity                      kWh
CO Concentration 1                          ppm
CO Concentration 2                          ppm
CO Concentration 3                          ppm
CO Concentration 4                          ppm
CO Concentration 5                          ppm
CO Concentration 6                          ppm
H2 Concentration 1                          ppm
Alarm 1                                     
Alarm 2                                     
Fan speed 1                                 RPM
Fan speed 2                                 RPM
Fan speed 3                                 RPM
Fan speed 4                                 RPM
Fan speed 5                                 RPM
Fan speed 6                                 RPM
Fan speed 7                                 RPM
Fan speed 8                                 RPM
Fan speed 9                                 RPM
Fan speed 10                                RPM
Fan speed 11                                RPM
Fan speed 12                                RPM
DC Voltage                                  V
DC Current                                  A
AC Voltage 1                                V
AC Voltage 2                                V
AC Voltage 3                                V
AC Power 1                                  W
AC Power 2                                  W
AC Power 3                                  W
Active Power                                W
Reactive Power                              var
Power Factor                                
Total output voltage of rectifiers         V
Total output current of rectifiers         A
Quantity of rectifiers                      
Total output power of rectifiers           W

The file called luna2000c_ess_subsystem.txt will collect the ESS container data. The following variables will be collected:

Variable Name                               Units
==============================================
Device Status                              
Rack Voltage                               V
Rack Current                               A
Battery SOC                                %
Battery SOH                                %
Charge Discharge Power                     kW
SOE                                        %
DOD                                        %
Chargeable Capacity                        kWh
Dischargeable Capacity                     kWh
Highest Pack Temperature                   °C
Pack Highest Temperature                   
Lowest Pack Temperature                    °C
Pack Lowest Temperature                    
Lowest Pack Voltage                        V
Pack Lowest Voltage                        
Highest Pack Voltage                       V
Pack Highest Voltage                       
Daily Energy Charged                       kWh
Daily Energy Discharged                    kWh
Device Status                              
Rack Voltage                               V
Rack Vurrent                               A
Battery SOC                                %
Battery SOH                                %
SOE                                        %
DOD                                        %
Chargeable Capacity                        kWh
Dischargeable Capacity                     kWh
Highest Pack Temperature                   °C
Pack Highest Temperature                   
Lowest Pack Temperature                    °C
Pack Lowest Temperature                    
Lowest Pack Voltage                        V
Pack Lowest Voltage                        
Highest Pack Voltage                       V
Pack Highest Voltage                       
Daily Energy Charged                       kWh
Daily Energy Discharged                    kWh
Cabinet Temperature                        °C
ISO Insulation Resistance 1               MOhm
Battery Voltage 1                          V
Bus Voltage 1                              V
Battery Current 1                          A
Bus Current 1                              A
ISO Insulation Resistance 2               MOhm
Battery Voltage 2                          V
Bus Voltage 2                              V
Battery Current 2                          A
Bus Current 2                              A
Running Status 1                           
Running Status 2                           
Alarm 1                                    
Alarm 2                                    
Alarm 3                                    
Alarm 4

The file called luna_pcs.txt will collect the PCS data for the models LUNA2000-200KTL-H1 and LUNA2000-100KTL-NHH1. The following variables will be collected:

Variable Name                            Units
==============================================
Rated Power                              W
Maximum AC Power                         W
Maximum Apparent Power                   VA
Maximum Reactive Power Feed              var
Maximum Reactive Power Supply            var
Real Time Charge Power                   W
Reverse Rectifier Maximum Power          W
Real Time Discharge Power                W
Status 1                                 
Status 2                                 
Alarm 1                                  
Alarm 2                                  
Alarm 3                                  
Alarm 4                                  
AC Voltage 12                            V
AC Voltage 23                            V
AC Voltage 31                            V
AC Voltage 1                             V
AC Voltage 2                             V
AC Voltage 3                             V
AC Current 1                             A
AC Current 2                             A
AC Current 3                             A
Active Power                             W
Reactive Power                           var
Power Factor                             
Grid Freq                                Hz
Efficiency                               %
Internal Temperature                     °C
Insulation Resistance                    Mohm
Device Status                            
Error Code                               
Startup Time                             
Shutdown Time                            
DC Voltage                               V
DC Current                               A
Total Power Supply from Grid             Wh
Daily Energy                             Wh
Daily Energy from Grid                   Wh
System Time                              
Q-U Characteristic Curve Mode            
Q-U Dispatch Trigger Power               %
Active Power Percentage                  %
Reactive Power Compensation Q/S          %
Fixed Active Power                       W
Reactive Power Compensation PF           
Fixed Nighttime Reactive Power           var
On                                       
Off

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. A Modbus address in the range 2-255. This can be a hyphenated list like 3-10 or a list like 2,5,7,9

• --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 a 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

• --stop_on_any_command_fail. If this is specified, then any Modbus commands that fail will stop all further queries for all bus addresses and attempts.

• --serial_lock. If this is set, the program can only be run one at a time (so as not to overload a Modbus device). If the device being queried is a serial device, this will automatically be set to "on". For IP addresses it is optional.

• --sampling_rate. If this is defined, and the sampling rate is greater than 1, then all DECIMAL and SWAP16 values will be collected as an average. In other words; it will take a sample at the nominated frequency. After X samples defined by sampling_rate, a record will be written and sent to the cloud.