1. FreeRTOS

2. Content Task management Task communication Task synchronization
Message queues
Task synchronization
Binary semaphores
Counting semaphores
Mutexes

3. Task management portBASE_TYPE xTaskCreate( pdTASK_CODE pvTaskCode,
const portCHAR * const pcName,
unsigned portSHORT usStackDepth,
void *pvParameters,
unsigned portBASE_TYPE uxPriority,
xTaskHandle *pvCreatedTask );
pvTaskCode Pointer to the task entry function. Tasks must be implemented to never return (i.e. continuous loop).
pcName A descriptive name for the task. This is mainly used to facilitate debugging. Max length defined by configMAX_TASK_NAME_LEN.
usStackDepth The size of the task stack specified as the number of variables the stack can hold - not the number of bytes. For example, if the stack is 16 bits wide and usStackDepth is defined as 100, 200 bytes will be allocated for stack storage. The stack depth multiplied by the stack width must not exceed the maximum value that can be contained in a variable of type size_t.

4. Task management
pvParameters Pointer that will be used as the parameter for the task being created.
uxPriority The priority at which the task should run.
pvCreatedTask Used to pass back a handle by which the created
task can be referenced.
void vTaskDelete( xTaskHandle pxTask );
pxTask The handle of the task to be deleted. Passing NULL
will cause the calling task to be deleted.

5. Task management (Cont.)
void vTaskDelay( portTickType xTicksToDelay );
xTicksToDelay  The amount of time, in tick periods, that the calling
task should block.
void vTaskDelayUntil( portTickType *pxPreviousWakeTime,
portTickType xTimeIncrement );
pxPreviousWakeTime Pointer to a variable that holds the time at which the task
was last unblocked. The variable must be initialised with
the current time prior to its first use. Following this the
variable is automatically updated within
vTaskDelayUntil().
xTimeIncrement The cycle time period. The task will be unblocked at time
(*pxPreviousWakeTime + xTimeIncrement). Calling
vTaskDelayUntil with the same xTimeIncrement
parameter value will cause the task to execute with a
fixed interval period.

6. Task communication
xQueueHandle xQueueCreate( unsigned portBASE_TYPE uxQueueLength, unsigned portBASE_TYPE uxItemSize );
uxQueueLength   The maximum number of items that the queue can
contain.
uxItemSize The number of bytes each item in the queue will require. Items are queued by copy, not by reference, so this is the
number of bytes that will be copied for each posted item.
Each item on the queue must be the same size.
void vQueueDelete( xQueueHandle xQueue );
xQueue A handle to the queue to be deleted.

7. Task communication (Cont.)
portBASE_TYPE xQueueSend( xQueueHandle xQueue,
const void * pvItemToQueue,
portTickType xTicksToWait );
xQueue   The handle to the queue on which the item is to be
posted.
pvItemToQueue A pointer to the item that is to be placed on the queue.
The size of the items the queue will hold was defined when the queue was created, so this many bytes will be copied from pvItemToQueue into the queue storage area.
xTicksToWait The maximum amount of time the task should block
waiting for space to become available on the queue, should it already be full. The call will return immediately if the queue is full and xTicksToWait is set to 0. The time is defined in tick periods so the constant
portTICK_RATE_MS should be used to convert to real time if this is required.

8. Task communication (Cont.)
portBASE_TYPE xQueueReceive( xQueueHandle xQueue,
void *pvBuffer,
portTickType xTicksToWait );
xQueue   The handle to the queue on which the item is to be posted.
pvBuffer Pointer to the buffer into which the received item will be
copied.
xTicksToWait The maximum amount of time the task should block
waiting for an item to receive should the queue be empty at the time of the call. Setting xTicksToWait to 0 will cause the function to return immediately if the queue is empty. The time is defined in tick periods so the constant portTICK_RATE_MS should be used to convert to real
time if this is required.

9. Task communication (Cont.)
portBASE_TYPE xQueueSendFromISR( xQueueHandle pxQueue,
const void *pvItemToQueue, portBASE_TYPE *pxHigherPriorityTaskWoken );
xQueue   The handle to the queue on which the item is to be posted.
pvItemToQueue A pointer to the item that is to be placed on the queue.
The size of the items the queue will hold was defined when the queue was created, so this many bytes will be copied from pvItemToQueue into the queue storage area.
pxHigherPriorityTaskWoken
xQueueSendFromISR() will set *pxHigherPriorityTaskWoken to pdTRUE if sending to the queue caused a task to unblock, and the unblocked task has a priority higher than the currently running task. If xQueueSendFromISR() sets this value to pdTRUE then a context switch should be requested before the interrupt is exited.

