- Home
- Modbus register maps
- SMA
- 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
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
Integration notes: SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2)
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.
| Register | Name | Type | Why | Access |
|---|---|---|---|---|
| IR 30775 | Plant AC active power, all phases [Pac] | INT32 ABCD | Plant AC power | Read |
| IR 30513 | Plant total yield [E-Total] | UINT64 ABCD | Plant total energy | Read |
| IR 30517 | Plant day yield [E-heute] | UINT64 ABCD | Plant day energy | Read |
| IR 30193 | Plant time (UTC) [SerTm] | UINT32 ABCD | Plant time | Read |
| HR 42112 | Device 1: Unit ID | UINT16 | Unit ID of device slot 1 | Read/write |
| IR 30007 | Modbus data change counter | UINT32 ABCD | Profile change counter | Read |
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
- Devices detected later get unit ID 255 and cannot be reached until you assign them a unit ID 3-247 (gateway table or Data > Devices > Modbus page).
- Reading a block that contains undefined registers returns NaN for those; a block with no defined register gives an exception.
Network setup
- Modbus TCP only, factory port 502.
- Unit ID 1 = gateway, 2 = plant, 3-247 = devices.
- Keep requests at least 10 s apart and 30 registers or less per transfer.
Watch out for
- SMA recommends about 25 devices per WebBox (max 50).
- Values from Sunny Central inverter families reach the WebBox Modbus interface with a typical delay of 8-10 s.
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.
| Table | Address | Name | Description | Type | Order | Scale | Units | Access | Values / bits |
|---|---|---|---|---|---|---|---|---|---|
| IR | 30001 | Version number of the SMA Modbus profile | Same value under unit ID 1 and 2. | UINT32 | ABCD | Read | |||
| IR | 30003 | Device ID of the WebBox | Same under unit ID 1 and 2. | UINT32 | ABCD | Read | |||
| IR | 30007 | Modbus data change counter | Increments whenever profile data changed. | UINT32 | ABCD | Read | |||
| IR | 30057 | Serial number of the WebBox | Same under unit ID 1 and 2. | UINT32 | ABCD | Read | |||
| IR | 30193 | Plant time (UTC) [SerTm] | Unit ID 2. Seconds since 1970-01-01 UTC. | UINT32 | ABCD | s | Read | ||
| IR | 30195 | Time zone (UTC) | Unit ID 2. Time-zone code from the manual's section 7.6. | UINT32 | ABCD | Read | |||
| IR | 30513 | Plant total yield [E-Total] | Unit ID 2. Sum of all devices. | UINT64 | ABCD | Wh | Read | ||
| IR | 30517 | Plant day yield [E-heute] | Unit ID 2. | UINT64 | ABCD | Wh | Read | ||
| IR | 30529 | Plant total yield (Wh) [E-Total] | Unit ID 2, 32-bit copy in Wh. | UINT32 | ABCD | Wh | Read | ||
| IR | 30531 | Plant total yield (kWh) [E-Total] | Unit ID 2. | UINT32 | ABCD | kWh | Read | ||
| IR | 30533 | Plant total yield (MWh) [E-Total] | Unit ID 2. | UINT32 | ABCD | MWh | Read | ||
| IR | 30535 | Plant day yield (Wh) [E-heute] | Unit ID 2. | UINT32 | ABCD | Wh | Read | ||
| IR | 30537 | Plant day yield (kWh) [E-heute] | Unit ID 2. | UINT32 | ABCD | kWh | Read | ||
| IR | 30539 | Plant day yield (MWh) [E-heute] | Unit ID 2. | UINT32 | ABCD | MWh | Read | ||
| IR | 30775 | Plant AC active power, all phases [Pac] | Unit ID 2. Sum over the plant. | INT32 | ABCD | W | Read | ||
| HR | 40001 | Set plant time (UTC) [SerTm] | Unit ID 2. Passed on to the devices. | UINT32 | ABCD | s | Read/write | ||
| HR | 40003 | Display time zone [TmZn] | Unit ID 2. Time-zone code from section 7.6. | UINT32 | ABCD | Read/write | |||
| HR | 42109 | Device 1: Device-ID | Unit ID 1. SMA device type code of assignment slot 1. | UINT16 | Read | ||||
| HR | 42110 | Device 1: Serial number | Unit ID 1. | UINT32 | ABCD | Read | |||
| HR | 42112 | Device 1: Unit ID | Unit ID 1. Modbus unit ID given to slot 1 (3..247; 255 = unassigned). | UINT16 | Read/write | ||||
| HR | 42113 | Device 2: Device-ID | Unit ID 1. Slots repeat every 4 registers. | UINT16 | Read | ||||
| HR | 42114 | Device 2: Serial number | Unit ID 1. | UINT32 | ABCD | Read | |||
| HR | 42116 | Device 2: Unit ID | Unit ID 1. | UINT16 | Read/write |
Notes on this map
- Word order: the manual's data-type figures put bits 31..16 in the first register and bits 15..0 in the second (64-bit: bits 63..48 first), and data are sent big-endian, so 32/64-bit values are high word first (ABCD).
- Format to scale: FIX0 = x1, FIX1 = x0.1, FIX2 = x0.01, FIX3 = x0.001, TEMP = one decimal (x0.1), DT = UTC seconds since 1970-01-01, Duration = seconds.
- NaN (no value): U16 0xFFFF, S16 0x8000, U32 0xFFFFFFFF, S32 0x80000000, U64 0xFFFFFFFFFFFFFFFF.
- Multi-register values must be read in one request. SMA recommends at least 10 s between data requests and no more than 30 registers per transfer.
- Unit ID 1 answers 30001/30003/30007/30057 and the assignment table; unit ID 2 answers the same four plus the plant values. Both are listed once here.
- Only assignment slots 1 and 2 are listed. Slot n starts at 42109 + 4 x (n-1) (Device-ID, 2-register serial number, Unit ID); the table runs to slot 245 at 43085-43088.
- To change a device's unit ID, write the slot's Device-ID, serial number and Unit ID registers as one block with FC16; only the Unit ID register is writable. Never assign the same unit ID twice.
- Time-zone code list (section 7.6) is not reproduced.
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
- Battery inverter
SMA Sunny Tripower Storage X / Sunny Island X (SMA Modbus, ennexOS)
Sunny Tripower Storage X 30/50 (incl. US variants) and Sunny Island X 30/50 (incl. US variants), queried through the System Manager over Modbus TCP.
Also known as: STPS30-20, STPS50-20, STPS27-US-20, STPS60-US-20, SI30-20, SI50-20, SI27-US208-20, SI40-US480-20, SI60-US480-20, Sunny Tripower Storage X 50, Sunny Island X 50 - Solar inverter (via Sunny WebBox gateway)
SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247)
SMA devices reached through a Sunny WebBox (fw 1.52+) on unit IDs 3-247 whose family uses the common address set; SB n000US and SB nn000TL-US-12 families use their own tables instead.
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
Other solar & battery inverters register maps
- Battery inverter (off-grid inverter-charger)
Studer Innotec Xtender XTH / XTM / XTS inverter-charger (via Xcom-485i)
Studer Xtender XTH, XTM and XTS inverter-chargers read through an Xcom-485i Modbus RTU gateway, system release R706.
Also known as: XTH, XTM, XTS, Xtender XTH, Xtender XTM, Xtender XTS, Xcom-485i - Solar inverter
Fronius Tauro ECO 50-100 (SunSpec int+SF)
Fronius Tauro ECO 50-100 kW commercial inverters (rest-of-world map, single MPPT), SunSpec Model Type int+SF.
Also known as: Fronius Tauro ECO, Tauro ECO 50-3-P, Tauro ECO 99-3-D, Tauro ECO 100-3-P, Tauro ECO 100-3-D - Solar charge controller (MPPT, battery charger)
Morningstar SunSaver MPPT solar charge controller (Modbus RTU via MeterBus)
Morningstar SunSaver MPPT through the MSC MeterBus-to-RS-232 adapter; Modbus specification v11.
Also known as: SunSaver MPPT, SS-MPPT - Sensor (battery monitoring system)
Vertiv (Alber) Alber MPM-100 and BDS series battery monitors (Modbus ASCII)
Alber MPM-100 (firmware 1.20+) and BDS series (controller firmware 2.20+) battery monitors with BMDM software 4.10+, per protocol document SL-29417 Rev 7.05.
Also known as: Alber MPM-100, Alber BDS, BDS-40, BDS40, MPM100, Vertiv Alber battery monitor, SL-29417 - Battery charger (industrial float charger, UPS-type DC system)
HindlePower AT10.1 / AT30 series battery charger with communications module (Modbus)
HindlePower AT10.1 and AT30 microprocessor-controlled float battery chargers fitted with the AT Series Communications Module (EJ5037-##) set to Modbus, per operating instructions JA0102-04 Rev. 02-2025.
Also known as: AT10.1, AT30, EJ5037, AT Series Communications Module - Battery inverter (off-grid sine wave)
Morningstar SureSine-300 off-grid sine-wave inverter (Modbus RTU via MeterBus)
Morningstar SureSine-300 (115 V and 220 V versions) via the MSC MeterBus adapter; Modbus specification V03 (29 Oct 2008).
Also known as: SureSine, SureSine-300
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.