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. The addresses come from a rack (Unit ID 101) on software 2.0.
Points
Section titled “Points”| Point | SunSpec name | Address | Type | Unit | Access | Notes |
|---|---|---|---|---|---|---|
1_Mn |
Manufacturer | 40004–40019 | string | – | read | C-Battery |
1_Vr |
Version | 40044–40051 | string | – | read | The rack’s software version, such as 2.0.0 |
1_DA |
Device Address | 40068 | uint16 | – | read | Modbus device address |
701_InvSt |
Inverter State | 40074 | enum16 | – | read | 3 running, 7 standby, 6 fault |
701_W |
Active Power | 40080 | int16 | W: register × 100 | read | Positive: discharging |
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 | −1 |
701_V_SF |
Voltage Scale Factor | 40184 | sunssf | – | read | −1 |
701_Hz_SF |
Frequency Scale Factor | 40185 | sunssf | – | read | −3 |
701_W_SF |
Active Power Scale Factor | 40186 | sunssf | – | read | 2 |
701_PF_SF |
Power Factor Scale Factor | 40187 | sunssf | – | read | −3 |
701_VA_SF |
Apparent Power Scale Factor | 40188 | sunssf | – | read | 2 |
701_Var_SF |
Reactive Power Scale Factor | 40189 | sunssf | – | read | 2 |
704_WSetEna |
Set Active Power Enable | 40299 | enum16 | – | read/write | 1: the rack follows 704_WSet. 0: standby |
704_WSetMod |
Set Active Power Mode | 40300 | enum16 | – | read/write | Fixed at 1, watts. Don’t write it |
704_WSet |
Active Power Setpoint (W) | 40301–40302 | int32 | W: register × 100 | read/write | Positive discharges, negative charges. Below 500 W either way: standby |
704_WSet_SF |
Active Power Scale Factor | 40332 | sunssf | – | read | 2 |
713_WHRtg |
Energy Rating | 40346 | uint16 | Wh: register × 100 | read | |
713_WHAvail |
Energy Available | 40347 | uint16 | Wh: register × 100 | read | |
713_SoC |
State of Charge | 40348 | uint16 | %: register × 0.1 | read | |
713_SoH |
State of Health | 40349 | uint16 | %: register × 0.1 | read | |
713_WH_SF |
Energy Scale Factor | 40351 | sunssf | – | read | 2 |
713_Pct_SF |
Percent Scale Factor | 40352 | sunssf | – | read | −1 |
714_NPrt |
Number Of Ports | 40357 | uint16 | – | read | 1 |
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 | −1 |
714_DCV_SF |
DC Voltage Scale Factor | 40369 | sunssf | – | read | −1 |
714_DCW_SF |
DC Power Scale Factor | 40370 | sunssf | – | read | 2 |
802_WChaRteMax |
Nameplate Max Charge Rate | 40411 | uint16 | W: register × 100 | read | The charge limit now, not the nameplate |
802_WDisChaRteMax |
Nameplate Max Discharge Rate | 40412 | uint16 | W: register × 100 | read | The discharge limit now, not the nameplate |
802_AlmRst |
Alarm Reset | 40427 | uint16 | – | read/write | Write 1 to reset a fault. Reads 0 again once applied |
802_V |
External Battery Voltage | 40441 | uint16 | V | read | Battery DC voltage. From software 3.0 scaled by 802_V_SF at 40466 |
802_AChaMax |
Max Charge Current | 40452 | uint16 | A: register × 0.1 | read | The charge limit now |
802_ADisChaMax |
Max Discharge Current | 40453 | uint16 | A: register × 0.1 | read | The discharge limit now |
802_WChaDisChaMax_SF |
Scale factor for maximum charge and discharge rate | 40461 | sunssf | – | read | 2 |
802_AMax_SF |
Scale factor for instantaneous DC charge/discharge current | 40469 | sunssf | – | read | −1 |
From software 3.0 the map holds more points of these models, among them 802_SetOp, 802_SetInvState, 802_State and 802_SoC. They are not part of the rack’s control: start and stop it with 704_WSetEna.
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 |