All devices

SolarEdge · Solar inverter

Single / three phase inverter with SetApp (SunSpec) Modbus register map

Download JSONSupplier documentationSuggest an edit

Default configuration

Protocol
Modbus TCP
Port
502
Unit ID
1
Addressing
0-based
Byte order
Big endian
Word order
High word first

Register map

AddressCountNameTypeUnitScaleAccess
400002
SunSpec identifier ("SunS")
0x53756E53.
UInt32-1R
400021
SunSpec model ID (common)
1 = common model.
UInt16-1R
400031
SunSpec common model length
65 registers follow.
UInt16-1R
4000416
Manufacturer
"SolarEdge".
Ascii-1R
4002016
Model
Inverter model, e.g. "SE5000".
Ascii-1R
400448
Firmware version
CPU software version with leading zeroes, e.g. "0002.0611".
Ascii-1R
4005216
Serial number
Ascii-1R
400681
Modbus unit ID
The inverter's own Modbus address.
UInt16-1R
400691
SunSpec model ID (inverter)
101 = single phase, 102 = split phase, 103 = three phase. SolarEdge uses the int+SF models; the float models 111-113 are not provided.
UInt16-1R
400701
SunSpec inverter model length
50 registers follow.
UInt16-1R
400711
AC current, total
Raw value; apply A_SF at 40075.
UInt16A1R
400721
AC current, phase A
UInt16A1R
400731
AC current, phase B
UInt16A1R
400741
AC current, phase C
UInt16A1R
400751
AC current scale factor (A_SF)
Engineering value = raw x 10^SF.
Int16-1R
400791
AC voltage, phase A-N
UInt16V1R
400801
AC voltage, phase B-N
UInt16V1R
400811
AC voltage, phase C-N
UInt16V1R
400821
AC voltage scale factor (V_SF)
Engineering value = raw x 10^SF.
Int16-1R
400831
AC active power
Raw value; apply W_SF at 40084.
Int16W1R
400841
AC power scale factor (W_SF)
Engineering value = raw x 10^SF.
Int16-1R
400851
AC frequency
Raw value; apply Hz_SF at 40086.
UInt16Hz1R
400861
AC frequency scale factor (Hz_SF)
Engineering value = raw x 10^SF.
Int16-1R
400871
AC apparent power
Raw value; apply VA_SF at 40088.
Int16VA1R
400881
AC apparent power scale factor (VA_SF)
Engineering value = raw x 10^SF.
Int16-1R
400891
AC reactive power
Raw value; apply VAr_SF at 40090.
Int16var1R
400901
AC reactive power scale factor (VAr_SF)
Engineering value = raw x 10^SF.
Int16-1R
400911
Power factor
Raw value; apply PF_SF at 40092.
Int16%1R
400921
Power factor scale factor (PF_SF)
Engineering value = raw x 10^SF.
Int16-1R
400932
AC lifetime energy
Raw value; apply WH_SF at 40095. Divide by 1000 for kWh.
UInt32Wh1R
400951
AC lifetime energy scale factor (WH_SF)
Engineering value = raw x 10^SF.
Int16-1R
400961
DC current
Raw value; apply DCA_SF at 40097. Only one DC input is reported; per-string data needs the SolarEdge monitoring platform.
UInt16A1R
400971
DC current scale factor (DCA_SF)
Engineering value = raw x 10^SF.
Int16-1R
400981
DC voltage
Raw value; apply DCV_SF at 40099.
UInt16V1R
400991
DC voltage scale factor (DCV_SF)
Engineering value = raw x 10^SF.
Int16-1R
401001
DC power
Raw value; apply DCW_SF at 40101.
Int16W1R
401011
DC power scale factor (DCW_SF)
Engineering value = raw x 10^SF.
Int16-1R
401021
Cabinet temperature
Raw value; apply Tmp_SF at 40106.
Int16°C1R
401031
Heat sink temperature
Raw value; apply Tmp_SF at 40106.
Int16°C1R
401061
Temperature scale factor (Tmp_SF)
Engineering value = raw x 10^SF.
Int16-1R
401071
Inverter operating state
1 = Off, 2 = Sleeping, 3 = Starting, 4 = MPPT (producing), 5 = Throttled, 6 = Shutting down, 7 = Fault, 8 = Standby.
UInt16-1R
401092
Inverter events 1
SunSpec model 101-103 Evt1 bit field.
UInt32-1R
401211
SunSpec model ID (meter common)
1 = SunSpec common model. Present only when a SolarEdge energy meter is enabled.
UInt16-1R
401221
Meter common model length
65 registers follow.
UInt16-1R
4012316
Meter manufacturer
Ascii-1R
4013916
Meter model
Ascii-1R
401558
Meter option
Connection type, e.g. "Export+Import" or "Production".
Ascii-1R
401638
Meter version
Ascii-1R
4017116
Meter serial number
Ascii-1R
401871
Meter Modbus unit ID
UInt16-1R
401881
SunSpec model ID (meter)
201 = single phase, 202 = split phase, 203 = three phase wye, 204 = three phase delta.
UInt16-1R
401891
SunSpec meter model length
UInt16-1R
401901
AC current, total
Raw value; apply A_SF at 40194.
Int16A1R
401911
AC current, phase A
Int16A1R
401921
AC current, phase B
Int16A1R
401931
AC current, phase C
Int16A1R
401941
Meter current scale factor (A_SF)
Engineering value = raw x 10^SF.
Int16-1R
401951
AC voltage, line to neutral (average)
Raw value; apply V_SF at 40203.
Int16V1R
402031
Meter voltage scale factor (V_SF)
Engineering value = raw x 10^SF.
Int16-1R
402041
AC frequency
Raw value; apply Hz_SF at 40205.
Int16Hz1R
402051
Meter frequency scale factor (Hz_SF)
Engineering value = raw x 10^SF.
Int16-1R
402061
AC active power, total
Raw value; apply W_SF at 40210. Positive = import from the grid.
Int16W1R
402101
Meter power scale factor (W_SF)
Engineering value = raw x 10^SF.
Int16-1R
402161
AC reactive power, total
Int16var1R
402211
Power factor (average)
Raw value; apply PF_SF at 40225.
Int16%1R
402251
Meter power factor scale factor (PF_SF)
Engineering value = raw x 10^SF.
Int16-1R
402262
Total exported energy
Raw value; apply TotWh_SF at 40242.
UInt32Wh1R
402342
Total imported energy
Raw value; apply TotWh_SF at 40242.
UInt32Wh1R
402421
Meter energy scale factor (TotWh_SF)
Engineering value = raw x 10^SF.
Int16-1R
614411
Active power limit (Power Control)
SolarEdge power control register 0xF001: site active power limit in % of the inverter's rated power. Takes effect only in a grid-code/power-control configuration and must be committed with register 61696.
UInt16%1RW
616961
Commit power control settings
Register 0xF100: write 1 to commit the values written to the power control registers.
UInt16-1RW

