Percepio Trace Recorder v4.11.0
Loading...
Searching...
No Matches
trcDiagnostics.h
Go to the documentation of this file.
1/*
2* Percepio Trace Recorder for Tracealyzer v4.11.0
3* Copyright 2025 Percepio AB
4* www.percepio.com
5*
6* SPDX-License-Identifier: Apache-2.0
7*/
8
14
15#ifndef TRC_DIAGNOSTICS_H
16#define TRC_DIAGNOSTICS_H
17
18#if (TRC_USE_TRACEALYZER_RECORDER == 1)
19
20#include <trcTypes.h>
21
22#ifdef __cplusplus
23extern "C" {
24#endif
25
26#define TRC_DIAGNOSTICS_COUNT 5UL
27
28typedef enum TraceDiagnosticsType
29{
30 TRC_DIAGNOSTICS_ENTRY_SYMBOL_LONGEST_LENGTH = 0x00UL,
31 TRC_DIAGNOSTICS_ENTRY_SLOTS_NO_ROOM = 0x01UL,
32 TRC_DIAGNOSTICS_BLOB_MAX_BYTES_TRUNCATED = 0x02UL,
33 TRC_DIAGNOSTICS_STACK_MONITOR_NO_SLOTS = 0x03UL,
34 TRC_DIAGNOSTICS_ASSERTS_TRIGGERED = 0x04UL,
35} TraceDiagnosticsType_t;
36
37typedef struct TraceDiagnostics /* Aligned */
38{
39 TraceBaseType_t metrics[TRC_DIAGNOSTICS_COUNT];
40} TraceDiagnosticsData_t;
41
50traceResult xTraceDiagnosticsInitialize(TraceDiagnosticsData_t* pxBuffer);
51
61traceResult xTraceDiagnosticsGet(TraceDiagnosticsType_t xType, TraceBaseType_t* pxValue);
62
72traceResult xTraceDiagnosticsSet(TraceDiagnosticsType_t xType, TraceBaseType_t xValue);
73
83traceResult xTraceDiagnosticsAdd(TraceDiagnosticsType_t xType, TraceBaseType_t xValue);
84
93traceResult xTraceDiagnosticsIncrease(TraceDiagnosticsType_t xType);
94
103traceResult xTraceDiagnosticsDecrease(TraceDiagnosticsType_t xType);
104
114traceResult xTraceDiagnosticsSetIfHigher(TraceDiagnosticsType_t xType, TraceBaseType_t xValue);
115
125traceResult xTraceDiagnosticsSetIfLower(TraceDiagnosticsType_t xType, TraceBaseType_t xValue);
126
133traceResult xTraceDiagnosticsCheckStatus(void);
134
135#ifdef __cplusplus
136}
137#endif
138
139#endif
140
141#endif
traceResult xTraceDiagnosticsAdd(TraceDiagnosticsType_t xType, TraceBaseType_t xValue)
Add to diagnostics value.
Definition trcDiagnostics.c:65
traceResult xTraceDiagnosticsIncrease(TraceDiagnosticsType_t xType)
Increase diagnostics value.
Definition trcDiagnostics.c:78
traceResult xTraceDiagnosticsDecrease(TraceDiagnosticsType_t xType)
Decrease diagnostics value.
Definition trcDiagnostics.c:83
traceResult xTraceDiagnosticsSetIfLower(TraceDiagnosticsType_t xType, TraceBaseType_t xValue)
Set a new diagnostics value if lower than previous value.
Definition trcDiagnostics.c:104
traceResult xTraceDiagnosticsSet(TraceDiagnosticsType_t xType, TraceBaseType_t xValue)
Set diagnostics value.
Definition trcDiagnostics.c:52
traceResult xTraceDiagnosticsCheckStatus(void)
Check the diagnostics status.
Definition trcDiagnostics.c:120
traceResult xTraceDiagnosticsSetIfHigher(TraceDiagnosticsType_t xType, TraceBaseType_t xValue)
Set a new diagnostics value if higher than previous value.
Definition trcDiagnostics.c:88
traceResult xTraceDiagnosticsGet(TraceDiagnosticsType_t xType, TraceBaseType_t *pxValue)
Retrieve diagnostics value.
Definition trcDiagnostics.c:36