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升级功能,显著降低设备维护成本,提升用户体验。该方案已在多种物联网设备中得到验证,适用于智能家居、工业监控和可穿戴设备等多种应用场景。
登录后查看全文
热门项目推荐
相关项目推荐
GLM-5智谱 AI 正式发布 GLM-5,旨在应对复杂系统工程和长时域智能体任务。Jinja00
GLM-5.1GLM-5.1是智谱迄今最智能的旗舰模型,也是目前全球最强的开源模型。GLM-5.1大大提高了代码能力,在完成长程任务方面提升尤为显著。和此前分钟级交互的模型不同,它能够在一次任务中独立、持续工作超过8小时,期间自主规划、执行、自我进化,最终交付完整的工程级成果。Jinja00
LongCat-AudioDiT-1BLongCat-AudioDiT 是一款基于扩散模型的文本转语音(TTS)模型,代表了当前该领域的最高水平(SOTA),它直接在波形潜空间中进行操作。00- QQwen3.5-397B-A17BQwen3.5 实现了重大飞跃,整合了多模态学习、架构效率、强化学习规模以及全球可访问性等方面的突破性进展,旨在为开发者和企业赋予前所未有的能力与效率。Jinja00
AtomGit城市坐标计划AtomGit 城市坐标计划开启!让开源有坐标,让城市有星火。致力于与城市合伙人共同构建并长期运营一个健康、活跃的本地开发者生态。01
FreeSql功能强大的对象关系映射(O/RM)组件,支持 .NET Core 2.1+、.NET Framework 4.0+、Xamarin 以及 AOT。C#00
项目优选
收起
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
654
4.23 K
deepin linux kernel
C
27
14
Ascend Extension for PyTorch
Python
489
600
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
390
280
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
937
854
Oohos_react_native
React Native鸿蒙化仓库
JavaScript
333
388
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.53 K
886
暂无简介
Dart
900
215
AscendNPU-IR是基于MLIR(Multi-Level Intermediate Representation)构建的,面向昇腾亲和算子编译时使用的中间表示,提供昇腾完备表达能力,通过编译优化提升昇腾AI处理器计算效率,支持通过生态框架使能昇腾AI处理器与深度调优
C++
123
194
昇腾LLM分布式训练框架
Python
142
167