BC5-MM、CSR867x的DFU更新流程之三：完整的DFU文件制作 ,到bin文件生成

以下内容是完整的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