SMA - Sunny Boy Storage 2.5
Reads battery and power data from SMA Sunny Boy Storage inverters via Modbus.
This template connects to the SMA Sunny Boy Storage 2.5 battery inverter via Modbus RTU. It reads battery state of charge, charge and discharge power, grid feed-in, and grid reference values. It also allows writing feed-in management and BMS operating modes.
- Protocol
- Modbus TCP
- Connection
- Ethernet, Modbus TCP
- Registers
- 18, read and write
- Brand
- SMA
- Key readings
- Battery state of charge · Battery charge/discharge power · Power grid feed-in · Power grid reference · Active power · Current battery capacity
- Available commands
- Feed-in management operating mode · BMS operating mode
- Compatible models
- SMA Sunny Boy Storage 2.5
- Last updated
Registers (18)
17 read, 2 write
| Name | Unit | Access | Address (Hidden until you enter your email) | Function (hidden) | Type (hidden) |
|---|---|---|---|---|---|
| Current battery state of charge | % | Read | |||
| Operating mode of feed-in management: | Read and write | ||||
| Active power limitation P, active power configuration | Read | ||||
| Current battery charging set voltage | V | Read | |||
| Battery oper. status | Read | ||||
| Power grid feed-in | kW | Read | |||
| Power grid reference | kW | Read | |||
| Power | W | Read | |||
| Operating mode of stat | Read | ||||
| Active power limitation P, active power configuration | W | Read | |||
| Control of battery charging via communication available | Read | ||||
| Present battery charge | W | Read | |||
| Present battery discharge | W | Read | |||
| Current battery capacity | % | Read | |||
| Plant mains connection | Read | ||||
| Operating mode of feed-in management | Read | ||||
| BMS operating mode | Read | ||||
| BMS operating mode | Write |
Loading registers…
Send your device list
If a device is not in the library yet, we build the template for free as soon as we have the register data.
Use cases
- Monitor battery state of charge and charge or discharge power on a live cloud dashboard for residential customers.
- Create alerts when battery state of charge drops below a critical threshold to prevent deep discharge events.
- Track grid feed-in and grid reference values over time to optimize self-consumption strategies.
- Remotely adjust the feed-in management operating mode to comply with updated grid operator requirements.
- Generate weekly or monthly energy storage reports for end customers without visiting the site.
- Compare active power and battery capacity trends across multiple SMA Sunny Boy Storage installations.
Installation
Connect the ModbusCloud Gateway to the SMA Sunny Boy Storage 2.5 via RS485 wiring, observing correct A, B, and GND terminal assignments.
Set the Modbus RTU baud rate to 9600 and parity to odd on both the gateway and the inverter to ensure matching communication parameters.
Enable Modbus RTU communication in the SMA inverter settings menu and assign a unique Modbus slave address.
Configure the same slave address on the ModbusCloud gateway so it polls the correct device on the bus.
Import the SMA Sunny Boy Storage 2.5 template in the ModbusCloud platform and assign it to the gateway.
Verify live data appears on the ModbusCloud dashboard and confirm that register values match the inverter display.
Things to watch for
The gateway cannot communicate with the inverter. What should I check?
Verify that the RS485 wiring is correct (A to A, B to B, GND to GND). Confirm that both the gateway and inverter are set to 9600 baud with odd parity. Make sure Modbus RTU is enabled in the inverter configuration menu.
The BMS operating mode register returns no data or an error. Is this normal?
The BMS operating mode read register may be unsupported or a placeholder on certain firmware versions. Check the SMA documentation for your specific firmware and update if necessary.
Values appear but seem incorrect or out of range. What could cause this?
Registers on the SMA Sunny Boy Storage 2.5 use uint32 and int32 types that span two consecutive registers. Ensure the byte order and word order settings in the gateway match the SMA register specification. Also verify that register addresses have not shifted due to a firmware update.
Can I connect multiple SMA inverters on the same RS485 bus?
Yes, assign a unique Modbus slave address to each inverter and add a corresponding device entry in the ModbusCloud platform for each one. Use proper bus termination on the first and last device.
Knowledge base articles for this device
Want to see how it works?
