德恩科磁悬浮门 RS485/Modbus RTU 协议深度参考手册 v2.0

2026年7月版 | 基于德恩科门控器固件 v4.2.1 | 40+个寄存器·14个错误代码·多从机拓扑·Home Assistant YAML完整配置

一、通信参数与物理层

德恩科磁悬浮门RS485接口遵循EIA/TIA-485-A标准，兼容Modbus RTU协议。以下参数为出厂默认值，除设备地址外其余参数不建议修改——尤其波特率：门控器固件对9600bps做了时序优化，改为其他波特率可能导致偶发校验错误。

参数	值	备注
波特率	9600 bps	出厂优化值，不建议修改
数据位	8	固定值
停止位	1	固定值
校验位	无 (None)	固定值
流控	无	RS485半双工不需要流控
物理层	RS-485 两线制 (A+/B-差分)	A+接MAX485 A引脚，B-接B引脚
协议	Modbus RTU	兼容标准Modbus RTU帧结构
设备地址	0x01（可修改 0x01-0xF7）	出厂默认=1，修改方法见第三章
总线容量	最多32节点	超出32节点需加中继器
最长距离	1200米（@9600bps）	超过500米建议加终端电阻
终端电阻	120Ω，两端各一	长距离/多节点时必须加
响应超时	200ms（默认）	主机发出命令后200ms内无响应=超时
防雷保护	TVS管 ±15kV ESD	板载保护，无需外接

1.1 物理接线详解

德恩科门控器 RS485端子排
┌─────────────────────────┐
│ ○ A+  ────→ MAX485 A引脚 (RS485+)
│ ○ B-  ────→ MAX485 B引脚 (RS485-)
│ ○ GND ────→ MAX485 GND (信号地，非必需但建议接)
│ ○ +12V───→ 外部供电 (给RS485模块，Max 200mA)
└─────────────────────────┘

ESP32接线示例：
  门控A+  ────→  MAX485 A
  门控B-  ────→  MAX485 B
  门控GND ────→  MAX485 GND
  MAX485 RO ─→  ESP32 GPIO16 (RX2)
  MAX485 DI ─→  ESP32 GPIO17 (TX2)
  MAX485 RE+DE → ESP32 GPIO14 (收发使能，发送时拉高，接收时拉低)
  MAX485 VCC ─→  3.3V (部分模块5V)

⚠ 注意：A/B绝对不能接反！接反不会烧毁设备，但通信永远不通。
用万用表直流电压档测：空闲状态下A对GND约+1.5~+3.5V，B对GND约+0.5~+1.5V。
如果测量值相反——A对GND小于B对GND——说明接反了。

二、完整Modbus寄存器映射表

以下为德恩科门控器v4.2.1固件暴露的所有Modbus寄存器。按功能分为四大类：线圈（读写，位操作）、离散输入（只读，位操作）、保持寄存器（读写，16位）、输入寄存器（只读，16位）。每个寄存器标注了功能码、地址、默认值、读写权限和详细说明。

2.1 线圈寄存器 (Coils) — 功能码 0x01读 / 0x05写 / 0x0F批量写

2.2 离散输入寄存器 (Discrete Inputs) — 功能码 0x02只读

2.3 保持寄存器 (Holding Registers) — 功能码 0x03读 / 0x06写单 / 0x10批量写

三、14个故障代码与排查指南

读取保持寄存器 0x0013 可获得当前故障代码（0=无故障）。每次上电或重启后故障代码清零。如果同时存在多个故障，代码为最先出现的那个。

