Percepio Trace Recorder v4.8.0.hotfix1
Loading...
Searching...
No Matches
trcTask.h File Reference

Public trace task APIs. More...

#include <trcTypes.h>

Go to the source code of this file.

Macros

#define xTraceTaskRegister(pvTask, szName, uxPriority, pxTaskHandle)   ((((pvTask) != 0) && (xTraceObjectRegister(PSF_EVENT_TASK_CREATE, pvTask, szName, uxPriority, (TraceObjectHandle_t*)(pxTaskHandle)) == TRC_SUCCESS)) ? (xTraceStackMonitorAdd(pvTask), TRC_SUCCESS) : TRC_FAIL)
 Register trace task in the trace.
 
#define xTraceTaskSetName   xTraceObjectSetName
 Sets trace task name.
 
#define xTraceTaskRegisterWithoutHandle(pvTask, szName, uxPriority)   ((((pvTask) != 0) && (xTraceObjectRegisterWithoutHandle(PSF_EVENT_TASK_CREATE, pvTask, szName, uxPriority) == TRC_SUCCESS)) ? (xTraceStackMonitorAdd(pvTask), TRC_SUCCESS) : TRC_FAIL)
 Registers trace task without trace task handle.
 
#define xTraceTaskUnregisterWithoutHandle(pvTask, uxPriority)   TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(xTraceStackMonitorRemove(pvTask), xTraceObjectUnregisterWithoutHandle(PSF_EVENT_TASK_DELETE, pvTask, uxPriority))
 Unregisters trace task without trace task handle.
 
#define xTraceTaskSetNameWithoutHandle   xTraceObjectSetNameWithoutHandle
 Sets trace task name without trace task handle.
 
#define xTraceTaskSetCurrent(pvTask)   TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(pxTraceTaskData->coreTasks[TRC_CFG_GET_CURRENT_CORE()] = (pvTask), TRC_SUCCESS)
 Sets current trace task on current core.
 
#define xTraceTaskSetCurrentOnCore(coreId, pvTask)   TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(pxTraceTaskData->coreTasks[coreId] = (pvTask), TRC_SUCCESS)
 Sets current trace task on specific core.
 
#define xTraceTaskGetCurrent(ppvTask)   TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(*(ppvTask) = pxTraceTaskData->coreTasks[TRC_CFG_GET_CURRENT_CORE()], TRC_SUCCESS)
 Gets current trace task on current core.
 
#define xTraceTaskGetCurrentOnCore(coreId, ppvTask)   TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(*(ppvTask) = pxTraceTaskData->coreTasks[coreId], TRC_SUCCESS)
 Gets current trace task on specific core.
 
#define xTraceTaskGetCurrentReturn()   (pxTraceTaskData->coreTasks[TRC_CFG_GET_CURRENT_CORE()])
 Returns current trace task.
 
#define xTraceTaskInstanceFinishedNow()   xTraceEventCreate0(PSF_EVENT_IFE_DIRECT)
 Registers trace task instance finished event.
 
#define xTraceTaskInstanceFinishedNext()   xTraceEventCreate0(PSF_EVENT_IFE_NEXT)
 Marks the current trace task instance as finished on the next kernel call.
 

Functions

traceResult xTraceTaskUnregister (TraceTaskHandle_t xTaskHandle, TraceUnsignedBaseType_t uxPriority)
 Unregister trace task from trace.
 
traceResult xTraceTaskSetPriority (TraceTaskHandle_t xTaskHandle, TraceUnsignedBaseType_t uxPriority)
 Sets trace task priority.
 
traceResult xTraceTaskSetPriorityWithoutHandle (void *pvTask, TraceUnsignedBaseType_t uxPriority)
 Sets trace task priority without trace task handle.
 
traceResult xTraceTaskSwitch (void *pvTask, TraceUnsignedBaseType_t uxPriority)
 Registers trace task switch event.
 

Detailed Description

Public trace task APIs.