View source for Mutex Semaphore 02: Recursive Locks ← Mutex Semaphore 02: Recursive Locks

[[category: Free RTOS with Arduino]]
In this tutorial, we will see one of the demerits of binary semaphore ie. Non-Recursive Locks.<br>
Here we will see what happens if a task tries to acquire same binary semaphore more than ones.<br><br>

==Teminologies==
#<b>LPT:</b> Low Priority Task
#<b>MPT:</b> Medium Priority Task
#<b>HPT:</b> High Priority Task


=Prerequisites=
Please check [[Semaphore|this tutorial]] for detailed explanation on Semaphores.<br> <br>

=API Details=
Below is the list of the API's used in this tutorial.

<b>1.xTaskCreate()</b>: This interface is used to create a new Task, if the task is successfully created then it returns pdPass(1) or else errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY(-1). Check [http://www.freertos.org/a00125.html this link] for more details.<br>

<b>2.vTaskDelay()</b>: This function is used to delay/block the task for specified delay time(ticks). INCLUDE_vTaskDelay needs to be set to 1 in FreeRtosConfig.h file for using this function. Check [http://www.freertos.org/a00127.html this link] for more details.<br>

<b>3.vTaskDelete():</b>This function is used to delete as task. We need to pass the taskHandle of the task to be deleted.<br> To delete the own task we should pass NULL as parameter.<br> 
Please check [http://www.freertos.org/a00126.html this link] for details. <br>

<b>4.vSemaphoreCreateBinary():</b> This interface is used to create a binary semaphore. We need to pass a handle of type SemaphoreHandle_t to this function.<br> 
Please check [http://www.freertos.org/a00121.html this link] for details. <br>

<b>5.xSemaphoreTake():</b> This interface is used to acquire a binary semaphore. We need to pass a semaphore handle and the amount of time to wait for semaphore to become available.<br> 
Please check [http://www.freertos.org/a00122.html this link] for details. <br>

<b>6.xSemaphoreGive():</b> This interface is used to release a binary semaphore. We need to pass a semaphore handle to this function.<br> 
Please check [http://www.freertos.org/a00123.html this link] for details. <br>

<b>7.vSemaphoreDelete ():</b> This interface is used to delete a binary semaphore. We need to pass a semaphore handle to this function.<br> 
Please check [http://www.freertos.org/a00113.html#vSemaphoreDelete this link] for details. <br>


=Example=
In this example, we will be creating an LPT. LPT will acquire a semaphore and creates an HPT.
HPT will preempt LPT as starts running. HPT tries to acquire a semaphore used by LPT and goes to blocked state resulting in priority inversion. Now LPT starts running and requests for the same semaphore.

<html><script src="https://gist.github.com/SaheblalBagwan/dbcd698228010f3a95c4927f18c365e8.js"></script></html>

[[File:BinarySemaphoreNonRecursiveLock.png]]

#LPT starts running and acquires the semaphore.
#Now HPT is created and it preempts LPT and starts running. It makes the request to acquire the semaphore. Since the semaphore is already with LPT, HPT goes to blocked state.
#LPT starts executing again and tries to take the same semaphore. Since the semaphore is not available, it gets blocked. 
#Finally the scheduler is left out with the idle task and it keeps running. The LPT and HPT will in blocked state until someone releases the semaphore.


Have an opinion, suggestion , question or feedback about the article let it out here!
{{DISQUS}}