FreeRTOS CortexM3 HowTo
- Download Eclipse CDT from the Website below:
- After installing Eclipse we will need to install Zylin GDB embedded debugging plugin. Therefore open Eclipse, go to Help->Software Updates or Help->Install new Software (depends on which Version of Eclipse CDT you are using). Download and install Zylin Embedded CDT from:
Get FreeRTOS and a Toolchain
- Download the newest Version of FreeRTOS from:
- The next step is to get a Toolchain. In our case, we decided to work with the Sourcery G++ Lite because it supports us with a special library for the thumb2 which the Cortex M3 is using. For downloading CodeSourcery G++ Lite use the following Link:
- After all that, be sure using the newest Version of OpenOCD, which can be downloaded from:
- Alternatively a Windows Installer for OpenOCD can be found at:
- Because of a GPL license violation OpenOCD cannot be distributed with support for ftd2xx.dll library. FT2232 JTAGs have to be used via libusb-win32 drivers and OpenOCD will be linked with libftdi library. If there were FTDI drivers installed in the system, they have to be manually removed and then libusb-win32 drivers have to be installed manually.
Create an Eclipse Project for using FreeRTOS
There are different ways to create a FreeRTOS specific Project under Eclipse. In this case, the Project contains three folders:
- FreeRTOSSource - STMSourceFiles - SourceCodes - Boot - Scripts
The FreeRTOSSource folder includes all FreeRTOS specific Header and Source files. The STM Source Files are located in the STMSourcceFiles folder. The Boot folder contains all files which are necessary for the Board, e.g the startup file. The Script folder holds the cfg for openOCD and the linker scripts.
The following steps describes how to create a Project which is running FreeRTOS.
- Create a new empty C Makefile Project
- Create the folder structure mentioned above. All folders except the Script folder are declared as source folders.
- Fill the FreeRTOSSource folder with the FreeRTOS specific files you will need. There should be also a copy of Port.c, Portmacro.c and the heap_n.c files. The files Port.c and Portmacro.c can be found at ..\FreeRTOS Install Path\Source\portable\GCC\ARM_CM3 if an CortexM3 is used with the GCC. If the GCC is not the compiler you are using, the portable folder contains all by FreeRTOS supported compiler and Microcontroller. The MemMang folder which can also be found at ..\FreeRTOS Install Path\Source\portable\ holds heap_1.c, heap_2.c and heap_3.c. In our case heap_2.c is used.
- Go to Project Settings->C/C++ Build
- under "Settings" select "GNU Elf Parser"
- under "ToolChain Editor" select "No Toolchain"
- Go to Project Settings->C/C++ General->Paths and Symbols and add the following folder to GNU C
\Code Sourcery Root\arm-none-eabi\include
- After preparing the folder structure, the next step will be to configure OpenOCD and the GDB debugging.
For configuring OpenOCD click Run->External Tools->External Tools Configurations.
- Create a new configuration for OpenOCD by:
- Choosing a name for the new created configuration
- Setting the location of the OpenOCD.exe
- Setting the working directory
- Specifying the arguments to run OpenOCD
- Save changes by clicking on the Apply Button
Below is a simple example for the arguments used for the Olimex STM32, Olimex JTAG TINY:
-f \openocd-0.4.0\0.4.0\board\olimex_stm32_h103.cfg -f \openocd-0.4.0\0.4.0\interface\olimex-jtag-tiny.cfg -c init -c reset run -c halt -d 3 -l openocd.log
-f can be used to load e.g. a configuration file. -c specifies commands for openocd. -d chooses the debug level and with "-l openocd.log" a Log file will be created and saved under openocd.log
The next step is to set the Debug Configurations, therefore go to Run->Debug Configurations
- Create a new configuration for Debugging
- Create a new Zylin Embedded debug (native) configuration
- Choose a name for the new configuration
- Select the Project
- Pick the C/C++ Application which should be used
- Click on Debugger Tab and load the GDB debugger
- Remove .gdbinit in the GDB Command file field
- Clock Command Tab and specify 'Initialize' Commands for GDB
Example GDB init commands:
target remote localhost:3333 reset init load reset init tbreak main continue
Running OpenOCD and GDB
- Replace SVCHandler, PendSVHandler and the SysTickHandler in the startup file with the FreeRTOS specific handlers:
SVCHandler -> vPortSVCHandler PendSVHandler -> xPortPendSVHandler SysTickHandler -> xPortSysTickHandler
- Check the CPU Clock in FreeRTOS.h
- Click on Run->External Tools and select the created external Tool and wait until OpenOCD is ready
- Click on Run->Debug Configurations and run the created Zylin Embedded Debug
- Change to Debug view Window->Open Perspective->Debug