OTA_SignalEvent

Signal event to the OTA Agent task.

bool OTA_SignalEvent( const OtaEventMsg_t * const pEventMsg );

This function adds the event to the back of event queue and used by internal OTA modules to signal agent task.

Parameters

[in]

pEventMsg

Event to be added to the queue

Returns

true If operation is successful, false If the event can not be added

Example Signal OTA agent that a new file block has been received over the http connection.

OtaHttpStatus_t handleDataFromHTTPService( const HTTPResponse_t * pResponse )
{
    // Assume otaEventBufferGet is a user defined, thread-safe function
    // that gets an available buffer from the pool of OTA buffers.
    OtaEventData_t * pData = otaEventBufferGet();
    OtaHttpStatus_t returnValue = OtaHttpRequestFailed;
    bool result = false;
 
    // Validate pResponse for correct data.
 
    if( pData != NULL )
    {
        memcpy( pData->data, pResponse->pBody, pResponse->bodyLen );
        pData->dataLength = pResponse->bodyLen;
 
        // Send job document received event.
        eventMsg.eventId = OtaAgentEventReceivedFileBlock;
        eventMsg.pEventData = pData;
        result = OTA_SignalEvent( &eventMsg );
 
        if( result )
        {
            returnValue = OtaHttpSuccess;
        }
    }
    return returnValue;
}