Repository files navigation

This is a port of FreeRTOS for STM32 as Arduino libraries.

For more information about FreeRTOS, visit theFreeRTOS Web Site.Also, See the very usefulGetting Started page.

This library provides 2 FreeRTOS versions:

• 9.x
• 10.x:
  • 10.0.1
  • 10.2.1
  • 10.3.1

Each have been modified by ST (See st_readme.txt in FreeRTOS Source).

These are the same provided with theSTM32Cube MCU Packages.Or thanks toSTMicroelectronics GitHub organization:stm32_mw_freertos.

FreeRTOS has several configuration options, which can be specified from within the FreeRTOSConfig.h file.

This library provides a default FreeRTOS configuration file namedFreeRTOSConfig_Default.h.

User can provide his own FreeRTOS configuration file at sketch level by adding his configuration in a file namedSTM32FreeRTOSConfig.h.

Or add extra FreeRTOS configuration to the default at sketch level by adding an extra configuration in a file namedSTM32FreeRTOSConfig_extra.h.

Heap allocation schemes are provided by FreeRTOS, seeMemory allocation implementations included in the RTOS source.To extend those schemes a thread-safe heap allocation using C runtime (Newlib) has been added based on Dave Nadler work:

http://www.nadler.com/embedded/newlibAndFreeRTOS.html

By default, theheap_useNewlib.c is used. It can be changed thanks a define in the configuration file:

/* Define memory allocation implementations to use: * 1 to 5 for heap_[1-5].c * -1 for heap_useNewlib_ST.c * Default -1 see heap.c */

Since v10.0.1, CMSIS-RTOSv2 can be used instead of default CMSIS-RTOS.

configUSE_CMSIS_RTOS_V2 has to be defined and set to1 to useCMSIS-RTOSv2.

• MPU: not supported.
• No CMSIS-RTOSv2 support provided. It is provided as example.
• On Cortex-M0 and Cortex-M0+, all IT are disabled between xTaskCreate() and vTaskStartScheduler().So it is not possible to use IT inbetween, like Serial.print() ...This is the reason why, in example "frLiyLayland", between xTaskCreate() and vTaskStartScheduler(),we use direct printf(), which will access directly USART without interrupt

• STM32FreeRTOS.h : Must always be #include first. It references required include files.
• STM32FreeRTOSConfig.h : If exist at sketch level, it contains the FreeRTOS configurations.
• STM32FreeRTOSConfig_extra.h : If exist at sketch level, it contains extra FreeRTOS configurations.
• FreeRTOSConfig_Default.h : Contains the default FreeRTOS configurations for this STM32 port ifSTM32FreeRTOSConfig.h doesn't exist.

* PASSED withconfigUSE_NEWLIB_REENTRANT set to 0 due to small RAM.

* PASSED withconfigUSE_NEWLIB_REENTRANT set to 0 due to small RAM.