#include "portable.h"
#include "list.h"

Data Structures
struct	xMEMORY_REGION

struct	xTASK_PARAMTERS

struct	xTIME_OUT

Macros
#define	taskDISABLE_INTERRUPTS() portDISABLE_INTERRUPTS()

#define	taskENABLE_INTERRUPTS() portENABLE_INTERRUPTS()

#define	taskENTER_CRITICAL() portENTER_CRITICAL()

#define	taskEXIT_CRITICAL() portEXIT_CRITICAL()

#define	taskSCHEDULER_NOT_STARTED 0

#define	taskSCHEDULER_RUNNING 1

#define	taskSCHEDULER_SUSPENDED 2

#define	taskYIELD() portYIELD()

#define	tskIDLE_PRIORITY ( ( unsigned portBASE_TYPE ) 0U )

#define	tskKERNEL_VERSION_NUMBER "V7.4.2"

#define	xTaskCreate(pvTaskCode, pcName, usStackDepth, pvParameters, uxPriority, pxCreatedTask) xTaskGenericCreate( ( pvTaskCode ), ( pcName ), ( usStackDepth ), ( pvParameters ), ( uxPriority ), ( pxCreatedTask ), ( NULL ), ( NULL ) )

#define	xTaskCreateRestricted(x, pxCreatedTask) xTaskGenericCreate( ((x)->pvTaskCode), ((x)->pcName), ((x)->usStackDepth), ((x)->pvParameters), ((x)->uxPriority), (pxCreatedTask), ((x)->puxStackBuffer), ((x)->xRegions) )

Typedefs
typedef struct xMEMORY_REGION	xMemoryRegion

typedef void *	xTaskHandle

typedef struct xTASK_PARAMTERS	xTaskParameters

typedef struct xTIME_OUT	xTimeOutType

Enumerations
enum	eSleepModeStatus { eAbortSleep = 0, eStandardSleep, eNoTasksWaitingTimeout, eAbortSleep = 0, eStandardSleep, eNoTasksWaitingTimeout, eAbortSleep = 0, eStandardSleep, eNoTasksWaitingTimeout, eAbortSleep = 0, eStandardSleep, eNoTasksWaitingTimeout, eAbortSleep = 0, eStandardSleep, eNoTasksWaitingTimeout }

enum	eTaskState { eRunning = 0, eReady, eBlocked, eSuspended, eDeleted, eRunning = 0, eReady, eBlocked, eSuspended, eDeleted, eRunning = 0, eReady, eBlocked, eSuspended, eDeleted, eRunning = 0, eReady, eBlocked, eSuspended, eDeleted, eRunning = 0, eReady, eBlocked, eSuspended, eDeleted, eInvalid, eRunning = 0, eReady, eBlocked, eSuspended, eDeleted }

Functions
eSleepModeStatus	eTaskConfirmSleepModeStatus (void)

eTaskState	eTaskGetState (xTaskHandle xTask) PRIVILEGED_FUNCTION
	task. More...

signed char *	pcTaskGetTaskName (xTaskHandle xTaskToQuery)

unsigned portBASE_TYPE	uxTaskGetNumberOfTasks (void) PRIVILEGED_FUNCTION

unsigned portBASE_TYPE	uxTaskGetStackHighWaterMark (xTaskHandle xTask) PRIVILEGED_FUNCTION
	task.h More...

unsigned portBASE_TYPE	uxTaskGetTaskNumber (xTaskHandle xTask)

unsigned portBASE_TYPE	uxTaskPriorityGet (xTaskHandle xTask) PRIVILEGED_FUNCTION

void	vTaskAllocateMPURegions (xTaskHandle xTask, const xMemoryRegion *const pxRegions) PRIVILEGED_FUNCTION

void	vTaskDelay (portTickType xTicksToDelay) PRIVILEGED_FUNCTION

void	vTaskDelayUntil (portTickType *const pxPreviousWakeTime, portTickType xTimeIncrement) PRIVILEGED_FUNCTION

void	vTaskDelete (xTaskHandle xTaskToDelete) PRIVILEGED_FUNCTION

void	vTaskEndScheduler (void) PRIVILEGED_FUNCTION

void	vTaskGetRunTimeStats (signed char *pcWriteBuffer) PRIVILEGED_FUNCTION

void	vTaskIncrementTick (void) PRIVILEGED_FUNCTION

void	vTaskList (signed char *pcWriteBuffer) PRIVILEGED_FUNCTION

void	vTaskMissedYield (void) PRIVILEGED_FUNCTION

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

void	vTaskPlaceOnEventListRestricted (const xList *const pxEventList, portTickType xTicksToWait) PRIVILEGED_FUNCTION

void	vTaskPriorityDisinherit (xTaskHandle *const pxMutexHolder) PRIVILEGED_FUNCTION

void	vTaskPriorityInherit (xTaskHandle *const pxMutexHolder) PRIVILEGED_FUNCTION

void	vTaskPrioritySet (xTaskHandle xTask, unsigned portBASE_TYPE uxNewPriority) PRIVILEGED_FUNCTION

void	vTaskResume (xTaskHandle xTaskToResume) PRIVILEGED_FUNCTION

void	vTaskSetTaskNumber (xTaskHandle xTask, unsigned portBASE_TYPE uxHandle)

void	vTaskSetTimeOutState (xTimeOutType *const pxTimeOut) PRIVILEGED_FUNCTION

void	vTaskStartScheduler (void) PRIVILEGED_FUNCTION

void	vTaskStepTick (portTickType xTicksToJump)

void	vTaskSuspend (xTaskHandle xTaskToSuspend) PRIVILEGED_FUNCTION

void	vTaskSuspendAll (void) PRIVILEGED_FUNCTION

void	vTaskSwitchContext (void) PRIVILEGED_FUNCTION

portBASE_TYPE	xTaskCallApplicationTaskHook (xTaskHandle xTask, void *pvParameter) PRIVILEGED_FUNCTION
	task.h More...

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

signed portBASE_TYPE	xTaskGenericCreate (pdTASK_CODE pxTaskCode, const signed char const pcName, unsigned short usStackDepth, void pvParameters, unsigned portBASE_TYPE uxPriority, xTaskHandle pxCreatedTask, portSTACK_TYPE puxStackBuffer, const xMemoryRegion *const xRegions) PRIVILEGED_FUNCTION

xTaskHandle	xTaskGetCurrentTaskHandle (void) PRIVILEGED_FUNCTION

xTaskHandle	xTaskGetIdleTaskHandle (void)
	xTaskGetIdleTaskHandle() is only available if INCLUDE_xTaskGetIdleTaskHandle is set to 1 in FreeRTOSConfig.h. More...

portBASE_TYPE	xTaskGetSchedulerState (void) PRIVILEGED_FUNCTION

portTickType	xTaskGetTickCount (void) PRIVILEGED_FUNCTION

portTickType	xTaskGetTickCountFromISR (void) PRIVILEGED_FUNCTION

signed portBASE_TYPE	xTaskIsTaskSuspended (xTaskHandle xTask) PRIVILEGED_FUNCTION
	task. More...

signed portBASE_TYPE	xTaskRemoveFromEventList (const xList *const pxEventList) PRIVILEGED_FUNCTION

signed portBASE_TYPE	xTaskResumeAll (void) PRIVILEGED_FUNCTION

portBASE_TYPE	xTaskResumeFromISR (xTaskHandle xTaskToResume) PRIVILEGED_FUNCTION

#define taskDISABLE_INTERRUPTS ( ) portDISABLE_INTERRUPTS()

#define taskENABLE_INTERRUPTS ( ) portENABLE_INTERRUPTS()

#define taskENTER_CRITICAL ( ) portENTER_CRITICAL()

#define taskEXIT_CRITICAL ( ) portEXIT_CRITICAL()

#define taskSCHEDULER_NOT_STARTED 0

#define taskSCHEDULER_RUNNING 1

#define taskSCHEDULER_SUSPENDED 2

#define taskYIELD ( ) portYIELD()

#define tskIDLE_PRIORITY ( ( unsigned portBASE_TYPE ) 0U )

#define tskKERNEL_VERSION_NUMBER "V7.4.2"

#define xTaskCreate	(	pvTaskCode,
		pcName,
		usStackDepth,
		pvParameters,
		uxPriority,
		pxCreatedTask
	)	xTaskGenericCreate( ( pvTaskCode ), ( pcName ), ( usStackDepth ), ( pvParameters ), ( uxPriority ), ( pxCreatedTask ), ( NULL ), ( NULL ) )

#define xTaskCreateRestricted	(	x,
		pxCreatedTask
	)	xTaskGenericCreate( ((x)->pvTaskCode), ((x)->pcName), ((x)->usStackDepth), ((x)->pvParameters), ((x)->uxPriority), (pxCreatedTask), ((x)->puxStackBuffer), ((x)->xRegions) )

typedef struct xMEMORY_REGION xMemoryRegion

typedef void* xTaskHandle

typedef struct xTASK_PARAMTERS xTaskParameters

typedef struct xTIME_OUT xTimeOutType

enum eSleepModeStatus

Enumerator
eAbortSleep
eStandardSleep
eNoTasksWaitingTimeout
eAbortSleep
eStandardSleep
eNoTasksWaitingTimeout
eAbortSleep
eStandardSleep
eNoTasksWaitingTimeout
eAbortSleep
eStandardSleep
eNoTasksWaitingTimeout
eAbortSleep
eStandardSleep
eNoTasksWaitingTimeout

enum eTaskState

