readme.txt
1Percepio Trace Recorder Initialization v4.8.1
2Copyright 2023 Percepio AB
3www.percepio.com
4
5This folder contains files that should only be included in a project
6if there is a need to initialize the Trace Recorder before main()
7has been called.
8
9An example of this scenario is if you have a global object instance that has
10a constructor that creates an object that should be traced.
11TraceRecorderInit will make it easier to initiate the recorder correctly.
12
13Usage:
14Add a call to TraceRecorderInit::Initialize() wherever a traced object
15is created before the Trace Recorder is normally initialized, or simply
16as early as absloutely possible. This will ensure the Trace Recorder is
17initialized only once.
18
19Set TRC_CFG_RECORDER_DATA_INIT to 0 in trcConfig.h to ensure
20recorder data isn't initialized cleared after the recorder has been
21already initialized.
22
23It is possible that you also need to make sure certain recorder data isn't
24cleared when RAM sections are initialized. Create a RAM section that isn't
25cleared, then set the appropriate attribute in TRC_CFG_RECORDER_DATA_ATTRIBUTE.
26This attribute will then be set for all necessary recorder data that should
27not be cleared.
28
29After the hardware and clocks are properly initialized, use
30vTraceEnable(TRC_START) to start the tracing.
31