mirror of
https://github.com/FreeRTOS/FreeRTOS-Kernel.git
synced 2025-10-14 16:57:41 -04:00
3a2f6646f0
* Use new version of CI-CD Actions, checkout@v3 instead of checkout@v2 on all jobs * Use cSpell spell check, and use ubuntu-20.04 for formatting check * Add in bot formatting action * Update freertos_demo.yml and freertos_plus_demo.yml files to increase github log readability * Add in a Qemu demo onto the workflows.
112 lines
2.9 KiB
C
112 lines
2.9 KiB
C
/*
|
|
* Percepio Trace Recorder for Tracealyzer v4.6.0
|
|
* Copyright 2021 Percepio AB
|
|
* www.percepio.com
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
*
|
|
* @brief Public trace static buffer APIs.
|
|
*/
|
|
|
|
#ifndef TRC_STATIC_BUFFER_H
|
|
#define TRC_STATIC_BUFFER_H
|
|
|
|
#if ( TRC_USE_TRACEALYZER_RECORDER == 1 )
|
|
|
|
#if ( TRC_CFG_RECORDER_MODE == TRC_RECORDER_MODE_STREAMING )
|
|
|
|
#include <trcTypes.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @defgroup trace_static_buffer_apis Trace Static Buffer APIs
|
|
* @ingroup trace_recorder_apis
|
|
* @{
|
|
*/
|
|
|
|
/* A buffer type that is maximum size */
|
|
typedef uint8_t TraceStaticBuffer_t[ TRC_MAX_BLOB_SIZE ];
|
|
|
|
/**
|
|
* @internal Trace Core Static Buffer Core Structure
|
|
*/
|
|
typedef struct TraceCoreStaticBufferCore
|
|
{
|
|
TraceStaticBuffer_t dummyEvents[ ( TRC_CFG_MAX_ISR_NESTING ) + 1 ]; /**< */
|
|
} TraceCoreStaticBuffer_t;
|
|
|
|
/**
|
|
* @internal Trace Static Buffer Table Structure
|
|
*/
|
|
typedef struct TraceStaticBufferTable
|
|
{
|
|
TraceCoreStaticBuffer_t coreDummyEvents[ TRC_CFG_CORE_COUNT ]; /**< Temporary buffers used for event or blob creation. */
|
|
} TraceStaticBufferTable_t;
|
|
|
|
#define TRC_STATIC_BUFFER_BUFFER_SIZE ( sizeof( TraceStaticBufferTable_t ) )
|
|
|
|
/**
|
|
* @internal Trace Static Buffer Buffer Structure
|
|
*/
|
|
typedef struct TraceStaticBufferBuffer
|
|
{
|
|
uint8_t buffer[ TRC_STATIC_BUFFER_BUFFER_SIZE ]; /**< */
|
|
} TraceStaticBufferBuffer_t;
|
|
|
|
extern TraceStaticBufferTable_t * pxTraceStaticBufferTable;
|
|
|
|
/**
|
|
* @internal Initialize trace static buffer.
|
|
*
|
|
* @param[in] pxBuffer Pointer to memory that will be used by the
|
|
* trace static buffer.
|
|
*
|
|
* @retval TRC_FAIL Failure
|
|
* @retval TRC_SUCCESS Success
|
|
*/
|
|
traceResult xTraceStaticBufferInitialize( TraceStaticBufferBuffer_t * pxBuffer );
|
|
|
|
#if ( ( TRC_CFG_USE_TRACE_ASSERT ) == 1 )
|
|
|
|
/**
|
|
* @brief Gets trace static buffer.
|
|
*
|
|
* @param[out] ppvBuffer Buffer.
|
|
*
|
|
* @retval TRC_FAIL Failure
|
|
* @retval TRC_SUCCESS Success
|
|
*/
|
|
traceResult xTraceStaticBufferGet( void ** ppvBuffer );
|
|
|
|
#else /* ((TRC_CFG_USE_TRACE_ASSERT) == 1) */
|
|
|
|
/**
|
|
* @brief Gets trace static buffer.
|
|
*
|
|
* @param[out] ppvBuffer Buffer.
|
|
*
|
|
* @retval TRC_FAIL Failure
|
|
* @retval TRC_SUCCESS Success
|
|
*/
|
|
#define xTraceStaticBufferGet( ppvBuffer ) ( *ppvBuffer = ( void * ) &pxTraceStaticBufferTable->coreDummyEvents[ TRC_CFG_GET_CURRENT_CORE() ].dummyEvents[ xTraceISRGetCurrentNestingReturned() + 1 ], TRC_SUCCESS )
|
|
|
|
#endif /* ((TRC_CFG_USE_TRACE_ASSERT) == 1) */
|
|
|
|
/** @} */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* (TRC_CFG_RECORDER_MODE == TRC_RECORDER_MODE_STREAMING) */
|
|
|
|
#endif /* (TRC_USE_TRACEALYZER_RECORDER == 1) */
|
|
|
|
#endif /* TRC_STATIC_BUFFER_H */
|