#include <stdlib.h>
#include <string.h>
#include "FreeRTOS.h"
#include "task.h"
#include "timers.h"
#include "stack_macros.h"
#include <stdio.h>

Data Structures
struct	tskTaskControlBlock

Macros
#define	configIDLE_TASK_NAME "IDLE"

#define	MPU_WRAPPERS_INCLUDED_FROM_API_FILE

#define	portRESET_READY_PRIORITY(uxPriority, uxTopReadyPriority)

#define	prvAddTaskToReadyList(pxTCB)

#define	prvGetTCBFromHandle(pxHandle) ( ( ( pxHandle ) == NULL ) ? ( TCB_t * ) pxCurrentTCB : ( TCB_t * ) ( pxHandle ) )

#define	taskEVENT_LIST_ITEM_VALUE_IN_USE 0x80000000UL

#define	taskNOT_WAITING_NOTIFICATION ( ( uint8_t ) 0 )

#define	taskNOTIFICATION_RECEIVED ( ( uint8_t ) 2 )

#define	taskRECORD_READY_PRIORITY(uxPriority)

#define	taskRESET_READY_PRIORITY(uxPriority)

#define	taskSELECT_HIGHEST_PRIORITY_TASK()

#define	taskSWITCH_DELAYED_LISTS()

#define	taskWAITING_NOTIFICATION ( ( uint8_t ) 1 )

#define	taskYIELD_IF_USING_PREEMPTION()

#define	tskBLOCKED_CHAR ( 'B' )

#define	tskDELETED_CHAR ( 'D' )

#define	tskDYNAMICALLY_ALLOCATED_STACK_AND_TCB ( ( uint8_t ) 0 )

#define	tskREADY_CHAR ( 'R' )

#define	tskSET_NEW_STACKS_TO_KNOWN_VALUE 1

#define	tskSTACK_FILL_BYTE ( 0xa5U )

#define	tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE ( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) )

#define	tskSTATICALLY_ALLOCATED_STACK_AND_TCB ( ( uint8_t ) 2 )

#define	tskSTATICALLY_ALLOCATED_STACK_ONLY ( ( uint8_t ) 1 )

#define	tskSUSPENDED_CHAR ( 'S' )

Typedefs
typedef tskTCB	TCB_t

typedef struct tskTaskControlBlock	tskTCB

Functions
eTaskState	eTaskGetState (TaskHandle_t xTask)
	task. More...

char *	pcTaskGetName (TaskHandle_t xTaskToQuery)

static	portTASK_FUNCTION (prvIdleTask, pvParameters)

static void	prvAddCurrentTaskToDelayedList (TickType_t xTicksToWait, const BaseType_t xCanBlockIndefinitely)

static void	prvAddNewTaskToReadyList (TCB_t *pxNewTCB)

static void	prvCheckTasksWaitingTermination (void)

static void	prvInitialiseNewTask (TaskFunction_t pxTaskCode, const char const pcName, const uint32_t ulStackDepth, void const pvParameters, UBaseType_t uxPriority, TaskHandle_t const pxCreatedTask, TCB_t pxNewTCB, const MemoryRegion_t *const xRegions)

static void	prvInitialiseTaskLists (static void prvCheckTasksWaitingTermination void)

static void	prvInitialiseTaskLists (void)

static UBaseType_t	prvListTasksWithinSingleList (TaskStatus_t pxTaskStatusArray, List_t pxList, eTaskState eState)

static void	prvResetNextTaskUnblockTime (void)

static uint16_t	prvTaskCheckFreeStackSpace (const uint8_t *pucStackByte)

static BaseType_t	prvTaskIsTaskSuspended (const TaskHandle_t xTask) PRIVILEGED_FUNCTION
	Utility task that simply returns pdTRUE if the task referenced by xTask is currently in the Suspended state, or pdFALSE if the task referenced by xTask is in any other state. More...

static char *	prvWriteNameToBuffer (char pcBuffer, const char pcTaskName)

void *	pvTaskIncrementMutexHeldCount (void)

uint32_t	ulTaskNotifyTake (BaseType_t xClearCountOnExit, TickType_t xTicksToWait)

UBaseType_t	uxTaskGetNumberOfTasks (void)

UBaseType_t	uxTaskGetStackHighWaterMark (TaskHandle_t xTask)
	task.h More...

UBaseType_t	uxTaskGetSystemState (TaskStatus_t const pxTaskStatusArray, const UBaseType_t uxArraySize, uint32_t const pulTotalRunTime)
	configUSE_TRACE_FACILITY must be defined as 1 in FreeRTOSConfig.h for uxTaskGetSystemState() to be available. More...

