mirror of
https://github.com/FreeRTOS/FreeRTOS-Kernel.git
synced 2025-04-20 05:21:59 -04:00
Update Win32 MSVC demo to include a simple blinky build option. The demo as it was is now the "full/comprehensive" build option.
This commit is contained in:
Richard Barry
parent
b8a219b30c
commit
08ca5dead5
|
|
@ -144,8 +144,9 @@ to exclude the API function. */
|
||||||
#define INCLUDE_eTaskGetState 1
|
#define INCLUDE_eTaskGetState 1
|
||||||
#define INCLUDE_xSemaphoreGetMutexHolder 1
|
#define INCLUDE_xSemaphoreGetMutexHolder 1
|
||||||
|
|
||||||
extern void vAssertCalled( void );
|
/* Standard assert semantics. */
|
||||||
#define configASSERT( x ) if( ( x ) == 0 ) vAssertCalled()
|
extern void vAssertCalled( unsigned long ulLine, const char * const pcFileName );
|
||||||
|
#define configASSERT( x ) if( ( x ) == 0 ) vAssertCalled( __LINE__, __FILE__ )
|
||||||
|
|
||||||
/* configUSE_PORT_OPTIMISED_TASK_SELECTION is only available in the MSVC
|
/* configUSE_PORT_OPTIMISED_TASK_SELECTION is only available in the MSVC
|
||||||
version of the Win32 simulator projects. It will be ignored in the GCC
|
version of the Win32 simulator projects. It will be ignored in the GCC
|
||||||
|
|
|
||||||
|
|
@ -173,6 +173,8 @@
|
||||||
<PreprocessorDefinitions Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">%(PreprocessorDefinitions)</PreprocessorDefinitions>
|
<PreprocessorDefinitions Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">%(PreprocessorDefinitions)</PreprocessorDefinitions>
|
||||||
<PreprocessorDefinitions Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">%(PreprocessorDefinitions)</PreprocessorDefinitions>
|
<PreprocessorDefinitions Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">%(PreprocessorDefinitions)</PreprocessorDefinitions>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
<ClCompile Include="main_blinky.c" />
|
||||||
|
<ClCompile Include="main_full.c" />
|
||||||
<ClCompile Include="Run-time-stats-utils.c" />
|
<ClCompile Include="Run-time-stats-utils.c" />
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
|
|
|
||||||
|
|
@ -124,6 +124,12 @@
|
||||||
<ClCompile Include="..\Common\Minimal\QueueOverwrite.c">
|
<ClCompile Include="..\Common\Minimal\QueueOverwrite.c">
|
||||||
<Filter>Demo App Source\Common Demo Tasks</Filter>
|
<Filter>Demo App Source\Common Demo Tasks</Filter>
|
||||||
</ClCompile>
|
</ClCompile>
|
||||||
|
<ClCompile Include="main_full.c">
|
||||||
|
<Filter>Demo App Source</Filter>
|
||||||
|
</ClCompile>
|
||||||
|
<ClCompile Include="main_blinky.c">
|
||||||
|
<Filter>Demo App Source</Filter>
|
||||||
|
</ClCompile>
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
<ClInclude Include="FreeRTOSConfig.h">
|
<ClInclude Include="FreeRTOSConfig.h">
|
||||||
|
|
|
||||||
|
|
@ -72,7 +72,17 @@
|
||||||
mission critical applications that require provable dependability.
|
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 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.
|
||||||
|
*
|
||||||
*******************************************************************************
|
*******************************************************************************
|
||||||
* -NOTE- The Win32 port is a simulation (or is that emulation?) only! Do not
|
* -NOTE- The Win32 port is a simulation (or is that emulation?) only! Do not
|
||||||
* expect to get real time behaviour from the Win32 port or this demo
|
* expect to get real time behaviour from the Win32 port or this demo
|
||||||
|
|
@ -88,73 +98,45 @@
|
||||||
* - READ THE WEB DOCUMENTATION FOR THIS PORT FOR MORE INFORMATION ON USING IT -
|
* - READ THE WEB DOCUMENTATION FOR THIS PORT FOR MORE INFORMATION ON USING IT -
|
||||||
*******************************************************************************
|
*******************************************************************************
|
||||||
*
|
*
|
||||||
* main() creates all the demo application tasks, then starts the scheduler.
|
|
||||||
* The web documentation provides more details of the standard demo application
|
|
||||||
* tasks, which provide no particular functionality but do provide a good
|
|
||||||
* example of how to use the FreeRTOS API.
|
|
||||||
*
|
|
||||||
* In addition to the standard demo tasks, the following tasks and tests are
|
|
||||||
* defined and/or created within this file:
|
|
||||||
*
|
|
||||||
* "Check" task - This only executes every five seconds but has a high priority
|
|
||||||
* to ensure it gets processor time. Its main function is to check that all the
|
|
||||||
* standard demo tasks are still operational. While no errors have been
|
|
||||||
* discovered the check task will print out "OK" and the current simulated tick
|
|
||||||
* time. If an error is discovered in the execution of a task then the check
|
|
||||||
* task will print out an appropriate error message.
|
|
||||||
*
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
|
||||||
/* Standard includes. */
|
/* Standard includes. */
|
||||||
#include <stdio.h>
|
#include <stdio.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
#include <conio.h>
|
#include <conio.h>
|
||||||
|
|
||||||
/* Kernel includes. */
|
/* FreeRTOS kernel includes. */
|
||||||
#include <FreeRTOS.h>
|
#include "FreeRTOS.h"
|
||||||
#include "task.h"
|
#include "task.h"
|
||||||
#include "queue.h"
|
|
||||||
#include "timers.h"
|
|
||||||
#include "semphr.h"
|
|
||||||
|
|
||||||
/* Standard demo includes. */
|
/* This project provides two demo applications. A simple blinky style project,
|
||||||
#include "BlockQ.h"
|
and a more comprehensive test and demo application. The
|
||||||
#include "integer.h"
|
mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting is used to select between the two.
|
||||||
#include "semtest.h"
|
The simply blinky demo is implemented and described in main_blinky.c. The more
|
||||||
#include "PollQ.h"
|
comprehensive test and demo application is implemented and described in
|
||||||
#include "GenQTest.h"
|
main_full.c. */
|
||||||
#include "QPeek.h"
|
#define mainCREATE_SIMPLE_BLINKY_DEMO_ONLY 1
|
||||||
#include "recmutex.h"
|
|
||||||
#include "flop.h"
|
|
||||||
#include "TimerDemo.h"
|
|
||||||
#include "countsem.h"
|
|
||||||
#include "death.h"
|
|
||||||
#include "dynamic.h"
|
|
||||||
#include "QueueSet.h"
|
|
||||||
#include "QueueOverwrite.h"
|
|
||||||
|
|
||||||
/* Priorities at which the tasks are created. */
|
/*
|
||||||
#define mainCHECK_TASK_PRIORITY ( configMAX_PRIORITIES - 1 )
|
* main_blinky() is used when mainCREATE_SIMPLE_BLINKY_DEMO_ONLY is set to 1.
|
||||||
#define mainQUEUE_POLL_PRIORITY ( tskIDLE_PRIORITY + 1 )
|
* main_full() is used when mainCREATE_SIMPLE_BLINKY_DEMO_ONLY is set to 0.
|
||||||
#define mainSEM_TEST_PRIORITY ( tskIDLE_PRIORITY + 1 )
|
*/
|
||||||
#define mainBLOCK_Q_PRIORITY ( tskIDLE_PRIORITY + 2 )
|
extern void main_blinky( void );
|
||||||
#define mainCREATOR_TASK_PRIORITY ( tskIDLE_PRIORITY + 3 )
|
extern void main_full( void );
|
||||||
#define mainFLASH_TASK_PRIORITY ( tskIDLE_PRIORITY + 1 )
|
|
||||||
#define mainuIP_TASK_PRIORITY ( tskIDLE_PRIORITY + 2 )
|
|
||||||
#define mainINTEGER_TASK_PRIORITY ( tskIDLE_PRIORITY )
|
|
||||||
#define mainGEN_QUEUE_TASK_PRIORITY ( tskIDLE_PRIORITY )
|
|
||||||
#define mainFLOP_TASK_PRIORITY ( tskIDLE_PRIORITY )
|
|
||||||
#define mainQUEUE_OVERWRITE_PRIORITY ( tskIDLE_PRIORITY )
|
|
||||||
|
|
||||||
#define mainTIMER_TEST_PERIOD ( 50 )
|
/* Some of the RTOS hook (callback) functions only need special processing when
|
||||||
|
the full demo is being used. The simply blinky demo has no special requirements,
|
||||||
|
so these functions are called from the hook functions defined in this file, but
|
||||||
|
are defined in main_full.c. */
|
||||||
|
void vFullDemoTickHookFunction( void );
|
||||||
|
void vFullDemoIdleFunction( void );
|
||||||
|
|
||||||
/* Task function prototypes. */
|
/* Prototypes for the standard FreeRTOS callback/hook functions implemented
|
||||||
static void prvCheckTask( void *pvParameters );
|
within this file. */
|
||||||
|
void vApplicationMallocFailedHook( void );
|
||||||
/* A task that is created from the idle task to test the functionality of
|
void vApplicationIdleHook( void );
|
||||||
eTaskStateGet(). */
|
void vApplicationStackOverflowHook( xTaskHandle pxTask, signed char *pcTaskName );
|
||||||
static void prvTestTask( void *pvParameters );
|
void vApplicationTickHook( void );
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Writes trace data to a disk file when the trace recording is stopped.
|
* Writes trace data to a disk file when the trace recording is stopped.
|
||||||
|
|
@ -162,26 +144,12 @@ static void prvTestTask( void *pvParameters );
|
||||||
*/
|
*/
|
||||||
static void prvSaveTraceFile( void );
|
static void prvSaveTraceFile( void );
|
||||||
|
|
||||||
/*
|
|
||||||
* Called from the idle task hook function to demonstrate a few utility
|
|
||||||
* functions that are not demonstrated by any of the standard demo tasks.
|
|
||||||
*/
|
|
||||||
static void prvDemonstrateTaskStateAndHandleGetFunctions( void );
|
|
||||||
|
|
||||||
/*-----------------------------------------------------------*/
|
|
||||||
|
|
||||||
/* The variable into which error messages are latched. */
|
|
||||||
static char *pcStatusMessage = "OK";
|
|
||||||
|
|
||||||
/* This semaphore is created purely to test using the vSemaphoreDelete() and
|
|
||||||
semaphore tracing API functions. It has no other purpose. */
|
|
||||||
static xSemaphoreHandle xMutexToDelete = NULL;
|
|
||||||
|
|
||||||
/* The user trace event posted to the trace recording on each tick interrupt.
|
/* The user trace event posted to the trace recording on each tick interrupt.
|
||||||
Note tick events will not appear in the trace recording with regular period
|
Note tick events will not appear in the trace recording with regular period
|
||||||
because this project runs in a Windows simulator, and does not therefore
|
because this project runs in a Windows simulator, and does not therefore
|
||||||
exhibit deterministic behaviour. */
|
exhibit deterministic behaviour. */
|
||||||
traceLabel xTickTraceUserEvent;
|
traceLabel xTickTraceUserEvent;
|
||||||
|
static portBASE_TYPE xTraceRunning = pdTRUE;
|
||||||
|
|
||||||
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
|
@ -192,247 +160,125 @@ int main( void )
|
||||||
vTraceInitTraceData();
|
vTraceInitTraceData();
|
||||||
xTickTraceUserEvent = xTraceOpenLabel( "tick" );
|
xTickTraceUserEvent = xTraceOpenLabel( "tick" );
|
||||||
|
|
||||||
/* Start the check task as described at the top of this file. */
|
|
||||||
xTaskCreate( prvCheckTask, ( signed char * ) "Check", configMINIMAL_STACK_SIZE, NULL, mainCHECK_TASK_PRIORITY, NULL );
|
|
||||||
|
|
||||||
/* Create the standard demo tasks. */
|
|
||||||
vStartBlockingQueueTasks( mainBLOCK_Q_PRIORITY );
|
|
||||||
vStartSemaphoreTasks( mainSEM_TEST_PRIORITY );
|
|
||||||
vStartPolledQueueTasks( mainQUEUE_POLL_PRIORITY );
|
|
||||||
vStartIntegerMathTasks( mainINTEGER_TASK_PRIORITY );
|
|
||||||
vStartGenericQueueTasks( mainGEN_QUEUE_TASK_PRIORITY );
|
|
||||||
vStartQueuePeekTasks();
|
|
||||||
vStartMathTasks( mainFLOP_TASK_PRIORITY );
|
|
||||||
vStartRecursiveMutexTasks();
|
|
||||||
vStartTimerDemoTask( mainTIMER_TEST_PERIOD );
|
|
||||||
vStartCountingSemaphoreTasks();
|
|
||||||
vStartDynamicPriorityTasks();
|
|
||||||
vStartQueueSetTasks();
|
|
||||||
vStartQueueOverwriteTask( mainQUEUE_OVERWRITE_PRIORITY );
|
|
||||||
|
|
||||||
/* The suicide tasks must be created last as they need to know how many
|
|
||||||
tasks were running prior to their creation. This then allows them to
|
|
||||||
ascertain whether or not the correct/expected number of tasks are running at
|
|
||||||
any given time. */
|
|
||||||
vCreateSuicidalTasks( mainCREATOR_TASK_PRIORITY );
|
|
||||||
|
|
||||||
/* Create the semaphore that will be deleted in the idle task hook. This
|
|
||||||
is done purely to test the use of vSemaphoreDelete(). */
|
|
||||||
xMutexToDelete = xSemaphoreCreateMutex();
|
|
||||||
|
|
||||||
/* Start the trace recording - the recording is written to a file if
|
/* Start the trace recording - the recording is written to a file if
|
||||||
configASSERT() is called. */
|
configASSERT() is called. */
|
||||||
printf( "\r\nTrace started. Hit a key to dump trace file to disk.\r\n" );
|
printf( "\r\nTrace started. Hit a key to dump trace file to disk.\r\n" );
|
||||||
uiTraceStart();
|
uiTraceStart();
|
||||||
|
|
||||||
/* Start the scheduler itself. */
|
/* The mainCREATE_SIMPLE_BLINKY_DEMO_ONLY setting is described at the top
|
||||||
vTaskStartScheduler();
|
of this file. */
|
||||||
|
#if ( mainCREATE_SIMPLE_BLINKY_DEMO_ONLY == 1 )
|
||||||
|
{
|
||||||
|
main_blinky();
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
{
|
||||||
|
main_full();
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
/* Should never get here unless there was not enough heap space to create
|
|
||||||
the idle and other system tasks. */
|
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
static void prvCheckTask( void *pvParameters )
|
|
||||||
{
|
|
||||||
portTickType xNextWakeTime;
|
|
||||||
const portTickType xCycleFrequency = 1000 / portTICK_RATE_MS;
|
|
||||||
|
|
||||||
/* Just to remove compiler warning. */
|
|
||||||
( void ) pvParameters;
|
|
||||||
|
|
||||||
/* Initialise xNextWakeTime - this only needs to be done once. */
|
|
||||||
xNextWakeTime = xTaskGetTickCount();
|
|
||||||
|
|
||||||
for( ;; )
|
|
||||||
{
|
|
||||||
/* Place this task in the blocked state until it is time to run again. */
|
|
||||||
vTaskDelayUntil( &xNextWakeTime, xCycleFrequency );
|
|
||||||
|
|
||||||
/* Check the standard demo tasks are running without error. */
|
|
||||||
if( xAreTimerDemoTasksStillRunning( xCycleFrequency ) != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: TimerDemo";
|
|
||||||
}
|
|
||||||
else if( xAreIntegerMathsTaskStillRunning() != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: IntMath";
|
|
||||||
}
|
|
||||||
else if( xAreGenericQueueTasksStillRunning() != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: GenQueue";
|
|
||||||
}
|
|
||||||
else if( xAreQueuePeekTasksStillRunning() != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: QueuePeek";
|
|
||||||
}
|
|
||||||
else if( xAreBlockingQueuesStillRunning() != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: BlockQueue";
|
|
||||||
}
|
|
||||||
else if( xAreSemaphoreTasksStillRunning() != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: SemTest";
|
|
||||||
}
|
|
||||||
else if( xArePollingQueuesStillRunning() != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: PollQueue";
|
|
||||||
}
|
|
||||||
else if( xAreMathsTaskStillRunning() != pdPASS )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Flop";
|
|
||||||
}
|
|
||||||
else if( xAreRecursiveMutexTasksStillRunning() != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: RecMutex";
|
|
||||||
}
|
|
||||||
else if( xAreCountingSemaphoreTasksStillRunning() != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: CountSem";
|
|
||||||
}
|
|
||||||
else if( xIsCreateTaskStillRunning() != pdTRUE )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Death";
|
|
||||||
}
|
|
||||||
else if( xAreDynamicPriorityTasksStillRunning() != pdPASS )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Dynamic\r\n";
|
|
||||||
}
|
|
||||||
else if( xAreQueueSetTasksStillRunning() != pdPASS )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Queue set\r\n";
|
|
||||||
}
|
|
||||||
else if( xIsQueueOverwriteTaskStillRunning() != pdPASS )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Queue overwrite\r\n";
|
|
||||||
}
|
|
||||||
|
|
||||||
/* This is the only task that uses stdout so its ok to call printf()
|
|
||||||
directly. */
|
|
||||||
printf( "%s - %d\r\n", pcStatusMessage, xTaskGetTickCount() );
|
|
||||||
}
|
|
||||||
}
|
|
||||||
/*-----------------------------------------------------------*/
|
|
||||||
|
|
||||||
static void prvTestTask( void *pvParameters )
|
|
||||||
{
|
|
||||||
const unsigned long ulMSToSleep = 5;
|
|
||||||
|
|
||||||
/* Just to remove compiler warnings. */
|
|
||||||
( void ) pvParameters;
|
|
||||||
|
|
||||||
/* This task is just used to test the eTaskStateGet() function. It
|
|
||||||
does not have anything to do. */
|
|
||||||
for( ;; )
|
|
||||||
{
|
|
||||||
/* Sleep to reduce CPU load, but don't sleep indefinitely in case there are
|
|
||||||
tasks waiting to be terminated by the idle task. */
|
|
||||||
Sleep( ulMSToSleep );
|
|
||||||
}
|
|
||||||
}
|
|
||||||
/*-----------------------------------------------------------*/
|
|
||||||
|
|
||||||
void vApplicationIdleHook( void )
|
|
||||||
{
|
|
||||||
const unsigned long ulMSToSleep = 15;
|
|
||||||
const unsigned char ucConstQueueNumber = 0xaaU;
|
|
||||||
void *pvAllocated;
|
|
||||||
static portBASE_TYPE xTraceRunning = pdTRUE;
|
|
||||||
|
|
||||||
/* These three functions are only meant for use by trace code, and not for
|
|
||||||
direct use from application code, hence their prototypes are not in queue.h. */
|
|
||||||
extern void vQueueSetQueueNumber( xQueueHandle pxQueue, unsigned char ucQueueNumber );
|
|
||||||
extern unsigned char ucQueueGetQueueNumber( xQueueHandle pxQueue );
|
|
||||||
extern unsigned char ucQueueGetQueueType( xQueueHandle pxQueue );
|
|
||||||
extern void vTaskSetTaskNumber( xTaskHandle xTask, unsigned portBASE_TYPE uxHandle );
|
|
||||||
extern unsigned portBASE_TYPE uxTaskGetTaskNumber( xTaskHandle xTask );
|
|
||||||
|
|
||||||
/* Sleep to reduce CPU load, but don't sleep indefinitely in case there are
|
|
||||||
tasks waiting to be terminated by the idle task. */
|
|
||||||
Sleep( ulMSToSleep );
|
|
||||||
|
|
||||||
/* Demonstrate a few utility functions that are not demonstrated by any of
|
|
||||||
the standard demo tasks. */
|
|
||||||
prvDemonstrateTaskStateAndHandleGetFunctions();
|
|
||||||
|
|
||||||
/* If xMutexToDelete has not already been deleted, then delete it now.
|
|
||||||
This is done purely to demonstrate the use of, and test, the
|
|
||||||
vSemaphoreDelete() macro. Care must be taken not to delete a semaphore
|
|
||||||
that has tasks blocked on it. */
|
|
||||||
if( xMutexToDelete != NULL )
|
|
||||||
{
|
|
||||||
/* Before deleting the semaphore, test the function used to set its
|
|
||||||
number. This would normally only be done from trace software, rather
|
|
||||||
than application code. */
|
|
||||||
vQueueSetQueueNumber( xMutexToDelete, ucConstQueueNumber );
|
|
||||||
|
|
||||||
/* Before deleting the semaphore, test the functions used to get its
|
|
||||||
type and number. Again, these would normally only be done from trace
|
|
||||||
software, rather than application code. */
|
|
||||||
configASSERT( ucQueueGetQueueNumber( xMutexToDelete ) == ucConstQueueNumber );
|
|
||||||
configASSERT( ucQueueGetQueueType( xMutexToDelete ) == queueQUEUE_TYPE_MUTEX );
|
|
||||||
vSemaphoreDelete( xMutexToDelete );
|
|
||||||
xMutexToDelete = NULL;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Exercise heap_4 a bit. The malloc failed hook will trap failed
|
|
||||||
allocations so there is no need to test here. */
|
|
||||||
pvAllocated = pvPortMalloc( ( rand() % 100 ) + 1 );
|
|
||||||
vPortFree( pvAllocated );
|
|
||||||
|
|
||||||
if( _kbhit() != pdFALSE )
|
|
||||||
{
|
|
||||||
if( xTraceRunning == pdTRUE )
|
|
||||||
{
|
|
||||||
prvSaveTraceFile();
|
|
||||||
xTraceRunning = pdFALSE;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
/*-----------------------------------------------------------*/
|
|
||||||
|
|
||||||
void vApplicationMallocFailedHook( void )
|
void vApplicationMallocFailedHook( void )
|
||||||
{
|
{
|
||||||
vAssertCalled();
|
/* vApplicationMallocFailedHook() will only be called if
|
||||||
|
configUSE_MALLOC_FAILED_HOOK is set to 1 in FreeRTOSConfig.h. It is a hook
|
||||||
|
function that will get called if a call to pvPortMalloc() fails.
|
||||||
|
pvPortMalloc() is called internally by the kernel whenever a task, queue,
|
||||||
|
timer or semaphore is created. It is also called by various parts of the
|
||||||
|
demo application. If heap_1.c or heap_2.c are used, then the size of the
|
||||||
|
heap available to pvPortMalloc() is defined by configTOTAL_HEAP_SIZE in
|
||||||
|
FreeRTOSConfig.h, and the xPortGetFreeHeapSize() API function can be used
|
||||||
|
to query the size of free heap space that remains (although it does not
|
||||||
|
provide information on how the remaining heap might be fragmented). */
|
||||||
|
vAssertCalled( __LINE__, __FILE__ );
|
||||||
}
|
}
|
||||||
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
void vApplicationStackOverflowHook( void )
|
void vApplicationIdleHook( void )
|
||||||
{
|
{
|
||||||
/* Can be implemented if required, but not required in this
|
/* vApplicationIdleHook() will only be called if configUSE_IDLE_HOOK is set
|
||||||
environment and running this demo. */
|
to 1 in FreeRTOSConfig.h. It will be called on each iteration of the idle
|
||||||
|
task. It is essential that code added to this hook function never attempts
|
||||||
|
to block in any way (for example, call xQueueReceive() with a block time
|
||||||
|
specified, or call vTaskDelay()). If the application makes use of the
|
||||||
|
vTaskDelete() API function (as this demo application does) then it is also
|
||||||
|
important that vApplicationIdleHook() is permitted to return to its calling
|
||||||
|
function, because it is the responsibility of the idle task to clean up
|
||||||
|
memory allocated by the kernel to any task that has since been deleted. */
|
||||||
|
|
||||||
|
/* The trace can be stopped with any key press. */
|
||||||
|
if( _kbhit() != pdFALSE )
|
||||||
|
{
|
||||||
|
if( xTraceRunning == pdTRUE )
|
||||||
|
{
|
||||||
|
vTraceStop();
|
||||||
|
prvSaveTraceFile();
|
||||||
|
xTraceRunning = pdFALSE;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if ( mainCREATE_SIMPLE_BLINKY_DEMO_ONLY != 1 )
|
||||||
|
{
|
||||||
|
/* Call the idle task processing used by the full demo. The simple
|
||||||
|
blinky demo does not use the idle task hook. */
|
||||||
|
vFullDemoIdleFunction();
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
void vApplicationStackOverflowHook( xTaskHandle pxTask, signed 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. */
|
||||||
|
vAssertCalled( __LINE__, __FILE__ );
|
||||||
}
|
}
|
||||||
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
void vApplicationTickHook( void )
|
void vApplicationTickHook( void )
|
||||||
{
|
{
|
||||||
/* Call the periodic timer test, which tests the timer API functions that
|
/* This function will be called by each tick interrupt if
|
||||||
can be called from an ISR. */
|
configUSE_TICK_HOOK is set to 1 in FreeRTOSConfig.h. User code can be
|
||||||
vTimerPeriodicISRTests();
|
added here, but the tick hook is called from an interrupt context, so
|
||||||
|
code must not attempt to block, and only the interrupt safe FreeRTOS API
|
||||||
|
functions can be used (those that end in FromISR()). */
|
||||||
|
|
||||||
/* Call the periodic queue overwrite from ISR demo. */
|
#if ( mainCREATE_SIMPLE_BLINKY_DEMO_ONLY != 1 )
|
||||||
vQueueOverwritePeriodicISRDemo();
|
{
|
||||||
|
vFullDemoTickHookFunction();
|
||||||
/* Write to a queue that is in use as part of the queue set demo to
|
}
|
||||||
demonstrate using queue sets from an ISR. */
|
#endif /* mainCREATE_SIMPLE_BLINKY_DEMO_ONLY */
|
||||||
vQueueSetAccessQueueSetFromISR();
|
|
||||||
|
|
||||||
/* Write a user event to the trace log.
|
/* Write a user event to the trace log.
|
||||||
Note tick events will not appear in the trace recording with regular period
|
Note tick events will not appear in the trace recording with regular period
|
||||||
because this project runs in a Windows simulator, and does not therefore
|
because this project runs in a Windows simulator, and does not therefore
|
||||||
exhibit deterministic behaviour. */
|
exhibit deterministic behaviour. Windows will run the simulator in
|
||||||
|
bursts. */
|
||||||
vTraceUserEvent( xTickTraceUserEvent );
|
vTraceUserEvent( xTickTraceUserEvent );
|
||||||
}
|
}
|
||||||
/*-----------------------------------------------------------*/
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
void vAssertCalled( void )
|
void vAssertCalled( unsigned long ulLine, const char * const pcFileName )
|
||||||
{
|
{
|
||||||
|
/* Parameters are not used. */
|
||||||
|
( void ) ulLine;
|
||||||
|
( void ) pcFileName;
|
||||||
|
|
||||||
taskDISABLE_INTERRUPTS();
|
taskDISABLE_INTERRUPTS();
|
||||||
|
|
||||||
/* Stop the trace recording. */
|
/* Stop the trace recording. */
|
||||||
|
if( xTraceRunning == pdTRUE )
|
||||||
|
{
|
||||||
vTraceStop();
|
vTraceStop();
|
||||||
prvSaveTraceFile();
|
prvSaveTraceFile();
|
||||||
|
}
|
||||||
|
|
||||||
for( ;; );
|
for( ;; );
|
||||||
}
|
}
|
||||||
|
|
@ -455,81 +301,3 @@ FILE* pxOutputFile;
|
||||||
printf( "\r\nFailed to create trace dump file\r\n" );
|
printf( "\r\nFailed to create trace dump file\r\n" );
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
/*-----------------------------------------------------------*/
|
|
||||||
|
|
||||||
static void prvDemonstrateTaskStateAndHandleGetFunctions( void )
|
|
||||||
{
|
|
||||||
xTaskHandle xIdleTaskHandle, xTimerTaskHandle;
|
|
||||||
const unsigned char ucConstTaskNumber = 0x55U;
|
|
||||||
signed char *pcTaskName;
|
|
||||||
static portBASE_TYPE xPerformedOneShotTests = pdFALSE;
|
|
||||||
xTaskHandle xTestTask;
|
|
||||||
|
|
||||||
/* Demonstrate the use of the xTimerGetTimerDaemonTaskHandle() and
|
|
||||||
xTaskGetIdleTaskHandle() functions. Also try using the function that sets
|
|
||||||
the task number. */
|
|
||||||
xIdleTaskHandle = xTaskGetIdleTaskHandle();
|
|
||||||
xTimerTaskHandle = xTimerGetTimerDaemonTaskHandle();
|
|
||||||
vTaskSetTaskNumber( xIdleTaskHandle, ( unsigned long ) ucConstTaskNumber );
|
|
||||||
configASSERT( uxTaskGetTaskNumber( xIdleTaskHandle ) == ucConstTaskNumber );
|
|
||||||
|
|
||||||
/* This is the idle hook, so the current task handle should equal the
|
|
||||||
returned idle task handle. */
|
|
||||||
if( xTaskGetCurrentTaskHandle() != xIdleTaskHandle )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Returned idle task handle was incorrect";
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Check the timer task handle was returned correctly. */
|
|
||||||
pcTaskName = pcTaskGetTaskName( xTimerTaskHandle );
|
|
||||||
if( strcmp( pcTaskName, "Tmr Svc" ) != 0 )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Returned timer task handle was incorrect";
|
|
||||||
}
|
|
||||||
|
|
||||||
/* This task is running, make sure it's state is returned as running. */
|
|
||||||
if( eTaskStateGet( xIdleTaskHandle ) != eRunning )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Returned idle task state was incorrect";
|
|
||||||
}
|
|
||||||
|
|
||||||
/* If this task is running, then the timer task must be blocked. */
|
|
||||||
if( eTaskStateGet( xTimerTaskHandle ) != eBlocked )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Returned timer task state was incorrect";
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Other tests that should only be performed once follow. The test task
|
|
||||||
is not created on each iteration because to do so would cause the death
|
|
||||||
task to report an error (too many tasks running). */
|
|
||||||
if( xPerformedOneShotTests == pdFALSE )
|
|
||||||
{
|
|
||||||
/* Don't run this part of the test again. */
|
|
||||||
xPerformedOneShotTests = pdTRUE;
|
|
||||||
|
|
||||||
/* Create a test task to use to test other eTaskStateGet() return values. */
|
|
||||||
if( xTaskCreate( prvTestTask, "Test", configMINIMAL_STACK_SIZE, NULL, tskIDLE_PRIORITY, &xTestTask ) == pdPASS )
|
|
||||||
{
|
|
||||||
/* If this task is running, the test task must be in the ready state. */
|
|
||||||
if( eTaskStateGet( xTestTask ) != eReady )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Returned test task state was incorrect 1";
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Now suspend the test task and check its state is reported correctly. */
|
|
||||||
vTaskSuspend( xTestTask );
|
|
||||||
if( eTaskStateGet( xTestTask ) != eSuspended )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Returned test task state was incorrect 2";
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Now delete the task and check its state is reported correctly. */
|
|
||||||
vTaskDelete( xTestTask );
|
|
||||||
if( eTaskStateGet( xTestTask ) != eDeleted )
|
|
||||||
{
|
|
||||||
pcStatusMessage = "Error: Returned test task state was incorrect 3";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
|
||||||
254
FreeRTOS/Demo/WIN32-MSVC/main_blinky.c
Normal file
254
FreeRTOS/Demo/WIN32-MSVC/main_blinky.c
Normal file
|
|
@ -0,0 +1,254 @@
|
||||||
|
/*
|
||||||
|
FreeRTOS V7.4.2 - 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 it can 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.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/******************************************************************************
|
||||||
|
* NOTE 1: The Win32 port is a simulation (or is that emulation?) only! Do not
|
||||||
|
* expect to get real time behaviour from the Win32 port or this demo
|
||||||
|
* application. It is provided as a convenient development and demonstration
|
||||||
|
* test bed only. This was tested using Windows XP on a dual core laptop.
|
||||||
|
*
|
||||||
|
* In this example, one simulated millisecond will take approximately 40ms to
|
||||||
|
* execute, and Windows will not be running the FreeRTOS simulator threads
|
||||||
|
* continuously, so the timing information in the FreeRTOS+Trace logs have no
|
||||||
|
* meaningful units. See the documentation page for the Windows simulator for
|
||||||
|
* an explanation of the slow timing:
|
||||||
|
* http://www.freertos.org/FreeRTOS-Windows-Simulator-Emulator-for-Visual-Studio-and-Eclipse-MingW.html
|
||||||
|
* - READ THE WEB DOCUMENTATION FOR THIS PORT FOR MORE INFORMATION ON USING IT -
|
||||||
|
*
|
||||||
|
* NOTE 2: 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 in main.c is used to select
|
||||||
|
* between the two. See the notes on using mainCREATE_SIMPLE_BLINKY_DEMO_ONLY
|
||||||
|
* in main.c. This file implements the simply blinky style version.
|
||||||
|
*
|
||||||
|
* NOTE 3: This file only contains the source code that is specific to the
|
||||||
|
* basic demo. Generic functions, such FreeRTOS hook functions, are defined
|
||||||
|
* in main.c.
|
||||||
|
******************************************************************************
|
||||||
|
*
|
||||||
|
* main_blinky() creates one queue, and two tasks. It then starts the
|
||||||
|
* scheduler.
|
||||||
|
*
|
||||||
|
* The Queue Send Task:
|
||||||
|
* The queue send task is implemented by the prvQueueSendTask() function in
|
||||||
|
* this file. prvQueueSendTask() sits in a loop that causes it to repeatedly
|
||||||
|
* block for 200 (simulated as far as the scheduler is concerned, but in
|
||||||
|
* reality much longer - see notes above) milliseconds, before sending the
|
||||||
|
* value 100 to the queue that was created within main_blinky(). Once the
|
||||||
|
* value is sent, the task loops back around to block for another 200
|
||||||
|
* (simulated) milliseconds.
|
||||||
|
*
|
||||||
|
* The Queue Receive Task:
|
||||||
|
* The queue receive task is implemented by the prvQueueReceiveTask() function
|
||||||
|
* in this file. prvQueueReceiveTask() sits in a loop where it repeatedly
|
||||||
|
* blocks on attempts to read data from the queue that was created within
|
||||||
|
* main_blinky(). When data is received, the task checks the value of the
|
||||||
|
* data, and if the value equals the expected 100, outputs a message. The
|
||||||
|
* 'block time' parameter passed to the queue receive function specifies that
|
||||||
|
* the task should be held in the Blocked state indefinitely to wait for data
|
||||||
|
* to be available on the queue. The queue receive task will only leave the
|
||||||
|
* Blocked state when the queue send task writes to the queue. As the queue
|
||||||
|
* send task writes to the queue every 200 (simulated - see notes above)
|
||||||
|
* milliseconds, the queue receive task leaves the Blocked state every 200
|
||||||
|
* milliseconds, and therefore outputs a message every 200 milliseconds.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/* Standard includes. */
|
||||||
|
#include <stdio.h>
|
||||||
|
|
||||||
|
/* Kernel includes. */
|
||||||
|
#include "FreeRTOS.h"
|
||||||
|
#include "task.h"
|
||||||
|
#include "semphr.h"
|
||||||
|
|
||||||
|
/* Priorities at which the tasks are created. */
|
||||||
|
#define mainQUEUE_RECEIVE_TASK_PRIORITY ( tskIDLE_PRIORITY + 2 )
|
||||||
|
#define mainQUEUE_SEND_TASK_PRIORITY ( tskIDLE_PRIORITY + 1 )
|
||||||
|
|
||||||
|
/* The rate at which data is sent to the queue. The 200ms value is converted
|
||||||
|
to ticks using the portTICK_RATE_MS constant. */
|
||||||
|
#define mainQUEUE_SEND_FREQUENCY_MS ( 200 / portTICK_RATE_MS )
|
||||||
|
|
||||||
|
/* The number of items the queue can hold. This is 1 as the receive task
|
||||||
|
will remove items as they are added, meaning the send task should always find
|
||||||
|
the queue empty. */
|
||||||
|
#define mainQUEUE_LENGTH ( 1 )
|
||||||
|
|
||||||
|
/* Values passed to the two tasks just to check the task parameter
|
||||||
|
functionality. */
|
||||||
|
#define mainQUEUE_SEND_PARAMETER ( 0x1111UL )
|
||||||
|
#define mainQUEUE_RECEIVE_PARAMETER ( 0x22UL )
|
||||||
|
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
/*
|
||||||
|
* The tasks as described in the comments at the top of this file.
|
||||||
|
*/
|
||||||
|
static void prvQueueReceiveTask( void *pvParameters );
|
||||||
|
static void prvQueueSendTask( void *pvParameters );
|
||||||
|
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
/* The queue used by both tasks. */
|
||||||
|
static xQueueHandle xQueue = NULL;
|
||||||
|
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
void main_blinky( void )
|
||||||
|
{
|
||||||
|
/* Create the queue. */
|
||||||
|
xQueue = xQueueCreate( mainQUEUE_LENGTH, sizeof( unsigned long ) );
|
||||||
|
|
||||||
|
if( xQueue != NULL )
|
||||||
|
{
|
||||||
|
/* Start the two tasks as described in the comments at the top of this
|
||||||
|
file. */
|
||||||
|
xTaskCreate( prvQueueReceiveTask, /* The function that implements the task. */
|
||||||
|
( signed char * ) "Rx", /* The text name assigned to the task - for debug only as it is not used by the kernel. */
|
||||||
|
configMINIMAL_STACK_SIZE, /* The size of the stack to allocate to the task. */
|
||||||
|
( void * ) mainQUEUE_RECEIVE_PARAMETER, /* The parameter passed to the task - just to check the functionality. */
|
||||||
|
mainQUEUE_RECEIVE_TASK_PRIORITY, /* The priority assigned to the task. */
|
||||||
|
NULL ); /* The task handle is not required, so NULL is passed. */
|
||||||
|
|
||||||
|
xTaskCreate( prvQueueSendTask, ( signed char * ) "TX", configMINIMAL_STACK_SIZE, ( void * ) mainQUEUE_SEND_PARAMETER, mainQUEUE_SEND_TASK_PRIORITY, NULL );
|
||||||
|
|
||||||
|
/* Start the tasks and timer running. */
|
||||||
|
vTaskStartScheduler();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* If all is well, the scheduler will now be running, and the following
|
||||||
|
line will never be reached. If the following line does execute, then
|
||||||
|
there was insufficient FreeRTOS heap memory available for the idle and/or
|
||||||
|
timer tasks to be created. See the memory management section on the
|
||||||
|
FreeRTOS web site for more details. */
|
||||||
|
for( ;; );
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
static void prvQueueSendTask( void *pvParameters )
|
||||||
|
{
|
||||||
|
portTickType xNextWakeTime;
|
||||||
|
const unsigned long ulValueToSend = 100UL;
|
||||||
|
|
||||||
|
/* Check the task parameter is as expected. */
|
||||||
|
configASSERT( ( ( unsigned long ) pvParameters ) == mainQUEUE_SEND_PARAMETER );
|
||||||
|
|
||||||
|
/* Initialise xNextWakeTime - this only needs to be done once. */
|
||||||
|
xNextWakeTime = xTaskGetTickCount();
|
||||||
|
|
||||||
|
for( ;; )
|
||||||
|
{
|
||||||
|
/* Place this task in the blocked state until it is time to run again.
|
||||||
|
The block time is specified in ticks, the constant used converts ticks
|
||||||
|
to ms. While in the Blocked state this task will not consume any CPU
|
||||||
|
time. */
|
||||||
|
vTaskDelayUntil( &xNextWakeTime, mainQUEUE_SEND_FREQUENCY_MS );
|
||||||
|
|
||||||
|
/* Send to the queue - causing the queue receive task to unblock and
|
||||||
|
toggle the LED. 0 is used as the block time so the sending operation
|
||||||
|
will not block - it shouldn't need to block as the queue should always
|
||||||
|
be empty at this point in the code. */
|
||||||
|
xQueueSend( xQueue, &ulValueToSend, 0U );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
static void prvQueueReceiveTask( void *pvParameters )
|
||||||
|
{
|
||||||
|
unsigned long ulReceivedValue;
|
||||||
|
|
||||||
|
/* Check the task parameter is as expected. */
|
||||||
|
configASSERT( ( ( unsigned long ) pvParameters ) == mainQUEUE_RECEIVE_PARAMETER );
|
||||||
|
|
||||||
|
for( ;; )
|
||||||
|
{
|
||||||
|
/* Wait until something arrives in the queue - this task will block
|
||||||
|
indefinitely provided INCLUDE_vTaskSuspend is set to 1 in
|
||||||
|
FreeRTOSConfig.h. */
|
||||||
|
xQueueReceive( xQueue, &ulReceivedValue, portMAX_DELAY );
|
||||||
|
|
||||||
|
/* To get here something must have been received from the queue, but
|
||||||
|
is it the expected value? If it is, toggle the LED. */
|
||||||
|
if( ulReceivedValue == 100UL )
|
||||||
|
{
|
||||||
|
/* Normally calling printf() from a task is not a good idea. Here
|
||||||
|
there is lots of stack space and only one task is using console IO
|
||||||
|
so it is ok. */
|
||||||
|
printf( "Message received\r\n" );
|
||||||
|
ulReceivedValue = 0U;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
466
FreeRTOS/Demo/WIN32-MSVC/main_full.c
Normal file
466
FreeRTOS/Demo/WIN32-MSVC/main_full.c
Normal file
|
|
@ -0,0 +1,466 @@
|
||||||
|
/*
|
||||||
|
FreeRTOS V7.4.2 - 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 it can 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.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/*
|
||||||
|
*******************************************************************************
|
||||||
|
* NOTE 1: The Win32 port is a simulation (or is that emulation?) only! Do not
|
||||||
|
* expect to get real time behaviour from the Win32 port or this demo
|
||||||
|
* application. It is provided as a convenient development and demonstration
|
||||||
|
* test bed only. This was tested using Windows XP on a dual core laptop.
|
||||||
|
*
|
||||||
|
* In this example, one simulated millisecond will take approximately 40ms to
|
||||||
|
* execute, and Windows will not be running the FreeRTOS simulator threads
|
||||||
|
* continuously, so the timing information in the FreeRTOS+Trace logs have no
|
||||||
|
* meaningful units. See the documentation page for the Windows simulator for
|
||||||
|
* an explanation of the slow timing:
|
||||||
|
* http://www.freertos.org/FreeRTOS-Windows-Simulator-Emulator-for-Visual-Studio-and-Eclipse-MingW.html
|
||||||
|
* - READ THE WEB DOCUMENTATION FOR THIS PORT FOR MORE INFORMATION ON USING IT -
|
||||||
|
*
|
||||||
|
* NOTE 2: 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 in main.c is used to select
|
||||||
|
* between the two. See the notes on using mainCREATE_SIMPLE_BLINKY_DEMO_ONLY
|
||||||
|
* in main.c. This file implements the comprehensive test and demo version.
|
||||||
|
*
|
||||||
|
* NOTE 3: This file only contains the source code that is specific to the
|
||||||
|
* basic demo. Generic functions, such FreeRTOS hook functions, are defined in
|
||||||
|
* main.c.
|
||||||
|
*******************************************************************************
|
||||||
|
*
|
||||||
|
* main() creates all the demo application tasks, then starts the scheduler.
|
||||||
|
* The web documentation provides more details of the standard demo application
|
||||||
|
* tasks, which provide no particular functionality but do provide a good
|
||||||
|
* example of how to use the FreeRTOS API.
|
||||||
|
*
|
||||||
|
* In addition to the standard demo tasks, the following tasks and tests are
|
||||||
|
* defined and/or created within this file:
|
||||||
|
*
|
||||||
|
* "Check" task - This only executes every five seconds but has a high priority
|
||||||
|
* to ensure it gets processor time. Its main function is to check that all the
|
||||||
|
* standard demo tasks are still operational. While no errors have been
|
||||||
|
* discovered the check task will print out "OK" and the current simulated tick
|
||||||
|
* time. If an error is discovered in the execution of a task then the check
|
||||||
|
* task will print out an appropriate error message.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
|
||||||
|
|
||||||
|
/* Standard includes. */
|
||||||
|
#include <stdio.h>
|
||||||
|
#include <stdlib.h>
|
||||||
|
|
||||||
|
/* Kernel includes. */
|
||||||
|
#include <FreeRTOS.h>
|
||||||
|
#include "task.h"
|
||||||
|
#include "queue.h"
|
||||||
|
#include "timers.h"
|
||||||
|
#include "semphr.h"
|
||||||
|
|
||||||
|
/* Standard demo includes. */
|
||||||
|
#include "BlockQ.h"
|
||||||
|
#include "integer.h"
|
||||||
|
#include "semtest.h"
|
||||||
|
#include "PollQ.h"
|
||||||
|
#include "GenQTest.h"
|
||||||
|
#include "QPeek.h"
|
||||||
|
#include "recmutex.h"
|
||||||
|
#include "flop.h"
|
||||||
|
#include "TimerDemo.h"
|
||||||
|
#include "countsem.h"
|
||||||
|
#include "death.h"
|
||||||
|
#include "dynamic.h"
|
||||||
|
#include "QueueSet.h"
|
||||||
|
#include "QueueOverwrite.h"
|
||||||
|
|
||||||
|
/* Priorities at which the tasks are created. */
|
||||||
|
#define mainCHECK_TASK_PRIORITY ( configMAX_PRIORITIES - 1 )
|
||||||
|
#define mainQUEUE_POLL_PRIORITY ( tskIDLE_PRIORITY + 1 )
|
||||||
|
#define mainSEM_TEST_PRIORITY ( tskIDLE_PRIORITY + 1 )
|
||||||
|
#define mainBLOCK_Q_PRIORITY ( tskIDLE_PRIORITY + 2 )
|
||||||
|
#define mainCREATOR_TASK_PRIORITY ( tskIDLE_PRIORITY + 3 )
|
||||||
|
#define mainFLASH_TASK_PRIORITY ( tskIDLE_PRIORITY + 1 )
|
||||||
|
#define mainuIP_TASK_PRIORITY ( tskIDLE_PRIORITY + 2 )
|
||||||
|
#define mainINTEGER_TASK_PRIORITY ( tskIDLE_PRIORITY )
|
||||||
|
#define mainGEN_QUEUE_TASK_PRIORITY ( tskIDLE_PRIORITY )
|
||||||
|
#define mainFLOP_TASK_PRIORITY ( tskIDLE_PRIORITY )
|
||||||
|
#define mainQUEUE_OVERWRITE_PRIORITY ( tskIDLE_PRIORITY )
|
||||||
|
|
||||||
|
#define mainTIMER_TEST_PERIOD ( 50 )
|
||||||
|
|
||||||
|
/* Task function prototypes. */
|
||||||
|
static void prvCheckTask( void *pvParameters );
|
||||||
|
|
||||||
|
/* A task that is created from the idle task to test the functionality of
|
||||||
|
eTaskStateGet(). */
|
||||||
|
static void prvTestTask( void *pvParameters );
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Called from the idle task hook function to demonstrate a few utility
|
||||||
|
* functions that are not demonstrated by any of the standard demo tasks.
|
||||||
|
*/
|
||||||
|
static void prvDemonstrateTaskStateAndHandleGetFunctions( void );
|
||||||
|
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
/* The variable into which error messages are latched. */
|
||||||
|
static char *pcStatusMessage = "OK";
|
||||||
|
|
||||||
|
/* This semaphore is created purely to test using the vSemaphoreDelete() and
|
||||||
|
semaphore tracing API functions. It has no other purpose. */
|
||||||
|
static xSemaphoreHandle xMutexToDelete = NULL;
|
||||||
|
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
int main_full( void )
|
||||||
|
{
|
||||||
|
/* Start the check task as described at the top of this file. */
|
||||||
|
xTaskCreate( prvCheckTask, ( signed char * ) "Check", configMINIMAL_STACK_SIZE, NULL, mainCHECK_TASK_PRIORITY, NULL );
|
||||||
|
|
||||||
|
/* Create the standard demo tasks. */
|
||||||
|
vStartBlockingQueueTasks( mainBLOCK_Q_PRIORITY );
|
||||||
|
vStartSemaphoreTasks( mainSEM_TEST_PRIORITY );
|
||||||
|
vStartPolledQueueTasks( mainQUEUE_POLL_PRIORITY );
|
||||||
|
vStartIntegerMathTasks( mainINTEGER_TASK_PRIORITY );
|
||||||
|
vStartGenericQueueTasks( mainGEN_QUEUE_TASK_PRIORITY );
|
||||||
|
vStartQueuePeekTasks();
|
||||||
|
vStartMathTasks( mainFLOP_TASK_PRIORITY );
|
||||||
|
vStartRecursiveMutexTasks();
|
||||||
|
vStartTimerDemoTask( mainTIMER_TEST_PERIOD );
|
||||||
|
vStartCountingSemaphoreTasks();
|
||||||
|
vStartDynamicPriorityTasks();
|
||||||
|
vStartQueueSetTasks();
|
||||||
|
vStartQueueOverwriteTask( mainQUEUE_OVERWRITE_PRIORITY );
|
||||||
|
|
||||||
|
/* The suicide tasks must be created last as they need to know how many
|
||||||
|
tasks were running prior to their creation. This then allows them to
|
||||||
|
ascertain whether or not the correct/expected number of tasks are running at
|
||||||
|
any given time. */
|
||||||
|
vCreateSuicidalTasks( mainCREATOR_TASK_PRIORITY );
|
||||||
|
|
||||||
|
/* Create the semaphore that will be deleted in the idle task hook. This
|
||||||
|
is done purely to test the use of vSemaphoreDelete(). */
|
||||||
|
xMutexToDelete = xSemaphoreCreateMutex();
|
||||||
|
|
||||||
|
/* Start the scheduler itself. */
|
||||||
|
vTaskStartScheduler();
|
||||||
|
|
||||||
|
/* Should never get here unless there was not enough heap space to create
|
||||||
|
the idle and other system tasks. */
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
static void prvCheckTask( void *pvParameters )
|
||||||
|
{
|
||||||
|
portTickType xNextWakeTime;
|
||||||
|
const portTickType xCycleFrequency = 1000 / portTICK_RATE_MS;
|
||||||
|
|
||||||
|
/* Just to remove compiler warning. */
|
||||||
|
( void ) pvParameters;
|
||||||
|
|
||||||
|
/* Initialise xNextWakeTime - this only needs to be done once. */
|
||||||
|
xNextWakeTime = xTaskGetTickCount();
|
||||||
|
|
||||||
|
for( ;; )
|
||||||
|
{
|
||||||
|
/* Place this task in the blocked state until it is time to run again. */
|
||||||
|
vTaskDelayUntil( &xNextWakeTime, xCycleFrequency );
|
||||||
|
|
||||||
|
/* Check the standard demo tasks are running without error. */
|
||||||
|
if( xAreTimerDemoTasksStillRunning( xCycleFrequency ) != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: TimerDemo";
|
||||||
|
}
|
||||||
|
else if( xAreIntegerMathsTaskStillRunning() != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: IntMath";
|
||||||
|
}
|
||||||
|
else if( xAreGenericQueueTasksStillRunning() != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: GenQueue";
|
||||||
|
}
|
||||||
|
else if( xAreQueuePeekTasksStillRunning() != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: QueuePeek";
|
||||||
|
}
|
||||||
|
else if( xAreBlockingQueuesStillRunning() != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: BlockQueue";
|
||||||
|
}
|
||||||
|
else if( xAreSemaphoreTasksStillRunning() != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: SemTest";
|
||||||
|
}
|
||||||
|
else if( xArePollingQueuesStillRunning() != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: PollQueue";
|
||||||
|
}
|
||||||
|
else if( xAreMathsTaskStillRunning() != pdPASS )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Flop";
|
||||||
|
}
|
||||||
|
else if( xAreRecursiveMutexTasksStillRunning() != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: RecMutex";
|
||||||
|
}
|
||||||
|
else if( xAreCountingSemaphoreTasksStillRunning() != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: CountSem";
|
||||||
|
}
|
||||||
|
else if( xIsCreateTaskStillRunning() != pdTRUE )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Death";
|
||||||
|
}
|
||||||
|
else if( xAreDynamicPriorityTasksStillRunning() != pdPASS )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Dynamic\r\n";
|
||||||
|
}
|
||||||
|
else if( xAreQueueSetTasksStillRunning() != pdPASS )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Queue set\r\n";
|
||||||
|
}
|
||||||
|
else if( xIsQueueOverwriteTaskStillRunning() != pdPASS )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Queue overwrite\r\n";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* This is the only task that uses stdout so its ok to call printf()
|
||||||
|
directly. */
|
||||||
|
printf( "%s - %d\r\n", pcStatusMessage, xTaskGetTickCount() );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
static void prvTestTask( void *pvParameters )
|
||||||
|
{
|
||||||
|
const unsigned long ulMSToSleep = 5;
|
||||||
|
|
||||||
|
/* Just to remove compiler warnings. */
|
||||||
|
( void ) pvParameters;
|
||||||
|
|
||||||
|
/* This task is just used to test the eTaskStateGet() function. It
|
||||||
|
does not have anything to do. */
|
||||||
|
for( ;; )
|
||||||
|
{
|
||||||
|
/* Sleep to reduce CPU load, but don't sleep indefinitely in case there are
|
||||||
|
tasks waiting to be terminated by the idle task. */
|
||||||
|
Sleep( ulMSToSleep );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
/* Called from vApplicationIdleHook(), which is defined in main.c. */
|
||||||
|
void vFullDemoIdleFunction( void )
|
||||||
|
{
|
||||||
|
const unsigned long ulMSToSleep = 15;
|
||||||
|
const unsigned char ucConstQueueNumber = 0xaaU;
|
||||||
|
void *pvAllocated;
|
||||||
|
|
||||||
|
/* These three functions are only meant for use by trace code, and not for
|
||||||
|
direct use from application code, hence their prototypes are not in queue.h. */
|
||||||
|
extern void vQueueSetQueueNumber( xQueueHandle pxQueue, unsigned char ucQueueNumber );
|
||||||
|
extern unsigned char ucQueueGetQueueNumber( xQueueHandle pxQueue );
|
||||||
|
extern unsigned char ucQueueGetQueueType( xQueueHandle pxQueue );
|
||||||
|
extern void vTaskSetTaskNumber( xTaskHandle xTask, unsigned portBASE_TYPE uxHandle );
|
||||||
|
extern unsigned portBASE_TYPE uxTaskGetTaskNumber( xTaskHandle xTask );
|
||||||
|
|
||||||
|
/* Sleep to reduce CPU load, but don't sleep indefinitely in case there are
|
||||||
|
tasks waiting to be terminated by the idle task. */
|
||||||
|
Sleep( ulMSToSleep );
|
||||||
|
|
||||||
|
/* Demonstrate a few utility functions that are not demonstrated by any of
|
||||||
|
the standard demo tasks. */
|
||||||
|
prvDemonstrateTaskStateAndHandleGetFunctions();
|
||||||
|
|
||||||
|
/* If xMutexToDelete has not already been deleted, then delete it now.
|
||||||
|
This is done purely to demonstrate the use of, and test, the
|
||||||
|
vSemaphoreDelete() macro. Care must be taken not to delete a semaphore
|
||||||
|
that has tasks blocked on it. */
|
||||||
|
if( xMutexToDelete != NULL )
|
||||||
|
{
|
||||||
|
/* Before deleting the semaphore, test the function used to set its
|
||||||
|
number. This would normally only be done from trace software, rather
|
||||||
|
than application code. */
|
||||||
|
vQueueSetQueueNumber( xMutexToDelete, ucConstQueueNumber );
|
||||||
|
|
||||||
|
/* Before deleting the semaphore, test the functions used to get its
|
||||||
|
type and number. Again, these would normally only be done from trace
|
||||||
|
software, rather than application code. */
|
||||||
|
configASSERT( ucQueueGetQueueNumber( xMutexToDelete ) == ucConstQueueNumber );
|
||||||
|
configASSERT( ucQueueGetQueueType( xMutexToDelete ) == queueQUEUE_TYPE_MUTEX );
|
||||||
|
vSemaphoreDelete( xMutexToDelete );
|
||||||
|
xMutexToDelete = NULL;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Exercise heap_4 a bit. The malloc failed hook will trap failed
|
||||||
|
allocations so there is no need to test here. */
|
||||||
|
pvAllocated = pvPortMalloc( ( rand() % 100 ) + 1 );
|
||||||
|
vPortFree( pvAllocated );
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
/* Called by vApplicationTickHook(), which is defined in main.c. */
|
||||||
|
void vFullDemoTickHookFunction( void )
|
||||||
|
{
|
||||||
|
/* Call the periodic timer test, which tests the timer API functions that
|
||||||
|
can be called from an ISR. */
|
||||||
|
vTimerPeriodicISRTests();
|
||||||
|
|
||||||
|
/* Call the periodic queue overwrite from ISR demo. */
|
||||||
|
vQueueOverwritePeriodicISRDemo();
|
||||||
|
|
||||||
|
/* Write to a queue that is in use as part of the queue set demo to
|
||||||
|
demonstrate using queue sets from an ISR. */
|
||||||
|
vQueueSetAccessQueueSetFromISR();
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
static void prvDemonstrateTaskStateAndHandleGetFunctions( void )
|
||||||
|
{
|
||||||
|
xTaskHandle xIdleTaskHandle, xTimerTaskHandle;
|
||||||
|
const unsigned char ucConstTaskNumber = 0x55U;
|
||||||
|
signed char *pcTaskName;
|
||||||
|
static portBASE_TYPE xPerformedOneShotTests = pdFALSE;
|
||||||
|
xTaskHandle xTestTask;
|
||||||
|
|
||||||
|
/* Demonstrate the use of the xTimerGetTimerDaemonTaskHandle() and
|
||||||
|
xTaskGetIdleTaskHandle() functions. Also try using the function that sets
|
||||||
|
the task number. */
|
||||||
|
xIdleTaskHandle = xTaskGetIdleTaskHandle();
|
||||||
|
xTimerTaskHandle = xTimerGetTimerDaemonTaskHandle();
|
||||||
|
vTaskSetTaskNumber( xIdleTaskHandle, ( unsigned long ) ucConstTaskNumber );
|
||||||
|
configASSERT( uxTaskGetTaskNumber( xIdleTaskHandle ) == ucConstTaskNumber );
|
||||||
|
|
||||||
|
/* This is the idle hook, so the current task handle should equal the
|
||||||
|
returned idle task handle. */
|
||||||
|
if( xTaskGetCurrentTaskHandle() != xIdleTaskHandle )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Returned idle task handle was incorrect";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Check the timer task handle was returned correctly. */
|
||||||
|
pcTaskName = pcTaskGetTaskName( xTimerTaskHandle );
|
||||||
|
if( strcmp( pcTaskName, "Tmr Svc" ) != 0 )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Returned timer task handle was incorrect";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* This task is running, make sure it's state is returned as running. */
|
||||||
|
if( eTaskStateGet( xIdleTaskHandle ) != eRunning )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Returned idle task state was incorrect";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* If this task is running, then the timer task must be blocked. */
|
||||||
|
if( eTaskStateGet( xTimerTaskHandle ) != eBlocked )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Returned timer task state was incorrect";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Other tests that should only be performed once follow. The test task
|
||||||
|
is not created on each iteration because to do so would cause the death
|
||||||
|
task to report an error (too many tasks running). */
|
||||||
|
if( xPerformedOneShotTests == pdFALSE )
|
||||||
|
{
|
||||||
|
/* Don't run this part of the test again. */
|
||||||
|
xPerformedOneShotTests = pdTRUE;
|
||||||
|
|
||||||
|
/* Create a test task to use to test other eTaskStateGet() return values. */
|
||||||
|
if( xTaskCreate( prvTestTask, "Test", configMINIMAL_STACK_SIZE, NULL, tskIDLE_PRIORITY, &xTestTask ) == pdPASS )
|
||||||
|
{
|
||||||
|
/* If this task is running, the test task must be in the ready state. */
|
||||||
|
if( eTaskStateGet( xTestTask ) != eReady )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Returned test task state was incorrect 1";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Now suspend the test task and check its state is reported correctly. */
|
||||||
|
vTaskSuspend( xTestTask );
|
||||||
|
if( eTaskStateGet( xTestTask ) != eSuspended )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Returned test task state was incorrect 2";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Now delete the task and check its state is reported correctly. */
|
||||||
|
vTaskDelete( xTestTask );
|
||||||
|
if( eTaskStateGet( xTestTask ) != eDeleted )
|
||||||
|
{
|
||||||
|
pcStatusMessage = "Error: Returned test task state was incorrect 3";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/*-----------------------------------------------------------*/
|
||||||
|
|
||||||
|
|
||||||
Loading…
Reference in a new issue