IAP在线升级模块详细设计说明
目 录
1 编写目的5
2 术语、定义和缩略语5
2.1 术语、定义 5
2.2 缩略语 5
3 模块描述5
3.1 Flash的特性 5
3.2 Flash的资源划分 5
3.3 MCU 中断的使用方式 5
3.3.1 Cortex-M3内核系列MCU中断向量表重定位6
3.4 MCU复位后的硬件外设初始化 6
4 标准模块6
5 模块设计6
5.1 Flash空间划分 6
5.2 异步事件处理机制 7
5.3 命令处理 7
5.3.1 BL和APP对命令的支持7
6 数据描述7
6.1 数据结构说明 7
6.1.1.1 宏定义 7
6.1.1.1.1 Flash资源 7
6.1.1.1.2 链路层协议 9
6.1.1.2 结构体/联合/枚举 定义 9
6.1.1.2.1 Flash资源 9
6.1.1.2.2 异步事件 10
6.1.1.2.3 链路层协议 10
6.1.1.2.4 命令实现 11
6.2 全局变量说明 12
6.3 数据库说明 12
7 函数定义12
7.1 引用函数定义 12
7.2 内部函数定义 13
7.2.1 链路层协议13
7.2.1.1 Mid_Tul_CheckCrc16 13
7.2.1.2 Mid_Tul_CheckTulLengthField 13
7.2.1.3 Mid_Tul_GetCmdFunc 13
7.2.1.4 Mid_Tul_GetCmdFuncTableAddr 13
8 接口设计13
8.1 用户接口 13
8.1.1 Flash资源13
8.1.1.1 Drv_Flash_AppChecksum_GetChecksumInfo 13
8.1.1.2 Drv_Flash_AppChecksum_UpdataChecksumInfo 14
8.1.1.3 Drv_Flash_FlagOpt_GetFlagInfo 14
8.1.1.4 Drv_Flash_FlagOpt_SetFlagInfo 14
8.1.2 异步事件14
8.1.2.1 App_SysEvt_SetEventFlag 14
8.1.2.2 App_SysEvt_GetEventFlag 14
8.1.3 链路层协议15
8.1.3.1 Mdi_Tul_UpperLayerCmdAnalysis 15
8.1.4 命令实现15
8.1.4.1 App_TulIap_CheckRunSpace 15
8.1.4.2 App_TulIap_ModifyRunSpace 15
8.1.4.3 App_TulIap_CheckObligateVersionFileSize 15
8.1.4.4 App_TulIap_TransmitVersionFile 16
8.1.4.5 App_TulIap_TransmitVersionFilePara 16
8.2 硬件接口 16
8.2.1 Flash资源16
8.2.1.1 Drv_Flash_InitialPara 16
8.2.1.2 Drv_Flash_ErasePagesWrite 16
8.2.1.3 Drv_Flash_Read 16
8.2.1.4 Drv_Flash_EraseVersionFileSpace 17
8.2.1.5 Drv_Flash_UpdataVersionFileSpace 17
8.2.1.6 Drv_Flash_Test_ReadWrite（Test Condition） 17
8.3 软件接口 17
8.3.1 规范接口17
8.3.2 非规范接口17
9 其它说明17
10 参考资料17
1
编写目的
本文档的编写目的在于详细的说明IAP在线升级模块中的设计思路以及实现细节，以利于后续程序员参考实现。
2 术语、定义和缩略语
2.1 术语、定义
无
2.2 缩略语
|
IAP |
In Application Program |
|
MCU |
Microprogrammed Control Unit |
|
BL |
Bootloader |
|
APP |
Application |
|
IVT |
Interrupt Vector Table |
|
TUL |
To Upper Layer |
3 模块描述
实现IAP主要有以下几个要点：
1) Flash的特性，以及资源划分
2) MCU中断的使用方式
3) MCU复位后的硬件外设初始化
3.1 Flash的特性
IAP的全称是In Application Program，即在应用编程。在MCU的应用程序中，通过在线擦除指定Flash区域，编程Flash区域来实现待升级版本文件（通常是.bin文件）的保存，因此要求Flash必须是可持续擦除和编程的。
3.2 Flash的资源划分
在一般的IAP应用中，分为BL程序和APP程序，即在MCU的存储空间内，BL程序和APP程序是共存的，因此需要对Flash地址做合理的规划，方便对Flash地址空间做有效的管理。一般的IAP应用将Flash划分为以下几个区间：
- BL程序区间（必须位于MCU的启动地址处）
- APP程序区间
- BL程序的全局参数存储区间
- APP程序的全局参数存储区间
- APP程序的检验区间
- BL程序的备份区间（也叫2级BL，用于对1级BL程序做IAP升级）
3.3 MCU 中断的使用方式
在MCU应用中，通常会使用中断Interrupt和外设进行数据交换。如果不能使用中断的交互方式，需要在程序结构和数据处理过程上计算处理周期，以保证数据的完整性。MCU中存放中断的地方叫做IVT，当程序发生中断时，首先是在IVT里查找对应的中断源地址，从而执行中断程序的。
在IAP应用中，MCU的Flash中需要同时存储BL程序和APP程序，也就意味着这两块程序会共用IVT，不论BL还是APP如果不能使用中断处理链路通讯，对数据完完整性会产生影响。
因此，这里会涉及到IVT的重定位问题。
3.3.1 Cortex-M3内核系列MCU中断向量表重定位
在Cortex-M3内核MCU中，IVT可以支持重定位此操作：
#define NVIC_VectTab_FLASH ((uint32_t)0x08000000)
#define mFlashAddr_Application_Start 0x0800C000
NVIC_SetVectorTable(NVIC_VectTab_FLASH, mFlashAddr_Application_Start);
3.4 MCU复位后的硬件外设初始化
当MCU的当前逻辑运行区间发生转换时，MCU都会复位，因此在BL和APP程序里需要对响应的硬件外设资源做正确的初始化配置。
4 标准模块
无
5 模块设计
5.1 Flash空间划分
/************************************************************************
STM32F103ZE flash total size is 256K
Single page size is 2K
Total pager number is 256
|-----------------------| 0x08000000
| Boot |
| 48K Bytes |
|-----------------------| 0x0800C000
| App |
| 202K Bytes |
|-----------------------| 0x0803E800
| Boot Para |
| 2K Bytes |
|-----------------------| 0x0803F000
| App Para |
| 2K Bytes |
|-----------------------| 0x0803F800 -> |------------|-----------|---------------|
| Apps CheckSum | | App Size | App CRC | KeepBytes |
| 2K Bytes | | 4 Bytes | 4 Bytes | 2K-8 Bytes |
|-----------------------| 0x0803FFFF
************************************************************************/
如上所示：
1) MCU的起始地址是0x08000000
2) BL程序分配20Kbytes
3) APP程序分配102KBytes
4) BL Para区间分配2Kbytes
5) APP Para区间分配2KBytes
6) Apps CheckSum区间分配2KBytes
5.2 异步事件处理机制
本系统采用异步事件处理机制，即中断源处理作为前台事件，Main函数作为后台处理，在前台事件中标识事件源，在后台处理事件源。
5.3 命令处理
根据《绘画板系列接口协议_Ver X.xx》文档，整个IAP流程需要用到以下命令：
- 命令3001，获取下位机运行区间
- 命令3002，设置下位机运行区间
- 命令3003，获取下位机预留的Flash空间大小
- 命令3004，向下位机传输待升级版本文件
- 命令3005，向下位机传输版本文件参数信息
5.3.1 BL和APP对命令的支持
|
|
命令3001 |
命令3002 |
命令3003 |
命令3004 |
命令3005 |
|
BL程序 |
√ |
|
√ |
√ |
√ |
|
APP程序 |
√ |
√ |
|
|
|
6 数据描述
6.1 数据结构说明
6.1.0.1 宏定义
6.1.0.1.1 Flash资源
#if CVIEW("公用资源")
/* 定义Flash一页数据大小 */
#define mFlashPageSize 2048
/* 获取所在页面地址 */
#define mFunc_Drv_FlashGetPageAddr(addr) (addr&0xFFFFF800)
/* 获取所在页面偏移地址 */
#define mFunc_Drv_FlashGetPageOffset(addr) (addr&0x000007ff)
/* 获取指定范围Flash的页面数量 */
#define mFunc_Drv_FlashSpecialRangePageNum(startAddr, endAddr) ((endAddr-startAddr)/mFlashPageSize)
#endif // #if CVIEW("公用资源")
#if CVIEW("地址规划")
#if CVIEW("Boot")
/* Boot区 */
#define mFlashAddr_Bootloader_Start 0x08000000
#define mFlashSize_Bootloader (10*mFlashPageSize)
#define mFlashAddr_Bootloader_End (mFlashAddr_Bootloader_Start + mFlashSize_Bootloader - 1)
#endif // #if CVIEW("Boot")
#if CVIEW("App")
/* App区 */
#define mAppliacationAddress (uint32_t)0x08005000
#define mFlashAddr_Application_Start 0x08005000
#define mFlashSize_Application (51*mFlashPageSize)
#define mFlashAddr_Application_End (mFlashAddr_Application_Start + mFlashSize_Application - 1)
#endif // #if CVIEW("App")
#if CVIEW("Boot Para")
/* Boot参数区 */
#define mFlashAddr_BootPara_Start 0x0801E800
#define mFlashSize_BootPara (1*mFlashPageSize)
#define mFlashAddr_BootPara_End (mFlashAddr_BootPara_Start + mFlashSize_BootPara - 1)
#endif // #if CVIEW("App Para")
#if CVIEW("App Para")
/* App参数区 */
#define mFlashAddr_AppPara_Start 0x0801F000
#define mFlashSize_AppPara (1*mFlashPageSize)
#define mFlashAddr_AppPara_End (mFlashAddr_AppPara_Start + mFlashSize_AppPara - 1)
#endif // #if CVIEW("App Para")
#if CVIEW("App Checksum")
/* Apps校验区 */
#define mFlashAddr_AppChecksum_Start 0x0801F800
#define mFlashSize_AppChecksum (1*mFlashPageSize)
#define mFlashAddr_AppChecksum_End (mFlashAddr_AppChecksum_Start + mFlashSize_AppChecksum - 1)
#endif // #if CVIEW("Apps Checksum")
#endif // #if CVIEW("地址规划")
6.1.0.1.2 链路层协议
#define mTul_FrameBootCode_Dn 0xCD
#define mTul_FrameBootCode_Up 0xAC
#define mTul_CmdFrameStruct_BootCode_Size (1)
#define mTul_CmdFrameStruct_SubsequentLength_Size (2)
#define mTul_CmdFrameStruct_CmdCode_Size (2)
#define mTul_CmdFrameStruct_CrcBytes_Size (2)
#define mTul_CmdFrameStruct_CmdPara_Size \
(mTul_Cmd_Array_Size - mTul_CmdFrameStruct_BootCode_Size \
- mTul_CmdFrameStruct_SubsequentLength_Size \
- mTul_CmdFrameStruct_CmdCode_Size \
- mTul_CmdFrameStruct_CrcBytes_Size)
#define mTul_RspFrameStruct_BootCode_Size (1)
#define mTul_RspFrameStruct_SubsequentLength_Size (2)
#define mTul_RspFrameStruct_CmdCode_Size (2)
#define mTul_RspFrameStruct_StatusCode_Size (1)
#define mTul_RspFrameStruct_CrcBytes_Size (2)
#define mTul_RspFrameStruct_CmdPara_Size \
(mTul_Rsp_Array_Size - mTul_RspFrameStruct_BootCode_Size \
- mTul_RspFrameStruct_SubsequentLength_Size \
- mTul_RspFrameStruct_CmdCode_Size \
- mTul_RspFrameStruct_StatusCode_Size \
- mTul_RspFrameStruct_CrcBytes_Size)
6.1.0.2 结构体/联合/枚举 定义
6.1.0.2.1 Flash资源
typedef enum enumFlash_AppChecksum_Kind{ // App校验区枚举类型
eFlash_AppChecksum_Kind_Size,
eFlash_AppChecksum_Kind_Crc,
}E_Flash_AppChecksum_Kind;
typedef enum enumFlash_FlagKind{ // Flash操作相关枚举
eFlash_FlagKind_VersionFileTrans,
eFlash_FlagKind_VersionFileChecksumTrans,
}E_Flash_FlagKind;
typedef struct structFlash_AppChecksum{ // App校验区数据结构
UINT32 ulAppSize;
UINT32 ulAppCrc;
}T_Flash_AppChecksum;
typedef struct structFlashOptFlag{ // Flash操作相关数据结构
UINT8 bVersionFileTransDoneFlag : 1;
UINT8 bVersionFileChecksumTransDoneFlag : 1;
UINT8 bKeepBits : 6;
}T_Flash_OptFlag;
6.1.0.2.2 异步事件
// 定义系统标志位结构体
typedef struct struct_SystemEventFlag{
UINT32 ulSysEventFlag_RevUsbFrame : 1; // 系统事件枚举，接收到UsbFrame
UINT32 ulSysEventFlag_KeyPressed : 1; // 系统事件枚举，按键
UINT32 ulSysEventFlag_SysReset : 1; // 系统事件枚举，系统复位
UINT32 ulSysEventFlag_KeepBits : 29; // 系统时间标志位，保留位
}T_SystemEventFlag;
// 定义系统标志位枚举
typedef enum enum_SystemEventFlag{
E_SystemEventFlag_SystemReset, // 系统事件枚举，复位系统
E_SystemEventFlag_KeyPressed, // 系统事件枚举，按键
E_SystemEventFlag_RevUsbFrame, // 系统事件枚举，接收到UsbFrame
}E_SystemEventFlag;
6.1.0.2.3 链路层协议
// 定义TUL层命令应答结构体
typedef struct struct_SystemResourceTul{
UINT8 aucTulCmdFrame[TUL_CMD_ARRAY_SIZE]; // 定义Tul层命令缓存
UINT16 usCmdFrameCnt; // 定义Tul层命令缓存指针计数器
UINT16 usCmdSubsequentLength; // 定义Tul层命令帧中长度字段后续数据长度
UINT16 usCmdTotalLen; // 定义Tul层命令帧全长缓存
UINT8 aucTulRspFrame[TUL_RSP_ARRAY_SIZE]; // 定义Tul层应答缓存
UINT16 usRspTotalLen; // 定义Tul层应答帧全长缓存
BOOL bReiceveCmdFrameStartFlag; // 定义命令接收标志位
BOOL bReiceveCmdFrameEndFlag; // 定义命令接收标志位
}T_SystemResource_Tul;
// 出错类别表
typedef enum {
E_TulErrorCode_Success = 0x00, // 正确
E_TulErrorCode_BootCodeError = 0x01, // 引导码错误
E_TulErrorCode_CmdFrameParaLengthError = 0x02, // 命令参数长度错误
E_TulErrorCode_CmdCodeError = 0x03, // 命令码错误
E_TulErrorCode_CrcCodeError = 0x04, // CRC错误
E_TulErrorCode_CmdParaError = 0x10, // 命令参数错误
}T_TulErr;
// 命令类型
typedef enum enum_TulCmdKind{
Tul_Cmd_Kind_Check = 0x10, // 查询类命令
Tul_Cmd_Kind_IapProtocol = 0x30, // IAP在线升级类命令
}T_TulCmdKind;
// 适用于链路层协议解析的通用函数指针
typedef T_TulErr (*PT_CmdFunc)(const UINT8 *paucUpperLayerCmdPara, UINT8 *paucRspPara, UINT16 *pusRetParaLen);
// 命令函数入口表数据结构
typedef struct tagTulCmdFuncTable{
UINT8 ucCmdSn; // 命令流水号
PT_CmdFunc ptCmdFunc; // 命令函数指针
}T_TulCmdFuncTable;
// 命令类型索引表结构体
typedef struct tagTulCmdKindIndex{
T_TulCmdKind tCmdKind; // 命令类型
const T_TulCmdFuncTable *ptCmdFuncTable; // 命令类型对应的命令入口函数码表
}T_TulCmdKindIndex;
// 解析帧所用参数结构体
typedef struct tagTulAnalysisPara{
T_TulErr tCmdFrameAnalysisRst; // 命令帧解析结果
UINT8 ucCmdKind; // 上位机命令类型
UINT8 ucCmdSn; // 上位机命令在对应命令码表中的流水号
UINT8 *pucRspParaAddr; // 应答参数的缓存地址
UINT8 *pucUpperLayerCmdParaAddr; // 上位机命令参数的缓存地址
}T_TulAnalysisPara;
6.1.0.2.4 命令实现
// 定义“查询下位机运行区间”命令
typedef struct struct_TulRspPara_Iap_CheckReaderRunSapce{
UINT8 ucRunSpace; // 运行区间
}T_TulRspPara_Iap_CheckReaderRunSpace;
// 定义“设置下位机运行区间”命令
typedef struct struct_TulCmdPara_Iap_SetReaderRunSapce{
UINT8 ucRunSpace; // 运行区间
}T_TulCmdPara_Iap_SetReaderRunSpace;
// 定义“查询下位机预留Flash空间大小”命令
typedef struct struct_TulRspPara_Iap_CheckObligateVersionFileSize{
UINT32 ulVersionFileSize; // 升级文件大小
}T_TulRspPara_Iap_CheckObligateVersionFileSize;
// 定义“向下位机传输版本文件”命令
typedef struct struct_TulCmdPara_Iap_TransmitVersionFile{
UINT8 bPackageEndFlag; // 包结束标识符
UINT16 usPackageSn; // 包序号
UINT16 usPackageLength; // 包长度
UINT8 aucPackageMessage[1]; // 包信息
}T_TulCmdPara_Iap_TransmitVersionFile;
// 定义“向下位机传输版本文件参数信息”命令
typedef struct struct_TulCmdPara_Iap_TransmitVersionFilePara{
UINT32 ulVersionFileLength; // 升级文件长度
UINT32 ulVersionFileCrc; // 升级文件Crc
}T_TulCmdPara_Iap_TransimitVersionFilePara;
6.2 全局变量说明
static T_TulAnalysisPara tTulAnalysisPara; // 解析用参数定义
static T_SystemEventFlag tSysEventFlag; // 定义系统事件标志位
const T_TulCmdFuncTable atCmdFuncTable_IapProtocol[]; // IAP命令码表
static T_Flash_AppChecksum tFlash_AppChecksum; // AppsChecksum校验数据缓存
static T_Flash_OptFlag tFlash_OptFlag; // Flash操作标志位缓存
6.3 数据库说明
无
7 函数定义
7.1 引用函数定义
无
7.2 内部函数定义
7.2.1 链路层协议
7.2.1.1 Mid_Tul_CheckCrc16
// 函数名称：Mid_Tul_CheckCrc16
// 函数功能：检查CRC16
// 函数输入：UINT8* paucUpperLayerCmdMsg，接收到的上层命令数据
// UINT16 usReceiveUpperLayerTotalLen，接收到上层数据的总长度
// 函数输出：无
// 函数返回：0表示CRC不一致，1表示CRC一致
7.2.1.2 Mid_Tul_CheckTulLengthField
// 函数名称：Mid_Tul_CheckTulLengthField
// 函数功能：检查长度字段
// 函数输入：UINT8* paucUpperLayerCmdMsg，接收到的上层命令数据
// UINT16 usReceiveUpperLayerTotalLen，接收到上层数据的总长度
// 函数输出：无
// 函数返回：0表示不一致，1表示一致
7.2.1.3 Mid_Tul_GetCmdFunc
// 函数名称：GetCmdFuncWithCmdSn
// 函数功能：获取命令执行函数地址
// 函数输入：UINT8 ucCmdKind，命令类型
// UINT8 ucCmdSn，命令序列号
// 函数输出：无
// 函数返回：PT_CmdFunc ptCmdFunc，命令执行函数
7.2.1.4 Mid_Tul_GetCmdFuncTableAddr
// 函数名称：Mid_Tul_GetCmdFuncTableAddr
// 函数功能：获取命令码类型对应的码表地址
// 函数输入：UINT8 ucCmdKind，命令类型
// 函数输出：无
// 函数返回：T_TulCmdFuncTable *ptCmdFuncTable，命令类型对应的码表
8 接口设计
8.1 用户接口
8.1.1 Flash资源
8.1.1.1 Drv_Flash_AppChecksum_GetChecksumInfo
// 函数名称：Drv_Flash_AppChecksum_GetChecksumInfo
// 函数功能：获取AppsChecksum校验区的校验信息，在正确读取后不需要对Size和Crc做大小端转换，这里由Updata操作确保写入时是小端写入
// 函数输入：E_Flash_AppChecksum_Kind eAppChecksumKind
// 函数输出：tFlash_AppsChecksum
// 函数返回：UINT32
8.1.1.2 Drv_Flash_AppChecksum_UpdataChecksumInfo
// 函数名称：Drv_Flash_AppChecksum_UpdataChecksumInfo
// 函数功能：更新AppsChecksum校验区的校验信息，确保函数输入数据为小端数据
// 函数输入：E_Flash_AppsChecksum_Kind eAppChecksumKind, UINT32 ulSizeOrCrcData
// 函数输出：tFlash_AppsChecksum
// 函数返回：无
8.1.1.3 Drv_Flash_FlagOpt_GetFlagInfo
// 函数名称：Drv_Flash_FlagOpt_GetFlagInfo
// 函数功能：查询Flash操作相关标志位
// 函数输入：E_Flash_FlagKind eFlashFlagKind
// 函数输出：tFlash_OptFlag
// 函数返回：BOOL
8.1.1.4 Drv_Flash_FlagOpt_SetFlagInfo
// 函数名称：Drv_Flash_FlagOpt_SetFlagInfo
// 函数功能：查询Flash操作相关标志位
// 函数输入：E_Flash_FlagKind eFlashFlagKind, BOOL bStatus
// 函数输出：tFlash_OptFlag
// 函数返回：无
8.1.2 异步事件
8.1.2.1 App_SysEvt_SetEventFlag
// 函数名称：App_SysEvt_SetEventFlag
// 函数功能：设置系统事件标志位
// 函数输入：E_SystemEventFlag eEventFlag，系统事件标志位
// BOOL bStatus，待设置内容
// 函数输出：tSystemEventFlag
// 函数返回：无
8.1.2.2 App_SysEvt_GetEventFlag
// 函数名称：App_SysEvt_GetEventFlag
// 函数功能：获取系统事件标志位
// 函数输入：E_SystemEventFlag eEventFlag，系统事件标志位
// 函数输出：tSystemEventFlag
// 函数返回：BOOL
8.1.3 链路层协议
8.1.3.1 Mdi_Tul_UpperLayerCmdAnalysis
// 函数名称：Mid_Tul_UpperLayerCmdAnalysis
// 函数功能：上层命令解析
// 函数输入：UINT8* paucUpperLayerCmdMsg，接收到的上层命令数据
// UINT8* paucReaderRspMsg，向上层返回的响应数据
// UINT16 usReceiveUpperLayerTotalLen，接收到上层数据的总长度
// 函数输出：无
// 函数返回：UINT6 usRetLength，返回的数据长度
8.1.4 命令实现
8.1.4.1 App_TulIap_CheckRunSpace
// 函数名称：App_TulIap_CheckRunSpace
// 函数功能：IAP，查询读写器运行区间
// 函数输入：const UINT8* pucCmdParaMsg，接收到的上层命令参数数据
// UINT8* pucRspRapaMsg，向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数输出：UINT8* pucRspRapaMsg，向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数返回：T_TulErr，函数执行状态
8.1.4.2 App_TulIap_ModifyRunSpace
// 函数名称：App_TulIap_ModifyRunSpace
// 函数功能：IAP，发送版本参数信息
// 函数输入：const UINT8* pucCmdParaMsg，接收到的上层命令参数数据
// UINT8* pucRspRapaMsg，向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数输出：UINT8* pucRspRapaMsg，向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数返回：T_TulErr，函数执行状态
8.1.4.3 App_TulIap_CheckObligateVersionFileSize
// 函数名称：App_TulIap_CheckObligateVersionFileSize
// 函数功能：IAP，查询预留Flash大小
// 函数输入：const UINT8* pucCmdParaMsg，读写器接收到的上层命令参数数据
// UINT8* pucRspRapaMsg，读写器向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数输出：UINT8* pucRspRapaMsg，读写器向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数返回：T_TulErr，函数执行状态
8.1.4.4 App_TulIap_TransmitVersionFile
// 函数名称：App_TulIap_TransmitVersionFile
// 函数功能：IAP，发送版本文件
// 函数输入：const UINT8* pucCmdParaMsg，读写器接收到的上层命令参数数据
// UINT8* pucRspRapaMsg，读写器向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数输出：UINT8* pucRspRapaMsg，读写器向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数返回：T_TulErr，函数执行状态
8.1.4.5 App_TulIap_TransmitVersionFilePara
// 函数名称：App_TulIap_TransmitVersionFilePara
// 函数功能：IAP，发送版本参数信息
// 函数输入：const UINT8* pucCmdParaMsg，读写器接收到的上层命令参数数据
// UINT8* pucRspRapaMsg，读写器向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数输出：UINT8* pucRspRapaMsg，读写器向上层返回的响应参数数据
// UINT16 *pusRetParaLen，需要返回的参数长度
// 函数返回：T_TulErr，函数执行状态
8.2 硬件接口
8.2.1 Flash资源
8.2.1.1 Drv_Flash_InitialPara
// 函数名称：Drv_Flash_InitialPara
// 函数功能：查询Flash操作相关标志位
// 函数输入：E_Flash_FlagKind eFlashFlagKind, BOOL bStatus
// 函数输出：tFlash_OptFlag
// 函数返回：无
8.2.1.2 Drv_Flash_ErasePagesWrite
// 函数名称：Drv_Flash_ErasePagesWrite
// 函数功能：Flash模块，擦除页信息并更新
// 函数输入：ULONG ulFlashAddr, UCHAR *pucSavebuf, ULONG ulLen
// 函数输出：无
// 函数返回：BOOL bStatus
8.2.1.3 Drv_Flash_Read
// 函数名称：Drv_Flash_Read
// 函数功能：Flash模块，读取数据信息
// 函数输入：ULONG ulFlashAddr, UCHAR *pucReadbuf, ULONG ulLen)
// 函数输出：无
// 函数返回：BOOL bStatus
8.2.1.4 Drv_Flash_EraseVersionFileSpace
// 函数名称：Drv_Flash_EraseVersionFileSpace
// 函数功能：IAP升级应用，擦除升级文件Flash空间
// 函数输入：无
// 函数输出：无
// 函数返回：无
8.2.1.5 Drv_Flash_UpdataVersionFileSpace
// 函数名称：Drv_Flash_UpdataVersionFileSpace
// 函数功能：IAP升级应用，更新升级文件预留Flash空间
// 函数输入：const UINT8 *pucPackageMessage, UINT16 usPackageLength, UINT16 usPackageSn
// 函数输出：无
// 函数返回：无
8.2.1.6 Drv_Flash_Test_ReadWrite（Test Condition）
// 函数名称：Drv_Flash_Test_ReadWrite
// 函数功能：Flash模块，测试读写
// 函数输入：无
// 函数输出：无
// 函数返回：无