UBaseType_t	uxTaskGetTaskNumber (TaskHandle_t xTask)

TickType_t	uxTaskResetEventItemValue (void)

void	vApplicationStackOverflowHook (TaskHandle_t xTask, char *pcTaskName)

void	vApplicationTickHook (void)
	This function is called by FreeRTOS each tick. More...

void	vTaskDelay (const TickType_t xTicksToDelay)

void	vTaskEndScheduler (void)

void	vTaskGetInfo (TaskHandle_t xTask, TaskStatus_t *pxTaskStatus, BaseType_t xGetFreeStackSpace, eTaskState eState)

void	vTaskInternalSetTimeOutState (TimeOut_t *const pxTimeOut)

void	vTaskList (char *pcWriteBuffer)

void	vTaskMissedYield (void)

void	vTaskNotifyGiveFromISR (TaskHandle_t xTaskToNotify, BaseType_t *pxHigherPriorityTaskWoken)

void	vTaskPlaceOnEventList (List_t *const pxEventList, const TickType_t xTicksToWait)

void	vTaskPlaceOnUnorderedEventList (List_t *pxEventList, const TickType_t xItemValue, const TickType_t xTicksToWait)

void	vTaskPriorityDisinheritAfterTimeout (TaskHandle_t const pxMutexHolder, UBaseType_t uxHighestPriorityWaitingTask)

void	vTaskPrioritySet (TaskHandle_t xTask, UBaseType_t uxNewPriority)

void	vTaskRemoveFromUnorderedEventList (ListItem_t *pxEventListItem, const TickType_t xItemValue)

void	vTaskResume (TaskHandle_t xTaskToResume)

void	vTaskSetTaskNumber (TaskHandle_t xTask, const UBaseType_t uxHandle)

void	vTaskSetTimeOutState (TimeOut_t *const pxTimeOut)

void	vTaskStartScheduler (void)

void	vTaskSuspend (TaskHandle_t xTaskToSuspend)

void	vTaskSuspendAll (void)

void	vTaskSwitchContext (void)

BaseType_t	xTaskCheckForTimeOut (TimeOut_t const pxTimeOut, TickType_t const pxTicksToWait)

BaseType_t	xTaskGenericNotify (TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, uint32_t *pulPreviousNotificationValue)

BaseType_t	xTaskGenericNotifyFromISR (TaskHandle_t xTaskToNotify, uint32_t ulValue, eNotifyAction eAction, uint32_t pulPreviousNotificationValue, BaseType_t pxHigherPriorityTaskWoken)

TaskHandle_t	xTaskGetCurrentTaskHandle (void)

TickType_t	xTaskGetTickCount (void)

TickType_t	xTaskGetTickCountFromISR (void)

BaseType_t	xTaskIncrementTick (void)

BaseType_t	xTaskNotifyStateClear (TaskHandle_t xTask)

BaseType_t	xTaskNotifyWait (uint32_t ulBitsToClearOnEntry, uint32_t ulBitsToClearOnExit, uint32_t *pulNotificationValue, TickType_t xTicksToWait)

BaseType_t	xTaskPriorityDisinherit (TaskHandle_t const pxMutexHolder)

BaseType_t	xTaskPriorityInherit (TaskHandle_t const pxMutexHolder)

BaseType_t	xTaskRemoveFromEventList (const List_t *const pxEventList)

BaseType_t	xTaskResumeAll (void)

BaseType_t	xTaskResumeFromISR (TaskHandle_t xTaskToResume)

Variables
PRIVILEGED_DATA TCB_t *volatile	pxCurrentTCB = NULL

static PRIVILEGED_DATA List_t *volatile	pxDelayedTaskList

static PRIVILEGED_DATA List_t *volatile	pxOverflowDelayedTaskList

static PRIVILEGED_DATA List_t	pxReadyTasksLists [configMAX_PRIORITIES]

static PRIVILEGED_DATA volatile UBaseType_t	uxCurrentNumberOfTasks = ( UBaseType_t ) 0U

static PRIVILEGED_DATA volatile UBaseType_t	uxPendedTicks = ( UBaseType_t ) 0U

static PRIVILEGED_DATA volatile UBaseType_t	uxSchedulerSuspended = ( UBaseType_t ) pdFALSE

static PRIVILEGED_DATA UBaseType_t	uxTaskNumber = ( UBaseType_t ) 0U

static PRIVILEGED_DATA volatile UBaseType_t	uxTopReadyPriority = tskIDLE_PRIORITY

static PRIVILEGED_DATA List_t	xDelayedTaskList1

static PRIVILEGED_DATA List_t	xDelayedTaskList2

