Skip to content

Register reference

Addresses count from 0, with SunS at 40000. A value is the register times 10 to the power of its scale factor. Every name is the one in the SunSpec model.

Point SunSpec name Address Type Unit Access Notes
1_Mn Manufacturer 40004–40019 string – read C-Battery
701_InvSt Inverter State 40074 enum16 – read What the PCS is doing. Values below
701_W Active Power 40080 int16 W: register × 100 read Positive: discharging
701_W_SF Active Power Scale Factor 40186 sunssf – read
704_WSetEna Set Active Power Enable 40299 enum16 – read/write Values below
704_WSet Active Power Setpoint (W) 40301–40302 int32 W: register × 100 read/write Positive discharges, negative charges
704_WSet_SF Active Power Scale Factor 40332 sunssf – read
713_WHRtg Energy Rating 40346 uint16 Wh: register × 100 read Usable energy
713_WHAvail Energy Available 40347 uint16 Wh: register × 100 read
713_WH_SF Energy Scale Factor 40351 sunssf – read
802_WChaRteMax Nameplate Max Charge Rate 40411 uint16 W: register × 100 read Read it every cycle
802_WDisChaRteMax Nameplate Max Discharge Rate 40412 uint16 W: register × 100 read Read it every cycle
802_SoC State of Charge 40418 uint16 % read
802_AlmRst Alarm Reset 40427 uint16 – read/write 1 resets latched faults. Reads 0 again once done
802_V External Battery Voltage 40441 uint16 V: register × 0.1 read
802_AChaMax Max Charge Current 40452 uint16 A: register × 0.1 read Changes with state of charge and temperature
802_ADisChaMax Max Discharge Current 40453 uint16 A: register × 0.1 read Changes with state of charge and temperature
802_SetOp Set Operation 40457 enum16 – read/write Values below
802_SetInvState Set Inverter State 40458 enum16 – read/write Values below
802_WChaDisChaMax_SF Scale factor for maximum charge and discharge rate 40461 sunssf – read
802_SoC_SF Scale factor for state of charge values 40463 sunssf – read
802_V_SF Scale factor for DC bus voltage 40466 sunssf – read
802_AMax_SF Scale factor for instantaneous DC charge/discharge current 40469 sunssf – read

Every system fills these too. They are for monitoring: you need none of them to control the battery.

Point SunSpec name Address Type Unit Access Notes
701_PF Power Factor 40083 int16 register × 0.001 read
701_Hz Frequency 40087–40088 uint32 Hz: register × 0.001 read
701_AL1 Amps L1 40115 int16 A: register × 0.1 read
701_VL1L2 Phase Voltage L1-L2 40116 uint16 V: register × 0.1 read
701_AL2 Amps L2 40138 int16 A: register × 0.1 read
701_VL2L3 Phase Voltage L2-L3 40139 uint16 V: register × 0.1 read
701_AL3 Amps L3 40161 int16 A: register × 0.1 read
701_VL3L1 Phase Voltage L3-L1 40162 uint16 V: register × 0.1 read
701_A_SF Current Scale Factor 40183 sunssf – read
701_V_SF Voltage Scale Factor 40184 sunssf – read
701_Hz_SF Frequency Scale Factor 40185 sunssf – read
701_PF_SF Power Factor Scale Factor 40187 sunssf – read
713_SoC State of Charge 40348 uint16 %: register × 0.1 read The same as 802_SoC
713_Pct_SF Percent Scale Factor 40352 sunssf – read
714_DCA DC Current 40358 int16 A: register × 0.1 read
714_DCW DC Power 40359 int16 W: register × 100 read
714_DCA_SF DC Current Scale Factor 40368 sunssf – read
714_DCW_SF DC Power Scale Factor 40370 sunssf – read

Every value SunSpec defines for each point that takes one of a list.

Value SunSpec name Meaning
0 OFF Not running
1 SLEEPING Not running, waiting to start
2 STARTING Starting
3 RUNNING Running: it follows 704_WSet
4 THROTTLED Running, held below 704_WSet
5 SHUTTING_DOWN Stopping
6 FAULT It cannot run: see Faults
7 STANDBY Ready, not converting: 704_WSet is 0, or control has ended
Value SunSpec name Meaning
0 DISABLED Control ends
1 ENABLED It follows 704_WSet, with 802_SetInvState = 3
Value SunSpec name Meaning
1 CONNECT Puts the battery on the DC bus
2 DISCONNECT Stops the PCS, then takes the battery off the DC bus. It stays off until you write 1
Value SunSpec name Meaning
1 INVERTER_STOPPED Stops the PCS: control ends
2 INVERTER_STANDBY Not used: write 1 or 3
3 INVERTER_STARTED Starts the PCS, with 704_WSetEna = 1
Type Registers Holds
uint16 1 Unsigned 16-bit integer
int16 1 Signed 16-bit integer
uint32 2 Unsigned 32-bit integer, high register first
int32 2 Signed 32-bit integer, high register first
enum16 1 One of the values listed for the point
string – ASCII, two characters per register, padded with 0
sunssf 1 Scale factor: the power of 10 to multiply by, signed

Where each model starts today, to check your walk against.

Model SunSpec name Starts at
1 Common 40002
701 DER AC Measurement 40070
702 DER Capacity 40225
704 DER AC Controls 40277
713 DER Storage Capacity 40344
714 DER DC Measurement 40353
715 DERCtl 40398
802 Battery Base Model 40407
End – 40471