tasks.c File Reference

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

Data Structures
struct	tskTaskControlBlock

Macros
#define	MPU_WRAPPERS_INCLUDED_FROM_API_FILE
#define	prvAddTaskToReadyQueue(pxTCB)
#define	prvCheckDelayedTasks()
#define	prvGetTCBFromHandle(pxHandle)   ( ( ( pxHandle ) == NULL ) ? ( tskTCB * ) pxCurrentTCB : ( tskTCB * ) ( pxHandle ) )
#define	tskBLOCKED_CHAR   ( ( signed char ) 'B' )
#define	tskDELETED_CHAR   ( ( signed char ) 'D' )
#define	tskIDLE_STACK_SIZE   configMINIMAL_STACK_SIZE
#define	tskREADY_CHAR   ( ( signed char ) 'R' )
#define	tskSTACK_FILL_BYTE   ( 0xa5U )
#define	tskSUSPENDED_CHAR   ( ( signed char ) 'S' )
#define	vWriteTraceToBuffer()

Typedefs
typedef struct tskTaskControlBlock	tskTCB

Functions
static	portTASK_FUNCTION (prvIdleTask, pvParameters)
static void	prvAddCurrentTaskToDelayedList (portTickType xTimeToWake)
static tskTCB *	prvAllocateTCBAndStack (unsigned short usStackDepth, portSTACK_TYPE *puxStackBuffer)
static void	prvCheckTasksWaitingTermination (void)
static void	prvInitialiseTaskLists (static void prvCheckTasksWaitingTermination void)
static void	prvInitialiseTaskLists (void)
static void	prvInitialiseTCBVariables (tskTCB *pxTCB, const signed char *const pcName, unsigned portBASE_TYPE uxPriority, const xMemoryRegion *const xRegions, unsigned short usStackDepth) PRIVILEGED_FUNCTION
unsigned portBASE_TYPE	uxTaskGetNumberOfTasks (void)
void	vApplicationStackOverflowHook (xTaskHandle *pxTask, signed char *pcTaskName)
void	vApplicationTickHook (void)
void	vTaskEndScheduler (void)
void	vTaskIncrementTick (void)
void	vTaskMissedYield (void)
void	vTaskPlaceOnEventList (const xList *const pxEventList, portTickType xTicksToWait)
void	vTaskSetTimeOutState (xTimeOutType *const pxTimeOut)
void	vTaskStartScheduler (void)
void	vTaskSuspendAll (void)
void	vTaskSwitchContext (void)
portBASE_TYPE	xTaskCheckForTimeOut (xTimeOutType *const pxTimeOut, portTickType *const pxTicksToWait)
portTickType	xTaskGetTickCount (void)
portTickType	xTaskGetTickCountFromISR (void)
signed portBASE_TYPE	xTaskRemoveFromEventList (const xList *const pxEventList)
signed portBASE_TYPE	xTaskResumeAll (void)

Variables
PRIVILEGED_DATA tskTCB *volatile	pxCurrentTCB = NULL
static PRIVILEGED_DATA xList *volatile	pxDelayedTaskList
static PRIVILEGED_DATA xList *volatile	pxOverflowDelayedTaskList
static PRIVILEGED_DATA xList	pxReadyTasksLists [configMAX_PRIORITIES]
static PRIVILEGED_DATA volatile unsigned portBASE_TYPE	uxCurrentNumberOfTasks = ( unsigned portBASE_TYPE ) 0
static PRIVILEGED_DATA volatile unsigned portBASE_TYPE	uxMissedTicks = ( unsigned portBASE_TYPE ) 0
static PRIVILEGED_DATA volatile unsigned portBASE_TYPE	uxSchedulerSuspended = ( unsigned portBASE_TYPE ) pdFALSE
static PRIVILEGED_DATA unsigned portBASE_TYPE	uxTaskNumber = ( unsigned portBASE_TYPE ) 0
static PRIVILEGED_DATA volatile unsigned portBASE_TYPE	uxTopReadyPriority = tskIDLE_PRIORITY
static PRIVILEGED_DATA unsigned portBASE_TYPE	uxTopUsedPriority = tskIDLE_PRIORITY
static PRIVILEGED_DATA xList	xDelayedTaskList1
static PRIVILEGED_DATA xList	xDelayedTaskList2
static PRIVILEGED_DATA volatile portBASE_TYPE	xMissedYield = ( portBASE_TYPE ) pdFALSE
static PRIVILEGED_DATA portTickType	xNextTaskUnblockTime = ( portTickType ) portMAX_DELAY
static PRIVILEGED_DATA volatile portBASE_TYPE	xNumOfOverflows = ( portBASE_TYPE ) 0
static PRIVILEGED_DATA xList	xPendingReadyList
static PRIVILEGED_DATA volatile signed portBASE_TYPE	xSchedulerRunning = pdFALSE
static PRIVILEGED_DATA volatile portTickType	xTickCount = ( portTickType ) 0