static PRIVILEGED_DATA TaskHandle_t	xIdleTaskHandle = NULL

static PRIVILEGED_DATA volatile TickType_t	xNextTaskUnblockTime = ( TickType_t ) 0U

static PRIVILEGED_DATA volatile BaseType_t	xNumOfOverflows = ( BaseType_t ) 0

static PRIVILEGED_DATA List_t	xPendingReadyList

static PRIVILEGED_DATA volatile BaseType_t	xSchedulerRunning = pdFALSE

static PRIVILEGED_DATA List_t	xSuspendedTaskList

static PRIVILEGED_DATA volatile TickType_t	xTickCount = ( TickType_t ) configINITIAL_TICK_COUNT

static PRIVILEGED_DATA volatile BaseType_t	xYieldPending = pdFALSE

#define configIDLE_TASK_NAME "IDLE"

Referenced by vTaskStartScheduler().

#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE

#define portRESET_READY_PRIORITY	(	uxPriority,
		uxTopReadyPriority
	)

Referenced by prvAddCurrentTaskToDelayedList(), and vTaskPrioritySet().

#define prvAddTaskToReadyList ( pxTCB )

Value:

traceMOVED_TASK_TO_READY_STATE( pxTCB );                                                        \
	taskRECORD_READY_PRIORITY( ( pxTCB )->uxPriority );                                                \
	vListInsertEnd( &( pxReadyTasksLists[ ( pxTCB )->uxPriority ] ), &( ( pxTCB )->xStateListItem ) ); \
	tracePOST_MOVED_TASK_TO_READY_STATE( pxTCB )

Referenced by prvAddNewTaskToReadyList(), vTaskNotifyGiveFromISR(), vTaskPriorityDisinheritAfterTimeout(), vTaskPrioritySet(), vTaskRemoveFromUnorderedEventList(), vTaskResume(), xTaskGenericNotify(), xTaskGenericNotifyFromISR(), xTaskIncrementTick(), xTaskPriorityDisinherit(), xTaskPriorityInherit(), xTaskRemoveFromEventList(), xTaskResumeAll(), and xTaskResumeFromISR().

#define prvGetTCBFromHandle ( pxHandle ) ( ( ( pxHandle ) == NULL ) ? ( TCB_t * ) pxCurrentTCB : ( TCB_t * ) ( pxHandle ) )

Referenced by pcTaskGetName(), uxTaskGetStackHighWaterMark(), vTaskGetInfo(), vTaskPrioritySet(), vTaskSuspend(), and xTaskNotifyStateClear().

#define taskEVENT_LIST_ITEM_VALUE_IN_USE 0x80000000UL

Referenced by vTaskPlaceOnUnorderedEventList(), vTaskPriorityDisinheritAfterTimeout(), vTaskPrioritySet(), vTaskRemoveFromUnorderedEventList(), and xTaskPriorityInherit().

#define taskNOT_WAITING_NOTIFICATION ( ( uint8_t ) 0 )

Referenced by prvInitialiseNewTask(), ulTaskNotifyTake(), vTaskSuspend(), xTaskNotifyStateClear(), and xTaskNotifyWait().

#define taskNOTIFICATION_RECEIVED ( ( uint8_t ) 2 )

Referenced by vTaskNotifyGiveFromISR(), xTaskGenericNotify(), xTaskGenericNotifyFromISR(), xTaskNotifyStateClear(), and xTaskNotifyWait().

#define taskRECORD_READY_PRIORITY ( uxPriority )

Value:

{                                                                                                   \
        if( ( uxPriority ) > uxTopReadyPriority )                                                       \
        {                                                                                               \
			uxTopReadyPriority = ( uxPriority );                                                     \
        }                                                                                               \
    } /* taskRECORD_READY_PRIORITY */

#define taskRESET_READY_PRIORITY ( uxPriority )

Referenced by vTaskPriorityDisinheritAfterTimeout(), vTaskSuspend(), xTaskPriorityDisinherit(), and xTaskPriorityInherit().

#define taskSELECT_HIGHEST_PRIORITY_TASK ( )

Value:

{                                                                                                   \
    UBaseType_t uxTopPriority = uxTopReadyPriority;                                                     \
                                                                                                        \
        /* Find the highest priority queue that contains ready tasks. */                                \
        while( listLIST_IS_EMPTY( &( pxReadyTasksLists[ uxTopPriority ] ) ) )                           \
        {                                                                                               \
			configASSERT( uxTopPriority );                                                               \
            --uxTopPriority;                                                                            \
        }                                                                                               \
                                                                                                        \
        /* listGET_OWNER_OF_NEXT_ENTRY indexes through the list, so the tasks of                        \
        the same priority get an equal share of the processor time. */                                  \
		listGET_OWNER_OF_NEXT_ENTRY( pxCurrentTCB, &( pxReadyTasksLists[ uxTopPriority ] ) );         \
		uxTopReadyPriority = uxTopPriority;                                                               \
    } /* taskSELECT_HIGHEST_PRIORITY_TASK */

