3.4.6. APP - Custom double Update
3.4.6.1. 概述
Note
自定义双备份升级(串口传输方式), 可用于第三方升级协议接入.
3.4.6.2. 工程配置
app配置,在工程代码中找到对应的文件(apps/demo/transfer/include/app_config.h)进行APP选择,本案例中选择多连,其结果如下所示:
#define CONFIG_APP_LE_TRANS 0 // LE's slave
#define CONFIG_APP_MULTI 0 //BLE多机应用,支持2.4g code,支持4主,3主1从,2主2从...
#define CONFIG_APP_NONCONN_24G 0 //2.4G 非连接收发
#define CONFIG_APP_DONGLE 0 //usb + 蓝牙(ble 主机),PC hid设备, 使用需要配置板级board_aw31n_demo_cfg.h
#define CONFIG_APP_AT_CHAR_COM 0 //AT com 字符串格式命令
#define CONFIG_APP_CUSTOM_DB_UPDATE 1 //自定义双备份升级(串口传输方式), 可用于第三方升级协议接入
#define CONFIG_APP_IDLE 0 // 空闲任务
板级选择,接着在文件(apps/demo/transfer/board/bd47/board config.h)下进行对应的板级选择如下:
#define CONFIG_BOARD_AW31N_DEMO
#include "board_aw31n_demo_cfg.h"
串口配置,接着在文件(apps/demo/transfer/board/bd47/board_aw31n_demo_cfg.h)下配置串口:
#define TCFG_COMMON_UART_ENABLE ENABLE_THIS_MOUDLE //通用数据转串口模块使能
#define COMMON_UART_TX_PIN IO_PORTA_06 //串口发送脚配置
#define COMMON_UART_RX_PIN IO_PORTA_07 //串口接收脚配置
#define COMMON_UART_INDEX UART_NUM_1
#define TCFG_COMMON_UART_BAUDRATE 115200
双备份升级配置,在文件(apps/demo/transfer/board/bd47/board_aw31n_demo_global_build_cfg.h)下配置串口:
#define CONFIG_DOUBLE_BANK_ENABLE 1 //单双备份选择(若打开了改宏,FLASH结构变为双备份结构,适用于接入第三方协议的OTA, PS: JL-OTA同样支持双备份升级, 需要根据实际FLASH大小同时配置CONFIG_FLASH_SIZE)
#define CONFIG_DB_UPDATE_DATA_GENERATE_EN 1 // generate db_update_data.bin
//flash size vaule definition
#define FLASH_SIZE_256K 0x40000
#define FLASH_SIZE_512K 0x80000
#define FLASH_SIZE_1M 0x100000
#define FLASH_SIZE_2M 0x200000
#define FLASH_SIZE_4M 0x400000
#define CONFIG_FLASH_SIZE FLASH_SIZE_512K //配置FLASH大小
Note
默认不开启蓝牙功能
3.4.6.3. 主要代码讲解(app_custom_db_update.c)
通用串口初始化
// 配置一个通用串口做数据传输
#if TCFG_COMMON_UART_ENABLE
common_uart_init(TCFG_COMMON_UART_BAUDRATE, COMMON_UART_TX_PIN, COMMON_UART_RX_PIN);
#endif
通用uart接收数据处理
/*************************************************************************************************/
/*!
* \brief uart操作回调函数
*
* \param [in] uart_num:串口号 uart_event:事件
*
* \return
*
* \note 内部调用
*/
/*************************************************************************************************/
static void common_uart_irq_func(int uart_num, enum uart_event event)
{
......
#if (CONFIG_DOUBLE_BANK_ENABLE && CONFIG_DB_UPDATE_DATA_GENERATE_EN && CONFIG_ONLY_GRENERATE_ALIGN_4K_CODE)
if (event & UART_EVENT_RX_TIMEOUT || event & UART_EVENT_RX_DATA) {
memset(db_update_packet, 0, sizeof(db_update_packet));
memcpy(db_update_packet, uart_rx_data, r_len);
if (r_len) {
app_db_updata_event_to_user(0, (u32)r_len);
}
}
#endif
......
}
调用第三方升级协议接口处理串口接收的bin数据
static int custom_update_event_handler(struct application *app, struct sys_event *event)
{
switch (event->type) {
case SYS_KEY_EVENT:
custom_update_key_event_handler(event);
return 0;
case SYS_BT_EVENT:
return 0;
case SYS_DEVICE_EVENT:
if ((u32)event->arg == DEVICE_EVENT_FROM_DUAL_UPDATE_UART) {
log_debug("dual_update revice data[%d]:", event->u.dev.value);
log_debug_hexdump(db_update_packet, event->u.dev.value);
dual_ota_app_data_deal(0, db_update_packet, event->u.dev.value);
}
return 0;
default:
return false;
}
}
3.4.6.4. 打印说明
下图为点击“开始升级”后的打印:芯片收到开始升级命令后调用 dual_ota_update_init,打印文件大小、CRC 与分包长度。
[00:00:35.037][Info]: [DUAL_OTA]dual_ota_app_data_deal[msg:0 len:10]
[00:00:35.038][Info]: [DUAL_OTA]dual_ota_update_deal[step:0]
[00:00:35.039][Info]: [DUAL_OTA]dual_ota_update_init[size:164054 crc:0x0 pkt_len:2048]
[00:00:35.043][Info]: [DUAL_OTA]dual_ota_notify_msg_to_app[msg:2]
[00:00:35.043][Info]: [UART_TR]uart_tr_send_data[10]
[00:00:35.044][Debug]: [DUAL_OTA]dual_ota_update_init[ret:0]

