{
  "spec_version": 1,
  "slug": "ziehl-abegg-ecblue-basic-modbus",
  "manufacturer": "ZIEHL-ABEGG",
  "model": "ECblue BASIC-MODBUS EC fans and motors",
  "category": "Fan controller",
  "supplier_url": "https://www.ziehl-abegg.com/en/service/downloads",
  "default_configuration": {
    "protocol": "modbus_rtu",
    "unit_id": 247,
    "addressing": "zero_based",
    "byte_order": "BigEndian",
    "word_order": "HighFirst",
    "native_interface": "rs485",
    "serial": {
      "baud_rate": 19200,
      "parity": "Even",
      "data_bits": 8,
      "stop_bits": 1
    }
  },
  "coils": [],
  "discrete_inputs": [],
  "input_registers": [
    {
      "address": 0,
      "count": 1,
      "name": "Firmware version",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "i0. Firmware version of the ECblue electronics, printed as xx.xx (range 0.00 - 655.35), so the raw word is divided by 100."
    },
    {
      "address": 1,
      "count": 1,
      "name": "Product code 1 (controller code)",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i1. Controller code of the device."
    },
    {
      "address": 2,
      "count": 1,
      "name": "Parameter set ID",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i2. Identifier of the loaded parameter set."
    },
    {
      "address": 9,
      "count": 1,
      "name": "Parameter set index",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i9. Index of the loaded parameter set."
    },
    {
      "address": 10,
      "count": 1,
      "name": "Operation condition 1",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i10. Bit-coded operating state of the fan."
    },
    {
      "address": 11,
      "count": 1,
      "name": "Operation condition 2",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i11. Bit-coded operating state of the fan (from firmware 14)."
    },
    {
      "address": 12,
      "count": 1,
      "name": "Error status",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i12. Bit-coded error status; selected entries are copied into i29/i30 by PIN codes 7500...7509."
    },
    {
      "address": 13,
      "count": 1,
      "name": "Error status 2",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i13. Second, bit-coded error word."
    },
    {
      "address": 14,
      "count": 1,
      "name": "Speed",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i14. Actual speed in 1/min."
    },
    {
      "address": 15,
      "count": 1,
      "name": "Motor current",
      "data_type": "UInt16",
      "units": "A",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "i15. Actual motor current in 0.01 A steps."
    },
    {
      "address": 20,
      "count": 1,
      "name": "DC-link voltage",
      "data_type": "UInt16",
      "units": "V",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i20. DC-link voltage in 1 V steps."
    },
    {
      "address": 21,
      "count": 1,
      "name": "Line voltage",
      "data_type": "UInt16",
      "units": "V",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i21. Supply voltage (peak value) in 1 V steps."
    },
    {
      "address": 22,
      "count": 1,
      "name": "IGBT temperature",
      "data_type": "Int16",
      "units": "degC",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "i22. IGBT temperature; 200 = 20.0 degC."
    },
    {
      "address": 23,
      "count": 1,
      "name": "Temperature inside the electronics",
      "data_type": "Int16",
      "units": "degC",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "i23. Ambient temperature of the electronics inside the housing; 200 = 20.0 degC."
    },
    {
      "address": 24,
      "count": 1,
      "name": "MCU temperature",
      "data_type": "Int16",
      "units": "degC",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "i24. Chip temperature; 200 = 20.0 degC."
    },
    {
      "address": 26,
      "count": 1,
      "name": "E1 input",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i26. Raw value at the analogue input E1: 0...32767 = 0...10 V or 0...100 % PWM."
    },
    {
      "address": 27,
      "count": 1,
      "name": "Control (modulation level)",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.0030518509475997192,
      "offset": 0,
      "access": "R",
      "description": "i27. Fan level of the speed controller: 0...32767 = 0...100 %."
    },
    {
      "address": 29,
      "count": 1,
      "name": "MSW of the selected event-log entry",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i29. Most significant word; format as error status i13."
    },
    {
      "address": 30,
      "count": 1,
      "name": "LSW of the selected event-log entry",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i30. Least significant word; format as error status i12."
    },
    {
      "address": 31,
      "count": 1,
      "name": "Event-log entry number",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i31. Item of the selected event-log entry (7500 = most recent fault)."
    },
    {
      "address": 32,
      "count": 1,
      "name": "Power factor",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i32. cos(phi) at the inverter output; the document prints the raw range 0...65535 only."
    },
    {
      "address": 33,
      "count": 1,
      "name": "Motor input power",
      "data_type": "UInt16",
      "units": "W",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i33. Motor input power in watts."
    },
    {
      "address": 40,
      "count": 1,
      "name": "Reactor temperature",
      "data_type": "Int16",
      "units": "degC",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "i40. Temperature at the input reactor; 200 = 20.0 degC."
    },
    {
      "address": 45,
      "count": 1,
      "name": "Motor voltage",
      "data_type": "UInt16",
      "units": "V",
      "scale_factor": 0.1,
      "offset": 0,
      "access": "R",
      "description": "i45. Effective motor voltage; 2000 = 200.0 V."
    },
    {
      "address": 47,
      "count": 1,
      "name": "Motor current, phase U",
      "data_type": "UInt16",
      "units": "A",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "i47. Maximum value of the current in phase U; 2000 = 2.00 A."
    },
    {
      "address": 48,
      "count": 1,
      "name": "Motor current, phase V",
      "data_type": "UInt16",
      "units": "A",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "i48. Maximum value of the current in phase V; 2000 = 2.00 A."
    },
    {
      "address": 49,
      "count": 1,
      "name": "Inquiry PIN protection level",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i49. Active write-authorization level 0...3 (see h16 bits 9:8)."
    },
    {
      "address": 50,
      "count": 1,
      "name": "Remaining lifetime",
      "data_type": "UInt16",
      "units": "h",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i50. Remaining lifetime of the electronics in hours."
    },
    {
      "address": 55,
      "count": 1,
      "name": "Motor installation position",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "i55. 0 = vertical installation (motor shaft horizontal), 1 = horizontal installation (motor shaft vertical)."
    },
    {
      "address": 59,
      "count": 1,
      "name": "Vibration velocity, X axis (1st order)",
      "data_type": "UInt16",
      "units": "mm/s",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "i59. Vibration velocity in mm/s x 100 (0...655.35 mm/s)."
    },
    {
      "address": 60,
      "count": 1,
      "name": "Vibration velocity, Y axis (1st order)",
      "data_type": "UInt16",
      "units": "mm/s",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "i60. Vibration velocity in mm/s x 100 (0...655.35 mm/s)."
    },
    {
      "address": 61,
      "count": 1,
      "name": "Vibration velocity, Z axis (1st order)",
      "data_type": "UInt16",
      "units": "mm/s",
      "scale_factor": 0.01,
      "offset": 0,
      "access": "R",
      "description": "i61. Vibration velocity in mm/s x 100 (0...655.35 mm/s)."
    }
  ],
  "holding_registers": [
    {
      "address": 0,
      "count": 1,
      "name": "PIN input",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h0. Code entry: 2143 = take over the communication parameters, 1234 = reset the motor controller, 0010/7401 = release PIN protection level 1/2, 7500...7509 = select an event-log entry, 9095 = restore the factory setting (delivery status), 3698 = delete the error memory."
    },
    {
      "address": 1,
      "count": 1,
      "name": "Control (digital control bits)",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h1. Bit 0 enable, 1 Set Intern2 (h6), 2 Set Intern3 (h9), 3 limit (h18), 4 reverse, 5 fire alarm 1, 6 fire alarm 2, 14 minimum speed OFF, 15 K1 control system. Each bit only takes effect when the matching control mode bit in h4 is set."
    },
    {
      "address": 2,
      "count": 1,
      "name": "Speed control",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h2. Speed setpoint; the interpretation depends on control mode h4 bits 3:0 (absolute 1/min, fractional 0...32767 or 0...100, or a characteristic curve)."
    },
    {
      "address": 3,
      "count": 1,
      "name": "COM parameter",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h3. Bits 15:8 = bus address 1...247 (default 247), bits 7:4 = baud rate 0 = 4800, 1 = 9600, 2 = 19200 (default), 3 = 38400, 4 = 115200 bit/s, bits 3:0 = frame 0 = 8N1, 1 = 8O1, 2 = 8E1 (default), 3 = 8N2. Settings become active after a reset or PIN 2143."
    },
    {
      "address": 4,
      "count": 1,
      "name": "Control mode",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h4. Bits 3:0 select the control source: 0 = E1 analogue/PWM input (default), 1...3 = speed control register h2, 4...6 = Set Intern1/2/3, 7...15 = characteristic-curve, air-flow and constant-moment modes. Bits 8...14 enable the matching bits of h1, bits 7:4 = automatic reset after error 0...3."
    },
    {
      "address": 5,
      "count": 1,
      "name": "Set Intern1",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h5. Speed preset for control mode 4. Range h7...h8, default 1/3 of h8."
    },
    {
      "address": 6,
      "count": 1,
      "name": "Set Intern2",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h6. Speed preset for control mode 5. Range h7...h8, default 2/3 of h8."
    },
    {
      "address": 7,
      "count": 1,
      "name": "Minimum speed",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h7. Lower speed limit, default 0."
    },
    {
      "address": 8,
      "count": 1,
      "name": "Maximum speed",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h8. Upper speed limit, default h20 (the device's rated maximum)."
    },
    {
      "address": 9,
      "count": 1,
      "name": "Set Intern3",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h9. Speed preset for control mode 6. Range h7...h8, default 3/3 of h8."
    },
    {
      "address": 10,
      "count": 1,
      "name": "Inverting E1 / D1 / K1",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h10. Bit 0 E1 inverting, bit 1 D1 inverting, bit 2 K1 inverting (normally open contact); all default 0."
    },
    {
      "address": 11,
      "count": 1,
      "name": "E1 minimum (analogue input start value)",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h11. Example: 20 % means a useful range of 2 V...E1 Max; default 5 %."
    },
    {
      "address": 12,
      "count": 1,
      "name": "E1 maximum (analogue input end value)",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h12. Example: 80 % means a useful range of E1 Min...8 V; default 100 %."
    },
    {
      "address": 13,
      "count": 1,
      "name": "E1 function",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h13. 0 = 0-10 V / PWM (default); above 0 the input works as a digital input: 1 = enable, 3 = limit, 5 = Set Intern2, 6 = Set Intern3, 13 = change direction of rotation, 15 = fire alarm 1, 19 = fire alarm 2."
    },
    {
      "address": 14,
      "count": 1,
      "name": "D1 function",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h14. 0 = OFF, 1 = enable (default), 3 = limit, 5 = Set Intern2, 6 = Set Intern3, 13 = change direction of rotation, 15 = fire alarm 1, 19 = fire alarm 2."
    },
    {
      "address": 15,
      "count": 1,
      "name": "K1 function",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h15. 0 = OFF, 1 = operation, 2 = fault (default), 4 = speed limit, 17 = control bit 15 of h1, 20 = fault or active temperature management."
    },
    {
      "address": 16,
      "count": 1,
      "name": "Controller setup flags",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h16. Default 513. Bit 0 LED mode, bits 3:1 value copied into h2 after a reset, bits 7:4 wireless channel, bits 9:8 PIN protection level, bit 10 tacho output, bits 12:11 switching frequency, bits 15:13 blocking-protection options."
    },
    {
      "address": 17,
      "count": 1,
      "name": "Communication watchdog",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h17. Bits 15:8 watchdog time in seconds (0 = off, default), bits 7:0 mode: 0 = off (default), 1 = fault, 2 = constant speed 1, 3 = fault + constant speed 1, 4...8 = E1-failure modes."
    },
    {
      "address": 18,
      "count": 1,
      "name": "Speed limit",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h18. Speed limit when activated by a digital control function; 0...100 %, default 75 %."
    },
    {
      "address": 19,
      "count": 1,
      "name": "Radio network code",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h19. 0...9999, default 9999. Only used with the AM-MODBUS-W radio module."
    },
    {
      "address": 25,
      "count": 1,
      "name": "Ramp timing",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h25. Bits 15:8 ramp-down time, bits 7:0 ramp-up time in seconds; the factory values depend on the device type (registers 20...24 and 26...29 hold factory settings that must not be changed)."
    },
    {
      "address": 30,
      "count": 1,
      "name": "Speed range suppression",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h30. Bit 0 = range 1 active, bit 1 = range 2 active, bit 2 = range 3 active; default 0."
    },
    {
      "address": 31,
      "count": 1,
      "name": "Suppression range 1 minimum",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h31. 0...20000 rpm, default 0."
    },
    {
      "address": 32,
      "count": 1,
      "name": "Suppression range 1 maximum",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h32. 0...20000 rpm, default 100."
    },
    {
      "address": 33,
      "count": 1,
      "name": "Suppression range 2 minimum",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h33. 0...20000 rpm, default 0."
    },
    {
      "address": 34,
      "count": 1,
      "name": "Suppression range 2 maximum",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h34. 0...20000 rpm, default 200."
    },
    {
      "address": 35,
      "count": 1,
      "name": "Suppression range 3 minimum",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h35. 0...20000 rpm, default 0."
    },
    {
      "address": 36,
      "count": 1,
      "name": "Suppression range 3 maximum",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "h36. 0...20000 rpm, default 300."
    }
  ],
  "combined_registers": [],
  "notes": "Source: ZIEHL-ABEGG \"Description MODBUS Communication ECblue BASIC-MODBUS\", L-BAL-E311-GB 1934 Index 001, software version ECblue firmware from 1.00, marked \"Preliminary edition\"; copy read is the vendor PDF mirrored at ivprodukt.com/file/3141, SHA-256 a1d33d7c2bb31d89ae4c756693a51fb312c5c7e67dc72444322a6e3c9e615fbe. The interface is Modbus RTU over RS-485 (2160EC / 2160 series EC fans and motors with ECblue BASIC electronics). Factory frame: holding register h3 documents bus address default 247, baud rate default 19200 bit/s and COM mode default 8E1 (8 data bits, even parity, 1 stop bit), and section 4 (emergency scenario) repeats \"Baudrate: 19200 / Parity: 8E1\" for the recovery defaults - so the seed declares 19200 8E1 at unit 247. Setting another address/frame is done by writing h3 and then a reset (PIN 2143 or power cycle); section 4's MODBUS Recovery Function answers on address 254, which is not the factory address. 3.2 states the application data start at MODBUS register address 0 in both areas, and the table's h/i numbers are used as the wire address, so the seed is zero_based; holding registers use FC 3/6/16 and input registers FC 4. Omitted by scope: the 6-register unique device signature i3...i8, the operating-hours and air-flow counters printed as separate 16-bit words (i38/i39, i42/i43), holding h37 (Fan Bad), the antiblock rows h50...h55, the vibration and lifetime thresholds h60...h71 and h80...h84, and the type-specific factory registers h20...h24 and h26...h29. Registers that need PIN protection level 1 or 2 stay writable in the seed but carry the level in the description."
}
