{
 "manufacturer": "Eastron",
 "model": "SDM120-Modbus",
 "short_model": "SDM120-Modbus",
 "aliases": [
  "SDM120M",
  "SDM120Modbus",
  "SDM120-M"
 ],
 "equipment_type": "Energy meter",
 "applies_to": "Eastron SDM120Modbus single-phase DIN-rail meter (direct connected), protocol implementation V2.4.",
 "summary": "The SDM120-Modbus is a one-module single-phase DIN-rail kWh meter with an RS485 Modbus RTU port. All measurements are IEEE-754 floats in input register pairs read with function 04: voltage, current, powers, power factor, frequency, import/export energy and demand. A handful of holding registers set the address, baud, parity, pulse output and how total energy is summed.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": 1,
  "baud": 2400,
  "parity": "None",
  "data_bits": null,
  "stop_bits": 1,
  "tcp_port": null
 },
 "addressing": {
  "convention": "Modicon",
  "note": "Registers are printed 30001/40001 style (six-digit 46xxxx for the F9xx block) next to the hex start address sent on the wire, e.g. 30007 = 0x0006 and 463777 = 0xF920. Wire address = printed number minus 30001, 40001 or 400001."
 },
 "default_word_order": "ABCD",
 "firmware": null,
 "source": {
  "title": "Eastron SDM120Modbus Smart Meter Modbus Protocol Implementation V2.4",
  "doc_number": "V2.4",
  "revision_date": null,
  "url": "https://res.cloudinary.com/fastron-electronics/image/upload/v1625456706/Eastron%20Europe/SDM120-MODBUS_Protocol.pdf",
  "pages": "Input and holding register tables, PDF pp. 5-8"
 },
 "notes": [
  "Word order: the document's read example returns 43 66 33 34 (high register first) for 230.2 V, so all floats here are ABCD.",
  "Floats must be read in register pairs starting on an even address; odd counts or starts return an exception.",
  "Left out: the serial number (464513), an unsigned 32-bit integer whose word order the document does not state, and the scroll-display time register (463745), whose format is given only as HEX without an encoding rule.",
  "Source host: the PDF is served from the media store used by Eastron Europe (Fastron Electronics, Eastron's UK distributor) for its product pages.",
  "Left out: meter code (464515) and software version (464516) because the document gives only a 'Hex' format with no layout beyond the SDM120 code 00 20."
 ],
 "registers": [
  {
   "table": "input_register",
   "address": 0,
   "documented": "30001",
   "name": "Voltage",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "V",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 6,
   "documented": "30007",
   "name": "Current",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 12,
   "documented": "30013",
   "name": "Active power",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 18,
   "documented": "30019",
   "name": "Apparent power",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "VA",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 24,
   "documented": "30025",
   "name": "Reactive power",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "VAr",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 30,
   "documented": "30031",
   "name": "Power factor",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 70,
   "documented": "30071",
   "name": "Frequency",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "Hz",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 72,
   "documented": "30073",
   "name": "Import active energy",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "kWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 74,
   "documented": "30075",
   "name": "Export active energy",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "kWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 76,
   "documented": "30077",
   "name": "Import reactive energy",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "kVArh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 78,
   "documented": "30079",
   "name": "Export reactive energy",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "kVArh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 84,
   "documented": "30085",
   "name": "Total active power demand",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 86,
   "documented": "30087",
   "name": "Max total active power demand",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 88,
   "documented": "30089",
   "name": "Import active power demand",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 90,
   "documented": "30091",
   "name": "Max import active power demand",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 92,
   "documented": "30093",
   "name": "Export active power demand",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 94,
   "documented": "30095",
   "name": "Max export active power demand",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "W",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 258,
   "documented": "30259",
   "name": "Current demand",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 264,
   "documented": "30265",
   "name": "Max current demand",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "A",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 342,
   "documented": "30343",
   "name": "Total active energy",
   "description": "Per the Measurement mode setting (default import + export).",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "kWh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 344,
   "documented": "30345",
   "name": "Total reactive energy",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "kVArh",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 12,
   "documented": "40013",
   "name": "Relay pulse width",
   "description": "60, 100 or 200 ms (default 100).",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "ms",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 18,
   "documented": "40019",
   "name": "Network parity / stop bits",
   "description": "Takes effect after restart.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "No parity, 1 stop bit (default)",
    "1": "Even parity, 1 stop bit",
    "2": "Odd parity, 1 stop bit",
    "3": "No parity, 2 stop bits"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 20,
   "documented": "40021",
   "name": "Meter ID (Modbus address)",
   "description": "1-247, default 1.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 28,
   "documented": "40029",
   "name": "Baud rate",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "2400 (default)",
    "1": "4800",
    "2": "9600",
    "5": "1200"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 86,
   "documented": "40087",
   "name": "Pulse 1 output mode",
   "description": "Energy quantity driving the pulse output.",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "1": "Import active energy",
    "2": "Import + export active energy",
    "4": "Export active energy (default)",
    "5": "Import reactive energy",
    "6": "Import + export reactive energy",
    "8": "Export reactive energy"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 63760,
   "documented": "463761",
   "name": "Pulse 1 output constant",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "0.001 kWh/imp (default)",
    "1": "0.01 kWh/imp",
    "2": "0.1 kWh/imp",
    "3": "1 kWh/imp"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 63776,
   "documented": "463777",
   "name": "Measurement mode",
   "description": "How the total energy registers are calculated.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "1": "Total = import",
    "2": "Total = import + export (default)",
    "3": "Total = import - export"
   },
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Read input registers with function 04 in two-register pairs; each value is an IEEE-754 float, high word first. Voltage is at 0x0000, current at 0x0006, active power at 0x000C and import kWh at 0x0048.",
  "minimum_registers": [
   {
    "table": "input_register",
    "address": 0,
    "why": "Voltage"
   },
   {
    "table": "input_register",
    "address": 6,
    "why": "Current"
   },
   {
    "table": "input_register",
    "address": 12,
    "why": "Active power"
   },
   {
    "table": "input_register",
    "address": 30,
    "why": "Power factor"
   },
   {
    "table": "input_register",
    "address": 70,
    "why": "Frequency"
   },
   {
    "table": "input_register",
    "address": 72,
    "why": "Import kWh"
   },
   {
    "table": "input_register",
    "address": 342,
    "why": "Total kWh"
   }
  ],
  "enable": "Modbus RTU is always available on the RS485 terminals.",
  "watchdog": null,
  "quirks": [
   "Settings at 40001-40087 are floats over two registers (write with function 16); the F9xx registers are single 16-bit hex values.",
   "The parity/stop setting only takes effect after a restart."
  ],
  "setup": [
   "Default: Modbus address 1, 2400 baud, no parity, 1 stop bit (data bits not stated in this document).",
   "Baud rates 1200, 2400, 4800 and 9600 are selectable."
  ],
  "gotchas": [
   "The factory default baud rate is 2400, not 9600; set the master accordingly before the first read."
  ]
 },
 "manufacturer_slug": "eastron",
 "model_slug": "sdm120-modbus",
 "page": "https://easymodbus.com/modbus-register-maps/eastron/sdm120-modbus",
 "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."
}
