Quality RTOS & Embedded Software

 Real time embedded FreeRTOS RSS feed 
Real time embedded FreeRTOS mailing list 
Quick Start Supported MCUs PDF Books Trace Tools Ecosystem TCP & FAT Training

Getting Started with Simple FreeRTOS Projects

[See also the Quick Start Guide and the hardware independent starter functions provided.]

Simply Blinky Projects

The most recent FreeRTOS demos can be configured to build either a simple blinky starter application, or a comprehensive test and demo application:

  1. Simple blinky demos

    Blinky demos are intended for beginners. They normally create just two tasks, one queue, and sometimes also a software timer. Their functionality is contained in a single C source file called main_blinky.c.

  2. Comprehensive demos

    Comprehensive demos demonstrate and test a lot of FreeRTOS features, including tasks, direct to task notifications, queues, semaphores, recursive semaphores, software timers, and more. Comprehensive demos create a lot of tasks and use a lot of API functions, so are not recommended for beginners.

Each official FreeRTOS project has its own documentation page. The documentation page describes how to configure the project to build either the simply blinky demo or the comprehensive demo, and describes the behaviour of both options.

Note: A project that is configured to build a simply blinky demo will still build all the source files used by the comprehensive demo, even though the simply blinky functionality is contained within the single main_blinky.c source file. Refer to the Source Code Organisation and Creating a New FreeRTOS Project pages for a description of the RTOS and demo application source files.

Try It Now, Using the Windows Port

No hardware yet? Don't worry - you can run a simple blinky demo in a Windows environment using free tools and the FreeRTOS Windows port, although the FreeRTOS Windows port will not exhibit true real time behaviour.

If you are a beginner, then don't read the main documentation page for the Windows demo yet, or pay any attention to the comprehensive demo that can be built by the same project (the comprehensive demo for the Windows port is very comprehensive as it is used as a development and test platform!) - just start by using the simple instructions below:

Simple FreeRTOS demo using Windows
  1. If you don't already have it installed, download and install the free version of Microsoft Visual Studio.

  2. If you have not done so already, download and unzip the official FreeRTOS distribution.

  3. Start Visual Studio, then use the File|Open|Project/Solution menu item to open the Win32.sln solution file, which is located in the FreeRTOS/Demo/WIN32-MSVC directory of the official FreeRTOS distribution.

  4. Find the definition of mainCREATE_SIMPLE_BLINKY_DEMO_ONLY at the top of main.c, and make sure it is set to 1.

  5. Read the comments at the top of main_blinky.c, before compiling and then either debugging or running the application.

Output generated by simple RTOS demo under Windows
The output produced by the FreeRTOS Windows port simple blinky demo

[ Back to the top ]    [ About FreeRTOS ]    [ Sitemap ]    [ ]

Copyright (C) 2004-2010 Richard Barry. Copyright (C) 2010-2016 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.

Latest News:

FreeRTOS V9.0.0 is now available for download.

Free TCP/IP and file system demos for the RTOS

Sponsored Links

⇓ Now With No Code Size Limit! ⇓
⇑ Free Download Without Registering ⇑

FreeRTOS Partners

ARM Connected RTOS partner for all ARM microcontroller cores

Renesas Electronics Gold Alliance RTOS Partner.jpg

Microchip Premier RTOS Partner

RTOS partner of NXP for all NXP ARM microcontrollers

Atmel RTOS partner supporting ARM Cortex-M3 and AVR32 microcontrollers

STMicro RTOS partner supporting ARM7, ARM Cortex-M3, ARM Cortex-M4 and ARM Cortex-M0

Xilinx Microblaze and Zynq partner

Silicon Labs low power RTOS partner

Altera RTOS partner for Nios II and Cortex-A9 SoC

Freescale Alliance RTOS Member supporting ARM and ColdFire microcontrollers

Infineon ARM Cortex-M microcontrollers

Texas Instruments MCU Developer Network RTOS partner for ARM and MSP430 microcontrollers

Cypress RTOS partner supporting ARM Cortex-M3

Fujitsu RTOS partner supporting ARM Cortex-M3 and FM3

Microsemi (previously Actel) RTOS partner supporting ARM Cortex-M3

Atollic Partner

IAR Partner

Keil ARM Partner

Embedded Artists