下图为点击“发送文件”后的打印:每收到一包数据打印 dual_ota_app_data_deal[msg:0 len:256],缓存满一包后写入 flash,写入成功打印 dual_ota_write_cb -> success,并向串口回复 continue。
[00:04:21.598][Info]: [DUAL_OTA]dual_ota_app_data_deal[msg:0 len:256]
...
[00:04:22.370][Info]: [DUAL_OTA]dual_ota_app_data_deal[msg:0 len:256]
[00:04:22.371][Info]: [DUAL_OTA]dual_ota_update_deal[step:1]
[00:04:22.399][Info]: [DUAL_OTA]dual_ota_write_cb -> success
[00:04:22.400][Info]: [DUAL_OTA]dual_ota_notify_msg_to_app[msg:2]
[00:04:22.434][Info]: [UART_TR]uart_tr_send_data[10]

下图为发送完毕并点击“升级结束”后的打印:进入校验步骤(step:2),校验通过后打印 dual_ota_verify_result[res:1 success],更新 boot info,最后复位(dual_ota_cpu_reset),芯片重新启动打印开机信息。
[00:05:31.636][Info]: [DUAL_OTA]dual_ota_update_deal[step:1]
[00:05:31.639][Info]: [DUAL_OTA]dual_ota_write_cb -> success
[00:05:45.851][Info]: [DUAL_OTA]dual_ota_app_data_deal[msg:0 len:2]
[00:05:45.852][Info]: [DUAL_OTA]dual_ota_update_deal[step:2]
[00:05:45.853][Info]: [DUAL_OTA]dual_ota_update_verify[file_crc:0]
[00:05:49.558][Info]: [DUAL_OTA]dual_ota_update_verify[verify_without_crc ret:0]
[00:05:49.559][Info]: [DUAL_OTA]dual_ota_verify_result[res:1 success]
[00:05:49.562][Info]: [DUAL_OTA]dual_ota_boot_info_cb[err:0]
[00:05:49.563][Info]: [DUAL_OTA]dual_ota_success_reset
...
[00:05:51.564][Info]: [DUAL_OTA]dual_ota_cpu_reset

3.4.6.5. 串口工具操作说明
3.4.6.5.1. 基本配置
通过“打开文件”选择升级文件
db_update_data.bin;串口工具会显示文件大小,例如164054字节。在“扩展 → 发送文件延时设置”中选择每次发送256字节延时100ms(选最大延时),保证芯片每包数据都处理完成。按该设置发送 164054 字节约需 85 秒。
在“多字符串发送 / 字符串双击注释”页配置升级命令:
序号 |
命令(HEX) |
含义 |
延时 |
|---|---|---|---|
1 |
|
开始升级(含文件大小与 CRC) |
1000 ms |
2 |
|
升级结束 |
3000 ms |
升级命令帧格式如下:
字段 |
长度(字节) |
说明 |
|---|---|---|
帧头 |
2 |
固定 |
文件大小 |
4 |
|
文件 CRC |
4 |
CRC16 校验值,低 16 位有效;不使用 CRC 时填 |
结束帧 |
2 |
单独发送 |
以上表为例:文件大小 164054 = 0x000280D6,按小端填入即为 D6 80 02 00;不带 CRC 校验时 CRC 字段填 00 00 00 00。

3.4.6.5.2. 操作步骤
选择升级文件(“打开文件”)。
查看文件大小,例如
164054字节。把文件大小换算成 16 进制,填入开始升级命令的第 3~6 字节,小端格式。如
164054=0x280D6→D6 80 02 00。CRC 字段先填
0(本 demo 不使用 CRC 校验)。点击“开始升级”,发送第一条开始升级命令。
点击“发送文件”,开始发送
db_update_data.bin。芯片每接收完一组数据会回复
continue,串口工具界面会持续打印continue,直到文件发送完成。等待直到发送完毕,界面打印“发送完毕!”及
continue,最终打印success。点击“升级结束”,发送
AA 55,等待芯片校验并复位。


3.4.6.6. case默认应用资源(默认使用AW31N DEMO开发板)
Note
demo默认占用外设资源如下,具体可以查看board_aw31n_demo_cfg.h
I/O口占用情况
PA口 I/O |
默认占用情况 |
|---|---|
PA3 |
默认打印UART0引脚 |
PA8 |
adkey检测引脚 |
硬件定时器占用情况
定时器 |
默认占用情况 |
|---|---|
TIMER0 |
暂无使用 |
TIMER1 |
暂无使用 |
TIMER2 |
暂无使用 |
TIMER3 |
暂无使用 |
串口占用情况
串口 |
默认占用情况 |
|---|---|
UART0 |
SDK打印 |
UART1 |
通用串口 |
UART2 |
暂无使用 |