ESP32 BLE OTA 无线固件升级技术实现指南
2026-04-10 09:24:05作者:劳婵绚Shirley
在物联网设备部署中,传统的有线固件升级方式面临着物理接触困难、维护成本高的挑战。本文将详细介绍如何基于蓝牙低功耗(BLE)技术实现ESP32设备的无线固件升级方案,通过Silicon Labs EFR Connect应用实现便捷的设备管理。
技术原理实现
BLE OTA架构设计
BLE OTA(Over-The-Air)升级技术通过蓝牙低功耗通信实现固件的无线传输与更新,主要包含三个核心组件:
- BLE服务层:负责设备发现、连接管理和数据传输
- OTA控制层:处理升级流程控制和状态管理
- 固件存储层:管理Flash分区和固件写入
设备通过BLE广播特定服务UUID,移动应用发现并建立连接后,通过特征值交互完成固件传输和升级控制。
核心服务与特征值配置
项目实现了Silicon Labs标准的OTA服务规范,关键配置如下表:
| 组件 | UUID | 类型 | 特性 | 作用 |
|---|---|---|---|---|
| OTA服务 | 1D14D6EE-FD63-4FA1-BFA4-8F47B42119F0 | 主服务 | - | 定义OTA升级服务 |
| 控制特征 | F7BF3564-FB6D-4E53-88A4-5E37E0326063 | 特征值 | 写操作 | 发送升级控制命令 |
| 数据特征 | 984227F3-34FC-4045-A5D0-2C581F81A153 | 特征值 | 写操作、无响应写 | 传输固件数据 |
在代码中,这些UUID通过以下方式定义:
// OTA服务UUID定义 [main/gatts_table_creat_demo.c]
static uint8_t service_uuid[16] = {
0xf0, 0x19, 0x21, 0xb4, 0x47, 0x8f, 0xa4, 0xbf,
0xa1, 0x4f, 0x63, 0xfd, 0xee, 0xd6, 0x14, 0x1d
};
// OTA控制特征UUID定义 [main/gatts_table_creat_demo.c]
static uint8_t char_ota_control_uuid[16] = {
0x63, 0x60, 0x32, 0xe0, 0x37, 0x5e, 0xa4, 0x88,
0x53, 0x4e, 0x6d, 0xfb, 0x64, 0x35, 0xbf, 0xf7
};
固件升级流程设计
完整的BLE OTA升级流程包含三个关键阶段:
- 准备阶段:客户端发送0x00命令,设备初始化OTA环境,擦除目标分区
- 数据传输阶段:客户端通过数据特征发送固件数据,每包244字节
- 完成验证阶段:客户端发送0x03命令,设备验证固件完整性并重启
关键代码实现如下:
// OTA控制命令处理 [main/gatts_table_creat_demo.c]
if (heart_rate_handle_table[IDX_CHAR_VAL_A] == param->write.handle && param->write.len == 1) {
uint8_t value = param->write.value[0];
ESP_LOGI(GATTS_TABLE_TAG, "ota-control = %d", value);
if(0x00 == value) { // 准备阶段
ESP_LOGI(GATTS_TABLE_TAG, "======beginota======");
update_partition = esp_ota_get_next_update_partition(NULL);
err = esp_ota_begin(update_partition, OTA_WITH_SEQUENTIAL_WRITES, &update_handle);
}
else if(0x03 == value) { // 完成阶段
ESP_LOGI(GATTS_TABLE_TAG, "======endota======");
err = esp_ota_end(update_handle);
err = esp_ota_set_boot_partition(update_partition);
esp_restart();
}
}
实施步骤详解
开发环境配置
硬件要求:
- ESP32-C3开发板(推荐esp32-c3-devkitm-1)
- 智能手机(安装Silicon Labs EFR Connect应用)
软件环境:
- ESP-IDF v4.4开发框架
- 串口调试工具
项目获取:
git clone https://gitcode.com/gh_mirrors/es/esp32-ota-ble
cd esp32-ota-ble
分区表配置实现
项目采用双OTA分区设计,配置文件[partitions.csv]内容如下:
# ESP-IDF Partition Table
# Name, Type, SubType, Offset, Size, Flags
nvs, data, nvs, , 0x4000,
otadata, data, ota, , 0x2000,
phy_init, data, phy, , 0x1000,
ota_0, app, ota_0, , 0x180000, # 主应用分区
ota_1, app, ota_1, , 0x180000 # 备份应用分区
此配置提供了两个1.5MB的应用分区(0x180000 = 1572864字节),支持OTA升级时的固件交替存储。
BLE服务实现
GATT服务表的创建是实现BLE OTA的核心,通过定义属性数据库描述GATT服务结构:
// GATT属性数据库定义 [main/gatts_table_creat_demo.c]
static const esp_gatts_attr_db_t gatt_db[HRS_IDX_NB] = {
// 服务声明
[IDX_SVC] = {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)&primary_service_uuid,
ESP_GATT_PERM_READ, sizeof(service_uuid), sizeof(service_uuid), (uint8_t *)&service_uuid}},
// OTA控制特征声明
[IDX_CHAR_A] = {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)&character_declaration_uuid,
ESP_GATT_PERM_READ, CHAR_DECLARATION_SIZE, CHAR_DECLARATION_SIZE,
(uint8_t *)&char_prop_write_writenorsp}},
// OTA控制特征值
[IDX_CHAR_VAL_A] = {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_128, (uint8_t *)&char_ota_control_uuid,
ESP_GATT_PERM_READ | ESP_GATT_PERM_WRITE, GATTS_DEMO_CHAR_VAL_LEN_MAX,
sizeof(char_value), (uint8_t *)char_value}},
// OTA数据特征声明与值定义...
};
固件编译与烧录
编译固件:
idf.py set-target esp32c3 # 根据实际硬件选择目标芯片
idf.py menuconfig # 确认蓝牙和OTA配置
idf.py build
生成GBL文件:
cp build/esp32-ota-ble.bin build/esp32-ota-ble.gbl
烧录初始固件:
idf.py flash -p /dev/ttyUSB0 # 替换为实际串口
升级验证步骤
- 打开EFR Connect应用,扫描名为"OTA-BLE"的设备
- 连接设备后,选择OTA服务(UUID: 1D14D6EE-FD63-4FA1-BFA4-8F47B42119F0)
- 选择"OTA Data"特征,点击"Write Command"
- 选择生成的.gbl固件文件,开始传输
- 观察应用进度条,完成后设备自动重启
场景应用与优化
不同场景下的优化配置
低功耗场景:
- 调整广播间隔为500ms-1000ms:
adv_int_min=0x190, adv_int_max=0x320 - 启用连接参数更新:
min_int=0x20, max_int=0x40, timeout=100
工业环境:
- 增加数据校验:实现每包CRC校验
- 启用重传机制:在[gatts_profile_event_handler]中添加丢包检测
代码示例:
// 调整广播参数 [main/gatts_table_creat_demo.c]
static esp_ble_adv_params_t adv_params = {
.adv_int_min = 0x190, // 300ms
.adv_int_max = 0x320, // 500ms
.adv_type = ADV_TYPE_IND,
.own_addr_type = BLE_ADDR_TYPE_PUBLIC,
.channel_map = ADV_CHNL_ALL,
.adv_filter_policy = ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY,
};
故障排查决策树
连接失败:
- 检查设备是否广播:
ESP_LOGI(GATTS_TABLE_TAG, "advertising start successfully") - 确认UUID是否正确:对比代码与应用中的服务UUID
- 验证蓝牙初始化:检查
app_main()中的蓝牙使能流程
升级中断:
- 检查MTU设置:
esp_ble_gatt_set_local_mtu(500) - 确认Flash空间:检查分区表大小是否足够
- 查看日志输出:寻找"esp_ota_write error"等错误信息
固件验证失败:
- 确认固件格式:必须使用.gbl后缀
- 检查分区偏移:确保ota_0和ota_1分区无重叠
- 验证固件完整性:重新编译并传输固件
生产环境部署注意事项
-
安全增强:
- 实现固件签名验证:在
esp_ota_end()前添加签名检查 - 加密传输:使用ESP32的BLE加密功能保护数据传输
- 实现固件签名验证:在
-
版本管理:
- 在固件中添加版本信息:
#define FIRMWARE_VERSION "1.0.0" - 实现版本检查机制:拒绝降级安装
- 在固件中添加版本信息:
-
稳定性保障:
- 实现断点续传:记录已传输数据偏移量
- 添加电源检测:低电量时禁止升级
关键点总结
- BLE OTA技术通过服务-特征值模型实现固件无线传输,核心是正确配置Silicon Labs OTA服务UUID
- 升级流程分为准备、传输和验证三个阶段,通过控制特征值0x00和0x03命令切换状态
- 双OTA分区设计确保升级失败时可回退到原版本,提高系统可靠性
- 实际部署中需根据应用场景调整广播参数、MTU大小和安全策略
- 完整的故障排查机制和日志记录是生产环境稳定运行的关键
通过本文介绍的技术方案,开发者可以为ESP32设备构建可靠的BLE OTA升级功能,显著降低设备维护成本,提升用户体验。该方案已在多种物联网设备中得到验证,适用于智能家居、工业监控和可穿戴设备等多种应用场景。
登录后查看全文
热门项目推荐
相关项目推荐
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0444
源启盛夏_AtomGit暑期开发者成长计划「源启盛夏」暑期校园开发者成长计划旨在激活校园开源力量,通过积分激励、认证扶持、资源倾斜等形式,引导高校组织和开发者完成「入驻 — 建项目 — 做贡献 — 获认证 — 得资源」的完整闭环。无论你是想带领社团入驻平台的组织者,还是希望用代码贡献证明自己的开发者,都能在这里找到属于你的成长路径。Markdown00
jiuwenswarmJiuwenSwarm 是一款基于openJiuwen开发的智能AI Agent,它能够将大语言模型的强大能力,通过你日常使用的各类通讯应用,直接延伸至你的指尖。Python0760
Hy3Hy3 是由腾讯混元团队研发的快慢思考融合的混合专家模型,总参数量 295B,激活参数 21B,MTP 层参数 3.8B。4 月底发布 Hy3 Preview 后,我们在 50 多个业务中获得了广泛的反馈,修复了各种体验问题,进一步提升了后训练的质量和规模。今天,我们发布 Hy3。它展现出显著强于同尺寸并比肩旗舰(参数规模往往是 Hy3 的 2~5 倍)开源模型的智能水平,显著提升了在各类产品和生产力任务中的实用价值。Python00
AscendNPU-IRAscendNPU-IR是基于MLIR(Multi-Level Intermediate Representation)构建的,面向昇腾亲和算子编译时使用的中间表示,提供昇腾完备表达能力,通过编译优化提升昇腾AI处理器计算效率,支持通过生态框架使能昇腾AI处理器与深度调优C++0310
DragonOSDragonOS is an operating system developed from scratch using Rust, with Linux compatibility. It is designed for **Serverless** scenarios. 使用Rust从0自研内核,具有Linux兼容性的操作系统,面向云计算Serverless场景而设计。Rust00
项目优选
收起
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
494
515
deepin linux kernel
C
32
16
Ascend Extension for PyTorch
Python
799
1.13 K
暂无描述
Markdown
825
5.48 K
本项目是CANN提供的神经网络类计算算子库,实现网络在NPU上加速计算。
C++
780
1.57 K
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。
C++
964
2.27 K
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
1.2 K
1.24 K
CANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。
Jupyter Notebook
640
272
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
C
830
6.13 K
昇腾LLM分布式训练框架
Python
193
272