OTA_Init

OtaErr_t OTA_Init( const OtaAppBuffer_t * pOtaBuffer,
                   const OtaInterfaces_t * pOtaInterfaces,
                   const uint8_t * pThingName,
                   OtaAppCallback_t OtaAppCallback );

OTA Agent initialization function.

Initialize the OTA engine by starting the OTA Agent ("OTA Task") in the system. This function must be called with the connection client context before calling OTA_CheckForUpdate. Only one OTA Agent may exist.

Parameters

[in]	pOtaBuffer	Buffers used by the agent to store different params.
[in]	pOtaInterfaces	A pointer to the OS context.
[in]	pThingName	A pointer to a C string holding the Thing name.
[in]	OtaAppCallback	Static callback function for when an OTA job is complete. This function will have input of the state of the OTA image after download and during self-test.

Returns

OtaErr_t The state of the OTA Agent upon return from the OtaState_t enum. If the agent was successfully initialized and ready to operate, the state will be OtaAgentStateReady. Otherwise, it will be one of the other OtaState_t enum values.

Example

// Application callback when the OTA agent has completed the job
// or is in self test mode. For example see [demos](https://github.com/aws/aws-iot-device-sdk-embedded-C/tree/main/demos/ota)
void otaAppCallback( OtaJobEvent_t event,
                     const void * pData );
 
// Optional: User buffer to pass down to the OTA Agent. These
// buffers are assumed to be initialized previously, example:
// uint8_t updateFilePath[ OTA_MAX_FILE_PATH_SIZE ];
OtaAppBuffer_t otaBuffer =
{
    .pUpdateFilePath    = updateFilePath,
    .updateFilePathsize = OTA_MAX_FILE_PATH_SIZE,
    .pCertFilePath      = certFilePath,
    .certFilePathSize   = OTA_MAX_FILE_PATH_SIZE,
    .pDecodeMemory      = decodeMem,
    .decodeMemorySize   = otaconfigFILE_BLOCK_SIZE,
    .pFileBitmap        = bitmap,
    .fileBitmapSize     = OTA_MAX_BLOCK_BITMAP_SIZE,
    .pUrl               = updateUrl,
    .urlSize            = OTA_MAX_URL_SIZE,
    .pAuthScheme        = authScheme,
    .authSchemeSize     = OTA_MAX_AUTH_SCHEME_SIZE
};
 
// OTA interface context required for library interface functions
// The functions set by these interfaces are assumed to be defined
// For more information see [demos](https://github.com/aws/aws-iot-device-sdk-embedded-C/tree/main/demos/ota)
OtaInterfaces_t pOtaInterfaces =
{
    // Initialize OTA library OS Interface.
    .os.event.init = Posix_OtaInitEvent;
    .os.event.send = Posix_OtaSendEvent;
    ...
    // Initialize the OTA library MQTT Interface.
    .mqtt.subscribe = mqttSubscribe;
    .mqtt.publish = mqttPublish;
    .mqtt.unsubscribe = mqttUnsubscribe;
    // Initialize the OTA library HTTP Interface.
    .http.init = httpInit;
    .http.request = httpRequest;
    .http.deinit = httpDeinit;
    // Initialize the OTA library PAL Interface.
    .pal.getPlatformImageState = otaPal_GetPlatformImageState;
    .pal.setPlatformImageState = otaPal_SetPlatformImageState;
}
 
// OTA library error status.
OtaErr_t otaErr = OtaErrNone;
 
// Unique client identifier
char * pClientIdentifier = "uniqueClientID";
 
otaErr = OTA_Init( &otaBuffer,
                   &otaInterfaces,
                   ( const uint8_t * ) pClientIdentifier,
                   otaAppCallback ) ) != OtaErrNone )
         if( otaErr == OtaErrNone )
{
    // Do something with the OTA agent.
}