death.c File Reference

#include <stdlib.h>
#include "FreeRTOS.h"
#include "task.h"
#include "death.h"

Go to the source code of this file.

Defines
#define	deathSTACK_SIZE   ( configMINIMAL_STACK_SIZE + 60 )
Functions
static	portTASK_FUNCTION (vCreateTasks, pvParameters)
static	portTASK_FUNCTION (vSuicidalTask, pvParameters)
static	portTASK_FUNCTION_PROTO (vSuicidalTask, pvParameters)
static	portTASK_FUNCTION_PROTO (vCreateTasks, pvParameters)
void	vCreateSuicidalTasks (unsigned portBASE_TYPE uxPriority)
portBASE_TYPE	xIsCreateTaskStillRunning (void)
Variables
static volatile unsigned short	usCreationCount = 0
static const unsigned portBASE_TYPE	uxMaxNumberOfExtraTasksRunning = 2
static volatile unsigned portBASE_TYPE	uxTasksRunningAtStart = 0
xTaskHandle	xCreatedTask

---

Define Documentation

#define deathSTACK_SIZE   ( configMINIMAL_STACK_SIZE + 60 )

Definition at line 96 of file death.c.

Referenced by vCreateSuicidalTasks().

---

Function Documentation

static portTASK_FUNCTION	(	vCreateTasks	,
		pvParameters
	)			[static]

Definition at line 190 of file death.c.

References configMINIMAL_STACK_SIZE, portBASE_TYPE, portTICK_RATE_MS, usCreationCount, vPortFree(), vTaskDelay(), xCreatedTask, and xTaskCreate.

{
const portTickType xDelay = ( portTickType ) 1000 / portTICK_RATE_MS;
unsigned portBASE_TYPE uxPriority;

    uxPriority = *( unsigned portBASE_TYPE * ) pvParameters;
    vPortFree( pvParameters );

    for( ;; )
    {
        /* Just loop round, delaying then creating the four suicidal tasks. */
        vTaskDelay( xDelay );

        xCreatedTask = NULL;

        xTaskCreate( vSuicidalTask, ( signed char * ) "SUICID1", configMINIMAL_STACK_SIZE, NULL, uxPriority, &xCreatedTask );
        xTaskCreate( vSuicidalTask, ( signed char * ) "SUICID2", configMINIMAL_STACK_SIZE, &xCreatedTask, uxPriority, NULL );

        ++usCreationCount;
    }
}

static portTASK_FUNCTION	(	vSuicidalTask	,
		pvParameters
	)			[static]

Definition at line 149 of file death.c.

References portTICK_RATE_MS, vTaskDelay(), and vTaskDelete().

{
volatile long l1, l2;
xTaskHandle xTaskToKill;
const portTickType xDelay = ( portTickType ) 200 / portTICK_RATE_MS;

    if( pvParameters != NULL )
    {
        /* This task is periodically created four times.  Two created tasks are
        passed a handle to the other task so it can kill it before killing itself.
        The other task is passed in null. */
        xTaskToKill = *( xTaskHandle* )pvParameters;
    }
    else
    {
        xTaskToKill = NULL;
    }

    for( ;; )
    {
        /* Do something random just to use some stack and registers. */
        l1 = 2;
        l2 = 89;
        l2 *= l1;
        vTaskDelay( xDelay );

        if( xTaskToKill != NULL )
        {
            /* Make sure the other task has a go before we delete it. */
            vTaskDelay( ( portTickType ) 0 );

            /* Kill the other task that was created by vCreateTasks(). */
            vTaskDelete( xTaskToKill );

            /* Kill ourselves. */
            vTaskDelete( NULL );
        }
    }
}/*lint !e818 !e550 Function prototype must be as per standard for task functions. */

static portTASK_FUNCTION_PROTO	(	vSuicidalTask	,
		pvParameters
	)			[static]

static portTASK_FUNCTION_PROTO	(	vCreateTasks	,
		pvParameters
	)			[static]

void vCreateSuicidalTasks

(

unsigned portBASE_TYPE

uxPriority

)

Definition at line 125 of file death.c.

References deathSTACK_SIZE, portBASE_TYPE, pvPortMalloc(), uxTaskGetNumberOfTasks(), uxTasksRunningAtStart, and xTaskCreate.

Referenced by vErrorChecks().

{
unsigned portBASE_TYPE *puxPriority;

    /* Create the Creator tasks - passing in as a parameter the priority at which
    the suicidal tasks should be created. */
    puxPriority = ( unsigned portBASE_TYPE * ) pvPortMalloc( sizeof( unsigned portBASE_TYPE ) );
    *puxPriority = uxPriority;

    xTaskCreate( vCreateTasks, ( signed char * ) "CREATOR", deathSTACK_SIZE, ( void * ) puxPriority, uxPriority, NULL );

    /* Record the number of tasks that are running now so we know if any of the
    suicidal tasks have failed to be killed. */
    uxTasksRunningAtStart = ( unsigned portBASE_TYPE ) uxTaskGetNumberOfTasks();
    
    /* FreeRTOS.org versions before V3.0 started the idle-task as the very
    first task. The idle task was then already included in uxTasksRunningAtStart.
    From FreeRTOS V3.0 on, the idle task is started when the scheduler is
    started. Therefore the idle task is not yet accounted for. We correct
    this by increasing uxTasksRunningAtStart by 1. */
    uxTasksRunningAtStart++;
}

portBASE_TYPE xIsCreateTaskStillRunning

(

void

)

Definition at line 215 of file death.c.

References pdFALSE, pdTRUE, portBASE_TYPE, usCreationCount, uxMaxNumberOfExtraTasksRunning, uxTaskGetNumberOfTasks(), and uxTasksRunningAtStart.

Referenced by prvCheckOtherTasksAreStillRunning().

{
static unsigned short usLastCreationCount = 0xfff;
portBASE_TYPE xReturn = pdTRUE;
static unsigned portBASE_TYPE uxTasksRunningNow;

    if( usLastCreationCount == usCreationCount )
    {
        xReturn = pdFALSE;
    }
    else
    {
        usLastCreationCount = usCreationCount;
    }
    
    uxTasksRunningNow = ( unsigned portBASE_TYPE ) uxTaskGetNumberOfTasks();

    if( uxTasksRunningNow < uxTasksRunningAtStart )
    {
        xReturn = pdFALSE;
    }
    else if( ( uxTasksRunningNow - uxTasksRunningAtStart ) > uxMaxNumberOfExtraTasksRunning )
    {
        xReturn = pdFALSE;
    }
    else
    {
        /* Everything is okay. */
    }

    return xReturn;
}

---

Variable Documentation

volatile unsigned short usCreationCount = 0 [static]

Definition at line 107 of file death.c.

Referenced by portTASK_FUNCTION(), and xIsCreateTaskStillRunning().

const unsigned portBASE_TYPE uxMaxNumberOfExtraTasksRunning = 2 [static]

Definition at line 117 of file death.c.

Referenced by xIsCreateTaskStillRunning().

volatile unsigned portBASE_TYPE uxTasksRunningAtStart = 0 [static]

Definition at line 112 of file death.c.

Referenced by vCreateSuicidalTasks(), and xIsCreateTaskStillRunning().

xTaskHandle xCreatedTask

Definition at line 121 of file death.c.

Referenced by portTASK_FUNCTION(), and vErrorChecks().