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.
Points
Section titled “Points”| 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 |
Measurements
Section titled “Measurements”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 |
Values
Section titled “Values”Every value SunSpec defines for each point that takes one of a list.
701_InvSt: Inverter State
Section titled “701_InvSt: Inverter State”| 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 |
704_WSetEna: Set Active Power Enable
Section titled “704_WSetEna: Set Active Power Enable”| Value | SunSpec name | Meaning |
|---|---|---|
| 0 | DISABLED | Control ends |
| 1 | ENABLED | It follows 704_WSet, with 802_SetInvState = 3 |
802_SetOp: Set Operation
Section titled “802_SetOp: Set Operation”| 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 |
802_SetInvState: Set Inverter State
Section titled “802_SetInvState: Set Inverter State”| 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 |
Models
Section titled “Models”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 |