OTA开启教程

1.Boot loader文件位置C:\Texas Instruments\ZStack-CC2530-2.5.0\Projects\zstack\OTA\Boot\CC2530DB 如果需开启OTA功能，首先节点需要烧写OTA启动代码，方便重新引导新下载的镜像。

与OAD相比，OTA的启动代码修改起来方便多了。

（OAD的方法我不多说，需要手动修改2进制文件，有兴趣的朋友可以去查看OAD的文档）。

1.核对Linker中output标签项下的配置信息（下图所示）2.Debugger记得选你所使用的驱动公司，一般都是TI的。

3.选择Texas Instruments的目录，核对Erase Flash与Verify download必须是勾选，这一步非常重要，因为烧写启动代码之前，需要把所有flash清空一遍。

4.设置完成后，编译一下，然后下载到节点中。

2.移植信息配置根据TI的OTA文档，按照它的移植方法，其实最后还是漏了几点步骤没有说明，导致我移植过程中，摸索和很久才有发现问题，起初到TI的e2e论坛发帖求助也得不到太大帮助，后来对比了HA的那个OTA例子，不停地尝试，终于找到了解决方法。

下面我简单说一说主要步骤。

以sensordemo为例子，移植其他例子也行。

1.核对并修改各种配置信息（千万要认真核对）打开工程后，到workspace选择你需要开启OTA的逻辑设备（协调器，路由器或者节点），一般是节点，所以我这里选SensorEB。

下图所示，在C/C++compiler中的预编译标签，添加OTA_CLIENT=TRUE，如果是HA的例子，还需要添加OTA_HA（一般工程不需要）。

在Linker中的Output标签，核对下图的配置，一定要勾选Allow C-SPY…..那个地方。

这个跟你编译后的输出文件有关，具体是什么我忘记了。

在Debugger目录下，如果是CC2530DB平台，选择TI的驱动，如果下面的Device description file是空白，自行添加，路径按照下面就行。

选择Texas Instruments的目录，核对Retain unchanged pages和CRC16的勾选，勾选前者的原因是前面已经下载的OTA boot loader 需要在flash page0中保留，不能够擦除。

2.设置完毕后，编译一下，如果没有出错，进入下一步。

3.生成二进制文件，按照下图配置，Output format必须为simple code。

完成后编译一下，在工程目录会发现出现.sim的文件，如果没有，再检测配置过程。

ZStack-CC2530-2.5.0\Projects\zstack\Samples\SensorDemo\CC2530DB\SensorEB\Exe3.添加代码与C文件ZigBee的OTA规范是基于ZigBee_Cluster_Library，所以首先需要在工程中添加zcl_Init( taskID++ )ZCL任务初始化函数和zcl_event_loop事件处理函数。

其后需要添加zclOTA_Init( taskID )OTA任务初始化函数和zclOTA_event_loop事件处理函数，后者正是执行OTA代码分发协议的核心所在。

找到osalInitTasks( void )这个函数，添加下面的红色的初始化函数，顺序不能搞错，一定需要反正在应用层上下两侧。

