FreeRTOS TaskManagement
FreeRTOS TaskManagement
2
FreeRTOS
3
The simplest case of task priority
assignments
• Assign higher priorities (lower priorities) to
threads that implement hard real-time (soft real-
time) requirements
– As a result, hard real-time threads are always
executed ahead of soft real-time threads.
• But, priority assignment decision are not always
that simple.
4
A note about terminology
5
Why use a real-time kernel
• For a simple system, many well-established
techniques can provide an appropriate solution
without the use of a kernel.
• For a more complex embedded application, a
kernel would be preferable.
• But where the crossover point occurs will always
be subjective.
6
Benefits of using real-time kernel 1
• Abstracting away timing information
– Kernel is responsible for execution timing and provides a time-related
API to the application. This allows the application code to be simpler
and the overall code size be smaller.
• Maintainability/Extensibility
– Abstracting away timing details results in fewer interdependencies
between modules and allows sw to evolve in a predictable way.
– Application performance is less susceptible to changes in the underlying
hardware.
• Modularity
– Tasks are independent modules, each of which has a well-defined
purpose.
• Team development
– Tasks have well-defined interfaces, allowing easier development by
teams
7
Benefits of using real-time kernel 2
• Easier testing
– Tasks are independent modules with clean interfaces, they
can be tested in isolation.
• Idle time utilization
– The idle task is created automatically when the kernel is
started. It executes whenever there are no application
tasks to run.
– Be used to measure spare processing capacity, perform
background checks, or simply place the process into a
low-power mode.
• Flexible interrupt handling
– Interrupt handlers can be kept very short by deferring most
of the required processing to handler tasks.
8
Standard FreeRTOS features
9
Outline
• Task Management
• Queue Management
• Interrupt Management
• Resource Management
• Memory Management
• Trouble Shooting
10
TASK MANAGEMENT
11
1.1 Introduction and scope
12
More specific topics
14
ATaskFunction
15
Special features of task function
• FreeRTOS task
– Must not contain a ‘return’ statement
– Must not be allowed to execute past the end of
the function
– If a task is no longer required, it should be
explicitly deleted.
– Be used to create any number of tasks
• Each created task is a separate execution instance with
its own stack, and its own copy of any automatic
variables defined within the task itself.
16
1.3 Top level task states
portBASE_TYPE xTaskCreate(
pdTASK_CODE pvTaskCode,
const signed char * const pcName,
unsigned short usStackDepth,
void *pvParameters,
unsigned portBASE_TYPE uxPriority,
xTaskHandle *pxCreatedTask
);
18
All parameters
• pvTaskCode
– a pointer to the function (just the function name)
that implements the task.
• pcName
– A descriptive name for the task. It is not used by
FreeRTOS, but a debugging aid.
– configMAX_TASK_NAME_LEN: the application
defined constant that defines the maximum length a
task name can task including the NULL terminator.
19
• usStackDepth
– Each task has its own unique stack that is
allocated by the kernel to the task when the task
is created.
– The value specifies the number of words the task
stack can hold.
• E.g., Cortex-M3 stack is 32 bits wide, if usStackDepth
is passed in as 100, 400 bytes of stack space will be
allocated (100*4 bytes)
– Size of the stack used by the idle task is defined
by configMINIMAL_STACK_SIZE.
• Adjustable w.r.t. applications
20
• pvParameters
– The value assigned to pvParameters will be the
values passed into the task.
• uxPriority
– defines the priority at which the task will execute.
– Priorities can be assigned from 0, which is the
lowest priority, to (configMAX_PRIOIRTIES-1),
which is the highest priority.
– Passing a value above (configMAX_PRIOIRTIES -
1) will result in the priority being capped the
maximum legitimate value.
21
• pxCreatedTask
– pass out a handle to the created task, then be used to
refer the created task in API calls.
• E.g., change the task priority or delete the task
– Be set to NULL if no use for the task handle
22
Example 1 Creating 2 tasks
23
vTask1
void vTask1( void *pvParameters )
{
const char *pcTaskName = "Task 1 is running\r\n";
volatile unsigned long ul;
26
Example 1 - Serial Monitor
27
Execution pattern of two Example 1 tasks
29
Example 2 vTaskFunction
void vTaskFunction( void *pvParameters )
{
char *pcTaskName;
volatile unsigned long ul;
/* The string to print out is passed in via the parameter. Cast this to a
character pointer. */
pcTaskName = ( char * ) pvParameters;
for( ;; );
}
31
1.5 Task priorities
• configMAX_PRIORITIES in FreeRTOSConfig.h
– Maximum number of priorities
– Higher this value, more RAM consumed
Range: [0(low), configMAX-PRIORITIES-1(high)]
– Any number of tasks can share the same priority
32
• To select the next task to run, the scheduler itself
must execute at the end of each time slice.
– Use a periodic interrupt called the tick (interrupt).
– Effectively set the length of time slice by the tick
interrupt frequency -- configTICK_RATE_HZ in
FreeRTOSConfig.h
• configTICK_RATE_HZ
– If it is 100(Hz), the time slice will be 10 ms.
– API always calls specify time in tick interrupts (ticks)
• portTICK_PERIOD_MS
– Convert time delays from milliseconds into the
number of tick interrupts.
33
• When kernel itself is running, the arrows in the
above figure show the sequence of execution
from task interrupt, then from interrupt back to a
next task.
34
Example 3. Experimenting with priorities
35
Example 3. Experimenting with priorities
36
Example 3 - Serial Monitor
37
• The scheduler always selects the highest priority
task that is able to run.
– Task 2 has a higher priority than Task 1; so Task 2 is
the only task to ever enter the Running state.
– Task 1 is to be ‘starved’ of processing time of Task 2.
38
‘Continuous processing’ task
• An event-driven task
– has work to perform only after the occurrence of the event
that triggers it
– Is not able enter the Running state before that event has
occurred.
• The scheduler selects the highest priority task that is
able to run.
– High priority tasks not being able to run means that the
scheduler cannot select them, and
– Must select a lower priority task that is able to run.
• Using event-driven tasks means that
– tasks can be created at different priorities without the
highest priority tasks starving all the lower priority tasks.
40
Full task state machine
41
Blocked state
• Tasks enter this state to wait for two types of events
– Temporal (time-related) events: the event being either a
delay expiring, or an absolute time being reached.
• A task enter the Blocked state to wait for 10ms to pass
– Synchronization events: where the events originate from
another task or interrupt
• A task enter the Blocked state to wait for data to arrive on a
queue.
– Can block on a synchronization event with a timeout,
effectively block on both types of event simultaneously.
• A task waits for a maximum of 10ms for data to arrive on a
queue. It leaves the Blocked state if either data arrives within
10ms or 10ms pass with no data arriving.
42
Suspended state
43
Ready state
44
Full Task State machine
45
Example 4 Using the Block state to
create a delay
• All tasks in the previous examples have been
periodic
– They have delayed for a period and printed out
their string before delay once more, and so on.
– Delayed generated using a null loop
• the task effectively polled an incrementing loop counter
until it reached a fixed value.
46
• Disadvantages to any form of polling
– While executing the null loop, the task remains in
the Ready state, ‘starving’ the other task of any
processing time.
– During polling, the task does not really have any
work to do, but it still uses maximum processing
time and so wastes processor cycles.
• This example corrects this behavior by
– replacing the polling null loop with a call to
vTaskDelay() API function.
– setting INCLUDE_vTaskDelay to 1 in
FreeRTOSConfig.h
47
vTaskDelay() API function
xTicksToDelay: the number of ticks that the calling task should remain in
the Blocked state before being transitioned back into the Ready state.
E.g, if a task called vTaskDelay(100) while the tick count was 10,000, it
enters the Blocked state immediately and remains there until the tick
count is 10,100.
48
Example 4
49
Example 4 - Serial Monitor
50
• Each time the tasks leave the Blocked state they
execute for a fraction of a tick period before re-
entering the Blocked state.
– Most of the time no application tasks are able to run and,
so, no tasks can be selected to enter the Running state.
– The idle task will run to ensure there is always at least one
task that is able to run. 51
Bold lines indicate the state transitions
performed by the tasks in Example 4
52
vTaskDelayUntil() API Function
• Parameters to vTaskDelayUntil()
– specify the exact tick count value at which the
calling task should be moved from the Blocked
state into the Ready state.
– Be used when a fixed execution period is
required.
• The time at which the calling task is unblocked is
absolute, rather than relative to when the function was
called (as vTaskDelay())
void vTaskDelayUntil(
portTickType *pxPreviousWakeTime,
portTickType xTimeIncrement);
53
vTaskDelayUntil() prototype
• pxPreviousWakeTime
– Assume that vTaskDelayUtil() is being used to
implement a task that executes periodically and
with a fixed frequency.
– Holds the time at which the task left the Blocked
state.
– Be used as a reference point to compute the time
at which the task next leaves the Blocked state.
– The variable pointed by pxPreviousWakeTime is
updated automatically, not be modified by
application code, other than when the variable is
first initialized.
54
vTaskDelayUntil() prototype
• xTimeIncrement
– Assume that vTaskDelayUtil() is being used to
implement a task that executes periodically and
with a fixed frequency – set by xTimeIncrement.
– Be specified in ‘ticks’. The constant
portTICK_PERIOD_MS can be used to convert
ms to ticks.
55
Example 5 Converting the example tasks
to use vTaskDelayUntil()
• Two tasks created in Example 4 are periodic
tasks.
• vTaskDelay() does not ensure that the
frequency at which they run is fixed,
– as the time at which the tasks leave the Blocked
state is relative to when they call vTaskDelay().
56
• In void vTaskFunction(void *pvParameters)
Change
vTaskDelay(250 / portTICK_RATE_MS);
// a period of 250ms is being specified.
To
vTaskDelayUntil( &xLastWakeTime, (250 /
portTICK_PERIOD_MS));
/*xLastWakeTime is initialized with the current tick count
before entering the infinite loop. This is the only time it is
written to explicitly. */
xLastWakeTime = xTaskGetTickCount();
/*It is then updated within vTaskDelayUntil();
automatically */
57
Example 6 Combining blocking and non-
blocking tasks
• Two tasks are created at priority 1.
– Always be either the Ready or the Running state
as never making any API function calls.
– Tasks of this nature are called continuous
processing tasks they always have work to do.
• A Third task is created at priority 2.
– Periodically prints out a string by using
vTaskDelayUntil() to place itself into the Blocked
state between each print iteration.
58
void vContinuousProcessingTask(void * pvParameters) {
char *pcTaskName;
pcTaskName = (char *) pvParameters;
for (;;) { Serial.print(pcTaskName);
delay(100);
}}
60
61
1.7 Idle Task and the Idle task hook
62
• The Idle task is immediately swapped out to
allow Task 2 to execute at the instant Task 2
leaves the Blocked state.
– Task 2 pre-empts the idle task automatically.
63
Idle Task Hook Functions
68
1.8 Change the priority of a task
• unsigned portBASE_TYPE
uxTaskPriorityGet(xTaskHandle pxTask);
– Be used to query the priority of a task
– Available if INCLUDE_vTaskPriorityGet is set 1
– pxTask: Handle of the task whose priority is being
modified. A task can query its own priority by
passing NULL in place of a valid task handle.
– Returned value: the priority currently assigned to
the task being queried
70
Example 8 Changing task priorities
71
Expected Behavior of Example 8
73
• Change vTask1 by initialization
unsigned portBASE_TYPE uxPriority;
uxPriority = uxTaskPriorityGet(NULL);
• And adding to the infinite loop
vTaskPrioritySet(xTask2Handle,
(uxPriority+1));
75
Task execution sequence
76
1.9 Deleting a task
• Function prototype
void vTaskDelete(xTaskHandle pxTaskToDelete);
78
Example 9
void setup( void )
{
// Insure malloc works in tasks
__malloc_heap_end = (char*)RAMEND;
Serial.begin(9600);
/* Create the first task at priority 1. This time the task parameter is
not used and is set to NULL. The task handle is also not used so likewise
is also set to NULL. */
xTaskCreate( vTask1, "Task 1", 200, NULL, 1, NULL );
/* The task is created at priority 1 ^. */
for( ;; );
// return 0;
}
79
void vTask1( void *pvParameters )
{
const TickType_t xDelay100ms = 100 / portTICK_PERIOD_MS;
for( ;; )
{
/* Print out the name of this task. */
Serial.println( "Task1 is running\r\n" );
/* Task2 has/had the higher priority, so for Task1 to reach here Task2
must have already executed and deleted itself. Delay for 100
milliseconds. */
vTaskDelay( xDelay100ms );
}
}
80
void vTask2( void *pvParameters )
{
/* Task2 does nothing but delete itself. To do this it could call vTaskDelete()
using a NULL parameter, but instead and purely for demonstration purposes it
instead calls vTaskDelete() with its own task handle. */
Serial.println( "Task2 is running and about to delete itself\r\n" );
vTaskDelete( xTask2Handle );
}
Example 9 - Serial Monitor
81
Example 9 Deleting tasks (Behavior)
1. Task 1 is created by setup() with priority 1. When it runs,
it creates Task 2 at priority 2. Task 2 as the highest priority
task starts to execute immediately.
2. Task 2 does nothing but delete itself by passing NULL or its
own task handle.
3. When Task 2 has been deleted, Task 1 is again the highest
priority task, so continues executing – at which point it calls
vTaskDelay() to block for a short period.
4. The idle task executes while Task 1 is in the blocked state
and frees the memory that was allocated to the now deleted
Task 2.
5. When Task 1 leaves the blocked state it again becomes the
highest priority Ready state task and preempts the Idle task.
Then, start from Step1 again.
82
Execution sequence
83
Summary –
1. Prioritized pre-emptive scheduling
• Examples illustrate how and when FreeRTOS
selects which task should be in the Running
state.
– Each task is assigned a priority.
– Each task can exist in one of several states.
– Only one task can exist in the Running state at any
one time.
– The scheduler always selects the highest priority
Ready state task to enter the Running state.
84
Fixed priority Pre-emptive scheduling
• Fixed priority
– Each task is assigned a priority that is not altered
by the kernel itself (only tasks can change
priorities)
• Pre-emptive
– A task entering the Ready state or having its
priority altered will always pre-empt the Running
state task, if the Running state task has a lower
priority.
85
Tasks in the Blocked state
88
• Task 3
– An event-driven task
• Execute with a low priority, but above the Idle task priority.
– It spends most of its time in the Blocked state waiting
for the event of interest, transitioning from Blocked to
Ready state each time the event occurs.
• All FreeRTOS inter-task communication mechanisms
(queues, semaphores, etc.) can be used to signal events and
unblock tasks in this way.
– Event occur at t3, t5, and also between t9 and t12.
• The events occurring at t3 and t5 are processed immediately
as it is the highest priority task that is able to run.
• The event occurring somewhere between t9 and t12 is not
processed as until t12 as until then Task 1 and 2 are still
running. They enter Blocked state at t12, making Task 3 the
highest priority Ready state task.
89
• Task 2
– A periodic task that executes at a priority above
Task 3, but below Task1. The period interval
means Task 2 wants to execute at t1, t6 and t9.
• At t6, Task 3 is in Running state, but task 2 has the
higher relative priority so preempts Task 3 and start to
run immediately.
• At t7, Task 2 completes its processing and reenters the
Blocked state, at which point Task 3 can re-enter the
Running state to complete its processing.
• At t8, Task 3 blocks itself.
90
• Task 1
– Also an event-driven task.
– Execute with the highest priority of all, so can
preempt any other task in the system.
– The only Task 1 event shown occurs at t10, at
which time Task 1 pre-empts Task 2.
– Only after Task 1 has re-entered the Blocked at
t11, Task 2 can complete its processing.
91
2. Selecting Task Priorities
92
Rate monotonic scheduling (RMS)
94