- Home
- Modbus register maps
- SMA
- 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
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
Integration notes: SMA Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247)
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.
| Register | Name | Type | Why | Access |
|---|---|---|---|---|
| IR 30775 | AC active power, all phases [Pac] | INT32 ABCD | AC power | Read |
| IR 30513 | Total yield [E-Total] | UINT64 ABCD | Total energy | Read |
| IR 30517 | Day yield [E-heute] | UINT64 ABCD | Day energy | Read |
| IR 30773 | DC power input [Ppv] | INT32 ABCD | DC power | Read |
| IR 30803 | Power frequency [Fac] | UINT32 ABCD | Grid frequency | Read |
| IR 30197 | Current event ID [ErrNo] | UINT32 ABCD | Active event number | Read |
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
- Read 64-bit counters as one 4-register block.
- NaN values (0x80000000 / 0xFFFFFFFF) mean the device does not supply that value.
Network setup
- Modbus TCP to the WebBox IP, port 502, unit ID = the device's assigned ID.
Watch out for
- Sunny Central families typically take 8-10 s for a value change to show at the WebBox Modbus interface; polling faster gains nothing.
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.
| Table | Address | Name | Description | Type | Order | Scale | Units | Access | Values / bits |
|---|---|---|---|---|---|---|---|---|---|
| IR | 30057 | Serial number | UINT32 | ABCD | Read | ||||
| IR | 30193 | Plant time (UTC) [SerTm] | Seconds since 1970-01-01 UTC. | UINT32 | ABCD | s | Read | ||
| IR | 30197 | Current event ID [ErrNo] | Event number of the active event. | UINT32 | ABCD | Read | |||
| IR | 30231 | Maximum continuous active power [Plimit] | Fixed by configuration; may exceed nominal power. | UINT32 | ABCD | W | Read | ||
| IR | 30233 | Permanent active power limitation [Pmax] | UINT32 | ABCD | W | Read | |||
| IR | 30513 | Total yield [E-Total] | UINT64 | ABCD | Wh | Read | |||
| IR | 30517 | Day yield [E-heute] | UINT64 | ABCD | Wh | Read | |||
| IR | 30521 | Operating time [h-On] | UINT64 | ABCD | s | Read | |||
| IR | 30525 | Feed-in time [h-Total] | UINT64 | ABCD | s | Read | |||
| IR | 30529 | Total yield (Wh) [E-Total] | UINT32 | ABCD | Wh | Read | |||
| IR | 30531 | Total yield (kWh) [E-Total] | UINT32 | ABCD | kWh | Read | |||
| IR | 30533 | Total yield (MWh) [E-Total] | UINT32 | ABCD | MWh | Read | |||
| IR | 30541 | Operating time (32-bit) [h-on] | UINT32 | ABCD | s | Read | |||
| IR | 30543 | Feed-in time (32-bit) [h-Total] | UINT32 | ABCD | s | Read | |||
| IR | 30769 | DC current input [Ipv] | INT32 | ABCD | × 0.001 | A | Read | ||
| IR | 30771 | DC voltage input [Vpv] | INT32 | ABCD | × 0.01 | V | Read | ||
| IR | 30773 | DC power input [Ppv] | INT32 | ABCD | W | Read | |||
| IR | 30775 | AC active power, all phases [Pac] | INT32 | ABCD | W | Read | |||
| IR | 30789 | Grid voltage phase AB [VacL12] | UINT32 | ABCD | × 0.01 | V | Read | ||
| IR | 30791 | Grid voltage phase BC [VacL23] | UINT32 | ABCD | × 0.01 | V | Read | ||
| IR | 30793 | Grid voltage phase CA [VacL31] | UINT32 | ABCD | × 0.01 | V | Read | ||
| IR | 30795 | Grid current [Iac] | UINT32 | ABCD | × 0.001 | A | Read | ||
| IR | 30803 | Power frequency [Fac] | UINT32 | ABCD | × 0.01 | Hz | Read | ||
| IR | 30805 | Reactive power [Qac] | Printed as FIX2 in the manual. | INT32 | ABCD | × 0.01 | var | Read | |
| IR | 30813 | Apparent power [Sac] | SC nnnCP: may not be in step with P and Q. | INT32 | ABCD | VA | Read | ||
| IR | 30837 | Active power target value [P-WSpt] | UINT32 | ABCD | W | Read | |||
| IR | 34109 | Heat sink temperature 1 [TmpHs] | INT32 | ABCD | × 0.1 | °C | Read | ||
| IR | 34113 | Interior temperature 1 [TmpCab1] | INT32 | ABCD | × 0.1 | °C | Read | ||
| IR | 34125 | External temperature 1, air supply [TmpExl1] | INT32 | ABCD | × 0.1 | °C | Read | ||
| HR | 40001 | Set plant time (UTC) [SerTm] | UINT32 | ABCD | s | 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.
- Each device family (Sunny Central, Sunny Island/Backup, STP nn000TL-10, string monitors, Meteo Station, Sensorbox) adds its own registers in sections 5.4.4-5.4.15 of the manual; only the common set is listed here.
- The manual states this common table does not apply to the SB n000US and SB nn000TL-US-12 families, which have separate tables.
- Find each device's unit ID in the WebBox gateway table (unit ID 1, from register 42109; see the Sunny WebBox map). The default unit_id of 3 here is just the first device slot.
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
- 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 gateway (PV plant data logger)
SMA Sunny WebBox Modbus gateway (plant and gateway unit IDs 1-2)
Sunny WebBox firmware 1.52 or later with Modbus enabled, SMA Modbus profile as documented in WEBBOX_MODBUS-TB-US-EN-19 v1.9 (legacy product).
Also known as: Sunny WebBox, WebBox, SWEBBOX, Sunny WebBox with Bluetooth
Other solar & battery inverters register maps
- 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 - Solar inverter
SolarEdge SolarEdge inverters (SunSpec logging)
SolarEdge single-, split- and three-phase inverters with SunSpec enabled (SolarEdge Go/SetApp units, or LCD units on firmware 3.xxxx+); meter 1 at the non-Synergy default base.
Also known as: SE5000, Synergy, SolarEdge SunSpec - Battery inverter (GX gateway for inverter/chargers, batteries and solar chargers)
Victron Energy GX device Modbus-TCP (Cerbo GX, Venus GX, Color Control GX)
Victron GX devices running Venus OS with the Modbus-TCP service enabled; register list version 3.81 (document Rev 54). Core system, VE.Bus inverter/charger, battery, solar charger and ESS registers only.
Also known as: Cerbo GX, Cerbo-S GX, Venus GX, Color Control GX, CCGX, Ekrano GX, Octo GX, MultiPlus-II GX, EasySolar-II GX, Venus OS, dbus-modbustcp - Battery charger (industrial float charger, UPS-type DC system)
HindlePower ATevo battery charger (Modbus communications adapter)
HindlePower ATevo battery chargers with the serial or Ethernet communications adapter set to Modbus, per the ATevo Communications online manual version 1.3.
Also known as: ATevo, ATevo Communications
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.