You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
428 lines
14 KiB
C
428 lines
14 KiB
C
/*
|
|
FreeRTOS.org V4.1.2 - Copyright (C) 2003-2006 Richard Barry.
|
|
|
|
This file is part of the FreeRTOS.org distribution.
|
|
|
|
FreeRTOS.org 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.org 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.org; 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.org, 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"
|
|
#include "blocktim.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 = configUSE_PREEMPTION;
|
|
|
|
/* 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 );
|
|
vCreateBlockTimeTasks();
|
|
|
|
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( xAreBlockTimeTestTasksStillRunning() != pdTRUE )
|
|
{
|
|
vDisplayMessage( "Error in block time test tasks!\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();
|
|
}
|
|
/*-----------------------------------------------------------*/
|
|
|