BGAPI Trace#

sli_bgapi_trace_message_type_t#

sli_bgapi_trace_message_type_t

Specifies the full type of a BGAPI message.

sli_bgapi_trace_init#

void sli_bgapi_trace_init (void )

Initialize BGAPI tracing.

sli_bgapi_trace_output_message#

void sli_bgapi_trace_output_message (sli_bgapi_trace_message_type_t type, uint32_t header, const void * data)

Output a BGAPI message to the trace channel.

sli_bgapi_trace_start#

void sli_bgapi_trace_start (void )

Start the BGAPI Trace.

This function is not used by normal applications. In the default configuration the BGAPI Trace will start automatically at application initialization time so that all BGAPI messages get traced. To avoid the RTT writes from blocking the application execution, something on the host computer side needs to read the RTT buffer. This may be inconvenient in situations where the user would like to use one application image for both a normal run where RTT is not read, and for taking debug traces using BGAPI Trace.

To faciliate using one image for both normal runs and for tracing, special applications (typically for example a test application used in automated testing) may define SLI_BGAPI_TRACE_DISABLE_AUTO_START as a global #define macro when building the application. When that macro is defined, the BGAPI Trace is not started automatically and the application can run normally even without anything reading RTT. When the application wants to start tracing in this configuration, it can do so by calling this function sli_bgapi_trace_start().

Use sli_bgapi_trace_stop() to stop the BGAPI Trace if needed.

sli_bgapi_trace_stop#

void sli_bgapi_trace_stop (void )

Stop the BGAPI Trace.

This function is not used by normal applications. See sli_bgapi_trace_start() for a description of special situations where this function might be useful.