Referenced by vTaskSwitchContext().

#define taskSWITCH_DELAYED_LISTS ( )

Value:

{                                                                                                   \
	List_t *pxTemp;                                                                                    \
                                                                                                    \
    /* The delayed tasks list should be empty when the lists are switched. */                       \
	configASSERT( ( listLIST_IS_EMPTY( pxDelayedTaskList ) ) );                                        \
                                                                                                    \
    pxTemp = pxDelayedTaskList;                                                                     \
	pxDelayedTaskList = pxOverflowDelayedTaskList;                                                 \
	pxOverflowDelayedTaskList = pxTemp;                                                                \
	xNumOfOverflows++;                                                                             \
	prvResetNextTaskUnblockTime();                                                                 \
}

Referenced by xTaskIncrementTick().

#define taskWAITING_NOTIFICATION ( ( uint8_t ) 1 )

Referenced by ulTaskNotifyTake(), vTaskNotifyGiveFromISR(), vTaskSuspend(), xTaskGenericNotify(), xTaskGenericNotifyFromISR(), and xTaskNotifyWait().

#define taskYIELD_IF_USING_PREEMPTION ( )

Referenced by prvAddNewTaskToReadyList(), vTaskPrioritySet(), vTaskResume(), xTaskGenericNotify(), and xTaskResumeAll().

#define tskBLOCKED_CHAR ( 'B' )

Referenced by vTaskList().

#define tskDELETED_CHAR ( 'D' )

Referenced by vTaskList().

#define tskDYNAMICALLY_ALLOCATED_STACK_AND_TCB ( ( uint8_t ) 0 )

#define tskREADY_CHAR ( 'R' )

Referenced by vTaskList().

#define tskSET_NEW_STACKS_TO_KNOWN_VALUE 1

#define tskSTACK_FILL_BYTE ( 0xa5U )

Referenced by prvInitialiseNewTask(), and prvTaskCheckFreeStackSpace().

#define tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE ( ( configSUPPORT_STATIC_ALLOCATION == 1 ) && ( configSUPPORT_DYNAMIC_ALLOCATION == 1 ) )

#define tskSTATICALLY_ALLOCATED_STACK_AND_TCB ( ( uint8_t ) 2 )

#define tskSTATICALLY_ALLOCATED_STACK_ONLY ( ( uint8_t ) 1 )

#define tskSUSPENDED_CHAR ( 'S' )

Referenced by vTaskList().

typedef tskTCB TCB_t

typedef struct tskTaskControlBlock tskTCB

eTaskState eTaskGetState ( TaskHandle_t xTask )

task.

h

eTaskState eTaskGetState( TaskHandle_t xTask );

INCLUDE_eTaskGetState must be defined as 1 for this function to be available. See the configuration section for more information.

Obtain the state of any task. States are encoded by the eTaskState enumerated type.

Parameters

xTask Handle of the task to be queried.

Returns: The state of xTask at the time the function was called. Note the state of the task might change between the function being called, and the functions return value being tested by the calling task.

References configASSERT, eBlocked, eDeleted, eReady, eRunning, eSuspended, listLIST_ITEM_CONTAINER, pxCurrentTCB, pxDelayedTaskList, pxOverflowDelayedTaskList, taskENTER_CRITICAL, taskEXIT_CRITICAL, tskTaskControlBlock::xEventListItem, tskTaskControlBlock::xStateListItem, and xSuspendedTaskList.

Referenced by vTaskGetInfo().

char* pcTaskGetName ( TaskHandle_t xTaskToQuery )

References configASSERT, tskTaskControlBlock::pcTaskName, and prvGetTCBFromHandle.

static portTASK_FUNCTION	(	prvIdleTask	,
		pvParameters
	)

static

THIS IS THE RTOS IDLE TASK - WHICH IS CREATED AUTOMATICALLY WHEN THE

SCHEDULER IS STARTED.

References configASSERT, configEXPECTED_IDLE_TIME_BEFORE_SLEEP, configPRE_SUPPRESS_TICKS_AND_SLEEP_PROCESSING, listCURRENT_LIST_LENGTH, mtCOVERAGE_TEST_MARKER, portSUPPRESS_TICKS_AND_SLEEP, portTASK_CALLS_SECURE_FUNCTIONS, prvCheckTasksWaitingTermination(), pxReadyTasksLists, taskYIELD, traceLOW_POWER_IDLE_BEGIN, traceLOW_POWER_IDLE_END, vApplicationIdleHook(), vTaskSuspendAll(), xNextTaskUnblockTime, xTaskResumeAll(), and xTickCount.

