Percepio Trace Recorder
v4.6.6
|
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. More... | |
#define | xTraceTaskSetName xTraceObjectSetName |
Sets trace task name. More... | |
#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. More... | |
#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. More... | |
#define | xTraceTaskSetNameWithoutHandle xTraceObjectSetNameWithoutHandle |
Sets trace task name without trace task handle. More... | |
#define | xTraceTaskSetCurrent(pvTask) TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(pxTraceTaskInfo->coreTasks[TRC_CFG_GET_CURRENT_CORE()] = (pvTask), TRC_SUCCESS) |
Sets current trace task. More... | |
#define | xTraceTaskGetCurrent(ppvTask) TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(*(ppvTask) = pxTraceTaskInfo->coreTasks[TRC_CFG_GET_CURRENT_CORE()], TRC_SUCCESS) |
Gets current trace task. More... | |
Functions | |
traceResult | xTraceTaskUnregister (TraceTaskHandle_t xTaskHandle, TraceUnsignedBaseType_t uxPriority) |
Unregister trace task from trace. More... | |
traceResult | xTraceTaskSetPriority (TraceTaskHandle_t xTaskHandle, TraceUnsignedBaseType_t uxPriority) |
Sets trace task priority. More... | |
traceResult | xTraceTaskSetPriorityWithoutHandle (void *pvTask, TraceUnsignedBaseType_t uxPriority) |
Sets trace task priority without trace task handle. More... | |
traceResult | xTraceTaskSwitch (void *pvTask, TraceUnsignedBaseType_t uxPriority) |
Registers trace task switch event. More... | |
traceResult | xTraceTaskInstanceFinishedNow (void) |
Registers trace task instance finished event. More... | |
traceResult | xTraceTaskInstanceFinishedNext (void) |
Marks the current trace task instance as finished on the next kernel call. More... | |
#define xTraceTaskGetCurrent | ( | ppvTask | ) | TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(*(ppvTask) = pxTraceTaskInfo->coreTasks[TRC_CFG_GET_CURRENT_CORE()], TRC_SUCCESS) |
Gets current trace task.
[out] | ppvTask | Task. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
#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.
[in] | pvTask | Task. |
[in] | szName | Name. |
[in] | uxPriority | Priority. |
[out] | pxTaskHandle | Pointer to uninitialized trace task. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
#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.
[in] | pvTask | Task. |
[in] | szName | Name. |
[in] | uxPriority | Priority. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
#define xTraceTaskSetCurrent | ( | pvTask | ) | TRC_COMMA_EXPR_TO_STATEMENT_EXPR_2(pxTraceTaskInfo->coreTasks[TRC_CFG_GET_CURRENT_CORE()] = (pvTask), TRC_SUCCESS) |
Sets current trace task.
[in] | pvTask | Task. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
#define xTraceTaskSetName xTraceObjectSetName |
Sets trace task name.
[in] | pvTask | Task. |
[in] | szName | Name. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
#define xTraceTaskSetNameWithoutHandle xTraceObjectSetNameWithoutHandle |
Sets trace task name without trace task handle.
[in] | pvTask | Task. |
[in] | szName | Name. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
#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.
[in] | pvTask | Task. |
[in] | uxPriority | Priority. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
traceResult xTraceTaskInstanceFinishedNext | ( | void | ) |
Marks the current trace task instance as finished on the next kernel call.
If that kernel call is blocking, the instance ends after the blocking event and the corresponding return event is then the start of the next instance. If the kernel call is not blocking, the viewer instead splits the current fragment right before the kernel call, which makes this call the first event of the next instance.
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
traceResult xTraceTaskInstanceFinishedNow | ( | void | ) |
Registers trace task instance finished event.
This routine creates a trace event that ends the current task instance at this very instant. This makes the viewer split the current fragment at this point and begin a new actor instance, even if no task-switch has occurred
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
traceResult xTraceTaskSetPriority | ( | TraceTaskHandle_t | xTaskHandle, |
TraceUnsignedBaseType_t | uxPriority | ||
) |
Sets trace task priority.
[in] | xTaskHandle | Pointer to initialized trace task. |
[in] | uxPriority | Priority. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
traceResult xTraceTaskSetPriorityWithoutHandle | ( | void * | pvTask, |
TraceUnsignedBaseType_t | uxPriority | ||
) |
Sets trace task priority without trace task handle.
[in] | pvTask | Task. |
[in] | uxPriority | Priority. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
traceResult xTraceTaskSwitch | ( | void * | pvTask, |
TraceUnsignedBaseType_t | uxPriority | ||
) |
Registers trace task switch event.
[in] | pvTask | Task. |
[in] | uxPriority | Priority. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |
traceResult xTraceTaskUnregister | ( | TraceTaskHandle_t | xTaskHandle, |
TraceUnsignedBaseType_t | uxPriority | ||
) |
Unregister trace task from trace.
[in] | xTaskHandle | Pointer to initialized trace task. |
[in] | uxPriority | Priority. |
TRC_FAIL | Failure |
TRC_SUCCESS | Success |