/* | |
FreeRTOS V7.4.0 - Copyright (C) 2013 Real Time Engineers Ltd. | |
FEATURES AND PORTS ARE ADDED TO FREERTOS ALL THE TIME. PLEASE VISIT | |
http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION. | |
*************************************************************************** | |
* * | |
* FreeRTOS tutorial books are available in pdf and paperback. * | |
* Complete, revised, and edited pdf reference manuals are also * | |
* available. * | |
* * | |
* Purchasing FreeRTOS documentation will not only help you, by * | |
* ensuring you get running as quickly as possible and with an * | |
* in-depth knowledge of how to use FreeRTOS, it will also help * | |
* the FreeRTOS project to continue with its mission of providing * | |
* professional grade, cross platform, de facto standard solutions * | |
* for microcontrollers - completely free of charge! * | |
* * | |
* >>> See http://www.FreeRTOS.org/Documentation for details. <<< * | |
* * | |
* Thank you for using FreeRTOS, and thank you for your support! * | |
* * | |
*************************************************************************** | |
This file is part of the FreeRTOS distribution. | |
FreeRTOS is free software; you can redistribute it and/or modify it under | |
the terms of the GNU General Public License (version 2) as published by the | |
Free Software Foundation AND MODIFIED BY the FreeRTOS exception. | |
>>>>>>NOTE<<<<<< The modification to the GPL is included to allow you to | |
distribute a combined work that includes FreeRTOS without being obliged to | |
provide the source code for proprietary components outside of the FreeRTOS | |
kernel. | |
FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY | |
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS | |
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more | |
details. You should have received a copy of the GNU General Public License | |
and the FreeRTOS license exception along with FreeRTOS; if not itcan be | |
viewed here: http://www.freertos.org/a00114.html and also obtained by | |
writing to Real Time Engineers Ltd., contact details for whom are available | |
on the FreeRTOS WEB site. | |
1 tab == 4 spaces! | |
*************************************************************************** | |
* * | |
* Having a problem? Start by reading the FAQ "My application does * | |
* not run, what could be wrong?" * | |
* * | |
* http://www.FreeRTOS.org/FAQHelp.html * | |
* * | |
*************************************************************************** | |
http://www.FreeRTOS.org - Documentation, books, training, latest versions, | |
license and Real Time Engineers Ltd. contact details. | |
http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products, | |
including FreeRTOS+Trace - an indispensable productivity tool, and our new | |
fully thread aware and reentrant UDP/IP stack. | |
http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High | |
Integrity Systems, who sell the code with commercial support, | |
indemnification and middleware, under the OpenRTOS brand. | |
http://www.SafeRTOS.com - High Integrity Systems also provide a safety | |
engineered and independently SIL3 certified version for use in safety and | |
mission critical applications that require provable dependability. | |
*/ | |
/****************************************************************************** | |
* This project provides two demo applications. A simple blinky style project, | |
* and a more comprehensive test and demo application. The | |
* mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting (defined in this file) is used to | |
* select between the two. The simply blinky demo is implemented and described | |
* in main_blinky.c. The more comprehensive test and demo application is | |
* implemented and described in main_full.c. | |
* | |
* This file implements the code that is not demo specific, including the | |
* hardware setup and FreeRTOS hook functions. | |
* | |
* This project does not provide an example of how to write an RTOS compatible | |
* interrupt service routine (other than the tick interrupt itself), so this | |
* file contains the function vAnExampleISR_C_Handler() as a dummy example (that | |
* is not actually installed) that can be used as a reference. Also see the | |
* file ExampleISR.S, and the documentation page for this demo on the | |
* FreeRTOS.org website for full instructions. | |
* | |
* ENSURE TO READ THE DOCUMENTATION PAGE FOR THIS PORT AND DEMO APPLICATION ON | |
* THE http://www.FreeRTOS.org WEB SITE FOR FULL INFORMATION ON USING THIS DEMO | |
* APPLICATION, AND ITS ASSOCIATE FreeRTOS ARCHITECTURE PORT! | |
* | |
*/ | |
/* Scheduler include files. */ | |
#include "FreeRTOS.h" | |
#include "task.h" | |
#include "semphr.h" | |
/* Set mainCREATE_SIMPLE_BLINKY_DEMO_ONLY to one to run the simple blinky demo, | |
or 0 to run the more comprehensive test and demo application. */ | |
#define mainCREATE_SIMPLE_BLINKY_DEMO_ONLY 0 | |
/*-----------------------------------------------------------*/ | |
/* | |
* main_blinky() is used when mainCREATE_SIMPLE_BLINKY_DEMO_ONLY is set to 1. | |
* main_full() is used when mainCREATE_SIMPLE_BLINKY_DEMO_ONLY is set to 0. | |
*/ | |
#if mainCREATE_SIMPLE_BLINKY_DEMO_ONLY == 1 | |
extern void main_blinky( void ); | |
#else | |
extern void main_full( void ); | |
#endif | |
/* Prototypes for the standard FreeRTOS callback/hook functions implemented | |
within this file. */ | |
void vApplicationMallocFailedHook( void ); | |
void vApplicationIdleHook( void ); | |
void vApplicationStackOverflowHook( TaskHandle_t pxTask, char *pcTaskName ); | |
void vApplicationTickHook( void ); | |
/* This variable is not actually used, but provided to allow an example of how | |
to write an ISR to be included in this file. */ | |
static SemaphoreHandle_t xSemaphore = NULL; | |
/*-----------------------------------------------------------*/ | |
int main( void ) | |
{ | |
/* The mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting is described at the top | |
of this file. */ | |
#if mainCREATE_SIMPLE_BLINKY_DEMO_ONLY == 1 | |
{ | |
main_blinky(); | |
} | |
#else | |
{ | |
main_full(); | |
} | |
#endif | |
/* Should not get here. See the definitions of main_blinky() and | |
main_full(). */ | |
return 0; | |
} | |
/*-----------------------------------------------------------*/ | |
void vAnExampleISR_C_Handler( void ) | |
{ | |
/* | |
* This demo does not include a functional interrupt service routine - so | |
* this dummy handler (which is not actually installed) is provided as an | |
* example of how an ISR that needs to cause a context switch needs to be | |
* implemented. ISRs that do not cause a context switch have no special | |
* requirements and can be written as per the compiler documentation. | |
* | |
* This C function is called from a wrapper function that is implemented | |
* in assembly code. See vANExampleISR_ASM_Wrapper() in ExampleISR.S. Also | |
* see the documentation page for this demo on the FreeRTOS.org website for | |
* full instructions. | |
*/ | |
short sHigherPriorityTaskWoken = pdFALSE; | |
/* Handler code goes here...*/ | |
/* For purposes of demonstration, assume at some point the hander calls | |
xSemaphoreGiveFromISR().*/ | |
xSemaphoreGiveFromISR( xSemaphore, &sHigherPriorityTaskWoken ); | |
/* If giving the semaphore unblocked a task, and the unblocked task has a | |
priority higher than or equal to the currently running task, then | |
sHigherPriorityTaskWoken will have been set to pdTRUE internally within the | |
xSemaphoreGiveFromISR() function. Passing a pdTRUE value to | |
portYIELD_FROM_ISR() will cause this interrupt to return directly to the | |
higher priority unblocked task. */ | |
portYIELD_FROM_ISR( sHigherPriorityTaskWoken ); | |
} | |
/*-----------------------------------------------------------*/ | |
void vApplicationMallocFailedHook( void ) | |
{ | |
/* Called if a call to pvPortMalloc() fails because there is insufficient | |
free memory available in the FreeRTOS heap. pvPortMalloc() is called | |
internally by FreeRTOS API functions that create tasks, queues, software | |
timers, and semaphores. The size of the FreeRTOS heap is set by the | |
configTOTAL_HEAP_SIZE configuration constant in FreeRTOSConfig.h. */ | |
taskDISABLE_INTERRUPTS(); | |
for( ;; ); | |
} | |
/*-----------------------------------------------------------*/ | |
void vApplicationStackOverflowHook( TaskHandle_t pxTask, char *pcTaskName ) | |
{ | |
( void ) pcTaskName; | |
( void ) pxTask; | |
/* Run time stack overflow checking is performed if | |
configCHECK_FOR_STACK_OVERFLOW is defined to 1 or 2. This hook | |
function is called if a stack overflow is detected. */ | |
taskDISABLE_INTERRUPTS(); | |
for( ;; ); | |
} | |
/*-----------------------------------------------------------*/ | |
void vApplicationIdleHook( void ) | |
{ | |
volatile size_t xFreeHeapSpace; | |
/* This is just a trivial example of an idle hook. It is called on each | |
cycle of the idle task. It must *NOT* attempt to block. In this case the | |
idle task just queries the amount of FreeRTOS heap that remains. See the | |
memory management section on the http://www.FreeRTOS.org web site for memory | |
management options. If there is a lot of heap memory free then the | |
configTOTAL_HEAP_SIZE value in FreeRTOSConfig.h can be reduced to free up | |
RAM. */ | |
xFreeHeapSpace = xPortGetFreeHeapSize(); | |
/* Remove compiler warning about xFreeHeapSpace being set but never used. */ | |
( void ) xFreeHeapSpace; | |
} | |