static void prvAddCurrentTaskToDelayedList	(	TickType_t	xTicksToWait,
		const BaseType_t	xCanBlockIndefinitely
	)

static

static void prvAddNewTaskToReadyList ( TCB_t * pxNewTCB )

static

References mtCOVERAGE_TEST_MARKER, pdFALSE, portSETUP_TCB, prvAddTaskToReadyList, prvInitialiseTaskLists(), pxCurrentTCB, taskENTER_CRITICAL, taskEXIT_CRITICAL, taskYIELD_IF_USING_PREEMPTION, traceTASK_CREATE, uxCurrentNumberOfTasks, tskTaskControlBlock::uxPriority, uxTaskNumber, tskTaskControlBlock::uxTCBNumber, and xSchedulerRunning.

static void prvCheckTasksWaitingTermination ( void )

static

THIS FUNCTION IS CALLED FROM THE RTOS IDLE TASK

References listGET_OWNER_OF_HEAD_ENTRY, taskENTER_CRITICAL, taskEXIT_CRITICAL, uxCurrentNumberOfTasks, uxListRemove(), and tskTaskControlBlock::xStateListItem.

Referenced by portTASK_FUNCTION().

static void prvInitialiseNewTask	(	TaskFunction_t	pxTaskCode,
		const char *const	pcName,
		const uint32_t	ulStackDepth,
		void *const	pvParameters,
		UBaseType_t	uxPriority,
		TaskHandle_t *const	pxCreatedTask,
		TCB_t *	pxNewTCB,
		const MemoryRegion_t *const	xRegions
	)

static

static void prvInitialiseTaskLists ( static void prvCheckTasksWaitingTermination void )

static

Referenced by prvAddNewTaskToReadyList().

static void prvInitialiseTaskLists ( void )

static

References configMAX_PRIORITIES, pxDelayedTaskList, pxOverflowDelayedTaskList, pxReadyTasksLists, vListInitialise(), xDelayedTaskList1, xDelayedTaskList2, xPendingReadyList, and xSuspendedTaskList.

static UBaseType_t prvListTasksWithinSingleList	(	TaskStatus_t *	pxTaskStatusArray,
		List_t *	pxList,
		eTaskState	eState
	)

static

References configLIST_VOLATILE, listCURRENT_LIST_LENGTH, listGET_OWNER_OF_NEXT_ENTRY, mtCOVERAGE_TEST_MARKER, pdTRUE, and vTaskGetInfo().

Referenced by uxTaskGetSystemState().

static void prvResetNextTaskUnblockTime ( void )

static

References listGET_LIST_ITEM_VALUE, listGET_OWNER_OF_HEAD_ENTRY, listLIST_IS_EMPTY, pdFALSE, pxDelayedTaskList, and xNextTaskUnblockTime.

Referenced by vTaskSuspend(), xTaskGenericNotify(), xTaskRemoveFromEventList(), and xTaskResumeAll().

static uint16_t prvTaskCheckFreeStackSpace ( const uint8_t * pucStackByte )

static

References tskSTACK_FILL_BYTE.

Referenced by uxTaskGetStackHighWaterMark(), and vTaskGetInfo().

static BaseType_t prvTaskIsTaskSuspended ( const TaskHandle_t xTask )

static

Utility task that simply returns pdTRUE if the task referenced by xTask is currently in the Suspended state, or pdFALSE if the task referenced by xTask is in any other state.

References configASSERT, listIS_CONTAINED_WITHIN, mtCOVERAGE_TEST_MARKER, pdFALSE, pdTRUE, tskTaskControlBlock::xEventListItem, xPendingReadyList, tskTaskControlBlock::xStateListItem, and xSuspendedTaskList.

Referenced by vTaskResume(), and xTaskResumeFromISR().

static char* prvWriteNameToBuffer	(	char *	pcBuffer,
		const char *	pcTaskName
	)

static

References configMAX_TASK_NAME_LEN.

Referenced by vTaskList().

void* pvTaskIncrementMutexHeldCount ( void )

References pxCurrentTCB, and tskTaskControlBlock::uxMutexesHeld.

Referenced by xQueueSemaphoreTake().

uint32_t ulTaskNotifyTake	(	BaseType_t	xClearCountOnExit,
		TickType_t	xTicksToWait
	)