10. Task communication (Cont.)
portBASE_TYPE xQueueReceiveFromISR( xQueueHandle pxQueue,
void *pvBuffer,
portBASE_TYPE *pxTaskWoken );
xQueue   The handle to the queue on which the item is to be posted.
pvBuffer Pointer to the buffer into which the received item will be
copied.
pxTaskWoken A task may be blocked waiting for space to become available on the queue. If xQueueReceiveFromISR causes such a task to unblock *pxTaskWoken will get set to pdTRUE, otherwise *pxTaskWoken will remain unchanged.

11. Task synchronization
vSemaphoreCreateBinary( xSemaphoreHandle xSemaphore )
xSemaphore   Handle to the created semaphore. Should be of type xSemaphoreHandle.
xSemaphoreHandle xSemaphoreCreateCounting(
unsigned portBASE_TYPE uxMaxCount,
unsigned portBASE_TYPE uxInitialCount )
uxMaxCount The maximum count value that can be reached. When the semaphore reaches this value it can no longer be 'given'.
uxInitialCount The count value assigned to the semaphore when it is created.
xSemaphoreHandle xSemaphoreCreateMutex( void )

12. Task synchronization (Cont.)
xSemaphoreTake( xSemaphoreHandle xSemaphore,
portTickType xBlockTime )
xSemaphore   Handle to the created semaphore. Should be of type xSemaphoreHandle.
xBlockTime  The time in ticks to wait for the semaphore to become available. The macro portTICK_RATE_MS can be used to convert this to a real time. A block time of zero can be used to poll the semaphore.
xSemaphoreGive( xSemaphoreHandle xSemaphore )
xSemaphore A handle to the semaphore being released. This is the handle returned when the semaphore was created.

13. Task synchronization (Cont.)
xSemaphoreGiveFromISR( xSemaphoreHandle xSemaphore,
signed portBASE_TYPE *pxHigherPriorityTaskWoken )
xSemaphore   Handle to the created semaphore. Should be of type xSemaphoreHandle.
pxHigherPriorityTaskWoken   xSemaphoreGiveFromISR() will set *pxHigherPriorityTaskWoken to pdTRUE if giving the semaphoree caused a task to unblock, and the unblocked task has a priority higher than the currently running task. If xSemaphoreGiveFromISR() sets this value to pdTRUE then a context switch should be requested before the interrupt is exited.

14. Example of interrupt function
void EXTI_IRQHandler(void) {
portBASE_TYPE xHigherPriorityTaskWoken = pdFALSE; // local var.
if(EXTI_GetITStatus(EXTI_Line10) != RESET)
EXTI_ClearITPendingBit(EXTI_Line10);
xSemaphoreGiveFromISR(Semaphore1, & xHigherPriorityTaskWoken);
portEND_SWITCHING_ISR( xHigherPriorityTaskWoken ); // must have }

15. Assignment

16. Assignment RTOS FreeRTOS 1 tick = 10 ms. User tasks function:
taskA, periodic task , every 100 ms, updates time, hr, mn, sc, dc.
taskB, periodic task , every 1 sec , sends time to terminal ,
Time hr:mn:sc ( Time 01:25:58 ).
taskC, waits for sw key4 interrupt , reads time of taskA, creates string "sw4 hr:mn:sc.dc" and sends string to taskE
taskD, waits for ascii data from uart rx interrupt, if data is available then reads one data from rx interrupt and reads time of taskA, creates string "$ hr:mn:sc.dc" ( $ is the received ascii character from uart rx interrupt ) and sends string to taskE ( k 03:01:59.6 )
taskE, waits for uart tx ready and uart tx data, if uart tx is available and data from other tasks is available then reads one data and writes it to uart tx register and enables uart tx interrupt to start transmitting.

17. Assignment RTOS (Cont.)
User interrupt functions:
sw key4 interrupt, makes taskC ready.
uart rx interrupt, receives a character from terminal, if it is 'a' - 'z' then send it to taskD.
uart tx interrupt, sends one data to uart tx register each time, if no more data to send then disables uart tx interrupt and makes uart tx available for taskE.

18. Assignment RTOS (Cont.)
Example: Terminal
Time 00:00:01
Time 00:00:02
Time 00:00:03
a 00:00:03.01
t 00:00:03.40
Time 00:00:04
u 00:00:04.90
Time 00:00:05
Time 00:00:06
sw4 00:00:06.05
Time 00:00:07
sw4 00:00:07.05
u 00:00:07.70
Time 00:00:08
Time 00:00:09

19. Task flow diagram Task A ? Task C Task D ? ? ? Task B Uart rx ISR
1 tick = 10 ms.
Task A
Task C ?
Task D ?
Task B ? ?
Uart rx ISR
Ext ISR ?
Task E
Uart tx ISR ?