OTA_GetStatistics

Get the statistics of OTA message packets.

OtaErr_t OTA_GetStatistics( OtaAgentStatistics_t * pStatistics );

Packet statistics are:

• Received: The number of OTA packets that have been received but not necessarily queued for processing by the OTA agent.
• Queued: The number of OTA packets that have been queued for processing. This implies there was a free message queue entry so it can be passed to the agent for processing.
• Processed: The number of OTA packets that have actually been processed.
• Dropped: The number of OTA packets that have been dropped because of either no queue or at shutdown cleanup.

Note

Calling OTA_Init will reset this statistic.

Returns

OtaErrNone if the statistics can be received successfully.

Example

// OTA library packet statistics per job.
OtaAgentStatistics_t otaStatistics = { 0 };
OtaErr_t otaErr = OtaErrNone;
 
// Get the current statistics from the agent.
otaErr = OTA_GetStatistics( &otaStatistics );
 
if( otaErr != OtaErrNone )
{
    printf( " Received: %u   Queued: %u   Processed: %u   Dropped: %u",
            otaStatistics.otaPacketsReceived,
            otaStatistics.otaPacketsQueued,
            otaStatistics.otaPacketsProcessed,
            otaStatistics.otaPacketsDropped );
}