为 OTA PAL 移植从版本 1 迁移到版本 3

OTA PAL 移植目录名称已从 ota 更新为 ota_pal_for_aws。此文件夹必须包含 2 个文件：ota_pal.c 和 ota_pal.h。已从 OTA 库中删除 PAL 头文件 libraries/freertos_plus/aws/ota/src/aws_iot_ota_pal.h，并且必须在移植内定义。

将返回代码 (OTA_Err_t) 转换成了枚举 OTAMainStatus_t。有关转换后的返回代码，请参阅 ota_platform_interface.h。还提供了辅助标记宏，用于组合 OtaPalMainStatus 和 OtaPalSubStatus 代码，并从 OtaPalStatus 中提取 OtaMainStatus 以及类似的宏。

登录 PAL

变量 cOTA_JSON_FileSignatureKey 已更改为 OTA_JsonFileSignatureKey。

版本 1：OTA_Err_t prvPAL_CreateFileForRx( OTA_FileContext_t * const *C* );

版本 3：OtaPalStatus_t otaPal_CreateFileForRx( OtaFileContext_t * const *pFileContext* );

备注：当数据块进入时，为其创建一个新的接收文件。

版本 1：int16_t prvPAL_WriteBlock( OTA_FileContext_t * const C, uint32_t ulOffset, uint8_t * const pcData, uint32_t ulBlockSize );

版本 3：int16_t otaPal_WriteBlock( OtaFileContext_t * const pFileContext, uint32_t ulOffset, uint8_t * const pData, uint32_t ulBlockSize );

备注：按照指定偏移量将数据块写入指定文件。

版本 1：OTA_Err_t prvPAL_ActivateNewImage( void );

版本 3：OtaPalStatus_t otaPal_ActivateNewImage( OtaFileContext_t * const *pFileContext* );

备注：激活通过 OTA 接收的最新 MCU 映像。

版本 1：OTA_Err_t prvPAL_ResetDevice( void );

版本 3：OtaPalStatus_t otaPal_ResetDevice( OtaFileContext_t * const *pFileContext* );

备注：重置设备。

版本 1：OTA_Err_t prvPAL_CloseFile( OTA_FileContext_t * const *C* );

版本 3：OtaPalStatus_t otaPal_CloseFile( OtaFileContext_t * const *pFileContext* );

备注：在指定 OTA 环境中验证并关闭底层接收文件。

版本 1：OTA_Err_t prvPAL_Abort( OTA_FileContext_t * const *C* );

版本 3：OtaPalStatus_t otaPal_Abort( OtaFileContext_t * const *pFileContext* );

备注：停止 OTA 传输。

版本 1：OTA_Err_t prvPAL_SetPlatformImageState( OTA_ImageState_t *eState* );

版本 3：OtaPalStatus_t otaPal_SetPlatformImageState( OtaFileContext_t * const pFileContext, OtaImageState_t eState );

备注：尝试设置 OTA 更新映像的状态。

版本 1：OTA_PAL_ImageState_t prvPAL_GetPlatformImageState( void );

版本 3：OtaPalImageState_t otaPal_GetPlatformImageState( OtaFileContext_t * const *pFileContext* );

备注：获取 OTA 更新映像的状态。

版本 1：OTA_PAL_ImageState_t

aws_iot_ota_agent.h 文件：

版本 3：OtaPalImageState_t

ota_private.h 文件：

备注：平台实现设置的映像状态。

版本 1：OTA_Err_t

aws_iot_ota_agent.h 文件：

版本 3：OtaErr_t OtaPalStatus_t (combination of OtaPalMainStatus_t and OtaPalSubStatus_t)

文件：ota.h、ota_platform_interface.h

备注：v1：这些是定义 32 无符号整数的宏。v3：代表错误类型且与错误代码关联的专用枚举。

版本 1：OTA_FileContext_t

aws_iot_ota_agent.h 文件：

版本 3：OtaFileContext_t

ota_private.h 文件：

备注：v1：包含枚举和数据缓冲区。v3：包含其他数据长度变量。

版本 1：OTA_ImageState_t

aws_iot_ota_agent.h 文件：

版本 3：OtaImageState_t

ota_private.h 文件：

备注：OTA 映像状态

文件 aws_ota_codesigner_certificate.h 已删除。

包括用于输出调试消息的新日志记录堆栈：

/**************************************************/
/******* DO NOT CHANGE the following order ********/
/**************************************************/

/* Logging related header files are required to be included in the following order:
 * 1. Include the header file "logging_levels.h".
 * 2. Define LIBRARY_LOG_NAME and  LIBRARY_LOG_LEVEL.
 * 3. Include the header file "logging_stack.h".
 */

/* Include header that defines log levels. */
#include "logging_levels.h"

/* Configure name and log level for the OTA library. */
#ifndef LIBRARY_LOG_NAME
    #define LIBRARY_LOG_NAME     "OTA"
#endif
#ifndef LIBRARY_LOG_LEVEL
    #define LIBRARY_LOG_LEVEL    LOG_INFO
#endif

#include "logging_stack.h"

/************ End of logging configuration ****************/ 

添加了常量配置：

/** * @brief Size of the file data block message (excluding the header). */   
#define otaconfigFILE_BLOCK_SIZE ( 1UL << otaconfigLOG2_FILE_BLOCK_SIZE )

在 demos/include/aws_ota_codesigner_certificate.h 中定义的 signingcredentialSIGNING_CERTIFICATE_PEM 已作为 otapalconfigCODE_SIGNING_CERTIFICATE 移至 ota_demo_config.h 中，并且可通过以下方式从 PAL 文件进行访问：

static const char codeSigningCertificatePEM[] = otapalconfigCODE_SIGNING_CERTIFICATE;

文件 aws_ota_codesigner_certificate.h 已删除。

宏 APP_VERSION_BUILD、APP_VERSION_MINOR、APP_VERSION_MAJOR 已添加到 ota_demo_config.h 中。已删除包含版本信息的旧文件，例如 tests/include/aws_application_version.h、libraries/c_sdk/standard/common/include/iot_appversion32.h、demos/demo_runner/aws_demo_version.c。

移除了“Full_OTA_AGENT”测试组以及所有相关文件。该测试组以前是资格认证所必需的。这些测试适用于 OTA 库，而不是特定于 OTA PAL 移植。现在，OTA 库具有托管在 OTA 存储库中的完整测试覆盖范围，因此不再需要此测试组。

删除了“Full_OTA_CBOR”和“Quarantine_OTA_CBOR”测试组以及所有相关文件。这些测试不是资格认证测试的一部分。这些测试所涵盖的功能现在正在 OTA 存储库中进行测试。

将测试文件从库目录移到了 tests/integration_tests/ota_pal 目录中。

更新了 OTA PAL 资格认证测试以使用 OTA 库 API 的 v3.0.0。

更新了 OTA PAL 测试访问测试代码签名证书的方式。以前，代码签名凭证有一个专用的头文件。对于新版本的库来说，情况不再是这样。测试代码预期在 ota_pal.c 中定义此变量。将该值分配给在平台特定的 OTA 配置文件中定义的宏。

将 ota pal 移植文件夹的名称从 ota 更新为 ota_pal_for_aws。

添加包含上述函数的文件 ota_pal.h。有关 ota_pal.h 示例文件，请参阅 GitHub。

添加配置文件：

对 ota_pal.c 进行以下更改：

更新 CMakeLists.txt 文件。

更新 IDE 项目。