外观
OpenMQTTGateway
OpenMQTTGateway (OMG) 的目标是把「五花八门的无线协议」统一成 MQTT：一块 ESP32 就能同时收发 433 MHz 射频、红外遥控、BLE 传感器数据，转发给 Home Assistant、Node-RED 等系统。它的想法是减少桌面上各种桥接盒子的数量。
项目概况
| 项目 | 内容 |
|---|---|
| 仓库 / 官网 | github.com/1technophile/OpenMQTTGateway，文档 docs.openmqttgateway.com |
| 作者 / 组织 | 1technophile 与社区；BLE 解码由 Theengs 项目提供 |
| 开源协议 | GPL-3.0 |
| 支持芯片 | ESP32、ESP8266（仓库描述） |
| 首次发布 | 仓库创建于 2016 年 9 月 17 日 |
| 版本 | 最近一次 release 为 v1.8.1（2025 年 1 月 13 日） |
| 热度 | 约 4100 星（2026 年 10 月） |
它是怎么工作的
固件由「模块」组成，编译或在线安装时选择需要的模块：
- 433 / 315 / 868 MHz 射频：收发遥控器、门磁、天气站等的信号（用 RF 接收/发射模块或 CC1101 之类的射频芯片）。
- 红外：接收和发射遥控码，用来控制空调、电视。
- BLE：借助 Theengs Decoder 解码温湿度计（小米、LYWSD 系列）、体重秤、植物传感器、胎压监测 (TPMS)、烧烤温度计等，文档称覆盖 100 多种设备。
- LoRa：作为 LoRa 与 MQTT 之间的桥。
- 其他：Wi-Fi / 以太网接入，通过 MQTT 的主题收发数据，支持 Home Assistant 自动发现。
所有数据都走 MQTT 主题，所以后端可以是任何会说 MQTT 的系统。
需要的硬件
| 场景 | 硬件 |
|---|---|
| BLE 网关 | 任意带蓝牙的 ESP32；Theengs 出售带外置天线、以太网的 Theengs Bridge |
| 433 MHz | ESP32 + RXB6 / SRX882 / CC1101 等射频模块 |
| 红外 | IR 发射管与接收头 |
| 现成硬件 | 项目有板型参考表格和购买建议，文档站列出可选板子 |
上手路径
- 文档的 Getting Started 称约 15 分钟就可以从浏览器刷入固件并看到第一个传感器数据。
- 在 Web 安装页选择预编译环境，用 Chrome / Edge 通过 USB 刷机，参见 烧录工具。
- 配置 Wi-Fi 和 MQTT Broker。
- 在 Home Assistant 的 MQTT 集成里自动出现设备。
- 选择 ESPHome 还是 OMG：如果设备只是 BLE 温湿度计，ESPHome 的蓝牙代理更省心；如果要混合 433 MHz、红外和 BLE，OMG 现成可用。
生态与衍生
- Theengs：Theengs Decoder 是 BLE 解码库，Theengs Gateway 可在树莓派 / PC 上做同样的事。
- Theengs Bridge 等商品基于该固件。
- 与 ESPresense 都用 BLE 接入 MQTT，用途不同。
- 相关玩法见 智能家居 与 传感器与监控。
局限与注意事项
- 同时开太多模块会占用有限的 RAM 与 flash，需要精简模块。
- BLE 和 Wi-Fi 共享射频，BLE 扫描频繁会影响 Wi-Fi 稳定性。
- 433 MHz 收发要遵守本地无线电法规，功率与频段在各国不同。
- 最近一次 release 为 2025 年 1 月，但仓库仍在更新（2026 年 10 月仍有推送），想要最新支持的设备可用开发版构建。
- 配置依赖文档与参数表，初次配置曲线较陡。