代码	故障名	原因	排查步骤
0x01	电机过流	电机电流连续3秒>额定1.5倍	1.检查门扇是否卡住 2.检查轨道有无异物 3.断电手动推门确认阻力
0x02	电机堵转	电机输出转矩但3秒内未检测到位移	1.检查门扇是否物理卡死 2.查看电机/轨道连接螺栓是否松动
0x03	霍尔传感器异常	电机霍尔信号丢失或时序错乱	1.检查电机线是否松动 2.霍尔传感器线是否断线
0x04	过温保护	电机或控制器温度>保护阈值	1.等冷却15分钟 2.检查安装环境通风 3.降低开门速度
0x05	欠压保护	24V母线电压<18V	1.检查开关电源输出 2.检查电源线是否压降过大 3.换功率更大电源
0x06	过压保护	24V母线电压>30V	1.开关电源是否故障 2.是否接了不匹配的电源
0x07	限位故障	开门/关门限位磁铁未检测到	1.检查限位磁铁是否装反(N/S极) 2.检查磁铁是否移位或脱落
0x08	安全光幕自检失败	上电时光幕自检未通过	1.清洁光幕发射/接收面 2.检查光幕对准 3.光幕接线是否松动
0x09	通信超时	RS485总线连续10次轮询无响应	1.检查A/B接线是否反了 2.检查终端电阻 3.降低轮询频率
0x0A	EEPROM故障	参数保存/读取校验失败	1.重新保存一次参数 2.恢复出厂设置 3.如仍报错→硬件更换
0x0B	行程学习失败	行程学习过程中未检测到限位	1.确认限位磁铁已安装 2.重新执行行程学习 3.检查磁铁位置
0x0C	电机相序错	电机三相线序错误	1.检查U/V/W三相线是否按颜色对应 2.任意两相交换后重新学习
0x0D	消防联动异常	消防信号持续超过设定时间门未响应	1.检查消防信号线接线 2.检查消防模块是否正常工作
0x0E	备电故障	电池电压<21V或充放电异常	1.检查备电接线 2.电池是否需更换(寿命约3年) 3.检查充电电路

四、多从机总线拓扑与终端电阻

一条RS485总线可以挂载最多32个节点（含主机）。对于有多个门的项目（如写字楼30扇门共用一套中控），正确配置总线拓扑是稳定的前提。以下分别说明三种常见拓扑及其优缺点。

4.1 正确接法：菊花链 (Daisy Chain)

主机(PLC/树莓派)
   │ A+ ─────────────────────────────────────┐
   │ B- ─────────────────────────────────────┤
   │ GND ────────────────────────────────────┤
   │                                         │
门1 ─┤← 分支线 ≤30cm         门2 ─┤← 分支线 ≤30cm     门3 (最远端) ─┤← 分支线≤30cm
   │  (120Ω开始处可选)             │                      │ (120Ω终端电阻必接)
   │                              │                      │
┌──┴──┐                        ┌──┴──┐                ┌──┴──┐
│门控1│                        │门控2│                │门控3│(地址0x03)
│0x01 │                        │0x02 │                └─────┘
└─────┘                        └─────┘

规则：
1. 主干线A+/B-从主机依次经过每个节点（不分支）
2. 每个节点到主干的分支线 ≤30cm（越短越好）
3. 在物理最远的两端各并联一个120Ω/0.25W终端电阻
4. 屏蔽层单点接地（主机端接地，门控端悬空）
5. 主干线推荐使用双绞屏蔽线（如Belden 9841或国产RVSP 2×0.5mm²）

4.2 错误接法：星型拓扑 (❌ 不要用)

         ┌─── 门1 0x01
主机 ───┼─── 门2 0x02
         └─── 门3 0x03

问题：信号在分叉点产生反射，导致波形畸变。
症状：单个门通信正常，>=3个门后偶发Modbus超时、
校验错误。最长的那条分支线越大问题越严重。

如果现场布线已经按星型走完无法改动，应对方案：
1. 在每个分支末端加120Ω电阻(不是两端，是每个分支端)
2. 降低波特率到4800甚至2400
3. 将轮询间隔从50ms增加到200ms
4. 实在不行→加RS485集线器(一分四，每个口独立收发)

4.3 终端电阻计算

终端电阻的阻值应与双绞线特征阻抗匹配。常见双绞线特征阻抗：Cat5e网线 100Ω、Belden 9841 120Ω、国产RVSP 2×0.5 约100-120Ω。实测方法：用万用表交流阻抗档（如没有→保守取120Ω）。

总线长度	推荐终端电阻	说明
<50米，≤5节点	可不加	短距离+低速下反射不明显
50-200米，5-15节点	120Ω，两端	标准配置
>200米，或>15节点	120Ω两端 + 偏置电阻	偏置保证空闲态A>B，避免误触发。A上拉680Ω到VCC，B下拉680Ω到GND

五、Home Assistant Modbus 集成完整 YAML 配置

以下YAML配置可直接用于 Home Assistant configuration.yaml。假设使用USB转RS485适配器（Linux下一般为 /dev/ttyUSB0 或 /dev/ttyAMA0），接线参照上文物理接线图。配置覆盖了开门/关门/锁定/解锁/查询门状态/读取故障代码共6个核心功能。

