Migrating from version 1 to version 3 for OTA PAL port

The OTA PAL port directory name has been updated from ota to ota_pal_for_aws. This folder must contain 2 files: ota_pal.c and ota_pal.h. The PAL header file libraries/freertos_plus/aws/ota/src/aws_iot_ota_pal.h has been deleted from the OTA library and must be defined inside the port.

The return codes (OTA_Err_t) are translated into an enum OTAMainStatus_t. Refer to ota_platform_interface.h for translated return codes. Helper macros are also provided to combine OtaPalMainStatus and OtaPalSubStatus codes and extract OtaMainStatus from OtaPalStatus and similar.

Logging in the PAL

Variable cOTA_JSON_FileSignatureKey changed to OTA_JsonFileSignatureKey.

Version 1: OTA_Err_t prvPAL_CreateFileForRx( OTA_FileContext_t * const *C* );

Version 3: OtaPalStatus_t otaPal_CreateFileForRx( OtaFileContext_t * const *pFileContext* );

Notes: Create a new receive file for the data chunks as they come in.

Version 1: int16_t prvPAL_WriteBlock( OTA_FileContext_t * const C, uint32_t ulOffset, uint8_t * const pcData, uint32_t ulBlockSize );

Version 3: int16_t otaPal_WriteBlock( OtaFileContext_t * const pFileContext, uint32_t ulOffset, uint8_t * const pData, uint32_t ulBlockSize );

Notes: Write a block of data to the specified file at the given offset.

Version 1: OTA_Err_t prvPAL_ActivateNewImage( void );

Version 3: OtaPalStatus_t otaPal_ActivateNewImage( OtaFileContext_t * const *pFileContext* );

Notes: Activate the newest MCU image received via OTA.

Version 1: OTA_Err_t prvPAL_ResetDevice( void );

Version 3: OtaPalStatus_t otaPal_ResetDevice( OtaFileContext_t * const *pFileContext* );

Notes: Reset the device.

Version 1: OTA_Err_t prvPAL_CloseFile( OTA_FileContext_t * const *C* );

Version 3: OtaPalStatus_t otaPal_CloseFile( OtaFileContext_t * const *pFileContext* );

Notes: Authenticate and close the underlying receive file in the specified OTA context.

Version 1: OTA_Err_t prvPAL_Abort( OTA_FileContext_t * const *C* );

Version 3: OtaPalStatus_t otaPal_Abort( OtaFileContext_t * const *pFileContext* );

Notes: Stop an OTA transfer.

Version 1: OTA_Err_t prvPAL_SetPlatformImageState( OTA_ImageState_t *eState* );

Version 3: OtaPalStatus_t otaPal_SetPlatformImageState( OtaFileContext_t * const pFileContext, OtaImageState_t eState );

Notes: Attempt to set the state of the OTA update image.

Version 1: OTA_PAL_ImageState_t prvPAL_GetPlatformImageState( void );

Version 3: OtaPalImageState_t otaPal_GetPlatformImageState( OtaFileContext_t * const *pFileContext* );

Notes: Get the state of the OTA update image.

Version 1: OTA_PAL_ImageState_t

File: aws_iot_ota_agent.h

Version 3: OtaPalImageState_t

File: ota_private.h

Notes: The image state set by platform implementation.

Version 1: OTA_Err_t

File: aws_iot_ota_agent.h

Version 3: OtaErr_t OtaPalStatus_t (combination of OtaPalMainStatus_t and OtaPalSubStatus_t)

File: ota.h, ota_platform_interface.h

Notes: v1: These were macros defining a 32 unsigned integer. v3: Specialized enum representing the type of error and associated with an error code.

Version 1: OTA_FileContext_t

File: aws_iot_ota_agent.h

Version 3: OtaFileContext_t

File: ota_private.h

Notes: v1: Contains an enum and buffers for the data. v3: Contains additional data-length variables.

Version 1: OTA_ImageState_t

File: aws_iot_ota_agent.h

Version 3: OtaImageState_t

File: ota_private.h

Notes: OTA Image states

The file aws_ota_codesigner_certificate.h has been deleted.

Included the new logging stack to print debug messages:

/**************************************************/
/******* 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 ****************/ 

Added the constant config:

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

signingcredentialSIGNING_CERTIFICATE_PEM which was defined in demos/include/aws_ota_codesigner_certificate.h has been moved to ota_demo_config.h as otapalconfigCODE_SIGNING_CERTIFICATE and can can be accessed from the PAL files as:

static const char codeSigningCertificatePEM[] = otapalconfigCODE_SIGNING_CERTIFICATE;

The file aws_ota_codesigner_certificate.h has been deleted.

The macros APP_VERSION_BUILD, APP_VERSION_MINOR, APP_VERSION_MAJOR have been added to ota_demo_config.h. The old files containing the version information have been removed, for example tests/include/aws_application_version.h, libraries/c_sdk/standard/common/include/iot_appversion32.h, demos/demo_runner/aws_demo_version.c.

Removed the "Full_OTA_AGENT" test group along with all related files. This test group was previously required for qualification. These tests were for the OTA library and not specific to the OTA PAL port. The OTA library now has full test coverage that is hosted in the OTA repository so this test group is no longer required.

Removed the "Full_OTA_CBOR" and "Quarantine_OTA_CBOR" test groups as well as all related files. These tests were not part of the qualification tests. The functionalities these tests covered are now being tested in the OTA repository.

Moved the testing files from the library directory to the tests/integration_tests/ota_pal directory.

Updated the OTA PAL qualification tests to use v3.0.0 of the OTA library API.

Updated how the OTA PAL tests access the code signing certificate for tests. Previously there was a dedicated header file for the code signing credential. This is no longer the case for the new version of the library. The test code expects this variable to be defined in ota_pal.c. The value is assigned to a macro that is defined in the platform specific OTA config file.

Update the name of the ota pal port folder from ota to ota_pal_for_aws.

Add the file ota_pal.h with the functions mentioned above. For an example ota_pal.h file, see GitHub.

Add the configuration files:

Make the following changes to ota_pal.c:

Update the CMakeLists.txt file.

Update the IDE projects.