SMA StpSe Battery

Installation

1. 1Enable Modbus TCP on the Sunny Tripower Smart Energy through the device web interface under Settings, then External Communication, and activate the TCP Server option.
2. 2Connect the inverter to the same LAN segment as the ModbusCloud Gateway using a standard Ethernet cable on port 502; confirm the inverter has a static or reserved IP address.
3. 3In your ModbusCloud portal, add the Gateway, import the SMA StpSe Battery template, and enter the inverter's IP address together with its configured Modbus unit ID.
4. 4Spot-check the soc register (address 30845) and voltage register (address 30851) in the live data view to confirm values are plausible before enabling alerts or write-register automation.

Things to watch for

01

Why does the gateway return error code 11 on every poll?

Error code 11 means the Modbus unit ID in your portal does not match the unit ID configured on the inverter. Open the inverter web interface, note the unit ID under the Modbus or External Communication section, and update the unit ID field in your ModbusCloud template assignment to match exactly.

02

The cur_bat_cha and cur_bat_dsch registers both read NaN. Why?

SMA documentation notes these registers return NaN when no battery inverter is detected in the system. Confirm the battery is powered, the BMS communication cable is connected to the inverter, and the inverter has completed its initialisation sequence before polling those addresses.

03

64-bit counters at addresses 31397 and 31401 look corrupt. What is wrong?

64-bit SMA registers must be read as a single contiguous 64-bit operation. Reading them as two separate 32-bit requests can produce inconsistent half-values. Ensure the ModbusCloud Gateway reads the full four-register block in one function-code 3 request, which the template is configured to do by default.

04

Is it safe to write to set_active_power and set_control_mode in normal operation?

Exercise caution. Writing an active-power setpoint via register 40149 without first enabling external control through set_control_mode (40151) may be ignored or cause unexpected behaviour. Never write these registers cyclically in a tight loop; SMA documentation warns that cyclical writes to non-control parameters can damage flash memory. Test with small setpoint increments and confirm the inverter responds as expected before deploying automated control.

Registers (16)

13 read / 3 write

More SMA templates

SMA Smart Energy Hybrid Inverter (battery)

SMA

Modbus TCP

10 registers

SMA - Sunny Boy Storage 2.5

SMA

Modbus TCP

Reads battery and power data from SMA Sunny Boy Storage inverters via Modbus.

18 registers138

SMA Sunny Boy

SMA

Modbus TCP

Reads SMA Sunny Boy inverter values via Modbus TCP.

12 registers204

SMA Data Manager (pv)

SMA

Modbus TCP

2 registers

SMA Sunny Island (Modbus) (battery)

SMA

Modbus TCP

5 registers

SMA SunnyIsland

SMA

Modbus TCP

41 registers

More TCP templates

Domekt R 400 V

Komfovent

Modbus TCP

Controls Komfovent Domekt recuperator ventilation via Modbus TCP

25 registers118

Fronius - Modbus TCP

Fronius

Modbus TCP

Monitors Fronius Symo and Primo inverters via Modbus TCP

15 registers597

NIBE Nibe S-Series (SG Ready)

NIBE

Modbus TCP

5 registers1

SunSpec Model 709 — DER Trip LF

SunSpec

Modbus TCP

9 registers

Victron Meter AcOut

Victron

Modbus TCP

16 registers

FoxESS Avocado (grid)

FoxESS

Modbus TCP

8 registers