Notes

SolarEdge inverters speak SunSpec Modbus TCP on port 502, unit ID 1. Modbus TCP must be enabled with SetApp (Communication -> LAN -> Modbus TCP) or, on inverters with an LCD, from the Communication menu; only one Modbus leader may talk to the inverter at a time, and SolarEdge recommends keeping the monitoring connection in parallel. The SunSpec map starts at base address 40000: common model at 40000, inverter model 101/102/103 at 40069 and, when an energy meter is installed, the meter's own common block at 40121 and its meter model 201-204 at 40188. A second and third meter follow at 40295 and 40469 (add 50 registers for 2-unit and 70 for 3-unit Synergy inverters). SolarEdge uses the integer-with-scale-factor (int+SF) models, so every measurement has a paired scale factor register: engineering value = raw x 10^SF, and the scale factors are chosen by the inverter rather than fixed. Reading a meter requires the meter to be enabled; the meter type is in the meter model ID. The vendor power control registers at 61441/61696 are only meaningful with a grid-code configuration and are documented in SolarEdge's power control application note, not in the SunSpec document. Points the inverter does not implement read as 0xFFFF (uint16, enum16), 0x8000 (int16) or 0xFFFFFFFF (acc32), so filter those values. Addresses are the base-0 (wire) addresses of the technical note. Source: SolarEdge "Inverters - SunSpec Logging - Technical Note" (version 3.0) together with the SunSpec models.