Easy Modbus
  1. Home
  2. Modbus register maps
  3. SMA
  4. Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247)

Solar inverter (via Sunny WebBox gateway) · Modbus register map

SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247) Modbus register map

Updated 17 November 2026

Short answer

The register set the Sunny WebBox offers for each connected SMA device on its own unit ID (3-247). It covers serial number, event number, power limits, energy and runtime counters, DC input, AC power, line voltages, current, frequency, reactive/apparent power and internal temperatures.

This page lists 30 Modbus registers for the SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247) — 1 writable — with the table, 0-based wire address, data type, word order, scale, units and access of each, re-typed from SMA’s own free documentation (linked below) and checked against it.

Manufacturer
SMA
Model
Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247)
Equipment type
Solar inverter (via Sunny WebBox gateway)
Registers
30 (1 writable)
Transport
Modbus TCP
Default unit ID
3
TCP port
502
Documented addressing
0-based (the number printed is the address on the wire)
32-bit word order
ABCD high word first (big-endian)
Firmware
WebBox firmware 1.52 or higher
Also known as
Sunny WebBox device profile, SMA Modbus profile WebBox, Sunny Central via WebBox, Sunny Tripower STP nn000TL-10 via WebBox, Sunny Mini Central via WebBox
Source document
SUNNY WEBBOX Modbus Interface - Technical Description · WEBBOX_MODBUS-TB-US-EN-19, version 1.9
Download CSV all columns JSON Manufacturer PDF ↗

Integration notes: SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247)

Integration in brief

Look up the device's unit ID in the WebBox gateway table, then read 30775 (AC power), 30529/30513 (energy) and 30769-30773 (DC input) on that unit ID.

Minimum registers to map

Addresses are 0-based wire addresses. Enough to monitor and run the unit; map more as the job needs.

RegisterNameTypeWhyAccess
IR 30775AC active power, all phases [Pac]INT32 ABCDAC powerRead
IR 30513Total yield [E-Total]UINT64 ABCDTotal energyRead
IR 30517Day yield [E-heute]UINT64 ABCDDay energyRead
IR 30773DC power input [Ppv]INT32 ABCDDC powerRead
IR 30803Power frequency [Fac]UINT32 ABCDGrid frequencyRead
IR 30197Current event ID [ErrNo]UINT32 ABCDActive event numberRead

Enable Modbus control & writes

Enable Modbus on the WebBox (Settings > Network > Use Modbus = Yes) and make sure the device has a unit ID other than 255.

Byte order & addressing

Network setup

Watch out for

SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247) Modbus registers

Address = 0-based wire address (the documented number is shown under it when it differs) · Order: ABCD = high word first, CDAB = low word first · Scale: engineering value = raw × scale.