References mtCOVERAGE_TEST_MARKER, pdFALSE, pdTRUE, portYIELD_WITHIN_API, prvAddCurrentTaskToDelayedList(), pxCurrentTCB, taskENTER_CRITICAL, taskEXIT_CRITICAL, taskNOT_WAITING_NOTIFICATION, taskWAITING_NOTIFICATION, traceTASK_NOTIFY_TAKE, traceTASK_NOTIFY_TAKE_BLOCK, tskTaskControlBlock::ucNotifyState, and tskTaskControlBlock::ulNotifiedValue.

UBaseType_t uxTaskGetNumberOfTasks ( void )

References uxCurrentNumberOfTasks.

Referenced by task_monitor().

UBaseType_t uxTaskGetStackHighWaterMark ( TaskHandle_t xTask )

task.h

UBaseType_t uxTaskGetStackHighWaterMark( TaskHandle_t xTask );

INCLUDE_uxTaskGetStackHighWaterMark must be set to 1 in FreeRTOSConfig.h for this function to be available.

Returns the high water mark of the stack associated with xTask. That is, the minimum free stack space there has been (in words, so on a 32 bit machine a value of 1 means 4 bytes) since the task started. The smaller the returned number the closer the task has come to overflowing its stack.

Parameters

xTask Handle of the task associated with the stack to be checked. Set xTask to NULL to check the stack of the calling task.

Returns: The smallest amount of free stack space there has been (in words, so actual spaces on the stack rather than bytes) since the task referenced by xTask was created.

References prvGetTCBFromHandle, prvTaskCheckFreeStackSpace(), and tskTaskControlBlock::pxStack.

UBaseType_t uxTaskGetSystemState	(	TaskStatus_t *const	pxTaskStatusArray,
		const UBaseType_t	uxArraySize,
		uint32_t *const	pulTotalRunTime
	)

configUSE_TRACE_FACILITY must be defined as 1 in FreeRTOSConfig.h for uxTaskGetSystemState() to be available.

uxTaskGetSystemState() populates an TaskStatus_t structure for each task in the system. TaskStatus_t structures contain, among other things, members for the task handle, task name, task priority, task state, and total amount of run time consumed by the task. See the TaskStatus_t structure definition in this file for the full member list.

NOTE: This function is intended for debugging use only as its use results in the scheduler remaining suspended for an extended period.

Parameters

