CSR8670学习笔记:OTA升级固件

Posted NiceBT

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了CSR8670学习笔记:OTA升级固件相关的知识,希望对你有一定的参考价值。

为了方便大家学习,现与我爱蓝牙网联合推出【QCC300x/CSR867x/QCC30xx/QCC51xx开发板】

技术交流QQ群号:743434463
开发板会员QQ群号:725398389(凭订单号入群,赠独家学习资料)
——————————正文分割线———————————–

1. 引言

当我们将产品交付给客户后,有时需要修复软件问题,或是增加新的特性,此时用OTA (on-the-air) 升级产品固件是一种方便实用的方式。

2. OTA升级流程

CSR8670平台的OTA升级流程可以简化成如下示意:

准备出厂固件 制作OTA升级文件 下载OTA升级文件到外部Flash 更新到较新的固件

下面每个步骤单独讲解。

2.1. 准备出厂固件

2.1.1. 生成密钥

首选我们需要随机生成一对公钥和私钥,用于加密那些在升级过程中需要被替换的文件,使得出厂固件和OTA文件能够一一对应,避免设备被第三方通过OTA升级的方式恶意劫持。

执行下列命令后,会生成dfu.private.key和dfu.public.key。

echo.
echo. ******** generate keys ********
echo.

:: create key folder
rd /s /Q %keypath%
mkdir %keypath%

:: generate key
cd /D %keypath%
call %toolpath%\\dfukeygenerate -o dfu

2.1.2. 签名loader和stack

接着需要签名loader和stack,并烧录到芯片中:

: sign_loader_and_stack

echo.
echo. ******** sign loader and stack ********
echo.

:: create signed loader and stack
rd /s /Q %loaderpath%
mkdir %loaderpath%

:: copy loader and stack here
cd /D %loaderpath%
copy %firmwarepath%\\loader_unsigned.xdv loader_unsigned.xdv
copy %firmwarepath%\\loader_unsigned.xpv loader_unsigned.xpv
copy %firmwarepath%\\stack_unsigned.xdv stack_unsigned.xdv
copy %firmwarepath%\\stack_unsigned.xpv stack_unsigned.xpv

:: sign loader and stack
cd /D %upgradepath%
call %toolpath%\\dfukeyinsert -v -o %loaderpath%\\loader_signed -l %loaderpath%\\loader_unsigned.xdv -ks %keypath%\\dfu.public.key
call %toolpath%\\dfusign -v -o %loaderpath%\\stack_signed -s %loaderpath%\\stack_unsigned.xpv -ks %keypath%\\dfu.private.key


: burn signed loader and stack to board

echo.
echo. ******** burn signed loader and stack to board ********
echo.

call %bluesuitepath%\\blueflashcmd -usb 0 erase
call %bluesuitepath%\\blueflashcmd -usb 0 %loaderpath%\\loader_signed.xpv
call %bluesuitepath%\\blueflashcmd -usb 0 %loaderpath%\\stack_signed.xpv

2.1.3. 配置ADK工程属性

使能如下选项:

  • Device Upgrade
  • GAIA

如果需要支持BLE OTA,使能如下选项:

  • Enable BLE/GATT
  • Enable GATT GAIA Server
  • 开机后需要触发BLE start bonding事件,否则手机只能搜索到传统蓝牙设备

别忘了修改ADK工程的firmware image配置,否则xIDE工具会将默认路径的loader和stack烧录进芯片,使得更新固件时出现加密校验失败。

2.1.4. 编写外部Flash分区表文件

首先需要知道ADK工程编译后的VM占用的size,可在.map文件中查看:

然后看一下芯片内部Flash和外部Flash的size大小:

可以看到内部Flash size是不到1M word(15.6875/8/2),VM用了约187K word,考察官方示例给出的分区表文件:

# Sample partition file for ADK
# Allows testing of all ADK forms of OTAU
0, 1024K, RS, (erase) # Logical 0: Partition for DFU
1, 32K, RO, (erase)# Logical 1: Audio Prompt partition #1,1
2, 32K, RO, (erase) # Logical 1: Audio Prompt partition #1,2
3, 16K, RO, (erase) # Logical 2: Audio Prompt partition #2,1
4, 16K, RO, (erase) # Logical 2: Audio Prompt partition #2,2
5, 64K, RS, (erase) # Logical 3: Test partition #1
6, 64K, RS, (erase) # Logical 3: Test partition #2
7, 8K, RS, (erase) # Logical 4: Single-banked test partition

官方给出的ptn的0号分区的size是1M word,在这个工程里使用是没有问题的。

在sink例程代码中也给出了用代码表示的分区表,需要确保代码中的分区数量和类型与分区表文件中的一致。

2.1.5. 烧录分区表文件到外部Flash

将外部Flash的分区表烧录到外部Flash中:

echo.
echo. ******** partition external serial flash memory ********
echo.

call %toolpath%\\nvscmd -usb 0 burn %ptnpath%\\upgrade_partition_file.ptn all

2.2. 制作OTA升级文件

2.2.1. 生成DFU文件

我们可能需要将psr和VM的修改添加到OTA文件中。对于VM层的修改,我们需要在修改代码后运行run以更新image.fs;对于psr的修改,我们需要手动创建stack.psr,并将我们的修改添加到其中。以修改设备名称为例,需标明目标升级芯片的ID号和需要更新的PSKEY键值:

