ESP32-BLE2MQTT终极指南：如何打造你的专属BLE到MQTT双向桥梁

【免费下载链接】esp32-ble2mqttA BLE to MQTT bridge running on an ESP32项目地址: https://gitcode.com/gh_mirrors/es/esp32-ble2mqtt

ESP32-BLE2MQTT是一个运行在ESP32上的BLE到MQTT双向桥梁项目，它能将BLE GATT特征值以MQTT主题形式暴露，实现双向通信。本指南将带你快速搭建属于自己的物联网数据转换桥梁，无需复杂编程即可实现蓝牙设备与MQTT系统的无缝对接。

🌟 为什么选择ESP32-BLE2MQTT？

这款桥梁工具基于ESP-IDF v5.2.1开发，专为ESP32系列芯片优化，具有以下核心优势：

• 双向通信：不仅能将BLE设备数据发布到MQTT，还能通过MQTT控制BLE设备
• 自动适配：自动识别标准BLE服务和特征值，无需手动编码解析
• 广泛兼容：支持iBeacon、Eddystone、小米Mijia等多种广播设备
• 灵活配置：通过简单的JSON配置文件即可定制设备连接规则和数据处理方式

🚀 快速开始：3步完成基础搭建

1️⃣ 准备开发环境

首先需要安装Espressif IoT Development Framework，请按照官方指南完成所有步骤，包括工具设置和get_idf别名配置。

2️⃣ 获取项目代码

git clone --recursive https://gitcode.com/gh_mirrors/es/esp32-ble2mqtt

3️⃣ 配置与烧录

修改配置文件data/config.json以适应你的网络环境，然后执行：

idf.py build flash

⚙️ 核心功能详解

BLE与MQTT数据转换

系统会自动将BLE设备的GATT特征值映射为MQTT主题。例如，MAC地址为a0:e6:f8:50:72:53的设备，其电池服务的电池电量特征值会被发布到：

a0:e6:f8:50:72:53/BatteryService/BatteryLevel

支持三种核心操作：

• 自动通知：支持通知的特征值会自动推送更新
• 主动读取：向主题后缀/Get发送任意消息触发读取
• 远程控制：向主题后缀/Set发送消息设置特征值

广播设备支持

对于非连接型BLE广播设备，系统会发布多种元数据：

• iBeacon：UUID、Major、Minor和距离
• Eddystone：UID帧、URL帧和TLM帧数据
• 小米设备：温度、湿度、甲醛浓度等传感器数据
• BeeWi设备：门状态和电池信息

所有广播数据会发布到BLE2MQTT-XXXX/<广播设备MAC地址>/主题下，包含类型、RSSI等基础信息和设备特定数据。

📝 配置文件详解

配置文件data/config.json是项目的核心，主要包含以下几个部分：

网络配置

可选择WiFi或以太网连接，以太网配置优先于WiFi：

{ "network": { "hostname": "MY_HOSTNAME", "wifi": { "ssid": "MY_SSID", "password": "MY_PASSWORD" }, "eth": { "phy": "LAN8720", "phy_power_pin": 12 } } }

MQTT配置

设置MQTT broker连接参数和主题格式：

{ "mqtt": { "server": { "host": "192.168.1.1", "port": 1883 }, "publish": { "qos": 0, "retain": true }, "topics": { "prefix": "", "get_suffix": "/Get", "set_suffix": "/Set" } } }

BLE配置

定义设备连接规则和特征值解析方式：

{ "ble": { "whitelist": ["aa:bb:cc:dd:ee:ff", "00:11:22:??:??:??"], "services": { "definitions": {}, "blacklist": [] }, "characteristics": { "definitions": {}, "blacklist": [] } } }

🔧 高级功能

远程日志

配置日志输出到UDP服务器，方便远程调试：

{ "log": { "host": "224.0.0.200", "port": 5000 } }

使用以下命令接收日志：

idf.py remote-monitor

空中升级(OTA)

支持固件和配置文件的远程升级：

# 升级固件 idf.py upload # 升级配置文件 idf.py upload-config # 指定设备升级 OTA_TARGET=BLE2MQTT-470C idf.py upload

📋 常见问题解决

设备连接问题

• 检查白名单/黑名单：确保设备MAC地址在配置的白名单中或不在黑名单中
• 验证密钥：对于加密设备，确保在mikeys部分配置了正确的密钥
• 信号强度：确认BLE设备在ESP32的有效通信范围内

MQTT通信问题

• 连接参数：检查MQTT服务器地址、端口和认证信息
• 主题格式：确认使用了正确的主题前缀和后缀
• 网络连接：验证ESP32已成功连接到网络

🛠️ 硬件兼容性

项目默认配置支持大多数ESP32开发板，对于特殊硬件如Olimex ESP32-POE，需进行针对性配置：

{ "network": { "eth": { "phy": "LAN8720", "phy_power_pin": 12 } } }

并通过idf.py menuconfig设置：

• RMII_CLK_OUTPUT=y
• RMII_CLK_OUT_GPIO=17

🎯 总结

ESP32-BLE2MQTT提供了一个简单而强大的解决方案，让你能够轻松构建BLE与MQTT之间的桥梁。通过本指南的步骤，你可以快速部署自己的物联网数据转换系统，实现各种蓝牙设备与MQTT生态的无缝集成。无论是智能家居、工业监控还是环境传感，这个工具都能为你的项目提供可靠的无线数据传输能力。

现在就动手尝试，开启你的物联网连接之旅吧！

【免费下载链接】esp32-ble2mqttA BLE to MQTT bridge running on an ESP32项目地址: https://gitcode.com/gh_mirrors/es/esp32-ble2mqtt