Port documentation pages are grouped by device manufacturer. Expand the list of supported devices, then click the manufacturer of
interest to be taken to a list of demo documentation pages.
The RTOS source code download includes a demonstration project for each port. The sample projects are preconfigured to
execute on the single board computer or prototyping board used during the port development. Each should build directly
as downloaded without any warnings or errors. A set of hardware indpendent
starter functions are also provided.
The demonstration projects are provided as:
An aid to learning how to use FreeRTOS - each source file demonstrates a component of the RTOS.
A preconfigured starting point for new applications - to ensure the correct development tool setup (compiler
switches, debugger format, etc) it is recommended that new applications are created by
modifying the existing demo projects. Once you have the demo application running, incrementally remove the demo functions
and source files and replace them with your own application code.
Locating a demo application
Every demo application is located in a subdirectory off the FreeRTOS/Demo directory. The name of each such subdirectory describes the configuration
of the demo application it contains. Please see the FreeRTOS source code organization page for a full
explanation of the FreeRTOS directory structure, and the
quick start guide for
further practical information.
Demo specific documentation
This website contains a documentation page for each demo application included in the FreeRTOS
download. These pages contain valuable and time saving information, such as how to setup the hardware and how to build the demo.
To locate the documentation page for any particular demo first expand the "Supported Devices" menu (see image below) to reveal a list of microcontroller
vendors that are supported by FreeRTOS. Clicking a vendor name will take you to a list of documentation pages specific to that vendor.
The structure of a demo application
Each demo application creates a set of demo real time tasks and/or co-routines - most of which are not specific to any one demo but common to many.
These tasks are created within main(), which in turn is defined within main.c. For example, the main() function for the Luminary Micro LM3S811
GCC demo is contained within FreeRTOS/Demo/CORTEX_LM3S811_GCC/main.c.
Most demos applications also create a 'check' task in one form or another.
The 'check' task will execute infrequently (typically every 3 or 5 seconds) but has a high priority so is guaranteed to get processor time.
Its primary responsibility is to check that all the other tasks are still operating as expected, and that no errors have been detected.
The check task will report the system status either on an LCD (if present) or by toggling an LED.
int main( void )
/* Setup the microcontroller hardware for the demo. */
/* Create the common demo application tasks, for example: */
/* Create any tasks defined within main.c itself, or otherwise specific to the
demo being built. */
xTaskCreate( vCheckTask, "check", STACK_SIZE, NULL, TASK_PRIORITY, NULL );
Start the RTOS scheduler, this function should not return as it causes the execution
context to change from main() to one of the created tasks. */
/* Should never get here! */
Partest.c - Accessing LEDs
Each demo application includes a file called partest.c (the name is historic and since lost its meaning, but is derived from 'parallel port test'). The file contains
the interface functions for setting LEDs, clearing LEDs and toggling LEDs. It is mentioned here for two reasons: First because the function
of the file is not obvious from its name, and second because getting the LED outputs working is normally the first step when porting a demo from one
hardware platform to another.
Demo application files
The table below lists some of the files that make up the demo projects along with a brief indication of the RTOS features demonstrated.
The following page describes each task and co-routine within the demo project in more
[These lists are currently a little historic as they have not been maintained completely as the number of demo files has increased over
the years. Even so they still provide a good reference. Demo project files that have been added more recently tend to have been
designed more specifically for testing than just for demonstration.]
Two implementations are provided for many files listed below. The files contained in the Demo/Common/Minimal
directory are for more RAM challenged systems such as the AVR. These files do not contain console IO. The files contained
in the Demo/Common/Full directory are predominantly for the x86 demo projects and contain console IO. Other than
that the functionality of the two implementations are basically the same.
See the Source Code Organization section for more information on the
demo project directory structure.
A few of points to note:
Not all the Demo/Common files are used in every demonstration project. How many files are used depends on
The demo projects often use all the available RAM on the target processor. This means that you cannot add more tasks
to the project without first removing some! This is especially true for the projects configured to run on the low end
In addition to the standard demo projects,
embedded web server projects are included in the download. These provide more application orientated examples.
The standard demo project files are provided for the purpose of demonstrating the use of the RTOS kernel and are
not intended to provide an optimized solution. This is particularly true of comtest.c (which uses an example UART driver),
which is generally written with
the intent of stressing (and therefore testing) the RTOS kernel implementation rather than providing an example of an optimal
Copyright (C) 2004-2010 Richard Barry. Copyright (C) 2010-2013 Real Time Engineers Ltd.
Any and all data, files, source code, html content and documentation included in the FreeRTOSTM distribution or available on this site are the exclusive property of Real Time Engineers Ltd..
See the files license.txt (included in the distribution) and this copyright notice for more information. FreeRTOSTM and FreeRTOS.orgTM are trade marks of Real Time Engineers Ltd.