void osalInitTasks( void ){uint8 taskID = 0;tasksEvents = (uint16 *)osal_mem_alloc( sizeof( uint16 ) * tasksCnt);osal_memset( tasksEvents, 0, (sizeof( uint16 ) * tasksCnt));macTaskInit( taskID++ );nwk_init( taskID++ );Hal_Init( taskID++ );#if defined( MT_TASK )MT_TaskInit( taskID++ );#endifAPS_Init( taskID++ );ZDApp_Init( taskID++ );zcl_Init( taskID++ );//cyjaddSAPI_Init( taskID++ );zclOTA_Init ( taskID );//cyjadd}找到tasksArr[]，添加下面红色的函数指针。

const pTaskEventHandlerFn tasksArr[] = {macEventLoop,nwk_event_loop,Hal_ProcessEvent,#if defined( MT_TASK )MT_ProcessEvent,#endifAPS_event_loop,ZDApp_event_loop,zcl_event_loop,//cyjaddSAPI_ProcessEvent,zclOTA_event_loop//cyjadd找到工程的应用层.c文件中，（我这里是sapi.c，其他工程类似）添加下面部分代码，其实就是镜像大小，制造商ID，镜像类型与镜像版本号信息，当然还有CRC信息。

添加的时候，最好放在GLOBAL VARIABLES声明的部分，放的地方不对，貌似会报错。

#pragma location="PREAMBLE"const CODE preamble_t OTA_Preamble ={0xFFFFFFFF, // Program LengthOTA_MANUFACTURER_ID, // Manufacturer IDOTA_TYPE_ID, // Image Type0x00000001, // Image Version};#pragma required=OTA_Preamble//cyjadd#pragma location="CRC"const CODE otaCrc_t OTA_CRC ={0xFFFF, // CRC0xFFFF, // CRC Shadow};#pragma required=OTA_CRC//cyjadd接着需要修改链接器信息。

下图所示，把原来的xcl文件修改成ota.xcl，复制下面就行。

$PROJ_DIR$\..\..\..\Tools\CC2530DB\ota.xcl修改后在Tools目录下添加ota.xcl文件，路径在C:\Texas Instruments\ZStack-CC2530-2.5.0\Projects\zstack\Tools\CC2530DB，并把原来的f8w2530.xcl去掉。

注意，去掉的方法是对文件点击右键option,然后勾选exclude from build就行。

然后添加下图选中的四个文件，路径如下，如果不添加这个4个文件，编译一定会报错的。

C:\Texas Instruments\ZStack-CC2530-2.5.0\Components\stack\zcl接着把OTA与ZCL源码文件路径添加到工程目录中，添加的所在地方如下图所示。

如果不添加，编译会提示文件路径不存在。

直接复制下面进去就可以。

$PROJ_DIR$\..\..\Source$PROJ_DIR$\..\..\..\OTA\Source$PROJ_DIR$\..\..\..\..\..\Components\stack\zcl4.完成上述设置后，编译一下，正常是不会再有出错。

进入下一步。

5.在应用层初始化函数中，需要读取协议栈版本信息，新镜像版本号信息，当前运行镜像的制造商ID，镜像类型和镜像版本号等信息。

最后，需要在应用层注册OTA回调事件ZCL_OTA_START_CALLBACK与ZCL_OTA_DL_COMPLETE_CALLBACK，前者指示节点更新开始，后者指示节点下载完成。

添加下列代码到应用层初始化函数中，例如SAPI_Init( byte task_id )注释部分是为了方便理解自己添加的，不喜欢可以去掉。

OTA_ImageHeader_t header;//声明preamble_t preamble;//声明#if HAL_OTA_XNV_IS_SPIXNV_SPI_INIT(); //初始化片外flash的SPI总线#endif//cyjadd//读取OTA文件头信息HalOTARead(0, (uint8 *)&header, sizeof(OTA_ImageHeader_t), HAL_OTA_DL);if (header.magicNumber == OTA_HDR_MAGIC_NUMBER){zclOTA_DownloadedFileVersion = header.fileId.version; //保存下载镜像版本号zclOTA_DownloadedZigBeeStackVersion = header.stackVersion; //保存下载镜像协议栈版本}//从非易失性变量区读取OTA属性变量HalOTARead(PREAMBLE_OFFSET, (uint8 *)&preamble, sizeof(preamble_t), HAL_OTA_RC);zclOTA_ManufacturerId = preamble.manufacturerId; //保存当前镜像制造商IDzclOTA_ImageType = preamble.imageType;//保存当前镜像类型zclOTA_CurrentFileVersion = preamble.imageVersion; //保存当前镜像版本号//在应用层注册ZCL OTA回调事件zclOTA_Register(sapi_TaskID);值得注意，如果不添加上述的代码，会影响到OTA应用控制台无法读取属性值，不添加回调事件，会影响到OTA升级无法开始和传输后无法更新的错误。

接着添加回调事件的处理函数，这里函数名可以自己取，记得在前面需要声明static void SensorDemoOta_ProcessOTAMsgs( zclOTA_CallbackMsg_t* pMsg );/********************************************************************** @fn SensorDemoOta_ProcessOTAMsgs** @brief Called to process callbacks from the ZCL OTA.** @param none** @return none*/static void SensorDemoOta_ProcessOTAMsgs( zclOTA_CallbackMsg_t* pMsg ){uint8 RxOnIdle;switch(pMsg->ota_event){case ZCL_OTA_START_CALLBACK:if (pMsg->hdr.status == ZSuccess){// Speed up the poll rateRxOnIdle = TRUE;ZMacSetReq( ZMacRxOnIdle, &RxOnIdle );NLME_SetPollRate( 1000 );}break;case ZCL_OTA_DL_COMPLETE_CALLBACK:if (pMsg->hdr.status == ZSuccess){// Reset the CRC Shadow and reboot. The bootloader will see the// CRC shadow has been cleared and switch to the new imageHalOTAInvRC();SystemReset();}else{// slow the poll rate back down.RxOnIdle = FALSE;ZMacSetReq( ZMacRxOnIdle, &RxOnIdle );NLME_SetPollRate(DEVICE_POLL_RATE);}break;default:break;}}/******************************************************************************************************************************************/添加完处理函数后，需要在应用层事件处理函数（如SAPI_ProcessEvent）的SYS_EVENT_MSG 处理部分添加下面代码，注意pMSGpkt类型必须先转化为afIncomingMSGPacket_t *类型，不然会造成下面的zclOTA_CallbackMsg_t*类型数据丢失。