All devices

SMA · Solar inverter

Sunny Boy / Sunny Tripower Modbus register map

Download JSONSupplier documentationSuggest an edit

Default configuration

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

Register map

AddressCountNameTypeUnitScaleAccess
300012
SMA Modbus profile version
Version number of the SMA Modbus profile.
UInt32-1R
300032
SUSy ID
SMA device family identifier.
UInt32-1R
300052
Serial number
Serial number of the inverter.
UInt32-1R
300512
Device class
8001 = PV inverter.
UInt32-1R
300532
Device type
Numerical device type code; see SMA's device-specific register list.
UInt32-1R
300552
Manufacturer
461 = SMA.
UInt32-1R
300592
Software package
Installed software package version.
UInt32-1R
302012
Device status
35 = Error, 303 = Off, 307 = OK, 455 = Warning.
UInt32-1R
302032
Power at status OK
Maximum active power while the inverter status is OK; 0 in any other status.
UInt32W1R
302052
Power at status warning
Maximum active power while the inverter status is Warning; 0 in any other status.
UInt32W1R
302072
Power at status error
Maximum active power while the inverter status is Error; 0 in any other status.
UInt32W1R
302112
Recommended action
336 = Contact manufacturer, 337 = Contact installer, 338 = Invalid, 887 = No recommended action.
UInt32-1R
302132
Status message
886 = No message; otherwise the last status message code.
UInt32-1R
302152
Status description
885 = No description; otherwise the last status description code.
UInt32-1R
305292
Total AC energy (total yield)
Total energy fed in on all line conductors.
UInt32Wh1R
305312
Total AC energy (total yield)
Total energy fed in on all line conductors.
UInt32kWh1R
305332
Total AC energy (total yield)
Total energy fed in on all line conductors.
UInt32MWh1R
305352
Daily AC energy (daily yield)
Energy fed in today on all line conductors.
UInt32Wh1R
305372
Daily AC energy (daily yield)
Energy fed in today on all line conductors.
UInt32kWh1R
305392
Daily AC energy (daily yield)
Energy fed in today on all line conductors.
UInt32MWh1R
305412
Operating time
UInt32s1R
305432
Feed-in time
UInt32s1R
305652
Number of generator starts
UInt32-1R
305852
Power outage time
UInt32s1R
307692
DC current input 1
Int32A0.001R
307712
DC voltage input 1
Int32V0.01R
307732
DC power input 1
Int32W1R
307752
Active power, all line conductors
Total AC active power (GridMs.TotW).
Int32W1R
307772
Active power L1
Int32W1R
307792
Active power L2
Int32W1R
307812
Active power L3
Int32W1R
307832
Line-to-neutral voltage L1
UInt32V0.01R
307852
Line-to-neutral voltage L2
UInt32V0.01R
307872
Line-to-neutral voltage L3
UInt32V0.01R
307892
Line-to-line voltage L1-L2
UInt32V0.01R
307912
Line-to-line voltage L2-L3
UInt32V0.01R
307932
Line-to-line voltage L3-L1
UInt32V0.01R
307952
Line current, all line conductors
UInt32A0.001R
307972
Line current L1
UInt32A0.001R
307992
Line current L2
UInt32A0.001R
308012
Line current L3
UInt32A0.001R
308032
Power frequency
UInt32Hz0.01R
308052
Reactive power, all line conductors
Positive = lagging, negative = leading (IEC convention).
Int32VAr1R
308072
Reactive power L1
Int32VAr1R
308092
Reactive power L2
Int32VAr1R
308112
Reactive power L3
Int32VAr1R
308132
Apparent power, all line conductors
Int32VA1R
308152
Apparent power L1
Int32VA1R
308172
Apparent power L2
Int32VA1R
308192
Apparent power L3
Int32VA1R
308212
Displacement power factor
cos φ of all line conductors.
UInt32-0.01R
308232
Excitation type
1041 = Leading, 1042 = Lagging.
UInt32-1R
308432
Battery current
Only available on devices with a battery (e.g. Sunny Boy Storage).
Int32A0.001R
308452
Battery state of charge
Only available on devices with a battery.
UInt32%1R
308472
Battery capacity
UInt32%1R
308492
Battery temperature
Int32°C1R
308512
Battery voltage
UInt32V0.01R
308532
Active battery charging mode
1767 = Boost charge, 1768 = Full charge, 1769 = Equalization charge, 1770 = Float charge.
UInt32-1R
309572
DC current input 2
Int32A0.001R
309592
DC voltage input 2
Int32V0.01R
309612
DC power input 2
Int32W1R

Combined registers

  • DC power, both inputs (calculated)Input registers 30773 + Input registers 30961 (W)Sum of the two DC input powers; useful on Tripower models.
  • AC active power L1 + L2 (calculated)Input registers 30777 + Input registers 30779 (W)
  • AC active power, all phases (calculated)AC active power L1 + L2 (calculated) + Input registers 30781 (W)L1 + L2 + L3, built from the nested combined register. Shown next to the device's own total at 30775.

Notes

Addresses are the ADR (DEC) values in SMA's Modbus technical information and are used as wire addresses (SMA documents the register numbers directly; do not subtract 1). The SMA Modbus profile uses unit ID 3. SMA also exposes a SunSpec profile at unit ID 126 with its own 40001-based numbering. Not every register is available on every model or firmware; battery registers apply to Sunny Boy Storage and hybrid models. Do not write holding registers cyclically: SMA warns that repeated writes wear the device's flash memory. Source: SMA technical information "SMA and SunSpec Modbus Interface" and the device-specific Modbus register list, linked on the supplier page.