Enumerator
eRunning
eReady
eBlocked
eSuspended
eDeleted
eRunning
eReady
eBlocked
eSuspended
eDeleted
eRunning
eReady
eBlocked
eSuspended
eDeleted
eRunning
eReady
eBlocked
eSuspended
eDeleted
eRunning
eReady
eBlocked
eSuspended
eDeleted
eInvalid
eRunning
eReady
eBlocked
eSuspended
eDeleted

eSleepModeStatus eTaskConfirmSleepModeStatus ( void )

eTaskState eTaskGetState ( xTaskHandle xTask )

task.

h

eTaskState eTaskGetState( xTaskHandle 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.

signed char* pcTaskGetTaskName ( xTaskHandle xTaskToQuery )

unsigned portBASE_TYPE uxTaskGetNumberOfTasks ( void )

unsigned portBASE_TYPE uxTaskGetStackHighWaterMark ( xTaskHandle xTask )

task.h

unsigned portBASE_TYPE uxTaskGetStackHighWaterMark( xTaskHandle 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 bytes) since the task referenced by xTask was created.

unsigned portBASE_TYPE uxTaskGetTaskNumber ( xTaskHandle xTask )

unsigned portBASE_TYPE uxTaskPriorityGet ( xTaskHandle xTask )

void vTaskAllocateMPURegions	(	xTaskHandle	xTask,
		const xMemoryRegion *const	pxRegions
	)

void vTaskDelay ( portTickType xTicksToDelay )

void vTaskDelayUntil	(	portTickType *const	pxPreviousWakeTime,
		portTickType	xTimeIncrement
	)

void vTaskDelete ( xTaskHandle xTaskToDelete )

void vTaskEndScheduler ( void )

void vTaskGetRunTimeStats ( signed char * pcWriteBuffer )

void vTaskIncrementTick ( void )

void vTaskList ( signed char * pcWriteBuffer )

void vTaskMissedYield ( void )

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

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

void vTaskPriorityDisinherit ( xTaskHandle *const pxMutexHolder )

void vTaskPriorityInherit ( xTaskHandle *const pxMutexHolder )

void vTaskPrioritySet	(	xTaskHandle	xTask,
		unsigned portBASE_TYPE	uxNewPriority
	)

void vTaskResume ( xTaskHandle xTaskToResume )

void vTaskSetTaskNumber	(	xTaskHandle	xTask,
		unsigned portBASE_TYPE	uxHandle
	)

void vTaskSetTimeOutState ( xTimeOutType *const pxTimeOut )

void vTaskStartScheduler ( void )

void vTaskStepTick ( portTickType xTicksToJump )

void vTaskSuspend ( xTaskHandle xTaskToSuspend )

void vTaskSuspendAll ( void )

void vTaskSwitchContext ( void )

portBASE_TYPE xTaskCallApplicationTaskHook	(	xTaskHandle	xTask,
		void *	pvParameter
	)

task.h

portBASE_TYPE xTaskCallApplicationTaskHook( xTaskHandle xTask, pdTASK_HOOK_CODE pxHookFunction );

Calls the hook function associated with xTask. Passing xTask as NULL has the effect of calling the Running tasks (the calling task) hook function.

pvParameter is passed to the hook function for the task to interpret as it wants.

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

signed portBASE_TYPE xTaskGenericCreate	(	pdTASK_CODE	pxTaskCode,
		const signed char *const	pcName,
		unsigned short	usStackDepth,
		void *	pvParameters,
		unsigned portBASE_TYPE	uxPriority,
		xTaskHandle *	pxCreatedTask,
		portSTACK_TYPE *	puxStackBuffer,
		const xMemoryRegion *const	xRegions
	)

xTaskHandle xTaskGetCurrentTaskHandle ( void )

xTaskHandle xTaskGetIdleTaskHandle ( void )

xTaskGetIdleTaskHandle() is only available if INCLUDE_xTaskGetIdleTaskHandle is set to 1 in FreeRTOSConfig.h.

Simply returns the handle of the idle task. It is not valid to call xTaskGetIdleTaskHandle() before the scheduler has been started.

portBASE_TYPE xTaskGetSchedulerState ( void )

portTickType xTaskGetTickCount ( void )

portTickType xTaskGetTickCountFromISR ( void )

signed portBASE_TYPE xTaskIsTaskSuspended ( xTaskHandle xTask )

task.

h

signed portBASE_TYPE xTaskIsTaskSuspended( xTaskHandle xTask );

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.

signed portBASE_TYPE xTaskRemoveFromEventList ( const xList *const pxEventList )

signed portBASE_TYPE xTaskResumeAll ( void )

portBASE_TYPE xTaskResumeFromISR ( xTaskHandle xTaskToResume )

Microchip® Advanced Software Framework

Data Structures

Macros

Typedefs

Enumerations

Functions