#define MPU_WRAPPERS_INCLUDED_FROM_API_FILE

#define prvAddTaskToReadyQueue

(

pxTCB

)

Value:

if( ( pxTCB )->uxPriority > uxTopReadyPriority )                                                                    \
    {                                                                                                                   \
		uxTopReadyPriority = ( pxTCB )->uxPriority;                                                                       \
    }                                                                                                                   \
	vListInsertEnd( ( xList * ) &( pxReadyTasksLists[ ( pxTCB )->uxPriority ] ), &( ( pxTCB )->xGenericListItem ) )

Referenced by prvInitialiseTaskLists(), xTaskRemoveFromEventList(), and xTaskResumeAll().

#define prvCheckDelayedTasks

(

)

Referenced by vTaskIncrementTick().

#define prvGetTCBFromHandle

(

pxHandle

)

( ( ( pxHandle ) == NULL ) ? ( tskTCB * ) pxCurrentTCB : ( tskTCB * ) ( pxHandle ) )

#define tskBLOCKED_CHAR   ( ( signed char ) 'B' )

#define tskDELETED_CHAR   ( ( signed char ) 'D' )

#define tskIDLE_STACK_SIZE   configMINIMAL_STACK_SIZE

Referenced by vTaskStartScheduler().

#define tskREADY_CHAR   ( ( signed char ) 'R' )

#define tskSTACK_FILL_BYTE   ( 0xa5U )

Referenced by prvAllocateTCBAndStack().

#define tskSUSPENDED_CHAR   ( ( signed char ) 'S' )

#define vWriteTraceToBuffer

(

)

Referenced by vTaskSwitchContext().

typedef struct tskTaskControlBlock tskTCB

static portTASK_FUNCTION ( prvIdleTask  , pvParameters    )

static

References listCURRENT_LIST_LENGTH, prvCheckTasksWaitingTermination(), pxReadyTasksLists, and taskYIELD.

static void prvAddCurrentTaskToDelayedList ( portTickType  xTimeToWake )

static

References listSET_LIST_ITEM_VALUE, pxCurrentTCB, pxDelayedTaskList, pxOverflowDelayedTaskList, vListInsert(), tskTaskControlBlock::xGenericListItem, xNextTaskUnblockTime, and xTickCount.

Referenced by vTaskPlaceOnEventList().

static tskTCB* prvAllocateTCBAndStack ( unsigned short  usStackDepth, portSTACK_TYPE *  puxStackBuffer  )

static

References NULL, pvPortMalloc(), pvPortMallocAligned, tskTaskControlBlock::pxStack, tskSTACK_FILL_BYTE, and vPortFree().

Referenced by prvInitialiseTaskLists().

static void prvCheckTasksWaitingTermination ( void  )

static

References listGET_OWNER_OF_HEAD_ENTRY, listLIST_IS_EMPTY, taskENTER_CRITICAL, taskEXIT_CRITICAL, uxCurrentNumberOfTasks, vListRemove(), vTaskSuspendAll(), tskTaskControlBlock::xGenericListItem, and xTaskResumeAll().

Referenced by portTASK_FUNCTION().

