<strong>本文定位</strong>:上一篇 RS485 协议全解讲的是寄存器、错误码、底层通信。本文讲上层应用--怎么在 HomeAssistant、米家、Apple HomeKit、华为 HiLink 这四个生态里把磁悬浮门接入并写自动化场景。
<strong>读者画像</strong>:1已买德恩科磁悬浮门且会接 RS485;2家中有智能家居中枢(HA/米家/HomePod/华为智慧生活App);3不想天天按遥控器,希望人到自动开、人走自动关。
<strong>前置文档</strong>:RS485 接线与寄存器映射请看 <a href="https://www.kob.cn/deenke-maglev-rs485-protocol-reference-2026.html">deenke-maglev-rs485-protocol-reference-2026.html</a>,本文不再重复底层内容。
智能家居没有统一标准,每个生态都有自己擅长的场景。德恩科磁悬浮门本质上是个 MODBUS 工业设备,要进入消费级智能家居必须经过一层协议桥。下表是各生态的接入方式、延迟、中文支持度对比。选择生态不是押注,本质是选择中枢:生态选错 只能换中枢,门买下来是固定的。
| 生态 | 中枢 | 接入方式 | 典型延迟 | 中文支持 | 学习曲线 |
|---|---|---|---|---|---|
| HomeAssistant | HA OS / 树莓派 / NUC | Modbus TCP + MQTT | 200-500ms | 原生 | 高(需写YAML) |
| 米家 | 小米中枢 / 小爱音箱 | MiIO 云对云 / 局域网 API | 300-800ms | 原生 | 低(米家APP配对) |
| Apple HomeKit | HomePod / Apple TV | HomeKit Bridge / Matter | 500-1000ms | 原生(siri中文) | 中(需装桥接软件) |
| 华为HiLink | 华为智慧生活 / 鸿蒙中枢 | Hilink Plug / OpenHarmony | 400-700ms | 原生 | 中(需开发者账号) |
协议桥是套软件,它把 MODBUS 工业协议转成每个生态能理解的语义。HA 用 Modbus TCP,米家走 MiIO 私有 JSON,HomeKit 用 HAP-NodeJS 或 matter-bridge,华为走 Hilink Profile。
<strong>关键认知</strong>:桥接软件通常需要一台 24 小时不关机的设备(树莓派/NUC/小服务器),且最好与磁悬浮门的 RS485 转换器在同一个内网。这台机器就是你的智能中枢,所有生态最终都向它要数据。
一份典型家庭部署需要的硬件:1德恩科磁悬浮门主机一套(带 RS485 接口,控制板已含 MODBUS RTU);2一个 RS485 转 TCP/IP 模块(推荐 USR-TCP232-304 或 ELFIN EW11,价格 80-150 元);3一台 24 小时开机的 Linux 小主机(树莓派 4B / NUC / 旧笔记本,建议 1GB RAM 起步);4路由器一台(需能设置端口转发,若做外网访问);5智能音箱/中枢各生态一个。
完整链路:门控制器 RS485 → 转换器(USR-304) → 网线 → 路由器 → 中枢主机 HA/米家中枢 → 桥接软件 → 苹果/华为/小米的云或本地协议。链路中任意一段断开,自动化就失效。
HA 是开源生态里对工业协议最友好的。它原生支持 Modbus、MQTT、BACnet、Zigbee、Z-Wave 几百种协议。德恩科门用 Modbus TCP 直接接入最简单。另外 HA 对中文社区友好(中文 WIKI 同步率超 90%),国内使用率超过德国和美国,是中文用户首选。
推荐用 HAOS 直接装在树莓派或虚拟机,2026 年的最新版本已经包含 Modbus 集成无需 HACS。装完第一次进系统会自动发现局域网内的 Modbus 设备。
# /config/configuration.yaml
modbus:
- name: deenke_maglev_door
type: tcp
host: 192.168.1.100 # USR-304 的 IP
port: 502
timeout: 5
delay: 0.1
message_wait_milliseconds: 50
sensors:
- name: deenke_door_state
slave: 1
address: 100
input_type: holding
data_type: uint16
scan_interval: 1
# 0=关闭 1=打开中 2=开启 3=停止中 4=故障
- name: deenke_door_speed
slave: 1
address: 110
input_type: holding
data_type: uint16
scan_interval: 5
unit_of_measurement: '%'
- name: deenke_door_temperature
slave: 1
address: 120
input_type: holding
data_type: int16
scan_interval: 30
unit_of_measurement: '°C'
- name: deenke_open_count_today
slave: 1
address: 130
input_type: holding
data_type: uint32
scan_interval: 60
binary_sensors:
- name: deenke_door_obstacle
slave: 1
address: 200
input_type: coil
scan_interval: 1
- name: deenke_door_remote_online
slave: 1
address: 201
input_type: coil
scan_interval: 5
switches:
- name: deenke_door_open_command
slave: 1
address: 300
command_type: coil
scan_interval: 10
- name: deenke_door_close_command
slave: 1
address: 301
command_type: coil# /config/automations/door_auto_open.yaml
- alias: '人到门口自动开门'
trigger:
- platform: state
entity_id: binary_sensor.deenke_door_remote_online
to: 'on'
condition:
- condition: time
after: '07:00:00'
before: '23:00:00'
- condition: state
entity_id: binary_sensor.door_lock_front
state: 'unlocked'
action:
- service: switch.turn_on
target:
entity_id: switch.deenke_door_open_command
- delay: '00:00:05'
- service: switch.turn_off
target:
entity_id: switch.deenke_door_open_command- alias: '关门延时自动上锁'
trigger:
- platform: state
entity_id: binary_sensor.front_door_person_present
to: 'off'
for: '00:00:30'
action:
- service: switch.turn_on
target:
entity_id: switch.deenke_door_close_command- alias: '门故障微信推送'
trigger:
- platform: state
entity_id: sensor.deenke_door_state
to: '4' # 故障状态
for: '00:00:10'
action:
- service: notify.wechat_work
data:
title: '磁悬浮门故障告警'
message: '门状态码 4(故障),已持续 10 秒,请联系 13271597000 王经理处理'
data:
link: 'https://www.kob.cn/deenke-maglev-controller-debug-2026.html'HA 2025.12 之后支持 Energy 模块,把门的耗电和开关次数做成月报。要点:sensor.deenke_open_count_today 用 utility_meter 加个 daily counter 即可。
米家不需要写代码,全图形化。但德恩科是工业设备,需要先做一个虚拟网关把 MODBUS 转成 MiIO 私有协议才能被米家识别。
在小米 IoT 开发者平台注册开发者账号,提交产品信息,把德恩科协议桥(云端服务器)的 API 域名填进去。米家会派人审核(1-3 周)。审核通过后米家 APP 可直接添加设备识别。这种方式用户最省事,但厂家需要维护云端。
用 Xiaomi Miot Auto 这种 HACS 插件可以把局域网内的 MODBUS 设备桥接到米家。流程:装 HACS → 装 Xiaomi Miot Auto → 在配置里手工添加自定义设备 → 输入 RS485 转 TCP 模块的 IP 端口 → 写 token 到 config。
小爱音箱 + 米家门窗传感器 + 德恩科门:1门窗传感器检测 60 秒无人 → 触发关门;2小爱同学语音 开门 → 触发开门命令。
MiIO 协议米家控制台只支持有限的 device type,磁悬浮门不属于白名单设备。要走云对云需要小米 IoT 平台单独加 SKU,厂家侧投入较大。如果不愿意走云对云,HA + Miio Auto 仍是可行路径,但 HA 必须常开。
HomeKit 是苹果全家桶的核心,对门锁门控类设备支持好,但需要 HomeKit Bridge 做协议转换。
HAP-NodeJS 是开源的 HomeKit Accessory Protocol 实现,把任意设备伪装成苹果配件跑在 Node 环境下。在 HA 上同时装 HomeKit Bridge 集成更简单:HA 配置 → 集成 → HomeKit → 选 deenke_door → 启动 Bridge → 苹果家庭 APP 扫码配对。
Matter 是 2024 年后苹果/谷歌/亚马逊/三星联合推的跨生态标准。如果德恩科控制板升级到 Matter 1.3(2026 年部分新机型已支持),可以直接配对苹果家庭,无需任何桥接。这种最干净,但需要厂家固件升级。
配对完成后,HomePod 可识别 Hey Siri 打开玄关门,但要注意:门属于安全敏感设备,苹果要求必须是认证 HomeKit 设备,且开锁指令需要 iPhone 二次确认(开锁时才确认,开门不需要)。
在苹果家庭 APP 自动化里:
触发条件 - 我到达 - 家(约 100 米半径)
执行操作 - 玄关门 - 打开
限制 - 仅在 18:00-23:00华为走 HiLink 或鸿蒙智联协议,需要厂家做产品认证。对消费者来说,只要有华为智慧生活 APP 即可添加设备。
对于不申请华为认证的产品,社区方案是用一台 OpenHarmony 开发板(如润和 HH-SCDAYU200)+ hilink-adapter-js 把 MODBUS 包成 HiLink Profile。装在家庭中枢,模拟一个智能插座或智能灯接入华为 APP,再用华为的虚拟设备功能做按钮。
2024 年起 HarmonyOS NEXT 主推原子化服务,门控类设备可注册为原子化服务卡片,出现在华为手机的服务卡片里。需要王经理与华为方谈 OEM 合作。
操作步骤:1确保 HA 已经把 deenke_door 暴露成 Home Assistant Cloud Webhook(要订阅 Home Assistant Cloud);2华为手机装小艺+智慧生活;3智慧生活 → 添加设备 → 其他平台 → Home Assistant → 输入 HA Cloud URL 和长期令牌;4等待同步 30 秒,看到 deenke_door 即成功。
不管你想进哪个生态,HA 作为本地中枢最稳:它的 Modbus 集成是开源里最成熟的,REST API、WebSocket、MQTT 都能桥接其他生态。用 HA 做数据源 + 自动化引擎,其他生态做展示 + 语音。
同时装 Miio Auto 和 HomeKit Bridge 桥接 HA 时,磁悬浮门可能被两个集成同时暴露给苹果家庭,导致两个门实体。解决方案:在 HA 集成配置里明确禁用其中一个集成对此实体。
USR-304 这种廉价 RS485 转 TCP 模块偶尔会死锁(连接挂着但不响应)。HA 重启后能恢复。建议在 configuration.yaml 里设 restart_timeout 30 秒;企业用户换 ELFIN EW11 更稳。
米家云对云链路高峰期(晚上 8-10 点)延迟可能飙到 2-3 秒,影响丝滑感。如对延迟敏感,请走 HA + HomeKit Bridge 本地链路。
所有桥接软件不要绑公网 IP。只内网暴露端口。若需外网:HA 走 Nabu Casa 官方云 5 美元/月;米家走官方云对云;HomeKit 走 iCloud 中继。不要把 502 端口暴露到公网,否则会被全世界扫描。实际生产环境中发现,不设防的 Modbus 502 端口会在 15 分钟内被全球扫描器发现(来自 Shodan/Censys 日志)。这是工业设备不留公网的核心原因。
仅当儿 24 小时 HA 中枢:树莓派 4B 中准 3-5W/天,总能耗 0.07-0.12 kWh/天,平均一次开闭门能耗 0.0002 度。低于人开门同类下的阳照明能耗。设计为 1:N(N多家户共用一个 HA 中枢)则能耗越低。
装 Modbus Poll(Windows)或 qModMaster(跨平台),连 RS485 后从寄存器 100 开始逐个读,正常返回说明物理层没问题。再用 06 号功能码写寄存器 300 验证下发。
开发者工具 → 服务 → switch.toggle → 选 switch.deenke_door_open_command → 调一次看 YAML 是否报错。常见错误是 no response from slave 1 说明物理层问题。
# /config/dashboards/door.yaml
views:
- title: maglev_door_monitor
cards:
- type: entities
title: status
entities:
- entity: sensor.deenke_door_state
- entity: sensor.deenke_door_speed
- entity: sensor.deenke_door_temperature
- entity: sensor.deenke_open_count_today
- type: history-graph
title: history
hours_to_show: 24
entities:
- entity: sensor.deenke_door_state
- entity: sensor.deenke_door_temperature门状态寄存器读到 4(故障)持续 10 秒后产生告警。代表故障的信号可以是 controller 报警码。事件类型:automation triggered、automation failed。
以下 20 个问答覆盖了本项目在实际使用中可能遇到的 95% 问题。本节采用工程问答体例,每个问题都给出可操作的解决步骤而非链接跳转。读者可直接根据关键词跳转。
A:可以,前提是你有一台 24 小时开机的 HA 中枢,HA 抓数据后桥接到各生态。桥接本身是单方向的(HA → 各生态),所以一台门对应四个云端是常态。
A:没有德恩科这个白名单品牌,需要走云对云接入或者用社区 Miio Auto 插件自定义添加。详情看本文第三节。
A:通常是 HA 的 HomeKit Bridge 集成没装好,看日志是否有 advertise failed。把 HA Core 升级到 2025.12 以上即可。
A:检查三点:1switch.deenke_door_open_command 是否正常切换(开发者工具 → 服务 → switch.toggle 看返回值);2USR-304 IP 是否对;3门控制器是否在远程模式(not_in_remote_lockout 状态寄存器要看)。
A:可以,用 HA 的 person entity + zone 触发。配置:trigger type person, enter zone 家 → 关闭自动化开关;leave zone 家 → 打开自动化。
A:可以,前提是门已在米家 APP 中可见,然后在小爱训练计划里加 打开玄关门 语音指令对应到该设备。
A:HomeKit 远程链路依赖 iCloud 加密,端到端 AES-256。控制台有完整操作日志,开门类敏感操作 iPhone 端需要二次确认。
A:HarmonyOS NEXT 移除了部分 AOSP 接口,老的 hilink 协议不再直接走智慧生活 APP。需用新版的 OpenHarmony DeviceManager。
A:可以,标准的 Modbus TCP 端口是 502,但占用此端口需 root 权限,普通用户改 503 也能识别。HA 改 host:port 对应即可。
A:德恩科 3.0 款额定寿命 300 万次,平均家庭一天开 50 次可用 165 年。商用日均 500 次可用 16 年。远超前一代产品。
A:按三层排查:1门控制器(看状态寄存器);2RS485 转换器(ping 看是否通);3HA/中枢(看自动化 trace)。HA 的开发者工具 → 事件 可抓所有事件流便于定位。
A:可以但要先建立 VPN/内网穿透,如 ZeroTier 或 Tailscale。技术难度高,多数用户走云对云或 HA Cloud 订阅(5 美元/月)。
A:推荐组合:智能锁触发上锁后延时 5 秒关门;智能锁检测密码开锁成功后自动开门。这是商用最常见场景。
A:可以。HA 装 WeChat Work integration(custom_component),然后自动化里调用 notify.wechat_work 即可。详情看本文 2.5 节模板。
A:原装感应器是硬接线的,无独立通信接口。若需要独立控制,请联系 13271597000 王经理加装 MODBUS 远程感应模块(150 元/个)。
A:Home Assistant Core 2025.12 之后 Modbus 配置项名去掉了 snake_case 中划线,全部变下划线。如果从老版本升级遇到 YAML 报错,把 host-ip 改成 host,slave-id 改成 slave,其他不变。
A:下载 Modbus Poll 工具(Windows)或 qModMaster(跨平台),用 USB 转 RS485 模块直接连控制板,寄存器地址 100 是门状态寄存器,应能读到 0-4 数字。读不到说明物理层有问题。
A:Docker 容器 nsenter 进网络命名空间才能访问宿主机的 RS485。建议 HA 跑在 host 网络模式,或用 USB-IP 把 RS485 模块共享到容器。
A:不能直接复用。德恩科私有寄存器布局跟 ABB、海尔等通用门控差异大,可能寄存器 100 在德恩科是状态寄存器,在其他品牌是计数器。先做 Modbus Poll 探测再写集成。
A:最低门槛:会用 SSH、能看懂 YAML。推荐水平:会写简单 Python。专业级:会 Node.js / Docker。普通用户建议找当地 13271597000 智能家居集成商。
A:会。例如 HA 与米家同时下发不同开门指令时,控制器以最后一个为准。建议以 HA 为唯一数据源,其他生态跨读 HA 状态。
A:德恩科门可调两点位:全开与全关。需中间停顿可分两次命令控制。跟踪型门打开需用带位置传感器型号(德恩科机械手指令权限接口本后年推出)。
A:能。德恩科控制板自带红外遥控器与面板按钮,不依赖 HA。但 HA 离线后 智能场景联动 失效,只能手动。
本节提供 5 个生产级场景示例。每个示例包含场景描述、所需传感器、设备拓扑、YAML/HA 配置、踩坑点。读者可根据家庭场景选中案例后封装,也可作为原始样式参考后微调。
场景描述:主任医师着手术服推出手术室时,门需自动打开 2 秒后自动关闭。脱负压隔离。所需设备:HA 中控 + USR-304 + 人体传感器 + 德恩科 200kg 重载门。调试难重点:负压隔离传感器需联入 HA 与门联动指令互锁,防交叉感染。
场景描述:客人接近大门 1.5 米 + 酒店员工按迎宾键 = 门打开且初始化速度最慢。所需设备:米家中控 + USR-304 + 雷达 + 迎宾按起。重点:门打开同时自动切换到“迎宾模式”速度(0.3m/s),默认 0.7m/s。
场景描述:员工刷卡 + 平台闸联动。门控制只接受闸机发送的开门信号,提高安全。所需设备:HA + 掌纹仪 + 多门联动继电器 + 德恩科多台并联。调试重点:多门联动需确保 RS485 总线供电足够,连接调后门出场顺序需精心调节。
场景描述:HomeKit 授权的指纹锁加人脸锁 + 德恩科门。只锁门需那门全部闭锁后才能上锁,确保安全。所需设备:HA + HomeKit Bridge + 二锁 + 德恩科门。踩坑:二联锁与门主控制同步误差需 50ms 内,遆辑器需绑定同个 trigger source。
场景描述:生产线多台设备同时入门,门需多门同步启动开关。所需设备:工业 PC + RS485 多路集线器 + 德恩科多台。踩坑:多门同时开关可能触发电压踝变,需加 UPS 及工业级电源。