Percepio Trace Recorder v4.11.0
Loading...
Searching...
No Matches
Trace Object APIs

Macros

#define xTraceObjectGetAddress(xObjectHandle, ppvAddress)
 Gets trace object address.
#define pvTraceObjectGetAddressReturn(xObjectHandle)
 Returns trace object address.
#define xTraceObjectGetName(xObjectHandle, pszName)
 Gets trace object name.
#define xTraceObjectSetState(xObjectHandle, uxState)
 Sets trace object state.
#define xTraceObjectSetSpecificState(xObjectHandle, uiIndex, uxState)
 Sets trace object specific state.
#define xTraceObjectGetSpecificState(xObjectHandle, uiIndex, puxState)
 Gets trace object specific state.
#define xTraceObjectSetOptions(xObjectHandle, uiOptions)
 Sets trace object options.
#define xTraceObjectSetStateWithoutHandle(pvObject, uxState)
 Set trace object state without trace object handle.
#define xTraceObjectFind(pvObject, pxObjectHandle)
 Get the TraceObjectHandle_t of the object.

Functions

traceResult xTraceObjectRegisterInternal (uint32_t uiEventCode, void *const pvObject, const char *szName, TraceUnsignedBaseType_t uxStateCount, const TraceUnsignedBaseType_t uxStates[], TraceUnsignedBaseType_t uxOptions, TraceObjectHandle_t *pxObjectHandle)
 Registers trace object.
traceResult xTraceObjectRegister (uint32_t uiEventCode, void *const pvObject, const char *szName, TraceUnsignedBaseType_t uxState, TraceObjectHandle_t *pxObjectHandle)
 Registers trace object.
traceResult xTraceObjectRegister2 (uint32_t uiEventCode, void *const pvObject, const char *szName, TraceUnsignedBaseType_t uxState1, TraceUnsignedBaseType_t uxState2, TraceObjectHandle_t *pxObjectHandle)
 Registers trace object with two initial states.
traceResult xTraceObjectUnregister (TraceObjectHandle_t xObjectHandle, uint32_t uiEventCode, TraceUnsignedBaseType_t uxState)
 Unregisters trace object.
traceResult xTraceObjectSetName (TraceObjectHandle_t xObjectHandle, const char *szName)
 Sets trace object name.
traceResult xTraceObjectRegisterWithoutHandle (uint32_t uiEventCode, void *pvObject, const char *szName, TraceUnsignedBaseType_t uxState)
 Registers trace object without trace object handle.
traceResult xTraceObjectRegisterWithoutHandle2 (uint32_t uiEventCode, void *pvObject, const char *szName, TraceUnsignedBaseType_t uxState1, TraceUnsignedBaseType_t uxState2)
 Registers trace object with two initial states without trace object handle.
traceResult xTraceObjectUnregisterWithoutHandle (uint32_t uiEventCode, void *pvObject, TraceUnsignedBaseType_t uxState)
 Unregisters trace object without trace object handle.
traceResult xTraceObjectSetNameWithoutHandle (void *pvObject, const char *szName)
 Set trace object name without trace object handle.
traceResult xTraceObjectSetSpecificStateWithoutHandle (void *pvObject, uint32_t uiIndex, TraceUnsignedBaseType_t uxState)
 Sets trace object specific state without trace object handle.
traceResult xTraceObjectSetOptionsWithoutHandle (void *pvObject, uint32_t uiOptions)
 Sets trace object options without trace object handle.

Detailed Description

Macro Definition Documentation

◆ pvTraceObjectGetAddressReturn

#define pvTraceObjectGetAddressReturn ( xObjectHandle)
Value:
pvTraceEntryGetAddressReturn((TraceEntryHandle_t)(xObjectHandle))

Returns trace object address.

Parameters
[in]xObjectHandleObject handle.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectFind

#define xTraceObjectFind ( pvObject,
pxObjectHandle )
Value:
xTraceEntryFind(pvObject, (TraceEntryHandle_t*)pxObjectHandle)
traceResult xTraceEntryFind(const void *const pvAddress, TraceEntryHandle_t *pxEntryHandle)
Finds trace entry mapped to object address.
Definition trcEntryTable.c:166

Get the TraceObjectHandle_t of the object.

Parameters
[in]pvObjectObject.
[out]pxObjectHandlePointer to returned object handle.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectGetAddress

#define xTraceObjectGetAddress ( xObjectHandle,
ppvAddress )
Value:
xTraceEntryGetAddress((TraceEntryHandle_t)(xObjectHandle), ppvAddress)

Gets trace object address.

Parameters
[in]xObjectHandleObject handle.
[out]ppvAddressPointer to returned task address.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectGetName

#define xTraceObjectGetName ( xObjectHandle,
pszName )
Value:
xTraceEntryGetSymbol((TraceEntryHandle_t)(xObjectHandle), pszName)

Gets trace object name.

Parameters
[in]xObjectHandlePointer to initialized trace object.
[out]pszNamePointer to name variable.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectGetSpecificState

#define xTraceObjectGetSpecificState ( xObjectHandle,
uiIndex,
puxState )
Value:
xTraceEntryGetState((TraceEntryHandle_t)(xObjectHandle), uiIndex, puxState)

Gets trace object specific state.

Parameters
[in]xObjectHandlePointer to initialized trace object.
[in]uiIndexState Index.
[out]puxStatePointer to state.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectSetOptions

#define xTraceObjectSetOptions ( xObjectHandle,
uiOptions )
Value:
xTraceEntrySetOptions((TraceEntryHandle_t)(xObjectHandle), uiOptions)

Sets trace object options.

Parameters
[in]xObjectHandlePointer to initialized trace object.
[in]uiOptionsOptions.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectSetSpecificState

