{
 "manufacturer": "KMB systems",
 "manufacturer_slug": "kmb-systems",
 "model": "SMC / SMY / SMZ / ARTIQ power analysers (Modbus manual v4.0)",
 "model_slug": "modbus-v4-analysers",
 "short_model": "KMB SMC/SMY",
 "aliases": [
  "SMC 133",
  "SMC 144",
  "PA 144",
  "SML 133",
  "SMM 133",
  "SMC 118",
  "SMY 133",
  "SMY 134",
  "SMP 133",
  "SMZ 133",
  "SMC 235",
  "SMC 233",
  "ARTIQ 235",
  "ARTIQ 233",
  "BC 235",
  "BCPM 233",
  "EMU 3",
  "SMZ 244"
 ],
 "equipment_type": "Power meter (power quality analyser)",
 "applies_to": "KMB systems panel and DIN-rail meters and analysers with firmware 4.x, per 'Modbus-TCP and Modbus-RTU protocol documentation' (revision of January 19, 2023). Which blocks a model supports depends on the instrument and its firmware modules.",
 "summary": "KMB systems (Czech Republic) builds the SMC, SMY, SMZ, SML, PA and ARTIQ families of power meters and power-quality analysers. Firmware 4.x devices share one Modbus register map over RS-485 (Modbus RTU, auto-detected alongside KMB's own protocol) or Ethernet (Modbus TCP, port 502). This map covers the compact 19000-19121 block of the most-used values as IEEE floats with units, power factor, status and identification.",
 "transport": [
  "RTU",
  "TCP"
 ],
 "defaults": {
  "unit_id": null,
  "baud": null,
  "parity": "None",
  "data_bits": 8,
  "stop_bits": 1,
  "tcp_port": 502
 },
 "addressing": {
  "convention": "0-based",
  "note": "Addresses are printed in decimal and hex as PDU (wire) addresses. The manual's modpoll examples use the -0 switch ('Modbus PDU addressing') with -r 528 for the device number and -r 4352 for the voltages, and a footnote says that without -0 every address would need +1."
 },
 "default_word_order": "ABCD",
 "firmware": "4.x (document lists FW compatibility up to 4.x releases)",
 "source": {
  "title": "Modbus-TCP and Modbus-RTU protocol documentation for panel meters, power quality analyzers and power factor controllers",
  "doc_number": "Modbus manual v4.0 EN rev 1.8",
  "revision_date": "2023-01-19",
  "url": "https://kmb.cz/en/download/download-documents/4-application-notes?download=200:modbus-manual-v4-0-en",
  "pages": "Communication options p. 1; functions, encoding, addressing, examples pp. 2-4; device identification p. 8; actual data pp. 17-21; 19000 block pp. 32-33"
 },
 "notes": [
  "Encoding (2.3): multi-byte values are big-endian and 32/64-bit values run MSB to LSB across consecutive registers, so floats are ABCD. The modpoll example reads voltages around 236 V as big-endian floats.",
  "Function 04 (input registers) returns actual 200 ms values; function 03 (holding registers) on the same addresses returns the averaged values set up in the instrument. Registers are listed here as input registers.",
  "Left out: the energy rows of the 19000 block (19054-19108). Their unit column says Wh / VAh / varh while the block's introduction says the registers give total kWh/kvarh counts, so the unit is ambiguous. The 0x2000 energy block (64-bit doubles) has no unit stated, so it is left out as well.",
  "Left out: the device number (528, printed only as '32b' with no signed/unsigned type), the detailed actual-data blocks 0x1100-0x13xx (no units printed), harmonics, archives, aggregated min/max blocks, RCM, PQ and NOVAR power-factor-controller registers, and the configuration/reset blocks.",
  "Multi-feeder instruments use the device address for feeder 1 and mirror the map for feeders 2-12 at address (X-1) x 20 + base address; their base address is limited to 1-20.",
  "Over RS-485 the device recognises Modbus RTU and KMB's own protocol automatically. The manual says KMB devices default to no parity; device address and baud must be set per the user manual."
 ],
 "registers": [
  {
   "table": "input_register",
   "address": 520,
   "documented": "520 (0x0208)",
   "name": "Props type (device family)",
   "description": "e.g. 0x0050 DIN-rail analysers, 0x0030 panel analysers, 0x0100 high-end PQ line, 0x0040 NOVAR.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 521,
   "documented": "521 (0x0209)",
   "name": "Device type",
   "description": "Exact instrument code within the family (see manual 3.4).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 4096,
   "documented": "4096 (0x1000)",
   "name": "Configuration change counter",
   "description": "Increments on every configuration change.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 4097,
   "documented": "4097 (0x1001)",
   "name": "Error code",
   "description": "0 = all OK; bit set = possible problem.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "RAM error",
    "1": "Instrument configuration error",
    "2": "Calibration error",
    "3": "Remote communication module error (WiFi/ZigBee)",
    "4": "Clock (RTC) error",
    "7": "Archive error",
    "8": "Flash memory error",
    "9": "Display error"
   },
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 4864,
   "documented": "4864 (0x1300)",
   "name": "Power factor total",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 4870,
   "documented": "4870 (0x1306)",
   "name": "Power factor L1",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 4872,
   "documented": "4872 (0x1308)",
   "name": "Power factor L2",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 4874,
   "documented": "4874 (0x130A)",
   "name": "Power factor L3",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19000,
   "documented": "19000",
   "name": "Voltage L1-N",
   "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": 19002,
   "documented": "19002",
   "name": "Voltage L2-N",
   "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": 19004,
   "documented": "19004",
   "name": "Voltage L3-N",
   "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": 19006,
   "documented": "19006",
   "name": "Voltage L1-L2",
   "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": 19008,
   "documented": "19008",
   "name": "Voltage L2-L3",
   "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": 19010,
   "documented": "19010",
   "name": "Voltage L3-L1",
   "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": 19012,
   "documented": "19012",
   "name": "Current L1",
   "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": 19014,
   "documented": "19014",
   "name": "Current L2",
   "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": 19016,
   "documented": "19016",
   "name": "Current L3",
   "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": 19018,
   "documented": "19018",
   "name": "Neutral current (calculated)",
   "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": 19020,
   "documented": "19020",
   "name": "Active power L1",
   "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": 19022,
   "documented": "19022",
   "name": "Active power L2",
   "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": 19024,
   "documented": "19024",
   "name": "Active power L3",
   "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": 19026,
   "documented": "19026",
   "name": "Active power total",
   "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": 19028,
   "documented": "19028",
   "name": "Apparent power L1",
   "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": 19030,
   "documented": "19030",
   "name": "Apparent power L2",
   "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": 19032,
   "documented": "19032",
   "name": "Apparent power L3",
   "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": 19034,
   "documented": "19034",
   "name": "Apparent power total",
   "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": 19036,
   "documented": "19036",
   "name": "Reactive power L1",
   "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": 19038,
   "documented": "19038",
   "name": "Reactive power L2",
   "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": 19040,
   "documented": "19040",
   "name": "Reactive power L3",
   "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": 19042,
   "documented": "19042",
   "name": "Reactive power total",
   "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": 19044,
   "documented": "19044",
   "name": "CosPhi L1",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19046,
   "documented": "19046",
   "name": "CosPhi L2",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19048,
   "documented": "19048",
   "name": "CosPhi L3",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19050,
   "documented": "19050",
   "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": 19052,
   "documented": "19052",
   "name": "Phase order",
   "description": "1 = correct 1-2-3, -1 = inverted 1-3-2, 0 = unknown (as a float).",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19110,
   "documented": "19110",
   "name": "THD voltage L1",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19112,
   "documented": "19112",
   "name": "THD voltage L2",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19114,
   "documented": "19114",
   "name": "THD voltage L3",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19116,
   "documented": "19116",
   "name": "THD current L1",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19118,
   "documented": "19118",
   "name": "THD current L2",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 19120,
   "documented": "19120",
   "name": "THD current L3",
   "description": "",
   "data_type": "FLOAT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Read input registers (function 04) from 19000 for 27 floats: phase and line voltages, currents, P/Q/S per phase and total, CosPhi, frequency and phase order. Use function 03 on the same block if you want the averaged values.",
  "minimum_registers": [
   {
    "table": "input_register",
    "address": 19000,
    "why": "Voltage L1-N"
   },
   {
    "table": "input_register",
    "address": 19012,
    "why": "Current L1"
   },
   {
    "table": "input_register",
    "address": 19026,
    "why": "Total active power"
   },
   {
    "table": "input_register",
    "address": 19034,
    "why": "Total apparent power"
   },
   {
    "table": "input_register",
    "address": 19050,
    "why": "Frequency"
   },
   {
    "table": "input_register",
    "address": 4864,
    "why": "Total power factor"
   },
   {
    "table": "input_register",
    "address": 4097,
    "why": "Instrument error flags (0 = OK)"
   }
  ],
  "enable": "Modbus TCP is on by default on Ethernet models (port 502, configurable with the TCP/IP settings). For RS-485 set the device address, baud rate and parity in the instrument (see its user manual); Modbus RTU is detected automatically.",
  "watchdog": null,
  "quirks": [
   "Addresses are 0-based PDU addresses.",
   "Function 03 and 04 on the same address return average vs actual values.",
   "Floats are big-endian."
  ],
  "setup": [
   "Device address 1-248 (0 and 249-255 reserved).",
   "At least three Modbus TCP masters can connect at once; each must wait for a reply before the next request."
  ],
  "gotchas": [
   "Multi-feeder devices answer feeder 2-12 data on extra Modbus addresses, not extra registers.",
   "The instrument replies within 200 ms; set master timeouts accordingly."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/kmb-systems/modbus-v4-analysers",
 "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."
}
