trcISR.h

Go to the documentation of this file.

/*
* Percepio Trace Recorder for Tracealyzer v4.11.0
* Copyright 2025 Percepio AB
* www.percepio.com
*
* SPDX-License-Identifier: Apache-2.0
*/

 
#ifndef TRC_ISR_H
#define TRC_ISR_H
 
#if (TRC_USE_TRACEALYZER_RECORDER == 1)
 
#include <trcTypes.h>
 
#ifdef __cplusplus
extern "C" {
#endif


typedef struct TraceISRCoreData /* Aligned */
{
    TraceISRHandle_t handleStack[TRC_CFG_MAX_ISR_NESTING];  
    int32_t stackIndex;                                     
    uint32_t isPendingContextSwitch;                            
} TraceISRCoreData_t;

typedef struct TraceISRData /* Aligned */
{
    TraceISRCoreData_t cores[TRC_CFG_CORE_COUNT]; /* ISR handles */
} TraceISRData_t;
 
/* We expose this to enable faster access */
extern TraceISRData_t* pxTraceISRData;

traceResult xTraceISRInitialize(TraceISRData_t *pxBuffer);

traceResult xTraceISRRegister(const char* szName, uint32_t uiPriority, TraceISRHandle_t* pxISRHandle);

traceResult xTraceISRBegin(TraceISRHandle_t xISRHandle);

traceResult xTraceISREnd(TraceBaseType_t xIsTaskSwitchRequired);
 
#if ((TRC_CFG_USE_TRACE_ASSERT) == 1)

traceResult xTraceISRGetCurrentNesting(int32_t* puiValue);

int32_t xTraceISRGetCurrentNestingReturned(void);

traceResult xTraceISRGetCurrent(TraceISRHandle_t* pxISRHandle);
 
#else /* ((TRC_CFG_USE_TRACE_ASSERT) == 1) */

#define xTraceISRGetCurrentNesting(puiValue) TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(*(puiValue) = pxTraceISRData->cores[TRC_CFG_GET_CURRENT_CORE()].stackIndex, TRC_SUCCESS)

#define xTraceISRGetCurrentNestingReturned() (pxTraceISRData->cores[TRC_CFG_GET_CURRENT_CORE()].stackIndex)

#define xTraceISRGetCurrent(pxISRHandle) (xTraceISRGetCurrentNestingReturned() >= 0 ? (*(pxISRHandle) = pxTraceISRData->cores[TRC_CFG_GET_CURRENT_CORE()].handleStack[xTraceISRGetCurrentNestingReturned()], TRC_SUCCESS) : TRC_FAIL)
 
#endif /* ((TRC_CFG_USE_TRACE_ASSERT) == 1) */

TraceISRHandle_t xTraceSetISRProperties(const char* szName, uint32_t uiPriority);

#define xTraceGetCurrentISRNesting(puiValue) xTraceISRGetCurrentNesting(puiValue)

#define vTraceStoreISRBegin(xISRHandle) xTraceISRBegin(xISRHandle)

#define vTraceStoreISREnd(xIsTaskSwitchRequired) xTraceISREnd(xIsTaskSwitchRequired)

 
#ifdef __cplusplus
}
#endif
 
#else
 
#define xTraceISRRegister(_szName, _uiPriority, _pxISRHandle) TRC_COMMA_EXPR_TO_STATEMENT_EXPR_4((void)(_szName), (void)(_uiPriority), (void)(_pxISRHandle), TRC_SUCCESS)
 
#define xTraceISRBegin(_xISRHandle) TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2((void)(_xISRHandle), TRC_SUCCESS)
 
#define xTraceISREnd(_xIsTaskSwitchRequired) TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2((void)(_xIsTaskSwitchRequired), TRC_SUCCESS)
 
#define xTraceISRGetCurrentNesting(_puiValue) TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2((void)(_puiValue), 0)
 
#define xTraceISRGetCurrentNestingReturned() (1)
 
#define xTraceISRGetCurrent(_pxISRHandle) TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2((void)(_pxISRHandle), TRC_SUCCESS)

#define xTraceSetISRProperties(_szName, _uiPriority) TRC_COMMA_EXPR_TO_STATEMENT_EXPR_3((void)(_szName), (void)(_uiPriority), TRC_SUCCESS)

#define xTraceGetCurrentISRNesting(_puiValue) xTraceISRGetCurrentNesting(_puiValue)

#define vTraceStoreISRBegin(_xISRHandle) xTraceISRBegin(_xISRHandle)

#define vTraceStoreISREnd(_xIsTaskSwitchRequired) xTraceISREnd(_xIsTaskSwitchRequired)
 
#endif
 
#endif