從版本 1 遷移至版本 3 以進行 OTA PAL 連接埠

OTA PAL 連接埠目錄名稱已從 更新ota為 ota_pal_for_aws。此資料夾必須包含 2 個檔案： ota_pal.c和 ota_pal.h。PAL 標頭檔案libraries/freertos_plus/aws/ota/src/aws_iot_ota_pal.h已從 OTA 程式庫中刪除，且必須在連接埠內定義。

傳回碼 (OTA_Err_t) 會轉譯為列舉 OTAMainStatus_t。請參閱 ota_platform_interface.h 以取得翻譯的傳回碼。 也提供協助程式巨集來結合 OtaPalMainStatus 和 OtaPalSubStatus程式碼，以及OtaMainStatus從 OtaPalStatus 和類似 擷取。

登入 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 )

signingcredentialSIGNING_CERTIFICATE_PEM 在 中定義的 demos/include/aws_ota_codesigner_certificate.h 已移至 ota_demo_config.h ，otapalconfigCODE_SIGNING_CERTIFICATE並且可以從 PAL 檔案存取為：

static const char codeSigningCertificatePEM[] = otapalconfigCODE_SIGNING_CERTIFICATE;

檔案aws_ota_codesigner_certificate.h已刪除。

巨集 APP_VERSION_BUILD、 APP_VERSION_MINORAPP_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 專案。