static void prvInitialiseTaskLists ( static void prvCheckTasksWaitingTermination  void )

static

References configASSERT, configMAX_PRIORITIES, errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY, NULL, pdFALSE, pdPASS, pdTRUE, portPRIVILEGE_BIT, portYIELD_WITHIN_API, prvAddTaskToReadyQueue, prvAllocateTCBAndStack(), prvInitialiseTCBVariables(), pxCurrentTCB, pxPortInitialiseStack(), tskTaskControlBlock::pxStack, tskTaskControlBlock::pxTopOfStack, taskENTER_CRITICAL, taskEXIT_CRITICAL, traceTASK_CREATE, traceTASK_CREATE_FAILED, uxCurrentNumberOfTasks, tskTaskControlBlock::uxPriority, uxTaskNumber, uxTopUsedPriority, and xSchedulerRunning.

static void prvInitialiseTaskLists ( void  )

static

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

static void prvInitialiseTCBVariables ( tskTCB *  pxTCB, const signed char *const  pcName, unsigned portBASE_TYPE  uxPriority, const xMemoryRegion *const  xRegions, unsigned short  usStackDepth  )

static

References configMAX_PRIORITIES, configMAX_TASK_NAME_LEN, listSET_LIST_ITEM_OWNER, listSET_LIST_ITEM_VALUE, NULL, tskTaskControlBlock::pcTaskName, tskTaskControlBlock::pxStack, tskTaskControlBlock::uxPriority, vListInitialiseItem(), tskTaskControlBlock::xEventListItem, and tskTaskControlBlock::xGenericListItem.

Referenced by prvInitialiseTaskLists().

unsigned portBASE_TYPE uxTaskGetNumberOfTasks

(

void

)

References uxCurrentNumberOfTasks.

Referenced by vCreateSuicidalTasks(), and xIsCreateTaskStillRunning().

void vApplicationStackOverflowHook	(	xTaskHandle *	pxTask,
		signed char *	pcTaskName
	)

void vApplicationTickHook

(

void

)

References crQUEUE_RECEIVE_FROM_ISR, crQUEUE_SEND_FROM_ISR, hookNUM_HOOK_CO_ROUTINES, hookTICK_CALLS_BEFORE_POST, pdFALSE, pdPASS, pdTRUE, uxCallCounter, uxNumberToPost, and xCoRoutineErrorDetected.

Referenced by vTaskIncrementTick().

void vTaskEndScheduler

(

void

)

References pdFALSE, vPortEndScheduler(), and xSchedulerRunning.

void vTaskIncrementTick

(

void

)

References configASSERT, listGET_LIST_ITEM_VALUE, listGET_OWNER_OF_HEAD_ENTRY, listLIST_IS_EMPTY, prvCheckDelayedTasks, pxDelayedTaskList, pxOverflowDelayedTaskList, traceTASK_INCREMENT_TICK, uxMissedTicks, uxSchedulerSuspended, vApplicationTickHook(), tskTaskControlBlock::xGenericListItem, xNextTaskUnblockTime, xNumOfOverflows, and xTickCount.

Referenced by xTaskResumeAll().

void vTaskMissedYield

(

void

)

References pdTRUE, and xMissedYield.

Referenced by prvUnlockQueue().

void vTaskPlaceOnEventList	(	const xList *const	pxEventList,
		portTickType	xTicksToWait
	)

References configASSERT, prvAddCurrentTaskToDelayedList(), pxCurrentTCB, vListInsert(), vListInsertEnd(), vListRemove(), tskTaskControlBlock::xEventListItem, tskTaskControlBlock::xGenericListItem, and xTickCount.

Referenced by xQueueGenericReceive(), and xQueueGenericSend().

void vTaskSetTimeOutState

(

xTimeOutType *const

pxTimeOut

)

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

Referenced by xQueueGenericReceive(), xQueueGenericSend(), and xTaskCheckForTimeOut().

void vTaskStartScheduler

(

void

)

