{
 "manufacturer": "SMA",
 "manufacturer_slug": "sma",
 "model": "Sunny WebBox Modbus profile - common addresses of SMA devices (unit IDs 3-247)",
 "model_slug": "sunny-webbox-device-common",
 "short_model": "WebBox device common",
 "aliases": [
  "Sunny WebBox device profile",
  "SMA Modbus profile WebBox",
  "Sunny Central via WebBox",
  "Sunny Tripower STP nn000TL-10 via WebBox",
  "Sunny Mini Central via WebBox"
 ],
 "equipment_type": "Solar inverter (via Sunny WebBox gateway)",
 "applies_to": "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.",
 "summary": "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.",
 "transport": [
  "TCP"
 ],
 "defaults": {
  "unit_id": 3,
  "baud": null,
  "parity": null,
  "data_bits": null,
  "stop_bits": null,
  "tcp_port": 502
 },
 "addressing": {
  "convention": "0-based",
  "note": "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."
 },
 "default_word_order": "ABCD",
 "firmware": "WebBox firmware 1.52 or higher",
 "source": {
  "title": "SUNNY WEBBOX Modbus Interface - Technical Description",
  "doc_number": "WEBBOX_MODBUS-TB-US-EN-19, version 1.9",
  "revision_date": null,
  "url": "https://files.sma.de/downloads/WEBBOX-MODBUS-TB-US-en-19.pdf",
  "pages": "pp. 14-19 (data types, formats), pp. 28-29 (common addresses of all SMA devices)"
 },
 "notes": [
  "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."
 ],
 "registers": [
  {
   "table": "input_register",
   "address": 30057,
   "documented": "30057",
   "name": "Serial number",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30193,
   "documented": "30193",
   "name": "Plant time (UTC) [SerTm]",
   "description": "Seconds since 1970-01-01 UTC.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "s",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30197,
   "documented": "30197",
   "name": "Current event ID [ErrNo]",
   "description": "Event number of the active event.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30231,
   "documented": "30231",
   "name": "Maximum continuous active power [Plimit]",
   "description": "Fixed by configuration; may exceed nominal power.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30233,
   "documented": "30233",
   "name": "Permanent active power limitation [Pmax]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30513,
   "documented": "30513",
   "name": "Total yield [E-Total]",
   "description": "",
   "data_type": "UINT64",
   "length": 4,
   "word_order": "ABCD",
   "scale": 1,
   "units": "Wh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30517,
   "documented": "30517",
   "name": "Day yield [E-heute]",
   "description": "",
   "data_type": "UINT64",
   "length": 4,
   "word_order": "ABCD",
   "scale": 1,
   "units": "Wh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30521,
   "documented": "30521",
   "name": "Operating time [h-On]",
   "description": "",
   "data_type": "UINT64",
   "length": 4,
   "word_order": "ABCD",
   "scale": 1,
   "units": "s",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30525,
   "documented": "30525",
   "name": "Feed-in time [h-Total]",
   "description": "",
   "data_type": "UINT64",
   "length": 4,
   "word_order": "ABCD",
   "scale": 1,
   "units": "s",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30529,
   "documented": "30529",
   "name": "Total yield (Wh) [E-Total]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "Wh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30531,
   "documented": "30531",
   "name": "Total yield (kWh) [E-Total]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "kWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30533,
   "documented": "30533",
   "name": "Total yield (MWh) [E-Total]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "MWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30541,
   "documented": "30541",
   "name": "Operating time (32-bit) [h-on]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "s",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30543,
   "documented": "30543",
   "name": "Feed-in time (32-bit) [h-Total]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "s",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30769,
   "documented": "30769",
   "name": "DC current input [Ipv]",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.001,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30771,
   "documented": "30771",
   "name": "DC voltage input [Vpv]",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30773,
   "documented": "30773",
   "name": "DC power input [Ppv]",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30775,
   "documented": "30775",
   "name": "AC active power, all phases [Pac]",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30789,
   "documented": "30789",
   "name": "Grid voltage phase AB [VacL12]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30791,
   "documented": "30791",
   "name": "Grid voltage phase BC [VacL23]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30793,
   "documented": "30793",
   "name": "Grid voltage phase CA [VacL31]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30795,
   "documented": "30795",
   "name": "Grid current [Iac]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.001,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30803,
   "documented": "30803",
   "name": "Power frequency [Fac]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "units": "Hz",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30805,
   "documented": "30805",
   "name": "Reactive power [Qac]",
   "description": "Printed as FIX2 in the manual.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "units": "var",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30813,
   "documented": "30813",
   "name": "Apparent power [Sac]",
   "description": "SC nnnCP: may not be in step with P and Q.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "VA",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30837,
   "documented": "30837",
   "name": "Active power target value [P-WSpt]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 34109,
   "documented": "34109",
   "name": "Heat sink temperature 1 [TmpHs]",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 34113,
   "documented": "34113",
   "name": "Interior temperature 1 [TmpCab1]",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 34125,
   "documented": "34125",
   "name": "External temperature 1, air supply [TmpExl1]",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 40001,
   "documented": "40001",
   "name": "Set plant time (UTC) [SerTm]",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "s",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "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": [
   {
    "table": "input_register",
    "address": 30775,
    "why": "AC power"
   },
   {
    "table": "input_register",
    "address": 30513,
    "why": "Total energy"
   },
   {
    "table": "input_register",
    "address": 30517,
    "why": "Day energy"
   },
   {
    "table": "input_register",
    "address": 30773,
    "why": "DC power"
   },
   {
    "table": "input_register",
    "address": 30803,
    "why": "Grid frequency"
   },
   {
    "table": "input_register",
    "address": 30197,
    "why": "Active event number"
   }
  ],
  "enable": "Enable Modbus on the WebBox (Settings > Network > Use Modbus = Yes) and make sure the device has a unit ID other than 255.",
  "watchdog": null,
  "quirks": [
   "Read 64-bit counters as one 4-register block.",
   "NaN values (0x80000000 / 0xFFFFFFFF) mean the device does not supply that value."
  ],
  "setup": [
   "Modbus TCP to the WebBox IP, port 502, unit ID = the device's assigned ID."
  ],
  "gotchas": [
   "Sunny Central families typically take 8-10 s for a value change to show at the WebBox Modbus interface; polling faster gains nothing."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/sma/sunny-webbox-device-common",
 "address_note": "address = 0-based Modbus wire (PDU) address; documented = as printed in the source.",
 "note": "Re-typed from the manufacturer's public documentation (see source) and verified against it. Registers vary by firmware and options; verify against the live device before writing."
}
