Easy Modbus
  1. Home
  2. Modbus register maps
  3. SMA
  4. Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2)

Solar inverter gateway (PV plant data logger) · Modbus register map

SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2) Modbus register map

Updated 17 November 2026

Short answer

Legacy SMA plant data logger that exposes its connected SMA inverters and sensors over Modbus TCP. Unit ID 1 is the gateway with the table that maps each detected device to a Modbus unit ID; unit ID 2 holds plant-wide values such as total and daily yield, plant AC power and plant time. Per-device data sit under unit IDs 3-247 (see the separate common-device map).

This page lists 23 Modbus registers for the SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2) — 4 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 gateway (plant and gateway unit IDs 1-2)
Equipment type
Solar inverter gateway (PV plant data logger)
Registers
23 (4 writable)
Transport
Modbus TCP
Default unit ID
2
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, WebBox, SWEBBOX, Sunny WebBox with Bluetooth
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 gateway (plant and gateway unit IDs 1-2)

Integration in brief

Enable Modbus in the WebBox web UI, run plant detection, then read plant totals from unit ID 2 and look up each device's unit ID in the unit-1 assignment table before polling devices on unit IDs 3-247.

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 30775Plant AC active power, all phases [Pac]INT32 ABCDPlant AC powerRead
IR 30513Plant total yield [E-Total]UINT64 ABCDPlant total energyRead
IR 30517Plant day yield [E-heute]UINT64 ABCDPlant day energyRead
IR 30193Plant time (UTC) [SerTm]UINT32 ABCDPlant timeRead
HR 42112Device 1: Unit IDUINT16Unit ID of device slot 1Read/write
IR 30007Modbus data change counterUINT32 ABCDProfile change counterRead

Enable Modbus control & writes

Log in to the WebBox as installer, Settings > Network, set 'Use Modbus' to Yes (default off), optionally change the port, Save. Activating Modbus assigns unit IDs to the devices already detected.

Byte order & addressing

Network setup

Watch out for

SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2) 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.

23 of 23 shown
SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2) Modbus register map
TableAddressNameDescriptionTypeOrderScaleUnitsAccessValues / bits
IR30001Version number of the SMA Modbus profileSame value under unit ID 1 and 2.UINT32ABCDRead
IR30003Device ID of the WebBoxSame under unit ID 1 and 2.UINT32ABCDRead
IR30007Modbus data change counterIncrements whenever profile data changed.UINT32ABCDRead
IR30057Serial number of the WebBoxSame under unit ID 1 and 2.UINT32ABCDRead
IR30193Plant time (UTC) [SerTm]Unit ID 2. Seconds since 1970-01-01 UTC.UINT32ABCDsRead
IR30195Time zone (UTC)Unit ID 2. Time-zone code from the manual's section 7.6.UINT32ABCDRead
IR30513Plant total yield [E-Total]Unit ID 2. Sum of all devices.UINT64ABCDWhRead
IR30517Plant day yield [E-heute]Unit ID 2.UINT64ABCDWhRead
IR30529Plant total yield (Wh) [E-Total]Unit ID 2, 32-bit copy in Wh.UINT32ABCDWhRead
IR30531Plant total yield (kWh) [E-Total]Unit ID 2.UINT32ABCDkWhRead
IR30533Plant total yield (MWh) [E-Total]Unit ID 2.UINT32ABCDMWhRead
IR30535Plant day yield (Wh) [E-heute]Unit ID 2.UINT32ABCDWhRead
IR30537Plant day yield (kWh) [E-heute]Unit ID 2.UINT32ABCDkWhRead
IR30539Plant day yield (MWh) [E-heute]Unit ID 2.UINT32ABCDMWhRead
IR30775Plant AC active power, all phases [Pac]Unit ID 2. Sum over the plant.INT32ABCDWRead
HR40001Set plant time (UTC) [SerTm]Unit ID 2. Passed on to the devices.UINT32ABCDsRead/write
HR40003Display time zone [TmZn]Unit ID 2. Time-zone code from section 7.6.UINT32ABCDRead/write
HR42109Device 1: Device-IDUnit ID 1. SMA device type code of assignment slot 1.UINT16Read
HR42110Device 1: Serial numberUnit ID 1.UINT32ABCDRead
HR42112Device 1: Unit IDUnit ID 1. Modbus unit ID given to slot 1 (3..247; 255 = unassigned).UINT16Read/write
HR42113Device 2: Device-IDUnit ID 1. Slots repeat every 4 registers.UINT16Read
HR42114Device 2: Serial numberUnit ID 1.UINT32ABCDRead
HR42116Device 2: Unit IDUnit ID 1.UINT16Read/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 gateway (plant and gateway unit IDs 1-2)

What Modbus registers does the SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2) have?

This map lists 23 registers: 15 input registers, 8 holding registers. 4 of them can be written. Registers vary with firmware, options and configuration, so confirm against the device.

Are the SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2) 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 gateway (plant and gateway unit IDs 1-2) 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 gateway (plant and gateway unit IDs 1-2)?

Start with IR 30775 Plant AC active power, all phases [Pac] (Plant AC power); IR 30513 Plant total yield [E-Total] (Plant total energy); IR 30517 Plant day yield [E-heute] (Plant day energy); IR 30193 Plant time (UTC) [SerTm] (Plant time); HR 42112 Device 1: Unit ID (Unit ID of device slot 1); IR 30007 Modbus data change counter (Profile change counter).

How do I enable Modbus control of the SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2)?

Log in to the WebBox as installer, Settings > Network, set 'Use Modbus' to Yes (default off), optionally change the port, Save. Activating Modbus assigns unit IDs to the devices already detected.

Where is the official SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2) 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.