References configASSERT, NULL, pdPASS, pdTRUE, portCONFIGURE_TIMER_FOR_RUN_TIME_STATS, portPRIVILEGE_BIT, tskIDLE_PRIORITY, tskIDLE_STACK_SIZE, xPortStartScheduler(), xSchedulerRunning, xTaskCreate, xTickCount, and xTimerCreateTimerTask().

Referenced by main().

void vTaskSuspendAll

(

void

)

References uxSchedulerSuspended.

Referenced by portTASK_FUNCTION(), prvCheckTasksWaitingTermination(), pvPortMalloc(), vMemCheckTask(), vParTestSetLED(), vParTestToggleLED(), vPortFree(), xQueueGenericReceive(), and xQueueGenericSend().

void vTaskSwitchContext

(

void

)

References configASSERT, listGET_OWNER_OF_NEXT_ENTRY, listLIST_IS_EMPTY, pdTRUE, pxCurrentTCB, pxReadyTasksLists, taskFIRST_CHECK_FOR_STACK_OVERFLOW, taskSECOND_CHECK_FOR_STACK_OVERFLOW, traceTASK_SWITCHED_IN, traceTASK_SWITCHED_OUT, uxSchedulerSuspended, uxTopReadyPriority, vWriteTraceToBuffer, and xMissedYield.

portBASE_TYPE xTaskCheckForTimeOut	(	xTimeOutType *const	pxTimeOut,
		portTickType *const	pxTicksToWait
	)

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

Referenced by xQueueGenericReceive(), and xQueueGenericSend().

portTickType xTaskGetTickCount

(

void

)

References taskENTER_CRITICAL, taskEXIT_CRITICAL, and xTickCount.

Referenced by device_cdc_task(), device_full_custom_task(), device_mass_storage_task(), device_mouse_hid_task(), device_template_task(), host_cdc_task(), host_mass_storage_task(), host_mouse_hid_task(), host_template_task(), portTASK_FUNCTION(), prvCheckDelayedList(), usb_device_task(), usb_host_task(), ushell_task(), vPrimaryBlockTimeTestTask(), and vSecondaryBlockTimeTestTask().

portTickType xTaskGetTickCountFromISR

(

void

)

References portCLEAR_INTERRUPT_MASK_FROM_ISR, portSET_INTERRUPT_MASK_FROM_ISR, and xTickCount.

signed portBASE_TYPE xTaskRemoveFromEventList

(

const xList *const

pxEventList

)

References configASSERT, listGET_OWNER_OF_HEAD_ENTRY, pdFALSE, pdTRUE, prvAddTaskToReadyQueue, pxCurrentTCB, tskTaskControlBlock::uxPriority, uxSchedulerSuspended, vListInsertEnd(), vListRemove(), tskTaskControlBlock::xEventListItem, tskTaskControlBlock::xGenericListItem, and xPendingReadyList.

Referenced by prvUnlockQueue(), xQueueGenericReceive(), xQueueGenericSend(), xQueueGenericSendFromISR(), and xQueueReceiveFromISR().

signed portBASE_TYPE xTaskResumeAll

(

void

)

References configASSERT, listGET_OWNER_OF_HEAD_ENTRY, listLIST_IS_EMPTY, pdFALSE, pdTRUE, portYIELD_WITHIN_API, prvAddTaskToReadyQueue, pxCurrentTCB, taskENTER_CRITICAL, taskEXIT_CRITICAL, uxCurrentNumberOfTasks, uxMissedTicks, tskTaskControlBlock::uxPriority, uxSchedulerSuspended, vListRemove(), vTaskIncrementTick(), tskTaskControlBlock::xEventListItem, tskTaskControlBlock::xGenericListItem, xMissedYield, and xPendingReadyList.

Referenced by portTASK_FUNCTION(), prvCheckTasksWaitingTermination(), pvPortMalloc(), vMemCheckTask(), vParTestSetLED(), vParTestToggleLED(), vPortFree(), xQueueGenericReceive(), and xQueueGenericSend().

PRIVILEGED_DATA tskTCB* volatile pxCurrentTCB = NULL

