Skip to content

Latest commit

 

History

History
78 lines (50 loc) · 2.74 KB

README.md

File metadata and controls

78 lines (50 loc) · 2.74 KB
Raw

FreeRTOS_Mutex Application Description

This application demonstrates the use of mutexes to serialize access to a shared resource.

The application has two threads:

-Thread1 : Prints messages counting from 1 to 10 ("Thread1 : This is message number x")
           Blinks the green LED every second

-Thread2 : Prints messages counting from 1 to 10 ("Thread2 : This is message number x")
           Blinks the yellow LED every second

The mutex is created before the threads using it are scheduled. Each thread will try to acquire it before outputting characters to the serial port. Once the mutex is acquired, the thread will proceed to printing its message, and then immediately releases it.

If the mutex is not used, the two threads will try to use "printf" at almost the same time. This will result in either thread winning over the other or both threads interrupting each other.

The user can observe the effect of not using a mutex to protect printf by setting the EXAMPLE_USES_MUTEX define in Src/app_freertos.c to 0.

Expected success behavior

If the EXAMPLE_USES_MUTEX is set to 0, some messages will not be printed, or may be corrupted.

If the EXAMPLE_USES_MUTEX is set to 1, each thread will display 10 messages identified by the thread name and the message number , for a total of 20 messages. Additional messages will be printed to displayed when the mutex is acquired or released.

The yellow LED and green LED will toggle every second.

Error behaviors

On failure, the red LED is ON.

Assumptions if any

None

Known limitations

None

Notes

None

FreeRTOS usage hints

The FreeRTOS heap size configTOTAL_HEAP_SIZE defined in FreeRTOSConfig.h is set accordingly to the OS resources memory requirements of the application with +10% margin and rounded to the upper Kbyte boundary.

For more details about FreeRTOS implementation on STM32Cube, please refer to UM1722 "Developing Applications on STM32Cube with RTOS".

Keywords

FreeRTOS, Mutex

Hardware and Software environment

  • This application runs on STM32H563xx devices.

  • This application has been tested with STMicroelectronics NUCLEO-H563ZI board MB1404 Rev. B02 and can be easily tailored to any other supported device and development board.

  • This application uses USART3 to display output, the hyperterminal configuration is as follows:

    • BaudRate = 115200 baud
    • Word Length = 8 Bits
    • Stop Bit = 1
    • Parity = none
    • Flow control = None

How to use it ?

In order to make the program work, you must do the following :

  • Open the project in your preferred toolchain
  • Rebuild all files and load your image into target memory
  • Run the application