Configuring the TraceAlyzer Snapshot Recorder
Configuration is performed through the addition of the following files:
(1) os_cfg_trace.c/h
These files are used to configure the optional triggering mechanism via µC/Probe. This module basically allows you to start a trace recording if the condition of user-defined trigger points in your code are met. From µC/Probe you can arm the trigger conditions and then µC/Probe will show you when recordings are ready for analysis.
The code listing below shows you an example of configuring a trigger point when a button on the board is pressed:
(2) trcConfig.h
From this file you can configure the name of the embedded target device by setting the macro SELECTED_PORT
. You can also configure the way the recorder behaves when the recording buffer gets full (e.g. TRACE_STORE_MODE_RING_BUFFER
or TRACE_STORE_MODE_STOP_WHEN_FULL
). At the same time, from this file you can configure the maximum number of events in the buffer and the maximum number of kernel objects to trace. The code listing below shows an example:Note: Setting SELECTED_PORT
is very important. The options include the following:
PORT_Atmel_AT91SAM7
PORT_Atmel_UC3A0
PORT_ARM_CortexM
PORT_ARM_CortexM_SysTick
PORT_Renesas_RX600
PORT_Microchip_dsPIC_AND_PIC24
PORT_TEXAS_INSTRUMENTS_TMS570
PORT_TEXAS_INSTRUMENTS_MSP430
PORT_MICROCHIP_PIC32MX
PORT_XILINX_PPC405
PORT_XILINX_PPC440
PORT_XILINX_MICROBLAZE
PORT_NXP_LPC210X
PORT_MICROCHIP_PIC32MZ
PORT_ARM_CORTEX_A9
PORT_ARM_CORTEX_M0
(3) trcKernelPort.h
In this file you need to verify that the macro to obtain the system clock frequency in Hertz exists in your project. It is usually a function that is part of your BSP. The code listing below shows an example: