mirror of
https://github.com/FreeRTOS/FreeRTOS-Kernel.git
synced 2025-08-18 09:08:33 -04:00
First version under SVN is V4.0.1
This commit is contained in:
Richard Barry
parent
243393860c
commit
b6df57c7e3
918 changed files with 269038 additions and 0 deletions
419
Demo/PC/main.c
Normal file
419
Demo/PC/main.c
Normal file
|
|
@ -0,0 +1,419 @@
|
|||
/*
|
||||
FreeRTOS V4.0.1 - Copyright (C) 2003-2006 Richard Barry.
|
||||
|
||||
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 as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
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
|
||||
along with FreeRTOS; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||
|
||||
A special exception to the GPL can be applied should you wish to distribute
|
||||
a combined work that includes FreeRTOS, without being obliged to provide
|
||||
the source code for any proprietary components. See the licensing section
|
||||
of http://www.FreeRTOS.org for full details of how and when the exception
|
||||
can be applied.
|
||||
|
||||
***************************************************************************
|
||||
See http://www.FreeRTOS.org for documentation, latest information, license
|
||||
and contact details. Please ensure to read the configuration and relevant
|
||||
port sections of the online documentation.
|
||||
***************************************************************************
|
||||
*/
|
||||
|
||||
/**
|
||||
* Creates all the demo application tasks and co-routines, then starts the
|
||||
* scheduler.
|
||||
*
|
||||
* Main. c also creates a task called "Print". This only executes every
|
||||
* five seconds but has the highest priority so is guaranteed to get
|
||||
* processor time. Its main function is to check that all the other tasks
|
||||
* are still operational. Nearly all the tasks in the demo application
|
||||
* maintain a unique count that is incremented each time the task successfully
|
||||
* completes its function. Should any error occur within the task the count is
|
||||
* permanently halted. The print task checks the count of each task to ensure
|
||||
* it has changed since the last time the print task executed. If any count is
|
||||
* found not to have changed the print task displays an appropriate message.
|
||||
* If all the tasks are still incrementing their unique counts the print task
|
||||
* displays an "OK" message.
|
||||
*
|
||||
* The LED flash tasks do not maintain a count as they already provide visual
|
||||
* feedback of their status.
|
||||
*
|
||||
* The print task blocks on the queue into which messages that require
|
||||
* displaying are posted. It will therefore only block for the full 5 seconds
|
||||
* if no messages are posted onto the queue.
|
||||
*
|
||||
* Main. c also provides a demonstration of how the trace visualisation utility
|
||||
* can be used, and how the scheduler can be stopped.
|
||||
*
|
||||
* \page MainC main.c
|
||||
* \ingroup DemoFiles
|
||||
* <HR>
|
||||
*/
|
||||
|
||||
/*
|
||||
Changes from V1.00:
|
||||
|
||||
+ Prevent the call to kbhit() for debug builds as the debugger seems to
|
||||
have problems stepping over the call.
|
||||
|
||||
Changes from V1.2.3
|
||||
|
||||
+ The integer and comtest tasks are now used when the cooperative scheduler
|
||||
is being used. Previously they were only used with the preemptive
|
||||
scheduler.
|
||||
|
||||
Changes from V1.2.6
|
||||
|
||||
+ Create new tasks as defined by the new demo application file dynamic.c.
|
||||
|
||||
Changes from V2.0.0
|
||||
|
||||
+ Delay periods are now specified using variables and constants of
|
||||
portTickType rather than unsigned portLONG.
|
||||
|
||||
Changes from V3.1.1
|
||||
|
||||
+ The tasks defined in the new file "events.c" are now created and
|
||||
monitored for errors.
|
||||
|
||||
Changes from V3.2.4
|
||||
|
||||
+ Now includes the flash co-routine demo rather than the flash task demo.
|
||||
This is to demonstrate the co-routine functionality.
|
||||
*/
|
||||
|
||||
#include <stdlib.h>
|
||||
#include <conio.h>
|
||||
#include "FreeRTOS.h"
|
||||
#include "task.h"
|
||||
#include "croutine.h"
|
||||
#include "partest.h"
|
||||
#include "serial.h"
|
||||
|
||||
/* Demo file headers. */
|
||||
#include "BlockQ.h"
|
||||
#include "PollQ.h"
|
||||
#include "death.h"
|
||||
#include "crflash.h"
|
||||
#include "flop.h"
|
||||
#include "print.h"
|
||||
#include "comtest.h"
|
||||
#include "fileio.h"
|
||||
#include "semtest.h"
|
||||
#include "integer.h"
|
||||
#include "dynamic.h"
|
||||
#include "mevents.h"
|
||||
#include "crhook.h"
|
||||
|
||||
/* Priority definitions for the tasks in the demo application. */
|
||||
#define mainLED_TASK_PRIORITY ( tskIDLE_PRIORITY + 1 )
|
||||
#define mainCREATOR_TASK_PRIORITY ( tskIDLE_PRIORITY + 3 )
|
||||
#define mainPRINT_TASK_PRIORITY ( tskIDLE_PRIORITY + 4 )
|
||||
#define mainQUEUE_POLL_PRIORITY ( tskIDLE_PRIORITY + 2 )
|
||||
#define mainQUEUE_BLOCK_PRIORITY ( tskIDLE_PRIORITY + 3 )
|
||||
#define mainCOM_TEST_PRIORITY ( tskIDLE_PRIORITY + 2 )
|
||||
#define mainSEMAPHORE_TASK_PRIORITY ( tskIDLE_PRIORITY + 1 )
|
||||
|
||||
#define mainPRINT_STACK_SIZE ( ( unsigned portSHORT ) 512 )
|
||||
#define mainDEBUG_LOG_BUFFER_SIZE ( ( unsigned portSHORT ) 20480 )
|
||||
|
||||
/* The number of flash co-routines to create. */
|
||||
#define mainNUM_FLASH_CO_ROUTINES ( 8 )
|
||||
|
||||
/* Task function for the "Print" task as described at the top of the file. */
|
||||
static void vErrorChecks( void *pvParameters );
|
||||
|
||||
/* Function that checks the unique count of all the other tasks as described at
|
||||
the top of the file. */
|
||||
static void prvCheckOtherTasksAreStillRunning( void );
|
||||
|
||||
/* Key presses can be used to start/stop the trace visualisation utility or stop
|
||||
the scheduler. */
|
||||
static void prvCheckForKeyPresses( void );
|
||||
|
||||
/* Buffer used by the trace visualisation utility so only needed if the trace
|
||||
being used. */
|
||||
#if configUSE_TRACE_FACILITY == 1
|
||||
static portCHAR pcWriteBuffer[ mainDEBUG_LOG_BUFFER_SIZE ];
|
||||
#endif
|
||||
|
||||
/* Constant definition used to turn on/off the pre-emptive scheduler. */
|
||||
static const portSHORT sUsingPreemption = pdTRUE;
|
||||
|
||||
/* Start the math tasks appropriate to the build. The Borland port does
|
||||
not yet support floating point so uses the integer equivalent. */
|
||||
static void prvStartMathTasks( void );
|
||||
|
||||
/* Check which ever tasks are relevant to this build. */
|
||||
static portBASE_TYPE prvCheckMathTasksAreStillRunning( void );
|
||||
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
portSHORT main( void )
|
||||
{
|
||||
/* Initialise hardware and utilities. */
|
||||
vParTestInitialise();
|
||||
vPrintInitialise();
|
||||
|
||||
/* CREATE ALL THE DEMO APPLICATION TASKS. */
|
||||
prvStartMathTasks();
|
||||
vStartComTestTasks( mainCOM_TEST_PRIORITY, serCOM1, ser115200 );
|
||||
vStartPolledQueueTasks( mainQUEUE_POLL_PRIORITY );
|
||||
vStartBlockingQueueTasks( mainQUEUE_BLOCK_PRIORITY );
|
||||
|
||||
vStartSemaphoreTasks( mainSEMAPHORE_TASK_PRIORITY );
|
||||
vStartDynamicPriorityTasks();
|
||||
vStartMultiEventTasks();
|
||||
|
||||
/* Create the "Print" task as described at the top of the file. */
|
||||
xTaskCreate( vErrorChecks, "Print", mainPRINT_STACK_SIZE, NULL, mainPRINT_TASK_PRIORITY, NULL );
|
||||
|
||||
/* This task has to be created last as it keeps account of the number of tasks
|
||||
it expects to see running. */
|
||||
vCreateSuicidalTasks( mainCREATOR_TASK_PRIORITY );
|
||||
|
||||
/* Create the co-routines that flash the LED's. */
|
||||
vStartFlashCoRoutines( mainNUM_FLASH_CO_ROUTINES );
|
||||
|
||||
/* Create the co-routines that communicate with the tick hook. */
|
||||
vStartHookCoRoutines();
|
||||
|
||||
/* Set the scheduler running. This function will not return unless a task
|
||||
calls vTaskEndScheduler(). */
|
||||
vTaskStartScheduler();
|
||||
|
||||
return 1;
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
static void vErrorChecks( void *pvParameters )
|
||||
{
|
||||
portTickType xExpectedWakeTime;
|
||||
const portTickType xPrintRate = ( portTickType ) 5000 / portTICK_RATE_MS;
|
||||
const portLONG lMaxAllowableTimeDifference = ( portLONG ) 0;
|
||||
portTickType xWakeTime;
|
||||
portLONG lTimeDifference;
|
||||
const portCHAR *pcReceivedMessage;
|
||||
const portCHAR * const pcTaskBlockedTooLongMsg = "Print task blocked too long!\r\n";
|
||||
|
||||
( void ) pvParameters;
|
||||
|
||||
/* Loop continuously, blocking, then checking all the other tasks are still
|
||||
running, before blocking once again. This task blocks on the queue of
|
||||
messages that require displaying so will wake either by its time out expiring,
|
||||
or a message becoming available. */
|
||||
for( ;; )
|
||||
{
|
||||
/* Calculate the time we will unblock if no messages are received
|
||||
on the queue. This is used to check that we have not blocked for too long. */
|
||||
xExpectedWakeTime = xTaskGetTickCount();
|
||||
xExpectedWakeTime += xPrintRate;
|
||||
|
||||
/* Block waiting for either a time out or a message to be posted that
|
||||
required displaying. */
|
||||
pcReceivedMessage = pcPrintGetNextMessage( xPrintRate );
|
||||
|
||||
/* Was a message received? */
|
||||
if( pcReceivedMessage == NULL )
|
||||
{
|
||||
/* A message was not received so we timed out, did we unblock at the
|
||||
expected time? */
|
||||
xWakeTime = xTaskGetTickCount();
|
||||
|
||||
/* Calculate the difference between the time we unblocked and the
|
||||
time we should have unblocked. */
|
||||
if( xWakeTime > xExpectedWakeTime )
|
||||
{
|
||||
lTimeDifference = ( portLONG ) ( xWakeTime - xExpectedWakeTime );
|
||||
}
|
||||
else
|
||||
{
|
||||
lTimeDifference = ( portLONG ) ( xExpectedWakeTime - xWakeTime );
|
||||
}
|
||||
|
||||
if( lTimeDifference > lMaxAllowableTimeDifference )
|
||||
{
|
||||
/* We blocked too long - create a message that will get
|
||||
printed out the next time around. If we are not using
|
||||
preemption then we won't expect the timing to be so
|
||||
accurate. */
|
||||
if( sUsingPreemption == pdTRUE )
|
||||
{
|
||||
vPrintDisplayMessage( &pcTaskBlockedTooLongMsg );
|
||||
}
|
||||
}
|
||||
|
||||
/* Check the other tasks are still running, just in case. */
|
||||
prvCheckOtherTasksAreStillRunning();
|
||||
}
|
||||
else
|
||||
{
|
||||
/* We unblocked due to a message becoming available. Send the message
|
||||
for printing. */
|
||||
vDisplayMessage( pcReceivedMessage );
|
||||
}
|
||||
|
||||
/* Key presses are used to invoke the trace visualisation utility, or end
|
||||
the program. */
|
||||
prvCheckForKeyPresses();
|
||||
}
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
static void prvCheckForKeyPresses( void )
|
||||
{
|
||||
portSHORT sIn;
|
||||
|
||||
taskENTER_CRITICAL();
|
||||
#ifdef DEBUG_BUILD
|
||||
/* kbhit can be used in .exe's that are executed from the command
|
||||
line, but not if executed through the debugger. */
|
||||
sIn = 0;
|
||||
#else
|
||||
sIn = kbhit();
|
||||
#endif
|
||||
taskEXIT_CRITICAL();
|
||||
|
||||
if( sIn )
|
||||
{
|
||||
/* Key presses can be used to start/stop the trace utility, or end the
|
||||
program. */
|
||||
sIn = getch();
|
||||
switch( sIn )
|
||||
{
|
||||
/* Only define keys for turning on and off the trace if the trace
|
||||
is being used. */
|
||||
#if configUSE_TRACE_FACILITY == 1
|
||||
case 't' : vTaskList( pcWriteBuffer );
|
||||
vWriteMessageToDisk( pcWriteBuffer );
|
||||
break;
|
||||
case 's' : vTaskStartTrace( pcWriteBuffer, mainDEBUG_LOG_BUFFER_SIZE );
|
||||
break;
|
||||
|
||||
case 'e' : {
|
||||
unsigned portLONG ulBufferLength;
|
||||
ulBufferLength = ulTaskEndTrace();
|
||||
vWriteBufferToDisk( pcWriteBuffer, ulBufferLength );
|
||||
}
|
||||
break;
|
||||
#endif
|
||||
|
||||
default : vTaskEndScheduler();
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
static void prvCheckOtherTasksAreStillRunning( void )
|
||||
{
|
||||
static portSHORT sErrorHasOccurred = pdFALSE;
|
||||
|
||||
if( prvCheckMathTasksAreStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Maths task count unchanged!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( xAreComTestTasksStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Com test count unchanged!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( xAreBlockingQueuesStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Blocking queues count unchanged!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( xArePollingQueuesStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Polling queue count unchanged!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( xIsCreateTaskStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Incorrect number of tasks running!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( xAreSemaphoreTasksStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Semaphore take count unchanged!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( xAreDynamicPriorityTasksStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Dynamic priority count unchanged!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( xAreMultiEventTasksStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Error in multi events tasks!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( xAreFlashCoRoutinesStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Error in co-routine flash tasks!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( xAreHookCoRoutinesStillRunning() != pdTRUE )
|
||||
{
|
||||
vDisplayMessage( "Error in tick hook to co-routine communications!\r\n" );
|
||||
sErrorHasOccurred = pdTRUE;
|
||||
}
|
||||
|
||||
if( sErrorHasOccurred == pdFALSE )
|
||||
{
|
||||
vDisplayMessage( "OK " );
|
||||
}
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
static void prvStartMathTasks( void )
|
||||
{
|
||||
#ifdef BCC_INDUSTRIAL_PC_PORT
|
||||
/* The Borland project does not yet support floating point. */
|
||||
vStartIntegerMathTasks( tskIDLE_PRIORITY );
|
||||
#else
|
||||
vStartMathTasks( tskIDLE_PRIORITY );
|
||||
#endif
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
static portBASE_TYPE prvCheckMathTasksAreStillRunning( void )
|
||||
{
|
||||
#ifdef BCC_INDUSTRIAL_PC_PORT
|
||||
/* The Borland project does not yet support floating point. */
|
||||
return xAreIntegerMathsTaskStillRunning();
|
||||
#else
|
||||
return xAreMathsTaskStillRunning();
|
||||
#endif
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
void vApplicationIdleHook( void )
|
||||
{
|
||||
/* The co-routines are executed in the idle task using the idle task
|
||||
hook. */
|
||||
vCoRoutineSchedule();
|
||||
}
|
||||
/*-----------------------------------------------------------*/
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue