APIs for Task

Introduction

For more details and example usage, see Task

Data Structures
struct	TaskP_Object
	Opaque task object used with the task APIs. More...
struct	TaskP_Params
	Parameters passed during TaskP_construct. More...

Functions
void	TaskP_Params_init (TaskP_Params *params)
	Set default values to TaskP_Params. More...
int32_t	TaskP_construct (TaskP_Object *obj, TaskP_Params *params)
	Create a task object. More...
void	TaskP_destruct (TaskP_Object *obj)
	Cleanup, delete, destruct a task object. More...
void	TaskP_yield ()
	Yield current task. More...
void	TaskP_exit ()
	Exit current task. More...

Typedefs
typedef void(*	TaskP_FxnMain) (void *args)
	Entry point to the task. More...

Macros
#define	TaskP_PRIORITY_LOWEST   (0u)
	Value to be used for lowest priority task. More...
#define	TaskP_PRIORITY_HIGHEST   (15u)
	Value to be used for highest priority task. More...
#define	TaskP_OBJECT_SIZE_MAX   (160u)
	Max size of task object across all OS's. More...

Macro Definition Documentation

TaskP_PRIORITY_LOWEST

#define TaskP_PRIORITY_LOWEST   (0u)

Value to be used for lowest priority task.

TaskP_PRIORITY_HIGHEST

#define TaskP_PRIORITY_HIGHEST   (15u)

Value to be used for highest priority task.

TaskP_OBJECT_SIZE_MAX

#define TaskP_OBJECT_SIZE_MAX   (160u)

Max size of task object across all OS's.

Typedef Documentation

TaskP_FxnMain

typedef void(* TaskP_FxnMain) (void *args)

Entry point to the task.

Function Documentation

TaskP_Params_init()

void TaskP_Params_init

(

TaskP_Params *

params

)

Set default values to TaskP_Params.

Strongly recommended to be called before seting values in TaskP_Params

Parameters

params

[out] parameter structure to set to default

TaskP_construct()

int32_t TaskP_construct	(	TaskP_Object *	obj,
		TaskP_Params *	params
	)

Create a task object.

Parameters

obj	[out] Created object
params	[in] Task create parameters

Returns

SystemP_SUCCESS on success, SystemP_FAILURE on error

TaskP_destruct()

void TaskP_destruct

(

TaskP_Object *

obj

)

Cleanup, delete, destruct a task object.

Parameters

obj	[in] task object

TaskP_yield()

void TaskP_yield

(

)

Yield current task.

TaskP_exit()

void TaskP_exit

(

)

Exit current task.

In FreeRTOS, task cannot simply return from a function. It needs to call vTaskDelete(NULL) instead. To keep the task exit portable, call this function when a task wants to terminate itself.