pxTaskStatusArray	A pointer to an array of TaskStatus_t structures. The array must contain at least one TaskStatus_t structure for each task that is under the control of the RTOS. The number of tasks under the control of the RTOS can be determined using the uxTaskGetNumberOfTasks() API function.
uxArraySize	The size of the array pointed to by the pxTaskStatusArray parameter. The size is specified as the number of indexes in the array, or the number of TaskStatus_t structures contained in the array, not by the number of bytes in the array.
pulTotalRunTime	If configGENERATE_RUN_TIME_STATS is set to 1 in FreeRTOSConfig.h then *pulTotalRunTime is set by uxTaskGetSystemState() to the total run time (as defined by the run time stats clock, see http://www.freertos.org/rtos-run-time-stats.html) since the target booted. pulTotalRunTime can be set to NULL to omit the total run time information.

Returns: The number of TaskStatus_t structures that were populated by uxTaskGetSystemState(). This should equal the number returned by the uxTaskGetNumberOfTasks() API function, but will be zero if the value passed in the uxArraySize parameter was too small.

Example usage:

This example demonstrates how a human readable table of run time stats
information is generated from raw data provided by uxTaskGetSystemState().
The human readable table is written to pcWriteBuffer
    void vTaskGetRunTimeStats( char *pcWriteBuffer )
    {
    TaskStatus_t *pxTaskStatusArray;
    volatile UBaseType_t uxArraySize, x;
    uint32_t ulTotalRunTime, ulStatsAsPercentage;

Make sure the write buffer does not contain a string.
         pcWriteBuffer = 0x00;

Take a snapshot of the number of tasks in case it changes while this
function is executing.
        uxArraySize = uxTaskGetNumberOfTasks();

Allocate a TaskStatus_t structure for each task.  An array could be
allocated statically at compile time.
        pxTaskStatusArray = pvPortMalloc( uxArraySize * sizeof( TaskStatus_t ) );

        if( pxTaskStatusArray != NULL )
        {
Generate raw status information about each task.
            uxArraySize = uxTaskGetSystemState( pxTaskStatusArray, uxArraySize, &ulTotalRunTime );

For percentage calculations.
            ulTotalRunTime /= 100UL;

Avoid divide by zero errors.
            if( ulTotalRunTime > 0 )
            {
For each populated position in the pxTaskStatusArray array,
format the raw data as human readable ASCII data
                for( x = 0; x < uxArraySize; x++ )
                {
What percentage of the total run time has the task used?
This will always be rounded down to the nearest integer.
ulTotalRunTimeDiv100 has already been divided by 100.
                    ulStatsAsPercentage = pxTaskStatusArray[ x ].ulRunTimeCounter / ulTotalRunTime;

                    if( ulStatsAsPercentage > 0UL )
                    {
                        sprintf( pcWriteBuffer, "%s\t\t%lu\t\t%lu%%\r\n", pxTaskStatusArray[ x ].pcTaskName, pxTaskStatusArray[ x ].ulRunTimeCounter, ulStatsAsPercentage );
                    }
                    else
                    {
If the percentage is zero here then the task has
consumed less than 1% of the total run time.
                        sprintf( pcWriteBuffer, "%s\t\t%lu\t\t<1%%\r\n", pxTaskStatusArray[ x ].pcTaskName, pxTaskStatusArray[ x ].ulRunTimeCounter );
                    }

                    pcWriteBuffer += strlen( ( char * ) pcWriteBuffer );
                }
            }

The array is no longer needed, free the memory it consumes.
            vPortFree( pxTaskStatusArray );
        }
    }

References configMAX_PRIORITIES, eBlocked, eDeleted, eReady, eSuspended, mtCOVERAGE_TEST_MARKER, prvListTasksWithinSingleList(), pxDelayedTaskList, pxOverflowDelayedTaskList, pxReadyTasksLists, uxCurrentNumberOfTasks, vTaskSuspendAll(), xSuspendedTaskList, and xTaskResumeAll().

Referenced by vTaskList().

UBaseType_t uxTaskGetTaskNumber ( TaskHandle_t xTask )

References tskTaskControlBlock::uxTaskNumber.

TickType_t uxTaskResetEventItemValue ( void )

References configMAX_PRIORITIES, listGET_LIST_ITEM_VALUE, listSET_LIST_ITEM_VALUE, pxCurrentTCB, tskTaskControlBlock::uxPriority, and tskTaskControlBlock::xEventListItem.

Referenced by xEventGroupSync(), and xEventGroupWaitBits().

void vApplicationStackOverflowHook	(	TaskHandle_t	xTask,
		char *	pcTaskName
	)

void vApplicationTickHook ( void )

This function is called by FreeRTOS each tick.

Referenced by xTaskIncrementTick().

void vTaskDelay ( const TickType_t xTicksToDelay )

References configASSERT, mtCOVERAGE_TEST_MARKER, pdFALSE, portYIELD_WITHIN_API, prvAddCurrentTaskToDelayedList(), traceTASK_DELAY, uxSchedulerSuspended, vTaskSuspendAll(), and xTaskResumeAll().

Referenced by task_led(), and task_monitor().

void vTaskEndScheduler ( void )

References pdFALSE, vPortEndScheduler(), and xSchedulerRunning.

void vTaskGetInfo	(	TaskHandle_t	xTask,
		TaskStatus_t *	pxTaskStatus,
		BaseType_t	xGetFreeStackSpace,
		eTaskState	eState
	)

void vTaskInternalSetTimeOutState ( TimeOut_t *const pxTimeOut )

References xNumOfOverflows, xTIME_OUT::xOverflowCount, xTickCount, and xTIME_OUT::xTimeOnEntering.

Referenced by xQueueGenericSend(), xQueuePeek(), xQueueReceive(), xQueueSemaphoreTake(), and xTaskCheckForTimeOut().

void vTaskList ( char * pcWriteBuffer )

References eBlocked, eDeleted, eReady, eSuspended, mtCOVERAGE_TEST_MARKER, prvWriteNameToBuffer(), pvPortMalloc(), tskBLOCKED_CHAR, tskDELETED_CHAR, tskREADY_CHAR, tskSUSPENDED_CHAR, uxCurrentNumberOfTasks, uxTaskGetSystemState(), and vPortFree().

Referenced by task_monitor().

void vTaskMissedYield ( void )

References pdTRUE, and xYieldPending.

Referenced by prvUnlockQueue().

void vTaskNotifyGiveFromISR	(	TaskHandle_t	xTaskToNotify,
		BaseType_t *	pxHigherPriorityTaskWoken
	)

void vTaskPlaceOnEventList	(	List_t *const	pxEventList,
		const TickType_t	xTicksToWait
	)

References configASSERT, pdTRUE, prvAddCurrentTaskToDelayedList(), pxCurrentTCB, vListInsert(), and tskTaskControlBlock::xEventListItem.

Referenced by xQueueGenericSend(), xQueuePeek(), xQueueReceive(), and xQueueSemaphoreTake().

void vTaskPlaceOnUnorderedEventList	(	List_t *	pxEventList,
		const TickType_t	xItemValue,
		const TickType_t	xTicksToWait
	)

References configASSERT, listSET_LIST_ITEM_VALUE, pdTRUE, prvAddCurrentTaskToDelayedList(), pxCurrentTCB, taskEVENT_LIST_ITEM_VALUE_IN_USE, uxSchedulerSuspended, vListInsertEnd(), and tskTaskControlBlock::xEventListItem.

Referenced by xEventGroupSync(), and xEventGroupWaitBits().

void vTaskPriorityDisinheritAfterTimeout	(	TaskHandle_t const	pxMutexHolder,
		UBaseType_t	uxHighestPriorityWaitingTask
	)

void vTaskPrioritySet	(	TaskHandle_t	xTask,
		UBaseType_t	uxNewPriority
	)

void vTaskRemoveFromUnorderedEventList	(	ListItem_t *	pxEventListItem,
		const TickType_t	xItemValue
	)

References configASSERT, listGET_LIST_ITEM_OWNER, listSET_LIST_ITEM_VALUE, pdFALSE, pdTRUE, prvAddTaskToReadyList, pxCurrentTCB, taskEVENT_LIST_ITEM_VALUE_IN_USE, uxListRemove(), tskTaskControlBlock::uxPriority, uxSchedulerSuspended, tskTaskControlBlock::xStateListItem, and xYieldPending.

Referenced by vEventGroupDelete(), and xEventGroupSetBits().

void vTaskResume ( TaskHandle_t xTaskToResume )

References configASSERT, mtCOVERAGE_TEST_MARKER, pdFALSE, prvAddTaskToReadyList, prvTaskIsTaskSuspended(), pxCurrentTCB, taskENTER_CRITICAL, taskEXIT_CRITICAL, taskYIELD_IF_USING_PREEMPTION, traceTASK_RESUME, uxListRemove(), tskTaskControlBlock::uxPriority, and tskTaskControlBlock::xStateListItem.

void vTaskSetTaskNumber	(	TaskHandle_t	xTask,
		const UBaseType_t	uxHandle
	)

References tskTaskControlBlock::uxTaskNumber.

void vTaskSetTimeOutState ( TimeOut_t *const pxTimeOut )

References configASSERT, taskENTER_CRITICAL, taskEXIT_CRITICAL, xNumOfOverflows, xTIME_OUT::xOverflowCount, xTickCount, and xTIME_OUT::xTimeOnEntering.

Referenced by xStreamBufferSend().

void vTaskStartScheduler ( void )

void vTaskSuspendAll ( void )

References uxSchedulerSuspended.

Referenced by portTASK_FUNCTION(), pvPortMalloc(), uxTaskGetSystemState(), vEventGroupDelete(), vTaskDelay(), vTaskGetInfo(), xEventGroupSetBits(), xEventGroupSync(), xEventGroupWaitBits(), xQueueGenericSend(), xQueuePeek(), xQueueReceive(), and xQueueSemaphoreTake().

void vTaskSwitchContext ( void )

References mtCOVERAGE_TEST_MARKER, pdFALSE, pdTRUE, pxCurrentTCB, taskCHECK_FOR_STACK_OVERFLOW, taskSELECT_HIGHEST_PRIORITY_TASK, traceTASK_SWITCHED_IN, traceTASK_SWITCHED_OUT, uxSchedulerSuspended, and xYieldPending.

Referenced by vTaskSuspend().

BaseType_t xTaskCheckForTimeOut	(	TimeOut_t *const	pxTimeOut,
		TickType_t *const	pxTicksToWait
	)

References configASSERT, pdFALSE, pdTRUE, pxCurrentTCB, taskENTER_CRITICAL, taskEXIT_CRITICAL, vTaskInternalSetTimeOutState(), xNumOfOverflows, xTIME_OUT::xOverflowCount, xTickCount, and xTIME_OUT::xTimeOnEntering.

Referenced by xQueueGenericSend(), xQueuePeek(), xQueueReceive(), xQueueSemaphoreTake(), and xStreamBufferSend().

BaseType_t xTaskGenericNotify	(	TaskHandle_t	xTaskToNotify,
		uint32_t	ulValue,
		eNotifyAction	eAction,
		uint32_t *	pulPreviousNotificationValue
	)

BaseType_t xTaskGenericNotifyFromISR	(	TaskHandle_t	xTaskToNotify,
		uint32_t	ulValue,
		eNotifyAction	eAction,
		uint32_t *	pulPreviousNotificationValue,
		BaseType_t *	pxHigherPriorityTaskWoken
	)