Referenced by prvAddCurrentTaskToDelayedList(), prvInitialiseTaskLists(), vTaskPlaceOnEventList(), vTaskSwitchContext(), xTaskRemoveFromEventList(), and xTaskResumeAll().

PRIVILEGED_DATA xList* volatile pxDelayedTaskList

static

Referenced by prvAddCurrentTaskToDelayedList(), prvInitialiseTaskLists(), and vTaskIncrementTick().

PRIVILEGED_DATA xList* volatile pxOverflowDelayedTaskList

static

Referenced by prvAddCurrentTaskToDelayedList(), prvInitialiseTaskLists(), and vTaskIncrementTick().

PRIVILEGED_DATA xList pxReadyTasksLists[configMAX_PRIORITIES]

static

Referenced by portTASK_FUNCTION(), prvInitialiseTaskLists(), and vTaskSwitchContext().

PRIVILEGED_DATA volatile unsigned portBASE_TYPE uxCurrentNumberOfTasks = ( unsigned portBASE_TYPE ) 0

static

Referenced by prvCheckTasksWaitingTermination(), prvInitialiseTaskLists(), uxTaskGetNumberOfTasks(), and xTaskResumeAll().

PRIVILEGED_DATA volatile unsigned portBASE_TYPE uxMissedTicks = ( unsigned portBASE_TYPE ) 0

static

Referenced by vTaskIncrementTick(), and xTaskResumeAll().

PRIVILEGED_DATA volatile unsigned portBASE_TYPE uxSchedulerSuspended = ( unsigned portBASE_TYPE ) pdFALSE

static

Referenced by vTaskIncrementTick(), vTaskSuspendAll(), vTaskSwitchContext(), xTaskRemoveFromEventList(), and xTaskResumeAll().

PRIVILEGED_DATA unsigned portBASE_TYPE uxTaskNumber = ( unsigned portBASE_TYPE ) 0

static

Referenced by prvInitialiseTaskLists().

PRIVILEGED_DATA volatile unsigned portBASE_TYPE uxTopReadyPriority = tskIDLE_PRIORITY

static

Referenced by vTaskSwitchContext().

PRIVILEGED_DATA unsigned portBASE_TYPE uxTopUsedPriority = tskIDLE_PRIORITY

static

Referenced by prvInitialiseTaskLists().

PRIVILEGED_DATA xList xDelayedTaskList1

static

Referenced by prvInitialiseTaskLists().

PRIVILEGED_DATA xList xDelayedTaskList2

static

Referenced by prvInitialiseTaskLists().

PRIVILEGED_DATA volatile portBASE_TYPE xMissedYield = ( portBASE_TYPE ) pdFALSE

static

Referenced by vTaskMissedYield(), vTaskSwitchContext(), and xTaskResumeAll().

PRIVILEGED_DATA portTickType xNextTaskUnblockTime = ( portTickType ) portMAX_DELAY

static

Referenced by prvAddCurrentTaskToDelayedList(), and vTaskIncrementTick().

PRIVILEGED_DATA volatile portBASE_TYPE xNumOfOverflows = ( portBASE_TYPE ) 0

static

Referenced by vTaskIncrementTick(), vTaskSetTimeOutState(), and xTaskCheckForTimeOut().

PRIVILEGED_DATA xList xPendingReadyList

static

Referenced by prvInitialiseTaskLists(), xTaskRemoveFromEventList(), and xTaskResumeAll().

PRIVILEGED_DATA volatile signed portBASE_TYPE xSchedulerRunning = pdFALSE

static

Referenced by prvInitialiseTaskLists(), vTaskEndScheduler(), and vTaskStartScheduler().

PRIVILEGED_DATA volatile portTickType xTickCount = ( portTickType ) 0

static

Referenced by prvAddCurrentTaskToDelayedList(), vTaskIncrementTick(), vTaskPlaceOnEventList(), vTaskSetTimeOutState(), vTaskStartScheduler(), xTaskCheckForTimeOut(), xTaskGetTickCount(), and xTaskGetTickCountFromISR().