SMA · Home battery
Sunny Boy Storage 2.5 / 3.7 / 5.0 / 6.0 Modbus register map
Default configuration
- Protocol
- Modbus TCP
- Port
- 502
- Unit ID
- 3
- Addressing
- 0-based
- Byte order
- Big endian
- Word order
- High word first
Register map
| Address | Count | Name | Type | Unit | Scale | Access |
|---|---|---|---|---|---|---|
| 30001 | 2 | SMA Modbus profile version | UInt32 | - | 1 | R |
| 30003 | 2 | SUSy ID | UInt32 | - | 1 | R |
| 30005 | 2 | Serial number | UInt32 | - | 1 | R |
| 30775 | 2 | Active power, all line conductors (GridMs.TotW) Positive means export to the grid. | Int32 | W | 1 | R |
| 30843 | 2 | Battery current (Bat.Amps) | Int32 | A | 0.001 | R |
| 30845 | 2 | Battery state of charge (Bat.ChaStt) | UInt32 | % | 1 | R |
| 30847 | 2 | Battery capacity (Bat.Cap) | UInt32 | % | 1 | R |
| 30849 | 2 | Battery temperature (Bat.TmpVal) | Int32 | °C | 1 | R |
| 30851 | 2 | Battery voltage (Bat.Vtg) | UInt32 | V | 0.01 | R |
| 30853 | 2 | Active battery charging mode (Bat.ChaMod) | UInt32 | - | 1 | R |
| 30865 | 2 | Power drawn from grid (Metering.GridMs.TotWIn) | Int32 | W | 1 | R |
| 30867 | 2 | Power fed to grid (Metering.GridMs.TotWOut) | Int32 | W | 1 | R |
| 31393 | 2 | Battery charge power (BatChrg.CurBatCha) | UInt32 | W | 1 | R |
| 31395 | 2 | Battery discharge power (BatDsch.CurBatDsch) | UInt32 | W | 1 | R |
Notes
SMA Modbus profile registers, taken from the evcc templates https://raw.githubusercontent.com/evcc-io/evcc/master/templates/definition/meter/sma-sbs-modbus.yaml and https://raw.githubusercontent.com/evcc-io/evcc/master/templates/definition/meter/sma-hybrid.yaml and named the way the SMA Modbus profile document names them. Modbus TCP has to be enabled on the inverter (Communication -> Modbus -> TCP, slave = 3), port 502, unit ID 3. Measurement values live in the 30xxx area and are listed as input registers here, setpoints in the 40xxx area as holding registers - the same convention as the Sunny Boy/Tripower seed. Battery setpoints (CmpBMS) are 32-bit unsigned values in W; OpMod 2424 is the default operating mode, 2289 is 'battery charge'. The six CmpBMS holding registers (40236 and 40793-40801) are the only write registers in this map and are exactly what evcc writes for active battery control; every input register is read-only. The metering energy counters of this profile (Metering.TotWhIn/TotWhOut) are 64-bit values and are left out rather than split. Category changed from Battery inverter to Home battery (storage-centred).