如何将原有的OAD示例代码所包含的BIM起始地址从0x1F000改到0x1000

通常在实现OAD（on-air-download）功能的过程中，TI会提供标准的示例BIM（Boot Image Manager）代码来进行镜像校验和下载。在TI所提供的示例代码中，BIM代码一般位于内部flash page31，和CCFG相邻。若用户根据自身功能定义不同，需要在BIM代码区域增加更多功能（例如自定义UART / SPI boot, 自定义安全校验功能等等）而导致自定义功能后的BIM代码超出4k byte，又由于BIM区域与CCFG及NV Storage Area相邻，在原有位置不能扩大，只能考虑重新为BIM划定地址空间来满足需求。

本文基于LAUNCHXL-CC2650评估板(http://www.ti.com.cn/tool/cn/launchxl-cc2650) 和BLE-STACK-2-2-1 SDK，详细描述如何将原有的OAD示例代码所包含的BIM起始地址从0x1F000改到0x1000，并且将BIM的地址区间从4k扩到8k。

注：所有不同版本的BLE SDK可以在以下网址找到：http://www.ti.com/tool/BLE-STACK-ARCHIVE

此外本文还会谈到在进行BIM重定位过程中会遇到的以下问题及其解决方案：

TI RTOS相关Flash区域冲突的规避

新的目标Image有效header的产生

如何修改python工具的脚本生成新的Image

*****************************************************************************************************************

首先关于BIM起始地址的修改，分以下几步：

Step1: 修改simple_peripheral project -> cc2650lp_app project的 flash起始地址

Step2: 重新给bim_extflash project 的BIM代码分配地址空间

Step3: 使用新的BIM分配方式来实现OAD功能

Step1：修改simple_peripheral project -> cc2650lp_app project的 flash起始地址

在IAR7.70/IAR7.8中导入C:\ti\simplelink\ble_sdk_2_02_01_18\examples\cc2650lp\simple_peripheral 文件夹下的项目如下

1) 修改APP_IMAGE_START

打开cc2650lp_app-FlashOnly_OAD_ExtFlash 工程的option--linker—config，将APP_IMAGE_START从0x1000修改成0x3000

2) 修改RTOS运行方式

从项目中打开打开CC2640.cfg，或者直接在以下地址内找到这个文件： ble_sdk_2_02_01_18\src\common\cc26xx\kernel\cc2640\config）

注释掉下图所示的代码：

原因：当选择“use BIOS in ROM”方式时，RTOS 的ROM指针会被固定的放在0x1500区域。这样就与我们所想要自定义的BIM代码空间冲突了。而选择“use BIOS in Flash”的方式可以让TI-RTOS从FLASH启动，以避免这个问题。当然”use BIOS in Flash”的方式会稍微多占用一些用户的flash区域。

3) 修改reset vector的地址

接上一步，在CC2640.cfg中，将m3Hwi.resetVectorAddress 从0x1010修改为0x3010。

原因：这是reset vector的地址，应该跟在header后面。

step2：重新给bim_extflash project的BIM代码分配地址空间

在IAR7.70/IAR7.8中导入C:\ti\simplelink\ble_sdk_2_02_01_18\examples\util\bim_extflash\cc2640文件夹下的项目如下

打开上图所示的cc26xx_bim_extflash.icf文件，重新定义一个FLASHPAGE1，定义其范围为8k，把region BIM定义为PAGE1的区域，并将BIM_START从0x1F000修改到0x1000.

      

编译通过后，检查生成的bim_extflash.map, 确认之前的改成是否有效。

Step3：使用新的BIM分配方式来实现OAD功能

基于step2中的操作，打开同一个项目中如下图所示的bim_main.c

做如下修改：

重新打开STEP1中修改过的C:\ti\simplelink\ble_sdk_2_02_01_18\examples\cc2650lp\simple_peripheral下的project, 找到

找到图中所示的oad_target_external_flash.c，做如下修改

以上三步完成后，各自重新编译成功，即完成了项目需要的所有改动。

*************************************************************************************

其次，为了配合新的地址分配来实现OAD，我们需要生成新的目标Hex待烧录文件。仍然采用相关的Python工具（这里使用了Python 2.7.10）来生成需要的新的hex文件（新的文件包含正确的metadata Header）。

注：这里重点说明BIM地址修改后，如何对python脚本进行修改。关于提到的Python工具的下载和使用说明可以参见BLE SDK中包含的CC2640 BLE OAD User’s Guide.pdf说明文档中的如下章节，这里不另加赘述。

10.1 Installing Python

10.2 TI OAD Image Tool (Python)

根据我们之前的修改，已经把simple_peripheral project -> cc2650lp_app project的代码起始地址改成了0x3000，而原来采用的python工具脚本所生成的hex文件，是配置成将header的imgAddr改成0x1000的，与我们需要把起始代码改成0x3000的需求不符。所以，我们需要对原有python 工具的脚本和相关操作进行修改，分成以下两步：

1)      修改oad image的脚本文件（ oad_image_tool.py）

该脚本文件位于：C:\ti\simplelink\ble_examples-ble_examples-2.2\tools\scripts\oad文件夹

用PythonGUI打开该文件，将startAddr赋值为0x3000，如下：

2)      修改python 工具的脚本的相关操作

这里我们会用到两个Python的argument: -m –r, 来完成修改目标Image的metadata header地址 的目的。

     

在命令行界面输入如下命令：

> set PATH=%PATH%;C:\python27\

> Python C:\ti\simplelink\ble_examples-ble_examples-2.2\tools\scripts\oad\oad_image_tool.py C:\Users\x0269290\Downloads\Desktop\ble_sdk_2_02_01_18\examples\cc2650lp\simple_peripheral\iar\app\FlashOnly_OAD_ExtFlash\Exe\simple_peripheral_cc2650lp_app.hex -o C:\Users\x0269290\Downloads\Desktop\ble_sdk_2_02_01_18\examples\cc2650lp\simple_peripheral\iar\app\FlashOnly_OAD_ExtFlash\Exe\Simple_peripheral_cc2650lp_app.hex -m 0x3000 -r :0xD000

(注：根据python脚本、目标hex、输出hex所在位置及名称的不同需要对命令做出对应的更改。)

如图所示：

得到结果如下：

注：以上例子中的“-m”是用命令给metaAddr赋值。但因为metaAddr（0x3000）大于imgStartAddr（0x1000）导致错误，所以在1)中修改python脚本中的对应代码。

审核编辑：何安