View source for FreeRTOS on the EK-TM4C123GXL LaunchPad Board

__NOTOC__
== FreeRTOS on the EK-TM4C123GXL LaunchPad Board ==

Getting latest [http://www.freertos.org/ FreeRTOS] working in CCS under ubuntu, and the GNU GCC compiler that ships with CCS, on a [[EmSys:Tiva C Series TM4C123GXL Board | EK-TM4C123GXL Launchpad]] from ground zero. This getting started guide demonstrates the use of [http://www.freertos.org/ FreeRTOS] on the EK-TM4C123GXL LaunchPad Board.
<hr>
== FreeRTOS Demo Application ==

The application blinks the user-selected LED at a user-selected frequency. <br />
*To select the LED press the left button 
*To select the frequency press the right button.
*The UART outputs the application status at 115,200 baud, 8-n-1 mode.

This application utilizes [http://www.freertos.org/ FreeRTOS] to perform the tasks in a concurrent fashion. <br />
The following tasks are created:
* An LED task, which blinks the user-selected on-board LED at a user-selected rate (changed via the buttons).
* A Switch task, which monitors the buttons pressed and passes the information to LED task.

In addition to the tasks, this application also uses the following [http://www.freertos.org/ FreeRTOS] resources:
* A Queue to enable information transfer between tasks.
* A Semaphore to guard the resource, UART, from access by multiple tasks at the same time.
* A non-blocking [http://www.freertos.org/ FreeRTOS] Delay to put the tasks in blocked state when they have nothing to do.
<hr>
== FreeRTOS_ON_TM4C ==
<big>►</big> <span class="newtab">[[EmSys:Using GCC with Tiva TM4C123G LaunchPad in CCSv6 | Install Code Composer Studio and Tivaware for C Series]] </span> (Skip this step if you have working CCS6.2.x.x OR CCS7.x.x.x & Tivaware for C Series Installed) <br />

<big>►</big> <span class="newtab">[[EmSys:FreeRTOS Source | Fetch FreeRTOS Source]] </span><br />

<big>►</big> <span class="newtab">[[EmSys:Create freertos_on_tm4c123 CCS Project | Create FreeRTOS CCS Demo Project]] </span><br />

With the project created, we are now going to import [http://www.freertos.org/ FreeRTOS] Source first. <br /><br />
<big>►</big> Right-click on the project (freertos_on_tm4c123) in the "Project Explorer", and make a New folder, Call it "'''FreeRTOS'''". <br />

Now we'll import the necessary [http://www.freertos.org/ FreeRTOS] (source/header) files into this folder:<br />

<big>►</big> <span class="newtab">[[EmSys:Import FreeRTOS Source Files | Import FreeRTOS Source Files]] </span><br />

Next, we will import the [http://www.freertos.org/ FreeRTOS] example program, drivers and uartstdio files from Tivaware Examples.

<big>►</big> <span class="newtab">[[EmSys:Import Tivaware FreeRTOS Demo Source Files | Import Tivaware FreeRTOS Demo Source Files]] </span><br />

<big>►</big> <span class="newtab">[[EmSys:Create a variable at workspace level | Create Path/Build variable CCS]]</span> 

With [http://www.freertos.org/ FreeRTOS] and tivaware in our project, we need to make sure the C/C++ compiler is configured properly to search the include and portable folders since [http://www.freertos.org/ FreeRTOS] (and our project) depend on it.

<big>►</big> <span class="newtab">[[EmSys:Configure FreeRTOS Demo Project Include Search Path| Configure FreeRTOS Demo Project Include Search Path]] </span><br />

There are few GCC options we're going to tune.

<big>►</big> <span class="newtab">[[EmSys:Configure FreeRTOS Demo Project GCC Options | Configure FreeRTOS Demo Project GCC Options]] </span><br />

[http://www.freertos.org/ FreeRTOS] requires the use of several hardware interrupts/peripherals to function, notably the SysTick feature for its RTOS tick and the software interrupt calls '''SVCall''' and '''PendSV''' for its internal operation. Let's configure these interrupt handlers.

<big>►</big> <span class="newtab">[[EmSys:Configure FreeRTOS Demo Project Interrupt Handlers | Configure FreeRTOS Demo Project Interrupt Handlers]] </span><br />

<big>►</big> <span class="newtab">[[EmSys:Link the TivaWare driverlib.lib file to FreeRTOS Demo Project  | Link the TivaWare libdriver.a file to FreeRTOS Demo Project]]</span> <br />

To get [http://www.freertos.org/ FreeRTOS] into a state where we can compile it, a [{{FreeRTOS}}/FreeRTOSConfig.h FreeRTOSConfig.h] file is required and it looks for it.  Add this file inside the FreeRTOS/include folder since we have that folder in our include path already:

After inluding FreeRTOS/include/[{{FreeRTOS}}/FreeRTOSConfig.h FreeRTOSConfig.h], let's try to build our project:

<big>►</big> <span class="newtab">[[EmSys:Build FreeRTOS Demo Project | Build FreeRTOS Demo Project]]</span> <br />

Now let's make [http://www.freertos.org/ FreeRTOS] actually run.

<big>►</big> <span class="newtab">[[EmSys:FreeRTOS Demo Project Debug Configuration | FreeRTOS Demo Project Debug Configuration]]</span> <br />

<big>►</big> <span class="newtab">[[EmSys:Build Load Run FreeRTOS Demo Project|Load, Debug, Run - FreeRTOS Demo Project]]</span> <br />

== Demo Project ==
*[{{FreeRTOS}}/freertos_on_tm4c123_readme.txt Read_Me_First]
*[{{FreeRTOS}}/freertos_on_tm4c123.tar.gz FreeRTOS_TM4C123_CCS7_GCC_DEMO_PROJECT]

== Reference ==
*[{{FreeRTOS}}/Mastering_the_FreeRTOS_Real_Time_Kernel_A_Hands_On_Tutorial_Guide.pdf Mastering the FreeRTOS Real Time Kernel - A Hands On Tutorial Guide]<br />
*[{{FreeRTOS}}/FreeRTOS_Reference_Manual_V10.0.0.pdf The FreeRTOS Reference Manual v10.0.0]<br />

== External Link ==
http://www.freertos.org/