{
  "spec_version": 1,
  "slug": "ebmpapst-ec-fans-modbus",
  "manufacturer": "ebm-papst",
  "model": "EC fans with integrated Modbus (product range, identification 0x0011)",
  "category": "Fan controller",
  "supplier_url": "https://www.ebmpapst.com/us/en/support/downloads/modbus-ebmbus.html",
  "default_configuration": {
    "protocol": "modbus_rtu",
    "unit_id": 1,
    "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": "Identification",
      "data_type": "Hex",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D000. 0x0011 identifies the ebm-papst product range at specification version 6.2."
    },
    {
      "address": 1,
      "count": 1,
      "name": "Maximum number of bytes per telegram",
      "data_type": "UInt16",
      "units": "bytes",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D001. Contrary to the general Modbus specification the maximum telegram length is 80 bytes."
    },
    {
      "address": 3,
      "count": 1,
      "name": "Bus controller software version",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D003. Software version of the bus controller (LSB; the MSB is always 0)."
    },
    {
      "address": 5,
      "count": 1,
      "name": "Commutation controller software version",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D005. Software version of the commutation controller (LSB; the MSB is always 0)."
    },
    {
      "address": 16,
      "count": 1,
      "name": "Current speed",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D010. Speed-referenced: 64000 = maximum speed (holding 281 / D119); the display is limited to 1.02 x maximum speed (0xFFF0)."
    },
    {
      "address": 17,
      "count": 1,
      "name": "Motor status (errors)",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D011. Bit 0 PHA (phase failure / line undervoltage), 1 TFE (output stage overheating), 2 SKF (master/slave communication error), 3 FB (fan bad), 4 TFM (motor overheating), 5 HLL (Hall sensor error), 6 BLK (motor blocked), 8 n_Limit (speed limit exceeded), 10 RL_Cal (rotor position calibration error), 12 UzLow (DC-link undervoltage)."
    },
    {
      "address": 18,
      "count": 1,
      "name": "Warning",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D012. Bit 0 I_Limit, 1 L_high, 2 P_Limit, 3 TE_high, 4 TM_high, 5 TEI_high, 6 UzLow, 7 Brems, 8 RL_Cal, 9 n_Low, 10 Kabelbr. (open circuit at the set value input), 12 UzHigh, 14 UeHigh, 15 LRF (shedding active)."
    },
    {
      "address": 24,
      "count": 1,
      "name": "Current direction of rotation",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D018. 0 = counter-clockwise, 1 = clockwise."
    },
    {
      "address": 25,
      "count": 1,
      "name": "Current modulation level",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.00152587890625,
      "offset": 0,
      "access": "R",
      "description": "D019. 65536 = 100 %."
    },
    {
      "address": 26,
      "count": 1,
      "name": "Current set value",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D01A. In speed control mode 64000 = maximum speed (D119); in open-loop control mode 65536 = 100 %; in sensor control mode referenced to the sensor characteristic curve."
    },
    {
      "address": 27,
      "count": 1,
      "name": "Sensor actual value",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D01B. Actual value of the external sensor selected by the source sensor value (D147), 65536 = 10 V at the analog input."
    },
    {
      "address": 28,
      "count": 1,
      "name": "Enable/Disable input state",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D01C. 0 = enable off (motor stop), 1 = enable on (motor start permitted)."
    },
    {
      "address": 29,
      "count": 1,
      "name": "Current parameter set",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D01D. 0 = parameter set 1, 1 = parameter set 2."
    },
    {
      "address": 30,
      "count": 1,
      "name": "Current controller function",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D01E. 0 = positive (heating), 1 = negative (cooling)."
    },
    {
      "address": 39,
      "count": 1,
      "name": "Current power",
      "data_type": "UInt16",
      "units": "W",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D027. The numerical value corresponds directly to the current power in W; no reference values are needed."
    },
    {
      "address": 40,
      "count": 1,
      "name": "Current set value source",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D028. 0 = analog input Ain1, 1 = RS485 (setpoint D001), 2 = analog input Ain2, 3 = PWM input PWMin3, 255 = fail-safe set value."
    },
    {
      "address": 75,
      "count": 1,
      "name": "MEMS sensor status",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D04B. Bit 0 test run interval elapsed, 1 XE_Err (communication break to the MEMS sensor), 2 more than 5 ranges detected, 4 limit (vibration velocity limit exceeded), 5 Ausbl (operating set value masked out)."
    }
  ],
  "holding_registers": [
    {
      "address": 0,
      "count": 1,
      "name": "Reset and parameter transfer",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D000. 0x02 = transfer parameter / reset, other values are ebm-papst service codes (see 2.2). Write authorization: ebm-papst, customer, end customer."
    },
    {
      "address": 1,
      "count": 1,
      "name": "Setpoint",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D001. In speed control mode the value is speed-referenced: 64000 = maximum speed (D119). In open-loop control mode 65536 = 100 %; in sensor control mode the value is referenced to the sensor characteristic curve. 0 = standstill. The 4 LSBs are insignificant."
    },
    {
      "address": 5,
      "count": 1,
      "name": "Factory setting control",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D005. Bit mask that copies the parameter area D100..D17F to or from the factory setting area (see 2.5)."
    },
    {
      "address": 6,
      "count": 1,
      "name": "Customer setting control",
      "data_type": "Binary",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D006. Bit mask that stores or restores the customer setting area (see 2.6)."
    },
    {
      "address": 9,
      "count": 1,
      "name": "Operating hours counter",
      "data_type": "UInt16",
      "units": "h",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D009. Incremented once per hour of fan operation; saturates at 65535. Writing requires ebm-papst authorization."
    },
    {
      "address": 10,
      "count": 1,
      "name": "Operating minutes counter",
      "data_type": "UInt16",
      "units": "min",
      "scale_factor": 1,
      "offset": 0,
      "access": "R",
      "description": "D00A. Incremented once per full minute of fan operation. Writing requires ebm-papst authorization."
    },
    {
      "address": 12,
      "count": 1,
      "name": "Addressing function on/off",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D00C. 0x00 = addressing function inactive, 0x01 = active (address assignment over the 0-10 V clock line)."
    },
    {
      "address": 15,
      "count": 1,
      "name": "Enable/Disable",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D00F. 0 = motor stop, 1 = motor start permitted (logic table in 2.54)."
    },
    {
      "address": 16,
      "count": 1,
      "name": "Remote control value at the 0-10 V output",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.00152587890625,
      "offset": 0,
      "access": "RW",
      "description": "D010. 65536 = 100 %; only effective when the output function is remote control (5)."
    },
    {
      "address": 17,
      "count": 1,
      "name": "Test run control",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D011. Starts the MEMS test run used for the mask-out ranges (see 2.13)."
    },
    {
      "address": 18,
      "count": 1,
      "name": "Mask-out back-up control",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D012. Bit 0 = enable mask-out, bit 1 = step-change mode, bit 8 = restore the back-up ranges; bits 15/14 report error/restore state."
    },
    {
      "address": 256,
      "count": 1,
      "name": "Fan address (Modbus slave address)",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D100. Permissible range 1...247. All fans leave the factory with address 1 (see 1.3.6)."
    },
    {
      "address": 257,
      "count": 1,
      "name": "Set value source",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D101. 0 = analog input Ain1, 1 = RS485 (setpoint D001), 2 = analog input Ain2, 3 = PWM input PWMin3."
    },
    {
      "address": 258,
      "count": 1,
      "name": "Preferred running direction",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D102. Preferred direction used when the running direction is not taken from a digital input."
    },
    {
      "address": 259,
      "count": 1,
      "name": "Store set value",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D103. Stores the current set value as the power-on value."
    },
    {
      "address": 260,
      "count": 1,
      "name": "Parameter set source",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D104. Selects whether parameter set 1 or 2 is used from the internal setting or a digital input."
    },
    {
      "address": 261,
      "count": 1,
      "name": "Parameter set internal",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D105. 0 = parameter set 1, 1 = parameter set 2 when the source is internal."
    },
    {
      "address": 262,
      "count": 1,
      "name": "Operating mode, parameter set 1",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D106. 0 = speed control, 1 = sensor control, 2 = open-loop control."
    },
    {
      "address": 263,
      "count": 1,
      "name": "Operating mode, parameter set 2",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D107. 0 = speed control, 1 = sensor control, 2 = open-loop control."
    },
    {
      "address": 264,
      "count": 1,
      "name": "Controller function, parameter set 1",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D108. 0 = positive (deviation = set value - actual value), 1 = negative (deviation = actual value - set value)."
    },
    {
      "address": 265,
      "count": 1,
      "name": "Controller function, parameter set 2",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D109. 0 = positive, 1 = negative."
    },
    {
      "address": 270,
      "count": 1,
      "name": "Maximum modulation level, parameter set 1",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.390625,
      "offset": 0,
      "access": "RW",
      "description": "D10E. 256 = 100 %; must stay below the maximum permissible modulation level (D117)."
    },
    {
      "address": 271,
      "count": 1,
      "name": "Maximum modulation level, parameter set 2",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.390625,
      "offset": 0,
      "access": "RW",
      "description": "D10F. 256 = 100 %."
    },
    {
      "address": 272,
      "count": 1,
      "name": "Minimum modulation level, parameter set 1",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.390625,
      "offset": 0,
      "access": "RW",
      "description": "D110. 256 = 100 %; must stay above the minimum permissible modulation level (D118)."
    },
    {
      "address": 273,
      "count": 1,
      "name": "Minimum modulation level, parameter set 2",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.390625,
      "offset": 0,
      "access": "RW",
      "description": "D111. 256 = 100 %."
    },
    {
      "address": 274,
      "count": 1,
      "name": "Motor stop enable, parameter set 1",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D112. 0 = motor stop permitted, 1 = motor stop blocked."
    },
    {
      "address": 275,
      "count": 1,
      "name": "Motor stop enable, parameter set 2",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D113. 0 = motor stop permitted, 1 = motor stop blocked."
    },
    {
      "address": 278,
      "count": 1,
      "name": "Starting modulation level",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.390625,
      "offset": 0,
      "access": "R",
      "description": "D116. 256 = 100 %. Modulation level applied when the motor starts. Writing requires ebm-papst authorization."
    },
    {
      "address": 279,
      "count": 1,
      "name": "Maximum permissible modulation level",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.390625,
      "offset": 0,
      "access": "R",
      "description": "D117. 256 = 100 %; upper limit for D10E/D10F. Writing requires ebm-papst authorization."
    },
    {
      "address": 280,
      "count": 1,
      "name": "Minimum permissible modulation level",
      "data_type": "UInt16",
      "units": "%",
      "scale_factor": 0.390625,
      "offset": 0,
      "access": "R",
      "description": "D118. 256 = 100 %; lower limit for D110/D111. Writing requires ebm-papst authorization."
    },
    {
      "address": 281,
      "count": 1,
      "name": "Maximum speed",
      "data_type": "UInt16",
      "units": "rpm",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D119. Every speed-referenced setpoint and actual value uses 64000 = this value, and the speed is limited to it in sensor and open-loop control."
    },
    {
      "address": 328,
      "count": 1,
      "name": "Running direction source",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D148. Selects whether the running direction comes from the internal setting or a digital input (see 2.18)."
    },
    {
      "address": 329,
      "count": 1,
      "name": "Transmission speed (baud rate)",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D149. 0 = 1200, 1 = 2400, 2 = 4800, 3 = 9600, 4 = 19200, 5 = 38400, 6 = 57600, 7 = 115200 bit/s. Standard value 19200 (0x04) is the default."
    },
    {
      "address": 330,
      "count": 1,
      "name": "Parity configuration",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D14A. 0 = 8E1, 1 = 8O1, 2 = 8N2, 3 = 8N1. Standard value 8E1 (0x00) is the default; 8N1 violates the Modbus serial-line specification."
    },
    {
      "address": 347,
      "count": 1,
      "name": "Fail-safe running direction",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D15B. Running direction used when a cable break is detected."
    },
    {
      "address": 348,
      "count": 1,
      "name": "Fail-safe set value source",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D15C. Selects the source of the fail-safe set value (see 2.48)."
    },
    {
      "address": 349,
      "count": 1,
      "name": "Fail-safe set value",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D15D. Coding as for the setpoint D001: in speed control mode 64000 = maximum speed (D119)."
    },
    {
      "address": 350,
      "count": 1,
      "name": "Fail-safe time delay",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D15E. Delay between detection of the cable break and activation of the fail-safe set value."
    },
    {
      "address": 362,
      "count": 1,
      "name": "Enable/Disable source",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D16A. Selects the source of the enable/disable signal (logic table in 2.54)."
    },
    {
      "address": 363,
      "count": 1,
      "name": "Stored Enable/Disable",
      "data_type": "UInt16",
      "units": "",
      "scale_factor": 1,
      "offset": 0,
      "access": "RW",
      "description": "D16B. Enable state stored as the power-on value."
    }
  ],
  "combined_registers": [],
  "notes": "Source: ebm-papst \"MODBUS parameter specification for 'ebm-papst product range'\" V6.2, document en-US_MODBUS_6_2_Auszug.docx, dated 6 March 2019 (the vendor excerpt: parameters for ebm-papst internal use are marked \"Reserved\"). Copy read: ebmpapst.se/sv/dat/site_common/upload/MODBUS_Series_V6.2_Excerpt.pdf, SHA-256 37fd6ac881db850be68694a964603e16a96c067c7c0994246f17891c39c55baa. Covers every fan of the product range whose electronics answer identification 0x0011 (e.g. RadiPac and HyBlade EC fans with integrated Modbus). Factory frame, from 2.44.3 (\"leave the interface settings on the default values\") and the parity table 2.44.2: 19200 bit/s, 8 data bits, even parity, 1 stop bit. Fan address: 1.3.6 states \"All ex works fans have the same address 1\" (range 1...247, 0 = broadcast) - 19200 8E1 at unit 1. Register addresses: the document prints them as D000...D1AA; the seed stores the decimal value of those hex numbers (D100 = 0x0100 = 256), and the worked frames in 1.3 send the address as-is and 1.1 documents the RTU byte structure, so the seed is zero_based. Several rows of the 2.1 overview print the address one row out of line with the parameter's own section - 2.1 puts transmission speed and parity at D148/D149 where 2.44.1 and 2.44.2 print D149/D14A - so the seed stores the per-section address. Scale factors come from the printed codings: current modulation level and the 0-10 V remote control value are word/65536 x 100 %, the modulation-level limits and set-points are word/256 x 100 %, and the absolute power row is already in W. Omitted: DC-link voltage and current (D013/D014), the three temperatures (D015...D017), the energy counter (D029), the mirrored blocks (input D100...D10F, holding D380...D39F and D480...D49F), the software-name rows (D002/D004) and every parameter the excerpt marks \"Reserved\". Registers whose write authorization is ebm-papst only are listed with access R and say so."
}
