{
 "manufacturer": "Lochinvar",
 "manufacturer_slug": "lochinvar",
 "model": "Lectrus KEB electric boilers / water heaters 0015-0150 (Modbus communication board)",
 "model_slug": "lectrus-keb-modbus",
 "short_model": "Lectrus KEB",
 "aliases": [
  "Lectrus",
  "KEB0015",
  "KEB0150",
  "KEB 0015-0150",
  "MODB-I-O-KEB",
  "Lochinvar Lectrus"
 ],
 "equipment_type": "Boiler (electric)",
 "applies_to": "Lochinvar Lectrus KEB 0015-0150 electric boilers/water heaters with the Modbus/BACnet communication board, per MODB-I-O-KEB Rev A.",
 "summary": "Lochinvar's Lectrus KEB electric boilers expose Modbus RTU through an RS-485 communication board. The BAS writes a configuration word, an enable word, a rate or setpoint command and optional remote temperatures; it reads safety-switch and pump states, outlet/inlet temperatures, modulation rate, pump speeds, cascade power and status/blocking/lockout codes.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": null,
  "baud": null,
  "parity": null,
  "data_bits": null,
  "stop_bits": null,
  "tcp_port": null
 },
 "addressing": {
  "convention": "Modicon",
  "note": "Addresses are printed Modicon-style (00001, 10001, 30001, 40001). Subtract the table base and 1 for the wire address; the manual's exception-code text confirms PDU addresses start at 0."
 },
 "default_word_order": null,
 "firmware": null,
 "source": {
  "title": "Modbus and BACnet Communication Instructions - Models KEB 0015-0150",
  "doc_number": "MODB-I-O-KEB 100389961_2000844370 Rev A",
  "revision_date": null,
  "url": "https://assets.lochinvar.com/damroot/Original/10017/MODB-I-O-KEB_100389961_2000844370_Rev_A_(63600).pdf",
  "pages": "pp. 5-8 (Modbus configuration, exception codes), 9-10 (memory map, configuration bits), 19-26 (unit operation, conversions), 28-29 (codes)"
 },
 "notes": [
  "Temperatures: the conversion section says the boiler passes temperatures in degrees C and the value must be divided by 10 (examples: 26.7 C sent as 267; outlet 683 = 68.3 C). Scale 0.1 is applied to the registers with 0.1 resolution in the map, assuming DIP switch 8 is OFF (Celsius).",
  "DIP switch 8 selects Celsius (OFF) or Fahrenheit (ON). The map shows Fahrenheit rows only for the setpoints; the manual does not say how the 0.1-resolution temperatures change with the switch ON, so keep it OFF when using this map.",
  "Left out: System/Cascade Setpoint (30004), Outlet Setpoint (30008) and Tank Setpoint (40004). They have 0.5 C (or 1.0/1.5 F) resolution in the map while the conversion text says C x 10, so their scaling is not settled.",
  "Signed types: inlet and BAS-supplied temperatures have negative minimums in the map and are listed as INT16; the manual itself only says 16-bit word.",
  "Input registers 30001-30003 are packed copies of the discrete inputs; the bit order is not stated, so they are UINT16. Use the discrete inputs instead.",
  "The manual repeats its unit-operation section twice (Control Modes 1-4 and Demand Configurations) with the same register values; the integration steps follow both."
 ],
 "registers": [
  {
   "table": "coil",
   "address": 0,
   "documented": "00001",
   "name": "Boiler Enable",
   "description": "Enable command from the BAS.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "coil",
   "address": 4,
   "documented": "00005",
   "name": "DHW Enable",
   "description": "DHW (tank thermostat) demand from the BAS.",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 1,
   "documented": "10002",
   "name": "Flow Switch",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 2,
   "documented": "10003",
   "name": "Low Pressure Switch",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 3,
   "documented": "10004",
   "name": "External Low Water Cut Off",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 4,
   "documented": "10005",
   "name": "Low Water Cut Off / Manual Reset High Limit",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 6,
   "documented": "10007",
   "name": "Auto Reset High Limit",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 8,
   "documented": "10009",
   "name": "SH Enable",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 9,
   "documented": "10010",
   "name": "DHW Enable",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 32,
   "documented": "10033",
   "name": "Run-time Contacts",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 33,
   "documented": "10034",
   "name": "Alarm Contacts",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 34,
   "documented": "10035",
   "name": "Boiler Pump",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 35,
   "documented": "10036",
   "name": "DHW Pump",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 36,
   "documented": "10037",
   "name": "Low Water Cut Off Enable",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 37,
   "documented": "10038",
   "name": "Safety Monitor Relay",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "discrete_input",
   "address": 38,
   "documented": "10039",
   "name": "System Pump",
   "description": "",
   "data_type": "BIT",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "0": "Off",
    "1": "On"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 0,
   "documented": "30001",
   "name": "Discrete Inputs 1-15",
   "description": "Packed copy of discrete inputs 1-15.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 1,
   "documented": "30002",
   "name": "Discrete Inputs 16-31",
   "description": "Packed copy of discrete inputs 16-31.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 2,
   "documented": "30003",
   "name": "Discrete Inputs 32-47",
   "description": "Packed copy of discrete inputs 32-47.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 4,
   "documented": "30005",
   "name": "System Pump Speed",
   "description": "0-100 %.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 5,
   "documented": "30006",
   "name": "Cascade Total Power",
   "description": "Total cascade capacity (100-800 %).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 6,
   "documented": "30007",
   "name": "Cascade Current Power",
   "description": "Current cascade output (0-800 %).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 8,
   "documented": "30009",
   "name": "Outlet Temperature",
   "description": "Raw is degrees C x 10 (manual example: 683 = 68.3 C).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 9,
   "documented": "30010",
   "name": "Inlet Temperature",
   "description": "",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 11,
   "documented": "30012",
   "name": "Modulation Rate",
   "description": "0-100 %.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 12,
   "documented": "30013",
   "name": "Boiler Pump Speed",
   "description": "0-100 %.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 13,
   "documented": "30014",
   "name": "Boiler Status Code",
   "description": "What the boiler is doing; 40 = lockout.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "2": "Heat demand blocked: high absolute outlet temperature",
    "4": "Heat demand blocked: high absolute delta T (outlet - inlet)",
    "8": "Heat demand blocked: low 24 VDC",
    "10": "Blocked: boiler switched off at the display",
    "16": "Service function",
    "19": "DHW function, storage tank",
    "21": "Heat demand from input sensor",
    "22": "Heat demand from boiler management system",
    "23": "Heat demand from cascade",
    "30": "Heat demand from freeze protection",
    "32": "DHW pump delay",
    "33": "Boiler pump delay",
    "34": "No heat function (after pump delay)",
    "40": "Lockout",
    "32767": "Code not present"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 14,
   "documented": "30015",
   "name": "Boiler Blocking Code",
   "description": "Why heat demand is blocked.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "2": "Low 24 VDC supply",
    "5": "Boiler switched off (display ENTER switch)",
    "7": "High delta T",
    "9": "High outlet temperature",
    "13": "Anti-cycling time",
    "18": "Power limited: high delta T"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "input_register",
   "address": 15,
   "documented": "30016",
   "name": "Boiler Lockout Code",
   "description": "Only valid while the status code is 40.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "R",
   "values": {
    "166": "EEPROM: auto reset high limit",
    "167": "EEPROM: auxiliary alarm contact",
    "168": "EEPROM: flow switch open",
    "169": "EEPROM: water pressure",
    "170": "EEPROM: external low water cut-off",
    "179": "Sensor 2 (inlet) fault",
    "180": "Sensor 2 (inlet) missing",
    "192": "Sensor 1 (outlet) fault",
    "193": "Sensor 1 (outlet) error",
    "230": "EEPROM: main control board error",
    "235": "EEPROM: LWCO / manual reset high limit",
    "237": "EEPROM: monitor relay not working properly",
    "241": "Low water cut-off recycling",
    "242": "Auxiliary alarm contact recycling",
    "243": "Flow switch recycling",
    "244": "Water pressure recycling"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 0,
   "documented": "40001",
   "name": "Configuration",
   "description": "Selects which values the BAS supplies instead of the boiler's own inputs.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "Boiler Enable from BAS",
    "1": "DHW Enable from BAS",
    "2": "0-10V BMS input from BAS",
    "3": "Tank Setpoint from BAS",
    "4": "System Supply Temperature from BAS",
    "5": "Outdoor Temperature from BAS",
    "6": "Tank Temperature from BAS"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1,
   "documented": "40002",
   "name": "BV 0-4",
   "description": "Command word ('Coils / BV'); manual examples: 0x0001 enables, 0x0008 = tank thermostat, 0x0000 disables.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2,
   "documented": "40003",
   "name": "0-10 BMS",
   "description": "Rate command: modulation % or setpoint, per the BMS Type setting (0-100).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "units": "%",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 4,
   "documented": "40005",
   "name": "Tank Temperature",
   "description": "Tank temperature supplied by the BAS (0-130 C).",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 5,
   "documented": "40006",
   "name": "Outdoor Temperature",
   "description": "Outdoor temperature supplied by the BAS (-40 to 60 C).",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 6,
   "documented": "40007",
   "name": "System Supply Temperature",
   "description": "System supply temperature supplied by the BAS.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 7,
   "documented": "40008",
   "name": "DHW Recirculation Temperature",
   "description": "DHW recirculation temperature supplied by the BAS.",
   "data_type": "INT16",
   "length": 1,
   "word_order": null,
   "scale": 0.1,
   "units": "°C",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "integration": {
  "summary": "Set address, baud and parity on the board DIP switches, set the control mode in the installer menu (code 5309, CONTROL MODES), then write 40001 and the commands: enable only = 40001 0x0001 + 40002 0x0001; enable + rate = 40001 0x0005 + 40002 0x0001 + 40003; rate only = 40001 0x0004 + 40003. Monitor 30009-30016.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 0,
    "why": "Configuration bits"
   },
   {
    "table": "holding_register",
    "address": 1,
    "why": "Enable command"
   },
   {
    "table": "holding_register",
    "address": 2,
    "why": "Rate (%) or setpoint command"
   },
   {
    "table": "input_register",
    "address": 8,
    "why": "Outlet temperature"
   },
   {
    "table": "input_register",
    "address": 11,
    "why": "Modulation rate"
   },
   {
    "table": "input_register",
    "address": 13,
    "why": "Status code"
   },
   {
    "table": "input_register",
    "address": 14,
    "why": "Blocking code"
   },
   {
    "table": "input_register",
    "address": 15,
    "why": "Lockout code"
   }
  ],
  "enable": "Installer menu (hold LEFT SELECT [MENU] 5 s, code 5309) > CONTROL MODES: set BMS to ACTIVE for rate/setpoint control or BMS TSTAT to ACTIVE for remote DHW, and choose BMS TYPE (POWER or SETPOINT). Re-send 40001 before each command.",
  "watchdog": "MODBUS T/O in CONTROL MODES, 5-120 s (default 10 s): BAS-supplied temperatures/0-10 V values must be refreshed within it. Other commands must be refreshed at least every 4 minutes or the boiler reverts to its own inputs.",
  "quirks": [
   "Modicon addressing: 30009 is input register 8 on the wire.",
   "Temperatures are degrees C x 10 with DIP switch 8 OFF.",
   "A setpoint sent through 40003 is the 0-10 V equivalent percentage interpolated from the BMS low/high setpoint parameters, not degrees.",
   "Read the lockout code only when the status code is 40."
  ],
  "setup": [
   "DIP switches 1-7: Modbus address (maximum 127).",
   "DIP switch 8: OFF = Celsius, ON = Fahrenheit.",
   "DIP switch 9: 0 = 9600 baud, 1 = 19200 baud.",
   "DIP switch 10: 0 = no parity with 2 stop bits, 1 = even parity with 1 stop bit.",
   "RTU only; check 120 ohm termination."
  ],
  "gotchas": [
   "Board LED D7: 1 s bright / 1 s dim = normal; 1.5 s on / 0.5 s off = no Modbus traffic; 0.5 s on / 1.5 s off = no burner-control communication."
  ]
 },
 "page": "https://easymodbus.com/modbus-register-maps/lochinvar/lectrus-keb-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."
}
