sac_stats.h

SPARK Audio Core statistics.

Copyright

Copyright (C) 2022 SPARK Microsystems International Inc. All rights reserved.

License

This source code is proprietary and subject to the SPARK Microsystems Software EULA found in this package in file EULA.txt.

Author

SPARK FW Team.

Functions

sac_statistics_t *sac_pipeline_update_stats(sac_pipeline_t *pipeline)

Update the SPARK Audio Core pipeline statistics.

After calling this function, the statistics inside the pipeline instance will be updated. The function also returns a reference to these internal statistics so they can be used by the caller.

Parameters

pipeline[in] Pipeline instance.

Returns

Reference to the statistics.

int sac_pipeline_format_stats(sac_pipeline_t *pipeline, char *buffer, uint16_t size)

Format the pipeline statistics as a string of characters.

Parameters
  • pipeline[in] Pipeline instance.

  • buffer[out] Buffer where to put the formatted string.

  • size[in] Size of the buffer.

Returns

The formatted string length, excluding the NULL terminator.

uint32_t sac_pipeline_get_producer_buffer_load(sac_pipeline_t *pipeline)

Get producer buffer load.

Parameters

pipeline[in] Pipeline instance.

Returns

buffer producer load value

uint32_t sac_pipeline_get_consumer_buffer_load(sac_pipeline_t *pipeline)

Get consumer buffer load.

Parameters

pipeline[in] Pipeline instance.

Returns

Consumer buffer load value.

uint32_t sac_pipeline_get_consumer_buffer_overflow_count(sac_pipeline_t *pipeline)

Get consumer buffer overflow count.

Parameters

pipeline[in] Pipeline instance.

Returns

Consumer buffer overflow counter.

uint32_t sac_pipeline_get_consumer_buffer_underflow_count(sac_pipeline_t *pipeline)

Get consumer buffer underflow count.

Parameters

pipeline[in] Pipeline instance.

Returns

Consumer buffer underflow counter.

uint32_t sac_pipeline_get_producer_packets_corrupted_count(sac_pipeline_t *pipeline)

Get producer packets corrupted.

Parameters

pipeline[in] Pipeline instance.

Returns

Producer packets corrupted.

uint32_t sac_pipeline_get_cdc_inflated_packets_count(sac_pipeline_t *pipeline)

Get the CDC inflated packet count.

Parameters

pipeline[in] Pipeline instance.

Returns

Inflated packet count.

uint32_t sac_pipeline_get_cdc_deflated_packets_count(sac_pipeline_t *pipeline)

Get the CDC deflated packet count.

Parameters

pipeline[in] Pipeline instance.

Returns

Deflated packet count.

uint32_t sac_pipeline_get_consumer_queue_peak_buffer_load(sac_pipeline_t *pipeline)

Get consumer queue peak load.

Parameters

pipeline[in] Pipeline instance.

Returns

Consumer queue peak load.

Get consumer’s all-time minimum link margin.

Parameters

pipeline[in] Pipeline instance.

Returns

Consumer link margin minimum.

uint32_t sac_pipeline_get_consumer_cca_peak(sac_pipeline_t *pipeline)

Get consumer CCA count peak.

Parameters

pipeline[in] Pipeline instance.

Returns

Consumer CCA count peak.

void sac_pipeline_reset_stats(sac_pipeline_t *pipeline)

Reset the SPARK Audio Core stats.

Parameters

pipeline[in] Pipeline instance.