#define xTraceObjectSetSpecificState ( xObjectHandle,
uiIndex,
uxState )
Value:
xTraceEntrySetState((TraceEntryHandle_t)(xObjectHandle), uiIndex, uxState)

Sets trace object specific state.

Parameters
[in]xObjectHandlePointer to initialized trace object.
[in]uiIndexState Index.
[in]uxStateState.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectSetState

#define xTraceObjectSetState ( xObjectHandle,
uxState )
Value:
xTraceObjectSetSpecificState(xObjectHandle, 0, uxState)
#define xTraceObjectSetSpecificState(xObjectHandle, uiIndex, uxState)
Sets trace object specific state.
Definition trcObject.h:153

Sets trace object state.

Parameters
[in]xObjectHandlePointer to initialized trace object.
[in]uxStateState.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectSetStateWithoutHandle

#define xTraceObjectSetStateWithoutHandle ( pvObject,
uxState )
Value:
traceResult xTraceObjectSetSpecificStateWithoutHandle(void *pvObject, uint32_t uiIndex, TraceUnsignedBaseType_t uxState)
Sets trace object specific state without trace object handle.
Definition trcObject.c:252

Set trace object state without trace object handle.

Parameters
[in]pvObjectObject.
[in]uxStateState.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

Function Documentation

◆ xTraceObjectRegister()

traceResult xTraceObjectRegister ( uint32_t uiEventCode,
void *const pvObject,
const char * szName,
TraceUnsignedBaseType_t uxState,
TraceObjectHandle_t * pxObjectHandle )

Registers trace object.

Parameters
[in]uiEventCodeEvent code.
[in]pvObjectObject.
[in]szNameName.
[in]uxStateState.
[out]pxObjectHandlePointer to uninitialized trace object.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectRegister2()

traceResult xTraceObjectRegister2 ( uint32_t uiEventCode,
void *const pvObject,
const char * szName,
TraceUnsignedBaseType_t uxState1,
TraceUnsignedBaseType_t uxState2,
TraceObjectHandle_t * pxObjectHandle )

Registers trace object with two initial states.

Parameters
[in]uiEventCodeEvent code.
[in]pvObjectObject.
[in]szNameName.
[in]uxState1State 1.
[in]uxState2State 2.
[out]pxObjectHandlePointer to uninitialized trace object.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectRegisterInternal()

traceResult xTraceObjectRegisterInternal ( uint32_t uiEventCode,
void *const pvObject,
const char * szName,
TraceUnsignedBaseType_t uxStateCount,
const TraceUnsignedBaseType_t uxStates[],
TraceUnsignedBaseType_t uxOptions,
TraceObjectHandle_t * pxObjectHandle )

Registers trace object.

Parameters
[in]uiEventCodeEvent code.
[in]pvObjectObject.
[in]szNameName.
[in]uxStateCountState count.
[in]uxStatesStates.
[in]uxOptionsOptions.
[out]pxObjectHandlePointer to uninitialized trace object.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectRegisterWithoutHandle()

traceResult xTraceObjectRegisterWithoutHandle ( uint32_t uiEventCode,
void * pvObject,
const char * szName,
TraceUnsignedBaseType_t uxState )

Registers trace object without trace object handle.

Parameters
[in]uiEventCodeEvent code.
[in]pvObjectObject.
[in]szNameName.
[in]uxStateState.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectRegisterWithoutHandle2()

traceResult xTraceObjectRegisterWithoutHandle2 ( uint32_t uiEventCode,
void * pvObject,
const char * szName,
TraceUnsignedBaseType_t uxState1,
TraceUnsignedBaseType_t uxState2 )

Registers trace object with two initial states without trace object handle.

Parameters
[in]uiEventCodeEvent code.
[in]pvObjectObject.
[in]szNameName.
[in]uxState1State 1.
[in]uxState2State 2.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectSetName()

traceResult xTraceObjectSetName ( TraceObjectHandle_t xObjectHandle,
const char * szName )

Sets trace object name.

Parameters
[in]xObjectHandlePointer to initialized trace object.
[in]szNameName.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectSetNameWithoutHandle()

traceResult xTraceObjectSetNameWithoutHandle ( void * pvObject,
const char * szName )

Set trace object name without trace object handle.

Parameters
[in]pvObjectObject.
[in]szNameName.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectSetOptionsWithoutHandle()

traceResult xTraceObjectSetOptionsWithoutHandle ( void * pvObject,
uint32_t uiOptions )

Sets trace object options without trace object handle.

Parameters
[in]pvObjectObject.
[in]uiOptionsOptions.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectSetSpecificStateWithoutHandle()

traceResult xTraceObjectSetSpecificStateWithoutHandle ( void * pvObject,
uint32_t uiIndex,
TraceUnsignedBaseType_t uxState )

Sets trace object specific state without trace object handle.

Parameters
[in]pvObjectObject.
[in]uiIndexState index.
[in]uxStateState.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectUnregister()

traceResult xTraceObjectUnregister ( TraceObjectHandle_t xObjectHandle,
uint32_t uiEventCode,
TraceUnsignedBaseType_t uxState )

Unregisters trace object.

Parameters
[in]xObjectHandlePointer to initialized trace object.
[in]uiEventCodeEvent code.
[in]uxStateState.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceObjectUnregisterWithoutHandle()

traceResult xTraceObjectUnregisterWithoutHandle ( uint32_t uiEventCode,
void * pvObject,
TraceUnsignedBaseType_t uxState )

Unregisters trace object without trace object handle.

Parameters
[in]uiEventCodeEvent code.
[in]pvObjectObject.
[in]uxStateState.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess