ESP32-BLE2MQTT 开源项目教程
项目介绍
ESP32-BLE2MQTT 是一个开源项目,旨在利用 ESP32 的蓝牙低功耗(BLE)功能,将 BLE 设备的数据通过 MQTT 协议传输到物联网平台。该项目主要由 Shmuel Zon 开发和维护,适用于需要在物联网环境中集成 BLE 设备的场景。
项目快速启动
硬件准备
- ESP32 开发板
- 电脑(Windows/Linux/Mac)
- USB 数据线
软件准备
- Arduino IDE
- ESP32 开发板支持包
- MQTT 服务器(如 Mosquitto)
安装步骤
- 安装 Arduino IDE:从 Arduino 官网下载并安装 Arduino IDE。
- 添加 ESP32 开发板支持:
- 打开 Arduino IDE,进入
文件
->首选项
。 - 在
附加开发板管理器网址
中添加:https://dl.espressif.com/dl/package_esp32_index.json
。 - 进入
工具
->开发板
->开发板管理器
,搜索esp32
并安装。
- 打开 Arduino IDE,进入
- 下载 ESP32-BLE2MQTT 项目:
- 在 GitHub 上下载项目代码:
https://github.com/shmuelzon/esp32-ble2mqtt.git
。
- 在 GitHub 上下载项目代码:
- 配置 MQTT 服务器信息:
- 打开
config.h
文件,配置 MQTT 服务器的 IP 地址、端口、用户名和密码。
- 打开
上传代码
- 将 ESP32 开发板通过 USB 数据线连接到电脑。
- 选择正确的开发板和端口(
工具
->开发板
->ESP32 Dev Module
,工具
->端口
)。 - 点击
上传
按钮,将代码上传到 ESP32 开发板。
示例代码
#include <BLEDevice.h>
#include <BLEUtils.h>
#include <BLEServer.h>
#include <PubSubClient.h>
// MQTT 服务器配置
const char* mqtt_server = "192.168.1.100";
const int mqtt_port = 1883;
const char* mqtt_user = "user";
const char* mqtt_password = "password";
// MQTT 客户端
WiFiClient espClient;
PubSubClient client(espClient);
void setup() {
Serial.begin(115200);
setup_wifi();
client.setServer(mqtt_server, mqtt_port);
client.setCallback(callback);
}
void loop() {
if (!client.connected()) {
reconnect();
}
client.loop();
}
void setup_wifi() {
delay(10);
Serial.println();
Serial.print("Connecting to ");
Serial.println(ssid);
WiFi.begin(ssid, password);
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println("");
Serial.println("WiFi connected");
Serial.println("IP address: ");
Serial.println(WiFi.localIP());
}
void callback(char* topic, byte* payload, unsigned int length) {
Serial.print("Message arrived [");
Serial.print(topic);
Serial.print("] ");
for (int i = 0; i < length; i++) {
Serial.print((char)payload[i]);
}
Serial.println();
}
void reconnect() {
while (!client.connected()) {
Serial.print("Attempting MQTT connection...");
if (client.connect("ESP32Client", mqtt_user, mqtt_password)) {
Serial.println("connected");
} else {
Serial.print("failed, rc=");
Serial.print(client.state());
Serial.println(" try again in 5 seconds");
delay(5000);
}
}
}