len0rd/FreeRTOS-Kernel
1
0
Fork 0
mirror of https://github.com/FreeRTOS/FreeRTOS-Kernel.git synced 2026-01-22 01:30:31 -05:00
Code Issues Projects Releases Packages Wiki Activity
FreeRTOS-Kernel/FreeRTOS/Demo/CORTEX_MPS2_QEMU_IAR_GCC
History
Johan Kraft 6d364f0b1f
TraceRecorder demo added in CORTEX_MPS2_QEMU_IAR_GCC (#1320) 
* * Added TraceRecorder demo for Percepio View in CORTEX_MPS2_QEMU_IAR_GCC (only gcc supported at the moment)

* * Added TraceRecorder demo instructions in readme.md.

* * Updated FreeRTOS-Plus-Trace pointer

* * Using FreeRTOS-Plus-Trace submodule (TraceRecorder) instead of a static TraceRecorder copy.
2025-01-23 10:11:33 +05:30
..
.vscode VSCode launch configurations (#820) 2022-06-07 21:21:52 -07:00
build TraceRecorder demo added in CORTEX_MPS2_QEMU_IAR_GCC (#1320) 2025-01-23 10:11:33 +05:30
CMSIS Add a GCC build to the QEMU/IAR project (#728) 2021-12-18 15:11:29 -08:00
TraceRecorderConfig TraceRecorder demo added in CORTEX_MPS2_QEMU_IAR_GCC (#1320) 2025-01-23 10:11:33 +05:30
FreeRTOSConfig.h TraceRecorder demo added in CORTEX_MPS2_QEMU_IAR_GCC (#1320) 2025-01-23 10:11:33 +05:30
Instructions.url Add a GCC build to the QEMU/IAR project (#728) 2021-12-18 15:11:29 -08:00
IntQueueTimer.c Fix C source and header file license spacing (#1155) 2024-01-12 16:43:31 -08:00
IntQueueTimer.h Fix C source and header file license spacing (#1155) 2024-01-12 16:43:31 -08:00
main.c TraceRecorder demo added in CORTEX_MPS2_QEMU_IAR_GCC (#1320) 2025-01-23 10:11:33 +05:30
main_blinky.c TraceRecorder demo added in CORTEX_MPS2_QEMU_IAR_GCC (#1320) 2025-01-23 10:11:33 +05:30
main_full.c Add register test tasks to QEMU project (#765) 2024-02-19 20:50:02 +05:30
Readme.md TraceRecorder demo added in CORTEX_MPS2_QEMU_IAR_GCC (#1320) 2025-01-23 10:11:33 +05:30

Readme.md

Running with VSCode Launch Configurations

Prerequisites

  • Install C/C++ extension in VSCode.
  • Install arm-none-eabi-gcc.
  • Install GNU make utility.
  • Ensure the required binaries are in PATH with arm-none-eabi-gcc --version, arm-none-eabi-gdb --version, and make --version.

Building and Running

  1. Open VSCode to the folder FreeRTOS/Demo/CORTEX_MPS2_QEMU_IAR_GCC.
  2. Open .vscode/launch.json, and ensure the miDebuggerPath variable is set to the path where arm-none-eabi-gdb is on your machine.
  3. Open main.c, and set mainCREATE_SIMPLE_BLINKY_DEMO_ONLY to 1 to generate just the simply blinky demo.
  4. On the VSCode left side panel, select the “Run and Debug” button. Then select “Launch QEMU RTOSDemo” from the dropdown on the top right and press the play button. This will build, run, and attach a debugger to the demo program.

Tracing with Percepio View

This demo project includes Percepio TraceRecorder, configured for snapshot tracing with Percepio View or Tracealyzer. Percepio View is a free tracing tool from Percepio, providing the core features of Percepio Tracealyzer but limited to snapshot tracing. No license or registration is required. More information and download is found at Percepio's product page for Percepio View.

TraceRecorder Integration

If you like to study how TraceRecorder is integrated, the steps for adding TraceRecorder are tagged with "TODO TraceRecorder" comments in the demo source code. This way, if using an Eclipse-based IDE, you can find a summary in the Tasks window by selecting Window -> Show View -> Tasks (or Other, if not listed). See also the official getting-started guide.

Usage with GCC

To save the TraceRecorder trace, start a debug session with GDB, for example using the provided Eclipse launch profile (should work in most Eclipse-based IDEs). Halt the execution and the run the command below. This saves the trace as trace.bin in the build/gcc folder. Open the trace file in Percepio View or Tracealyzer.

dump binary value trace.bin *RecorderDataPtr

Note that you can copy/paste this command into the Eclipse Debugger Console by using Ctrl-C, Ctrl-V.

Usage with IAR Embedded Workbench for Arm

The IAR project is not yet updated for TraceRecorder (work in progress). However, you can easily extend the existing IAR project with TraceRecorder. Simply add the source files and include paths for TraceRecorder listed in build/gcc/Makefile. Build and run. To save the trace, please refer to the guides at https://percepio.com/iar.