//chip ID
// 0000 0000 0000 0200 = BC5MM
// 0000 0000 0000 1000 = CSR8670
// 0000 0000 0000 2000 = CSR8675
&F002 = 0000 0000 0000 1000

// PSKEY_DEVICE_NAME
&0108 = 6c42 6575 6f4d 6f74 3272 6e20 326f

在我们准备好stack.psr和image.fs文件后,运行如下命令,生成DFU文件:

echo.
echo. ******** create application DFU file ********
echo.

:: sign stack psr
copy %psrpath%\\stack.psr %buildpath%\\stack.psr
call %toolpath%\\dfukeyinsert -v -o %buildpath%\\sps -ps %buildpath%\\stack.psr -ka %keypath%\\dfu.public.key
call %toolpath%\\dfusign -v -o %buildpath%\\sps -ps %buildpath%\\sps.psr -ks %keypath%\\dfu.private.key

:: sign image
copy %projectpath%\\image.fs %buildpath%\\image.fs
call %toolpath%\\dfusign -v -o %buildpath%\\image_signed -h %buildpath%\\image.fs -ka %keypath%\\dfu.private.key

:: create DFU file
call %toolpath%\\dfubuild -v -pedantic -t 2 -f %buildpath%\\upgrade_file.dfu -uv 0xffff -up 0xffff -ui "DFU OTA upgrade" -p3 . %buildpath%\\sps.stack.psr . -h %buildpath%\\image_signed.fs

2.2.2. 生成bin文件

我们有了DFU文件后,需要将版本控制信息(包括image和psr)和目标更新分区记录在upd格式的文件:

# ADK upgrade requires an empty signature appended to the end of the file.
add_empty_signature

# Set the upgrade version and previous version(s)
# that are compatible to upgrade from. The minor
# version can be '*' to act as a wildcard.
upgrade_version 1.0
compatible_upgrade 0.*

# Set the ps config version and previous version(s)
# that are compatible to upgrade from
ps_config_version 1
ps_prev_config_version 0

# list all partition starting from index 0 including partition type
# <partition number> <partition type> <full path filename>
# DFU file with file system
0 1 upgrade_partition_dfu.xuv

此处需要注意,upd文件可以阻止旧版本的bin文件更新设备,所以在制作新版本的bin文件时,需要升级upgrade_version和ps_config_version的版本号。

准备好upd文件后,执行指令生成bin文件:

: create upgrade file

echo.
echo. ******** create upgrade file ********
echo.

copy %updpath%\\upgrade_partition.upd  %buildpath%\\upgrade_partition.upd

cd %buildpath%

call %toolpath%\\XUV2BIN -e upgrade_file.dfu upgrade_partition_dfu.xuv
call %toolpath%\\UpgradeFileGen upgrade_partition.upd upgrade_file.xuv
call %toolpath%\\XUV2BIN -d upgrade_file.xuv upgrade_file.bin

2.3. 下载OTA文件到外部Flash

步骤简述如下:

CSR8670进入配对模式,同时触发ble start bonding事件 手机打开app和蓝牙功能 手机在app中搜索到CSR8670并与其建立传统蓝牙或BLE蓝牙连接 等待与手机完成交互,如出现配对或绑定弹窗,一定要点确认 进入upgrade界面并选择bin文件 点击upgrade图标并等待下载OTA文件完成 下载OTA文件完成后点确认,CSR8670重启进入dfu升级模式,完成后以新的固件重新运行 如果8670允许开机后自动回连到目标设备,app会显示升级完成

整个下载过程中有几个注意事项:

  • 一定要在app界面内完成配对,否则BLE连接是会被8670主动reject的,这是很多人发现BLE连接会自动断开的原因。可以通过改代码的方式取消这个机制。
  • 注意upd文件中的upgrade_version一定要大于代码中默认的version号,可以搜索init_version找到。否则会报0x0018错误,提示应用版本号不合适。
  • 注意外部Flash一定要在8670开机过程中已经上电,否则会在进入upgrade时提示0x0014错误——找不到分区。
  • 如果完成升级后,app提示有0x0018错误是正常现象,因为升级成功后,固件的应用版本号会和bin文件的一致,此时可以检查那些需要更新的PSKEY的值是否已改变,来确认OTA升级已生效。
  • 传统蓝牙升级完大约需要7分钟,BLE需要约4小时。ios平台不支持传统蓝牙升级,因为走的是spp通道,需要加MFi加密芯片并过苹果认证。

3. 总结

在ADK4.4版本中,得益于BT4.2对BLE的extend packet length的扩增,使得BLE连接的升级时间有显著缩短。

虽然BLE传输较慢,但其支持断电续传,对通话和音乐播放功能没有显著影响,可以在连接手机app后让8670在后台无感下载固件。

以上是关于CSR8670学习笔记:OTA升级固件的主要内容,如果未能解决你的问题,请参考以下文章

CSR8670学习笔记:自定义ADK configuration tool配置项

CSR8670学习笔记:自定义ADK configuration tool配置项

CSR8670学习笔记:自定义ADK configuration tool配置项

CSR8670的A2DP与AVRCP的应用笔记

CSR8670的TWS模式的应用笔记

乐鑫Esp32学习之旅30 对接华为IoT物联网平台适配踩坑,使用ESP-IDF 编程使用HTTPS请求固件跳过证书校验,实现OTA远程升级文件。(附带源码)