This document provides instructions for using Percepio Tracealyzer to analyze FreeRTOS programs running on an AVNET MiniZED board with Xilinx Vitis. It describes extracting a patched FreeRTOS source code zip, setting up software projects in Vitis, enabling the Tracealyzer plugin, configuring plugin settings, debugging with GDB, saving trace snapshots, and viewing results in Tracealyzer to see thread activity and CPU load graphs. It reminds the user to revert the FreeRTOS source code when finished.

1. Percepio Tracealyzer for
FreeRTOS on MiniZED
Using Xilinx Vitis
Vincent Claes

2. Needed
• freertos10_xilinx_v1_6 –Trace.zip
• This is a patched version of the FreeRTOS Kernel and includes the Tracealyzer
sources [do not distribute it online]
• AVNET MiniZED Board
• Xilinx Vitis
• xsa export from Xilinx Vivado (your hardware project)
Vincent Claes

3. Extract the zip in this directory
• Step 1) rename “freertos10_xilinx_v1_6” to “freertos10_xilinx_v1_6old“
(afterwards you can get back to the Xilinx freertos port)
• Step 2) extract the zip file and rename this directory to “freertos10_xilinx_v1_6”
Vincent Claes

4. Create your Software projects and change
BSP Settings
Vincent Claes

5. Enable Tracealyzer
Vincent Claes

6. Install Percepio Tracealyzer plugin
Vincent Claes

7. Install Percepio Tracealyzer plugin
Vincent Claes

8. Set Percepio Tracealyzer plugin settings
Vincent Claes

9. Set Percepio Tracealyzer plugin settings
Vincent Claes

10. Launch GDB debug session
Vincent Claes

11. Click Exporter Diagnostics and start debugging
(green arrow used for starting execution of app)
Vincent Claes

12. Click Save Snapeshot Trace
Vincent Claes

13. FreeRTOS Insights
Vincent Claes

14. Percepio Tracealyzer
• Tracealayzer should open automatically
Vincent Claes

15. Trace View and Communication Flow
Vincent Claes

16. Trace View, Thread1, Thread2, ThreadRX,
ThreadTX, TzCtrl, Tmr SVC
Vincent Claes

17. CPU Load Graphs
Vincent Claes

18. Final Reminder
• When you have done using Percepio Tracealyzer set back the version
of “freertos10_xilinx_v1_6” to the Xilinx Original one before starting
your new FreeRTOS Project.
Vincent Claes