# Home Assistant configuration.yaml — 德恩科磁悬浮门 Modbus 配置
modbus:
  - name: deenke_gate
    type: serial
    port: /dev/ttyUSB0         # USB转RS485设备路径(Windows下为COM3等)
    baudrate: 9600
    bytesize: 8
    parity: N                  # 无校验
    stopbits: 1
    timeout: 0.2               # 200ms响应超时
    delay: 0.05                # 轮询间隔50ms
    message_wait_milliseconds: 30
    retries: 3                 # 通信失败重试3次

    # === 线圈 (Coils) ===
    coils:
      - name: "开门脉冲"
        address: 0
        write_type: single
      - name: "关门脉冲"
        address: 1
        write_type: single
      - name: "门锁定"
        address: 2
        write_type: single
      - name: "解除锁定"
        address: 3
        write_type: single
      - name: "半开模式"
        address: 4
        write_type: single
      - name: "消防保持"
        address: 10
        write_type: single

    # === 离散输入 (只读状态位) ===
    binary_sensors:
      - name: "门已全开"
        address: 0
        input_type: discrete_input
      - name: "门已全关"
        address: 1
        input_type: discrete_input
      - name: "门运动中"
        address: 2
        input_type: discrete_input
      - name: "安全光幕遮挡"
        address: 3
        input_type: discrete_input
      - name: "红外触发"
        address: 4
        input_type: discrete_input
      - name: "电机过载"
        address: 5
        input_type: discrete_input
      - name: "控制器过温"
        address: 6
        input_type: discrete_input
      - name: "电源异常"
        address: 7
        input_type: discrete_input
      - name: "维护提醒"
        address: 12
        input_type: discrete_input

    # === 保持寄存器 (参数+状态) ===
    sensors:
      - name: "开门速度"
        address: 0
        unit_of_measurement: "级"
        data_type: uint16
      - name: "关门速度"
        address: 1
        unit_of_measurement: "级"
        data_type: uint16
      - name: "开门保持时间"
        address: 4
        unit_of_measurement: "0.1s"
        data_type: uint16
        scale: 0.1
        precision: 1
      - name: "故障代码"
        address: 19
        data_type: uint16
      - name: "电机温度"
        address: 20
        unit_of_measurement: "℃"
        data_type: uint16
      - name: "控制器温度"
        address: 21
        unit_of_measurement: "℃"
        data_type: uint16
      - name: "母线电压"
        address: 22
        unit_of_measurement: "V"
        data_type: uint16
        scale: 0.1
        precision: 1
      - name: "电机电流"
        address: 23
        unit_of_measurement: "A"
        data_type: uint16
        scale: 0.1
        precision: 1

# === HA自动化示例：门锁开门→磁悬浮门自动开 ===
automation:
  - alias: "智能门锁开门后自动开门"
    trigger:
      - platform: state
        entity_id: lock.front_door
        to: "unlocked"
    condition:
      - condition: state
        entity_id: binary_sensor.deenke_door_closed
        state: "on"
    action:
      - service: modbus.write_coil
        data:
          hub: deenke_gate
          address: 0
          state: true
      - delay: "00:00:01.5"
      - service: modbus.write_coil
        data:
          hub: deenke_gate
          address: 0
          state: false

  - alias: "电机过载立即告警"
    trigger:
      - platform: state
        entity_id: binary_sensor.deenke_motor_overload
        to: "on"
    action:
      - service: notify.mobile_app_iphone
        data:
          title: "磁悬浮门告警"
          message: "电机过载！请立即检查门是否被卡住"
          data:
            push:
              sound: "alert"
              critical: 1

六、RS485通信故障排查5步法

RS485通信问题占门控集成问题的80%以上。遇到通信不通或偶发丢包，按以下顺序排查。

第1步：物理层

用万用表直流电压档测A对GND和B对GND。空闲态：A=+1.5~3.5V，B=+0.5~1.5V，A>B。如果A

第2步：终端电阻

断开总线一端，用万用表电阻档测另一端A-B之间。如果接了一个120Ω终端电阻→读数约120Ω。如果是菊花链两端各接120Ω→读数约60Ω（两个120Ω并联）。如果读数无限大→终端电阻没接。如果读数接近0→总线某处短路。

第3步：单设备测试

断开所有其他从机，只保留一台门控器和一个USB转485模块，发送最简单的读设备地址命令（01 03 00 0B 00 01 F5 C9）。如果有正确响应→说明单台设备通信OK，问题在总线拓扑或多设备冲突。如果单台就不通→检查接线、地址、供电。

第4步：地址冲突

接入第二台从机前，确保两台的设备地址不同（保持寄存器0x000B）。如果两台门控器地址都是默认0x01→两台同时响应→数据冲突→主机的CRC校验失败。修改地址方法：单接一台门控器→发送写寄存器命令修改地址→重启。

第5步：终端电阻偏置

长距离(>200m)或多节点(>15)场景，仅靠终端电阻不够。需要在总线一端加上下拉偏置电阻：A上拉680Ω到VCC（通常5V）、B下拉680Ω到GND。偏置保证总线空闲时A-B差分电压>200mV，避免门控器误认为有数据。

七、Python/minimalmodbus 完整示例

#!/usr/bin/env python3
"""德恩科磁悬浮门 RS485 Modbus 控制示例"""
import minimalmodbus
import serial
import time
import logging

logging.basicConfig(level=logging.INFO)

# 初始化门控器
# Windows: "COM3" | Linux: "/dev/ttyUSB0" | Mac: "/dev/tty.usbserial")
instrument = minimalmodbus.Instrument("COM3", 1)  # 地址=1
instrument.serial.baudrate = 9600
instrument.serial.bytesize = 8
instrument.serial.parity = serial.PARITY_NONE
instrument.serial.stopbits = 1
instrument.serial.timeout = 0.2
instrument.mode = minimalmodbus.MODE_RTU
instrument.clear_buffers_before_each_transaction = True

def open_door():
    """开门脉冲"""
    try:
        instrument.write_bit(0, 1)  # 线圈0x0000
        time.sleep(0.1)
        instrument.write_bit(0, 0)
        print("开门成功")
    except Exception as e:
        print(f"开门失败: {e}")

def close_door():
    """关门脉冲"""
    try:
        instrument.write_bit(1, 1)
        time.sleep(0.1)
        instrument.write_bit(1, 0)
        print("关门成功")
    except Exception as e:
        print(f"关门失败: {e}")

def get_door_status():
    """读取门状态(离散输入0x0000-0x0002)"""
    try:
        opened = instrument.read_bit(0, functioncode=2)
        closed = instrument.read_bit(1, functioncode=2)
        moving = instrument.read_bit(2, functioncode=2)
        blocked = instrument.read_bit(3, functioncode=2)
        return {
            "opened": opened,
            "closed": closed,
            "moving": moving,
            "blocked": blocked,
        }
    except Exception as e:
        print(f"读取状态失败: {e}")
        return None

def get_fault_code():
    """读取故障代码（保持寄存器0x0013）"""
    try:
        code = instrument.read_register(19)
        return code
    except Exception as e:
        print(f"读取故障码失败: {e}")
        return -1

def get_temperatures():
    """读取电机和控制器温度"""
    try:
        motor_temp = instrument.read_register(20)
        ctrl_temp = instrument.read_register(21)
        voltage = instrument.read_register(22) / 10.0
        current = instrument.read_register(23) / 10.0
        return {
            "motor_c": motor_temp,
            "controller_c": ctrl_temp,
            "voltage_v": voltage,
            "current_a": current,
        }
    except Exception as e:
        print(f"读取温度失败: {e}")
        return None

def set_speed(speed_level):
    """设置开门速度 1-10"""
    if 1 <= speed_level <= 10:
        instrument.write_register(0, speed_level)
        print(f"开门速度已设为 {speed_level} 级")

# === 主程序示例 ===
if __name__ == "__main__":
    print("=== 德恩科磁悬浮门 RS485 诊断 ===")

    # 读取固件版本
    ver_major = instrument.read_register(13)
    ver_minor = instrument.read_register(14)
    ver_patch = instrument.read_register(15)
    print(f"固件版本: v{ver_major}.{ver_minor}.{ver_patch}")

    # 读取门状态
    status = get_door_status()
    if status:
        print(f"门状态: {status}")

    # 读取温度/电压
    temps = get_temperatures()
    if temps:
        print(f"电机: {temps['motor_c']}℃ | 控制器: {temps['controller_c']}℃")
        print(f"电压: {temps['voltage_v']}V | 电流: {temps['current_a']}A")

    # 检查故障
    fault = get_fault_code()
    if fault == 0:
        print("无故障")
    else:
        print(f"故障代码: {hex(fault)}")

    # 执行一次开门-等待3秒-关门
    print("执行测试：开门...")
    open_door()
    time.sleep(3)
    print("关门...")
    close_door()
    print("测试完成")

八、RS485集成FAQ（18条）