以下内容是完整的DFU文件制作过程,涉及.dfu文件制作、.udp文件创建、.bin文件生成;
当前流程适用于:ADK3.5之前的DFU文件升级、也适用于ADK4.0开始的bin文件升级方式;
1、先安装相关ADK
当前笔者例子使用的是ADK4.2,这里会涉及无签名fw文件的拷贝、dfu常用指令的指向等;
Note:ADK 的安装路径不能有中文,也不要有空格;
2、文件制作开始
建议创建一个专用文件夹,用于放置制作相关文件,统一管理;如笔者自行创建了 名为“DFU_Upgrade”的文件夹:
1) 把当前Project 使用的ADK对应fw 文件夹整体copy到当前的“DFU_Upgrade”中;
如当前的ADK4.2,我们需要将“ADK_CSR867x.WIN4.2\firmware\assisted\unified”下的“gordon”文件夹整理copy 到“DFU_Upgrade”中;
gordon文件夹中为原始的无签名fw, 稍后我们将对其签名并产生对应的签名fw;
2 )制作生成公私密钥的bat档;
Note:一般情况下我们建议把制作步骤拆成各部分(多个bat 档),防止误操作带来不必要麻烦;
如当前生成公私密钥的.bat档,命名为《01_GenerateKey.bat》
具体内容实现是:
echo off
set dfu_tools_path="D:\SDK\ADK_CSR867x.WIN4.2\tools\bin"
set adk_path="D:\SDK\ADK_CSR867x.WIN4.2"
set debug_transport=SPITRANS=USB SPIPORT=0
echo --------- dfukeygenerate ---------
%dfu_tools_path%\dfukeygenerate -o dfu
%dfu_tools_path%\dfukeygenerate -o app
pause
当前bat 档双击执行后,将生成两个分别名为dfu和app的公私秘钥对,具体如下:
Note:实际上同一个DFU文件使用一对公私密钥也可,这个并没有强行规定;
Attention:在实际Project中,绝对不要重复创建新的秘钥对,在正式Project整合后的密钥,一定要使用至项目结束,否则将很悲催;(这也是为何要拆开DFU 生成流程的其中一个重要原因);
3)对“gordon”文件夹的fw进行签名
bat 档命名为:02_CreateSignedFiles.bat
具体实现如下:
echo off
set dfu_tools_path="D:\SDK\ADK_CSR867x.WIN4.2\tools\bin"
set adk_path="D:\SDK\ADK_CSR867x.WIN4.2"
set debug_transport=SPITRANS=USB SPIPORT=0
echo;
echo --------- dfukeyinsert to loader ---------
%dfu_tools_path%\dfukeyinsert -v -o loader_signed -l gordon\loader_unsigned.xdv -ks dfu.public.key
pause
echo;
echo --------- dfusign to stack ---------
%dfu_tools_path%\dfusign -v -o stack_signed -s gordon\stack_unsigned.xpv -ks dfu.private.key
pause
Note :这里使用的是名为dfu的密钥对,注意区别;
双击执行后,将在当前的“DFU_Upgrade”根目录下生成签名的fw;
4)对外部flash 进行刷除(当前步骤针对的是OTA形式升级;而串口和USB等有线升级,此步骤省省略。当前步骤要求PC与板子通过SPI flash连接,且板子带外部flash
Attention:外部flash一定要实际刷除过,不能只通过指令访问大小,笔者遇到过某些flash能通过指令访问大小,但却不能刷除);
bat档命名为:03_BurnPtnFile.bat
具体实现是:
echo off
set dfu_tools_path="D:\SDK\ADK_CSR867x.WIN4.2\tools\bin"
set adk_path="D:\SDK\ADK_CSR867x.WIN4.2"
set debug_transport=SPITRANS=USB SPIPORT=0
echo;
echo --------- Burn ptn file ---------
%dfu_tools_path%\nvscmd -usb 0 erase -nvstype SPIF
%dfu_tools_path%\nvscmd -usb 0 burn sqif.ptn all -nvstype SPIF
pause
Note:这里涉及到.ptn文件(后续文章将详细讲解ptn的size计算等相关);
当前我们命名了一个“spif.ptn”的文件,其内部实现是:
# Partition Table
0, 1024K, RS, (erase) # DFU
1, 64K, RS, (erase) # Test partition #1
2, 64K, RS, (erase) # Test partition #2
3, *, RS, (erase) # Free Area
以上实现中,笔者使用partition 0作为DFU 文件的保存位置(这里指的是外部flash),这里会关联到后续的.udp文件中的设置;
5)psr文件签名、DFU文件制作以及bin文件生成
这是最后一个bat档,所以内容较多,但没有拆开的必要了
当前bat档命名为:04_CreateUpgradeFiles.bat
具体实现是:
echo off
set dfu_tools_path="D:\SDK\ADK_CSR867x.WIN4.2\tools\bin"
set adk_path="D:\SDK\ADK_CSR867x.WIN4.2"
set debug_transport=SPITRANS=USB SPIPORT=0
echo;
echo --------- dfukeyinsert to stack.psr ---------
%dfu_tools_path%\dfukeyinsert -v -o sps -ps stack.psr -ka app.public.key
pause
echo;
echo --------- dfusign to sps.psr ---------
%dfu_tools_path%\dfusign -v -o sps -ps sps.psr -ks dfu.private.key
pause
::sign PSKEYs to be included in the DFU image
%dfu_tools_path%\dfusign -v -o dfu_vm_signed_image -pa example_DFU_vm.psr -ka app.private.key
::%dfu_tools_path%\dfusign -v -o dfu_fw_signed_image -ps example_DFU_fw.psr -ks app.private.key
pause
echo;
echo --------- dfusign to image.fs ---------
%dfu_tools_path%\dfusign -v -o image_signed -h image.fs -ka app.private.key
pause
echo;
echo --------- dfubuild ---------
%dfu_tools_path%\dfubuild -v -pedantic -t 2 -f upgrade_file.dfu -uv 0xffff -up 0xffff -ui "DFU OTA upgrade" -p3 . sps.stack.psr dfu_vm_signed_image.app.psr -h image_signed.fs
pause
echo;
echo --------- XUV2BIN ---------
%dfu_tools_path%\XUV2BIN -e upgrade_file.dfu upgrade_partition_dfu.xuv
pause
echo;
echo --------- UpgradeFileGen ---------
%dfu_tools_path%\UpgradeFileGen upgrade_partition.upd upgrade_file.xuv
pause
echo;
echo --------- XUV2BIN ---------
%dfu_tools_path%\XUV2BIN -d upgrade_file.xuv upgrade_file.bin
pause
里面涉及了 stack 和app psr的设置等(stack 和app psr的区别、作用范围等,将在后续文章中详细讲解);而当前涉及的sps.psr 和stack.psr可自行定义,也可移除,但需修改dfubuild指令中 -p3参数,如改为使用‘.’替代,不能为空;
当前bat还涉及到名为“image.fs”,这是ADK Project 在 "RUNNING"下生成的系统文件;如果当前DFU只涉及psr更新,可不用关注“image.fs”,通过dfubuild中的参数可自行删减。
如笔者为了验证整个DFU或OAT流程,经常砍掉“image.fs”,此时升级过程秒刷;
砍掉“image.fs”的dfubuild实现如下,即移除“ -h image_signed.fs”部分设置,此时得到的升级文件只有几KB 大小,非常适合用于快速验证;
%dfu_tools_path%\dfubuild -v -pedantic -t 2 -f upgrade_file.dfu -uv 0xffff -up 0xffff -ui "DFU OTA upgrade" -p3 . sps.stack.psr dfu_vm_signed_image.app.psr
这里还涉及名为“upgrade_partition.upd”的udp文件,其最后的“0 1 upgrade_partition_dfu.xuv”,这里的“0”表示DFU文件保存在partition 0,和“spif.ptn”表述一致。
其具体实现是:
# 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 2.1
compatible_upgrade 0.*
compatible_upgrade 1.*
compatible_upgrade 2.*
# Set the ps config version and previous version(s)
# that are compatible to upgrade from
ps_config_version 2
ps_prev_config_version 0
ps_prev_config_version 1
# 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