30 of 30 shown
SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247) Modbus register map
TableAddressNameDescriptionTypeOrderScaleUnitsAccessValues / bits
IR30057Serial numberUINT32ABCDRead
IR30193Plant time (UTC) [SerTm]Seconds since 1970-01-01 UTC.UINT32ABCDsRead
IR30197Current event ID [ErrNo]Event number of the active event.UINT32ABCDRead
IR30231Maximum continuous active power [Plimit]Fixed by configuration; may exceed nominal power.UINT32ABCDWRead
IR30233Permanent active power limitation [Pmax]UINT32ABCDWRead
IR30513Total yield [E-Total]UINT64ABCDWhRead
IR30517Day yield [E-heute]UINT64ABCDWhRead
IR30521Operating time [h-On]UINT64ABCDsRead
IR30525Feed-in time [h-Total]UINT64ABCDsRead
IR30529Total yield (Wh) [E-Total]UINT32ABCDWhRead
IR30531Total yield (kWh) [E-Total]UINT32ABCDkWhRead
IR30533Total yield (MWh) [E-Total]UINT32ABCDMWhRead
IR30541Operating time (32-bit) [h-on]UINT32ABCDsRead
IR30543Feed-in time (32-bit) [h-Total]UINT32ABCDsRead
IR30769DC current input [Ipv]INT32ABCD× 0.001ARead
IR30771DC voltage input [Vpv]INT32ABCD× 0.01VRead
IR30773DC power input [Ppv]INT32ABCDWRead
IR30775AC active power, all phases [Pac]INT32ABCDWRead
IR30789Grid voltage phase AB [VacL12]UINT32ABCD× 0.01VRead
IR30791Grid voltage phase BC [VacL23]UINT32ABCD× 0.01VRead
IR30793Grid voltage phase CA [VacL31]UINT32ABCD× 0.01VRead
IR30795Grid current [Iac]UINT32ABCD× 0.001ARead
IR30803Power frequency [Fac]UINT32ABCD× 0.01HzRead
IR30805Reactive power [Qac]Printed as FIX2 in the manual.INT32ABCD× 0.01varRead
IR30813Apparent power [Sac]SC nnnCP: may not be in step with P and Q.INT32ABCDVARead
IR30837Active power target value [P-WSpt]UINT32ABCDWRead
IR34109Heat sink temperature 1 [TmpHs]INT32ABCD× 0.1°CRead
IR34113Interior temperature 1 [TmpCab1]INT32ABCD× 0.1°CRead
IR34125External temperature 1, air supply [TmpExl1]INT32ABCD× 0.1°CRead
HR40001Set plant time (UTC) [SerTm]UINT32ABCDsRead/write

Notes on this map

Check it against the live device. A register map tells you what the controller can expose; the unit in front of you may differ by firmware or options. Read a few registers and compare them with the unit’s own display; for a 32-bit value the float and byte-order decoder shows all four word orders at once, so a wrong word order or scale is obvious. New to this? Read what a register map is and why addresses are off by one.

Questions about the SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247)

What Modbus registers does the SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247) have?

This map lists 30 registers: 29 input registers, 1 holding register. 1 of them can be written. Registers vary with firmware, options and configuration, so confirm against the device.

Are the SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247) Modbus addresses 0-based or 1-based?

The manufacturer's document numbers registers 0-based (the number printed is the address on the wire). Every address on this page is the 0-based wire address you put in the request; the documented number is shown under it where it differs. The assignment tables give 'ADR (DEC)', the decimal Modbus register address, which is sent unchanged in the request (the manual's gateway example reads device 1 at 42109). 30xxx entries are read-only values, 40xxx entries are writable parameters; the WebBox accepts FC03 and FC04 for reads.

What byte order does the SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247) use for 32-bit values?

Multi-register values in this map use ABCD (high word first (big-endian)). Set your client to this order for every 32/64-bit value in the table.

What are the minimum Modbus registers to integrate the SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247)?

Start with IR 30775 AC active power, all phases [Pac] (AC power); IR 30513 Total yield [E-Total] (Total energy); IR 30517 Day yield [E-heute] (Day energy); IR 30773 DC power input [Ppv] (DC power); IR 30803 Power frequency [Fac] (Grid frequency); IR 30197 Current event ID [ErrNo] (Active event number).

How do I enable Modbus control of the SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247)?

Enable Modbus on the WebBox (Settings > Network > Use Modbus = Yes) and make sure the device has a unit ID other than 255.

Where is the official SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247) Modbus documentation?

The source is SUNNY WEBBOX Modbus Interface - Technical Description (WEBBOX_MODBUS-TB-US-EN-19, version 1.9), published free by SMA at https://files.sma.de/downloads/WEBBOX-MODBUS-TB-US-en-19.pdf.

More SMA Modbus register maps

Other solar & battery inverters register maps

All solar & battery inverters Modbus register maps →

Source: SUNNY WEBBOX Modbus Interface - Technical Description · WEBBOX_MODBUS-TB-US-EN-19, version 1.9. Register numbers, types, scaling and units are reproduced as published; descriptions are our own.