OTA_ActivateNewImage

OtaErr_t OTA_ActivateNewImage( void );

Activate the newest MCU image received via OTA.

This function should reset the MCU and cause a reboot of the system to execute the newly updated firmware. It should be called by the user code sometime after the OtaJobEventActivate event is passed to the users application via the OTA Job Complete Callback mechanism. Refer to the OTA_Init function for more information about configuring the callback.

Returns

OtaErrNone if successful, otherwise an error code prefixed with 'OtaErr' from the list above.

Example

static void otaAppCallback( OtaJobEvent_t event,
                            const void * pData )
{
    OtaErr_t otaErr = OtaErrNone;
    if( event == OtaJobEventActivate )
    {
        // Activate the new firmware image.
        // This calls the platform specific code required to
        // activate the received OTA update firmware.
        otaErr = OTA_ActivateNewImage();
        if( otaErr == OtaErrActivateFailed )
        {
             // Handle Image activation failure by requesting manual response, sending
             // error logs or retrying activation.
        }
    }
 
    // Handle other events
}