旧楼宇对讲智能化改造：Comelit Simplebus2 转 MQTT 接入 Home Assis

一、项目概述

Simplebus2‑MQTT‑Bridge 是一套完整开源软硬件项目，基于 Seeed XIAO‑ESP32‑C3，用于对接 Comelit Simplebus2 总线式楼宇对讲系统。设备直接并联在原有对讲总线上，无需额外供电、无需改造楼宇原有布线，把传统模拟对讲的门铃呼叫、开门控制转换成标准 MQTT 消息，无缝接入 Home Assistant 等智能家居平台。

项目完整包含总线信号处理 PCB、3D 打印外壳、PlatformIO 固件源码、网页配置界面，实现门铃事件上报、远程开门、响铃自动开门、设备 OTA 升级全套能力。

二、核心功能

事件状态上报
- 上报单元大门呼叫、室内家门门铃呼叫事件；
- 上报响铃自动开门 (Ring‑to‑Open) 功能状态；
- 定时心跳报文，用于智能家居平台在线状态检测。
远程控制能力
- 通过 MQTT 下发指令远程触发楼宇对讲开门；
- 可启用响铃自动开门：门铃触发后延时自动解锁单元门，延时时长可自定义配置；
- 支持开启 / 关闭自动开门功能。
设备管理
- 内置 Web 网页配置界面：WiFi、MQTT 服务器、总线地址、信号增益、阈值、自动开门时长全部可视化配置；
- 支持 OTA 固件在线升级，无需拆卸硬件；
- 参数持久化存储，断电配置不丢失；
- Home Assistant MQTT 自动发现，接入后自动生成传感器、开关、实体按键，无需手动编写配置文件。
多设备适配
- DIP 拨码开关配置 Simplebus2 总线地址，适配不同公寓 / 分机编号；
- 总线信号增益、比较阈值可调，适配不同长度对讲总线线缆。

三、硬件架构

主控单元：Seeed XIAO‑ESP32‑C3，仅支持 2.4GHz WiFi，设备直接从 Simplebus2 对讲总线获取工作电源，不需要外接电源适配器。
信号调理 PCB 板：完成 Simplebus2 总线信号隔离、放大、电平转换。
💡关键调校参数：Gain 增益、Threshold 比较阈值；20 米线缆典型参数为 Gain=20，阈值 600mV；线缆长度变化需要重新校准参数。
接口资源
- DIP 拨码：设置对讲分机总线地址；
- J2 扩展排针：预留扩展 IO；
- J3 调试排针：用于信号观测调试；
- USB‑C 接口：用于固件烧录；
机械结构：配套 3D 打印外壳，可直接卡扣在 DIN 导轨上，适配弱电箱安装环境。

四、软件说明

开发环境

固件使用 PlatformIO 进行编译构建，依赖库：PubSubClient (MQTT 客户端)、WiFiManager、Debounce 防抖库，基于 Arduino‑ESP32 框架。

支持直接刷写预编译.bin固件，不需要本地编译环境。

设备工作流程

首次上电：设备开启 WiFi 热点Simplebus2‑Bridge，手机连接热点，浏览器访问设备网页，填入家庭 WiFi 信息、MQTT 服务器连接参数，完成入网配置。
正常运行：监听 Simplebus2 总线门铃信号，事件通过 MQTT 发布；接收 MQTT 指令执行开门、功能切换。
OTA 升级：网页界面上传固件 bin 文件完成升级，部分配置可以保留。

MQTT 数据交互

默认根 topic 前缀：SimpleBus，可在网页配置修改。

发布（设备 → MQTT Broker）

表格

Topic	输出值	说明
`SimpleBus/loorbell`	ON/OFF	单元大门门铃呼叫
`SimpleBus/entrydoor`	ON/OFF	家门口室内分机门铃呼叫
`SimpleBus/RingToOpenStatus`	ON/OFF	响铃自动开门功能启用状态
`SimpleBus/RingToOpenTime`	数字 (分钟)	当前自动开门延时时间
`SimpleBus/heartbeat`	ON	5 分钟一次心跳
`SimpleBus/availability`	online	设备上线状态

订阅（MQTT Broker → 设备）

表格

Topic	输入值	说明
`SimpleBus/OpenDoor`	ON	触发开门动作
`SimpleBus/RingToOpen`	ON/OFF	开启 / 关闭响铃自动开门
`SimpleBus/SetRingToOpenTime`	1‑1440	设置响铃后自动开门延时 (分钟)
`SimpleBus/SetGain`	2‑40	设置总线信号增益
`SimpleBus/SetThreshold`	100‑1500	设置信号检测阈值 (mV)
`SimpleBus/Restart`	ON	设备重启

五、Home Assistant 集成

设备 MQTT 联网之后，自动发送 MQTT 发现报文。Home Assistant 会自动识别设备，自动生成：

门铃触发传感器（大门门铃、家门门铃）
Ring‑to‑Open 功能开关
开门执行按钮实体

无需编写 yaml 配置，开箱即可使用；可以直接搭配 HA 自动化：门铃推送手机通知、人脸识别后远程开门等场景。

六、重要版本注意事项⚠️（v2.0.0）

EEPROM 存储布局发生变更，旧版本固件升级后原有全部配置会被清空，升级完成后必须重新配置 MQTT、总线参数；
WiFi AP 热点名称发生变更；
硬件仅支持 2.4GHz WiFi，不支持 5GHz 无线网络。

七、适用与限制

✅适用：搭载 Comelit Simplebus2 协议的楼宇对讲系统； ⚠️限制：不同布线长度的总线，需要调试增益、阈值参数，否则会出现漏报、误报门铃事件；设备不能脱离 Simplebus2 总线独立工作。

八、项目开源资源

固件源码、PCB 工程、3D 外壳模型全部开源；
仓库地址：simplebus2‑mqtt‑bridge；
用户可以自行 PCB 打板、3D 打印外壳，也可以采购现成 PCBA 硬件。

九、License

GPL-3.0 license

十、项目地址

https://github.com/Elektroarzt/simplebus2-mqtt-bridge