ESP32-BLE2MQTT配置完全手册：WiFi、MQTT与BLE参数优化

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

ESP32-BLE2MQTT是一款运行在ESP32上的BLE转MQTT桥接工具，能够帮助用户轻松实现蓝牙设备与MQTT协议的互联互通。本手册将详细介绍如何配置WiFi连接、优化MQTT参数以及调整BLE设置，让你的物联网项目搭建更加高效稳定。

准备工作：环境搭建与固件获取

在开始配置前，需要准备以下环境和工具：

• ESP32开发板（推荐ESP32-C3或ESP32-S3型号）
• 安装ESP-IDF开发框架
• 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/es/esp32-ble2mqtt

项目核心配置文件位于main/config.h，包含了WiFi、MQTT和BLE的基础参数定义。固件编译前可通过修改此文件或使用Kconfig配置界面进行参数调整。

快速配置：基础参数设置

WiFi网络配置

WiFi连接是设备接入网络的基础，在main/wifi.c中实现了网络连接逻辑。主要配置参数包括：

• WiFi SSID和密码：通过WIFI_SSID和WIFI_PASSWORD宏定义设置
• 连接超时时间：默认30秒，可通过WIFI_CONNECT_TIMEOUT调整
• 重连机制：支持自动重连，间隔时间可通过WIFI_RECONNECT_DELAY设置

MQTT服务器连接

MQTT协议是物联网通信的核心，main/mqtt.c实现了MQTT客户端功能。关键配置项：

• 服务器地址和端口：MQTT_BROKER_URI（如"mqtt://iot.eclipse.org:1883"）
• 客户端ID：MQTT_CLIENT_ID，建议设置为设备唯一标识
• 用户名和密码：MQTT_USER和MQTT_PASSWORD，用于服务器认证
• 保活时间：MQTT_KEEPALIVE，默认60秒

高级优化：提升系统性能

BLE扫描参数调整

BLE扫描性能直接影响设备发现效率，在main/ble.c中可调整以下参数：

• 扫描间隔：BLE_SCAN_INTERVAL，默认100ms
• 扫描窗口：BLE_SCAN_WINDOW，默认50ms
• 扫描持续时间：BLE_SCAN_DURATION，默认30秒

缩短扫描间隔和窗口可以提高发现速度，但会增加功耗；延长扫描持续时间适合需要发现低功耗设备的场景。

数据转发优化

main/ble2mqtt.c实现了BLE数据到MQTT的转发逻辑。通过调整以下参数优化性能：

• 消息缓存大小：MSG_QUEUE_SIZE，默认20条
• 转发间隔：DATA_FORWARD_INTERVAL，默认1000ms
• QoS级别：MQTT_QOS，建议设置为1以保证消息可靠传输

Web配置界面使用指南

项目提供了Web配置界面，通过浏览器即可轻松修改设备参数：

1. 设备启动后连接名为"BLE2MQTT-XXXX"的WiFi热点
2. 访问http://192.168.4.1进入配置页面
3. 在界面中设置WiFi网络、MQTT服务器等参数
4. 保存配置后设备将自动重启并应用新设置

Web界面的静态资源位于www/目录，包含HTML、CSS和JavaScript文件，用户可根据需求自定义界面样式和功能。

常见问题解决

WiFi连接失败

• 检查SSID和密码是否正确
• 确认WiFi网络是否为2.4GHz频段（不支持5GHz）
• 尝试增加WIFI_CONNECT_TIMEOUT延长连接等待时间

MQTT连接不稳定

• 检查网络信号强度，确保设备在WiFi覆盖范围内
• 调整MQTT_KEEPALIVE参数，避免频繁断连
• 启用MQTT遗嘱消息，通过MQTT_LWT_TOPIC和MQTT_LWT_MSG配置

BLE设备发现不及时

• 减小BLE_SCAN_INTERVAL和BLE_SCAN_WINDOW
• 延长BLE_SCAN_DURATION扫描持续时间
• 确保BLE设备处于广播状态

配置文件示例

以下是data/config.json的典型配置示例：

{ "wifi": { "ssid": "YourWiFiName", "password": "YourWiFiPassword" }, "mqtt": { "broker": "mqtt.example.com", "port": 1883, "client_id": "esp32-ble2mqtt-001", "username": "mqttuser", "password": "mqttpass" }, "ble": { "scan_interval": 100, "scan_window": 50, "scan_duration": 30 } }

通过合理配置以上参数，ESP32-BLE2MQTT可以稳定高效地实现BLE设备与MQTT服务器的桥接功能，为你的物联网项目提供可靠的数据传输通道。如需进一步定制功能，可参考项目源代码进行二次开发。

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