5分钟上手ESP32-BLE2MQTT：从配置到运行的快速入门教程

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

ESP32-BLE2MQTT是一款运行在ESP32上的蓝牙转MQTT桥接工具，能够帮助用户轻松实现蓝牙设备与MQTT协议的互联互通。本教程将带你快速掌握从环境配置到设备运行的全过程，让你在短时间内搭建属于自己的蓝牙转MQTT网关。

一、准备工作：快速搭建开发环境

要开始使用ESP32-BLE2MQTT，首先需要准备以下工具和材料：

• ESP32开发板（推荐ESP32-C3或ESP32-S3型号）
• USB数据线
• 安装有Git和Python的电脑
• ESP-IDF开发环境

1.1 克隆项目代码库

打开终端，执行以下命令克隆项目仓库：

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

1.2 安装依赖库

项目提供了requirements.txt文件，包含所需的Python依赖：

pip install -r requirements.txt

二、核心配置：5分钟完成参数设置

2.1 配置文件详解

项目的核心配置文件位于[data/config.json]，你可以通过修改该文件来设置WiFi连接、MQTT服务器信息和蓝牙设备过滤规则。典型的配置内容包括：

• WiFi SSID和密码
• MQTT服务器地址、端口、用户名和密码
• 要监控的蓝牙设备MAC地址白名单
• 数据上报间隔时间

2.2 使用Kconfig进行项目配置

项目提供了Kconfig.projbuild配置文件，你可以使用ESP-IDF的menuconfig工具进行图形化配置：

idf.py menuconfig

在配置菜单中，你可以设置：

• 网络连接方式（WiFi或以太网）
• 日志级别和输出方式
• 设备名称和MQTT主题前缀
• 蓝牙扫描参数和连接超时设置

三、编译与烧录：一键部署到ESP32

3.1 选择目标芯片型号

根据你使用的ESP32型号，选择对应的配置文件：

• ESP32-C3：sdkconfig.defaults.esp32c3
• ESP32-S3：sdkconfig.defaults.esp32s3

3.2 编译项目

执行以下命令编译整个项目：

idf.py build

3.3 烧录到设备

将ESP32开发板通过USB连接到电脑，执行烧录命令：

idf.py flash monitor

烧录完成后，开发板将自动重启并开始运行程序。你可以通过串口监视器查看设备输出的日志信息。

四、设备运行：轻松实现蓝牙到MQTT的桥接

4.1 网页管理界面

设备启动后，会创建一个WiFi接入点或连接到你配置的WiFi网络。你可以通过浏览器访问设备的IP地址，打开网页管理界面（[www/index.html]）。网页界面使用了[www/css/mini-default.min.css]样式表和[www/js/ble2mqtt.js]脚本，提供了直观的设备管理和数据监控功能。

4.2 监控蓝牙设备

ESP32-BLE2MQTT会自动扫描周围的蓝牙设备，并将符合条件的设备数据通过MQTT协议发送到指定的服务器。你可以在网页界面上查看已连接的蓝牙设备列表和实时数据。

4.3 自定义数据解析

如果你需要解析特定蓝牙设备的数据格式，可以修改[main/broadcasters.c]和[main/gatt.c]文件中的相关代码，实现自定义的数据解析和转换逻辑。

五、常见问题解决：快速排查运行故障

5.1 连接WiFi失败

检查[data/config.json]中的WiFi配置是否正确，确保SSID和密码没有错误。如果使用企业级WiFi，可能需要修改[main/wifi.c]中的认证方式。

5.2 MQTT连接问题

确认MQTT服务器地址、端口、用户名和密码是否正确。可以通过查看设备日志（[main/log.c]）来获取详细的连接错误信息。

5.3 蓝牙设备无法发现

检查蓝牙设备是否处于可被发现状态，以及是否在配置的白名单中。你可以通过修改[main/ble.c]中的扫描参数来增加扫描范围和频率。

通过本教程，你已经掌握了ESP32-BLE2MQTT的基本使用方法。这款强大的工具可以帮助你快速构建物联网应用，实现蓝牙设备与MQTT生态的无缝对接。无论是家庭自动化、工业监控还是智能健康设备，ESP32-BLE2MQTT都能为你提供简单、可靠的解决方案。

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