{
 "manufacturer": "Huawei",
 "manufacturer_slug": "huawei",
 "model": "SDongleA smart dongle (Modbus TCP)",
 "model_slug": "sdonglea",
 "short_model": "SDongleA",
 "aliases": [
  "SDongleA-01",
  "SDongleA-02-CN",
  "SDongleA-03-EU",
  "SDongleA-03-AU",
  "SDongleA-03-KR",
  "SDongleA-03-JP",
  "SDongleA-03-CN"
 ],
 "equipment_type": "Solar inverter gateway (smart dongle)",
 "applies_to": "Huawei SDongleA WLAN/WLAN-FE/4G dongles with firmware V100R001C00SPC100 or later, per MODBUS Interface Definitions issue 05.",
 "summary": "The SDongleA is Huawei's smart dongle. It acts as a Modbus TCP server for itself (logical device ID 100) and for the inverters, power meter and other devices it manages (IDs 1-247). This map covers the dongle's own registers: identity, network and traffic status, plant-level input, load, grid and battery power, time settings, management-server and NTP settings, and the reset and device-search commands.",
 "transport": [
  "TCP"
 ],
 "defaults": {
  "unit_id": 100,
  "baud": null,
  "parity": null,
  "data_bits": null,
  "stop_bits": null,
  "tcp_port": null
 },
 "addressing": {
  "convention": "0-based",
  "note": "Register addresses are sent as printed. The read example puts 0x89C0 (35264, the mobile signal-strength register) in the request, so 35264 goes on the wire unchanged."
 },
 "default_word_order": "ABCD",
 "firmware": "V100R001C00SPC100 or later",
 "source": {
  "title": "SDongleA V100R001C00 MODBUS Interface Definitions",
  "doc_number": "Issue 05",
  "revision_date": "2022-07-06",
  "url": "https://community.symcon.de/uploads/short-url/qyJdcRAZ1Ks4UonBY9Ddh3kXA4Y.pdf",
  "pages": "p. 2 (models, firmware), pp. 3-9 (register table), pp. 10-12 (addressing, device IDs, encoding), pp. 15-16 (read example)",
  "unofficial": true
 },
 "notes": [
  "Huawei publishes this document only behind a support-site login; the copy linked is a forum upload of the unaltered Huawei PDF.",
  "Data encoding is big-endian for addresses and data, with the leftmost byte sent first, so 32-bit values are read high word first (ABCD).",
  "Gain is a divisor: power has gain 1000 in kW (so 1 count = 1 W) and traffic gain 100 in MB.",
  "The read example's text names register 32306 but its frame bytes request 0x89C0 (35264); the frame bytes were used to settle the numbering.",
  "Left out: Device operation (47402, 11 registers mixing an SN string with a command word), whose layout is better taken from the source directly.",
  "The TCP port is not stated in this document."
 ],
 "registers": [
  {
   "table": "holding_register",
   "address": 30015,
   "documented": "30015",
   "name": "SN",
   "description": "Dongle serial number.",
   "data_type": "STRING",
   "length": 10,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 30050,
   "documented": "30050",
   "name": "OS version",
   "description": "",
   "data_type": "STRING",
   "length": 15,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 30068,
   "documented": "30068",
   "name": "Protocol version",
   "description": "Main version in the high byte, release version in the low byte.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 31200,
   "documented": "31200",
   "name": "Registration key",
   "description": "",
   "data_type": "STRING",
   "length": 10,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 35104,
   "documented": "35104",
   "name": "Wireless router signal strength",
   "description": "-100 to 0 (weak to strong); 0x7FFF disconnected, 0x7FFE auth failure. Not on 4G model.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 35116,
   "documented": "35116",
   "name": "Monthly used traffic",
   "description": "SDongleA-4G only.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "MB",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 35118,
   "documented": "35118",
   "name": "Monthly remaining traffic",
   "description": "SDongleA-4G only.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "MB",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 35120,
   "documented": "35120",
   "name": "Average daily used traffic",
   "description": "SDongleA-4G only.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "MB",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 35122,
   "documented": "35122",
   "name": "Traffic status",
   "description": "SDongleA-4G only.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": {
    "0": "Normal",
    "1": "Warning",
    "2": "Used up",
    "255": "No package configured"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 35254,
   "documented": "35254",
   "name": "IMEI",
   "description": "SDongleA-4G only.",
   "data_type": "STRING",
   "length": 10,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 35264,
   "documented": "35264",
   "name": "Mobile signal strength",
   "description": "0 (no signal) to 5. SDongleA-4G only.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37410,
   "documented": "37410",
   "name": "Dongle type",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": {
    "0": "N/A",
    "2": "WLAN",
    "3": "4G",
    "5": "WLAN-FE"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37411,
   "documented": "37411",
   "name": "Device search status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": {
    "0": "Search completed",
    "1": "Searching",
    "2": "Search failed"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37412,
   "documented": "37412",
   "name": "Device change sequence number",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37429,
   "documented": "37429",
   "name": "Maximum number of devices allowed",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37430,
   "documented": "37430",
   "name": "Mobile system",
   "description": "e.g. 2G, 3G, 4G. SDongleA-4G only.",
   "data_type": "STRING",
   "length": 10,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37440,
   "documented": "37440",
   "name": "Carrier",
   "description": "SDongleA-4G only.",
   "data_type": "STRING",
   "length": 15,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37498,
   "documented": "37498",
   "name": "Total input power",
   "description": "Plant PV input power.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.001,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37500,
   "documented": "37500",
   "name": "Load power",
   "description": "",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.001,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37502,
   "documented": "37502",
   "name": "Grid power",
   "description": "Positive = buying from grid, negative = selling.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.001,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37504,
   "documented": "37504",
   "name": "Total battery power",
   "description": "Positive = charging, negative = discharging.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.001,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 37516,
   "documented": "37516",
   "name": "Total active power",
   "description": "",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.001,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "kW",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 40205,
   "documented": "40205",
   "name": "Reset",
   "description": "Write 0 to reset the dongle.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 40500,
   "documented": "40500",
   "name": "System time",
   "description": "UTC epoch seconds, 2000-01-01 to 2068-12-31.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "s",
   "access": "W",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 42900,
   "documented": "42900",
   "name": "Daylight saving time",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Disabled (default)",
    "1": "Enabled"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43006,
   "documented": "43006",
   "name": "Time zone",
   "description": "-720 to 840 minutes; default 480 (GMT+8).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "min",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43064,
   "documented": "43064",
   "name": "Application heartbeat period",
   "description": "1-65535, default 30.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "min",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43065,
   "documented": "43065",
   "name": "TCP heartbeat period",
   "description": "0xFFFF = no heartbeat; 0 = default (3 minutes).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "s",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43067,
   "documented": "43067",
   "name": "NMS server",
   "description": "Management server domain or IP.",
   "data_type": "STRING",
   "length": 30,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43097,
   "documented": "43097",
   "name": "NMS server port 1",
   "description": "Default 27250.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43098,
   "documented": "43098",
   "name": "SSL encryption",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Disabled",
    "1": "Enabled (default)"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43099,
   "documented": "43099",
   "name": "NMS server port 2",
   "description": "Default 27251.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43100,
   "documented": "43100",
   "name": "Port mode",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Dual ports (default)",
    "1": "Single port"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43101,
   "documented": "43101",
   "name": "Registration status",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Unregistered (default)",
    "1": "Registered"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43134,
   "documented": "43134",
   "name": "Unsolicited report interval",
   "description": "5-120 in steps of 5; 0xFFFF not supported.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "min",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43135,
   "documented": "43135",
   "name": "Reported data record period",
   "description": "5 (default), 15, 30 or 60.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "min",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43311,
   "documented": "43311",
   "name": "NTP time synchronisation",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Disabled (default)",
    "1": "Enabled"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43312,
   "documented": "43312",
   "name": "NTP server address",
   "description": "",
   "data_type": "STRING",
   "length": 30,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43342,
   "documented": "43342",
   "name": "NTP server port",
   "description": "Default 123.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43343,
   "documented": "43343",
   "name": "NTP sync interval",
   "description": "1-1440, default 5.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "min",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43386,
   "documented": "43386",
   "name": "SIM card number (ICCID)",
   "description": "SDongleA-4G only.",
   "data_type": "STRING",
   "length": 10,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43430,
   "documented": "43430",
   "name": "Network mode",
   "description": "SDongleA-4G only.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": {
    "0": "4G/3G/2G auto (default)",
    "1": "3G/2G auto",
    "2": "2G only"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43564,
   "documented": "43564",
   "name": "Traffic package",
   "description": "SDongleA-4G only.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "MB",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 43566,
   "documented": "43566",
   "name": "Monthly used traffic (correction)",
   "description": "Write to correct the counter. SDongleA-4G only.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.01,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "MB",
   "access": "RW",
   "values": null,
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 45038,
   "documented": "45038",
   "name": "Connection port",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": {
    "1": "Port 1",
    "2": "Port 2"
   },
   "bits": null
  },
  {
   "table": "holding_register",
   "address": 47413,
   "documented": "47413",
   "name": "Start device search",
   "description": "Write 0 to start searching for devices.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "offset": 0,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": null,
   "bits": null
  }
 ],
 "integration": {
  "summary": "Connect over Modbus TCP and use logical device ID 100 for the dongle; read plant power at 37498-37517. IDs 1-247 reach the inverters and other devices the dongle manages.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 37498,
    "why": "Total PV input power"
   },
   {
    "table": "holding_register",
    "address": 37500,
    "why": "Load power"
   },
   {
    "table": "holding_register",
    "address": 37502,
    "why": "Grid import/export power"
   },
   {
    "table": "holding_register",
    "address": 37504,
    "why": "Battery power"
   },
   {
    "table": "holding_register",
    "address": 37516,
    "why": "Total active power"
   },
   {
    "table": "holding_register",
    "address": 37410,
    "why": "Dongle type"
   }
  ],
  "enable": "The document does not describe an enable step.",
  "watchdog": null,
  "quirks": [
   "Logical device ID 100 addresses the dongle; 1-247 address devices behind it.",
   "Powers are in kW with gain 1000.",
   "Grid power is positive when buying, negative when selling."
  ],
  "setup": [
   "Read with function 03, write with 06 or 16; function 2B reads device identifiers."
  ],
  "gotchas": [
   "Several registers are marked as supported only on the 4G dongle.",
   "Writing 0 to 40205 sends the reset command."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/huawei/sdonglea",
 "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."
}
