Skip to content

Commit dc3f0aa

Browse files
committed
Update library information for v10.0.1
Signed-off-by: Frederic.Pillon <[email protected]>
1 parent b7057f4 commit dc3f0aa

File tree

3 files changed

+39
-6
lines changed

3 files changed

+39
-6
lines changed

README.md

+37-4
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,13 @@ This is a port of FreeRTOS for STM32 as Arduino libraries.
55
For more information about FreeRTOS, visit the [FreeRTOS Web Site](http://www.freertos.org/ "FreeRTOS").
66
Also, See the very useful [Getting Started](http://www.freertos.org/FreeRTOS-quick-start-guide.html "Quick Start Guide") page.
77

8-
Current FreeRTOS version used for this library is [9.0.0](http://www.freertos.org/FreeRTOS-V9.html) and has been modified by ST (See st_readme.txt in FreeRTOS Source).
8+
This library provides 2 FreeRTOS versions:
9+
* [9.0.0](http://www.freertos.org/FreeRTOS-V9.html)
10+
* [10.0.1](http://www.freertos.org/FreeRTOS-V10.html)
911

10-
This is the current one provided with the [STM32Cube MCU Packages](http://www.st.com/en/embedded-software/stm32cube-mcu-packages.html)
12+
Both have been modified by ST (See st_readme.txt in FreeRTOS Source).
13+
14+
These are the same provided with the [STM32Cube MCU Packages](http://www.st.com/en/embedded-software/stm32cube-mcu-packages.html)
1115

1216
## Configuration
1317

@@ -17,11 +21,13 @@ This library provides a default FreeRTOS configuration file named `FreeRTOSConfi
1721

1822
User can provide his own FreeRTOS configuration file at sketch level by adding his configuration in a file named `STM32FreeRTOSConfig.h`.
1923

24+
Or add extra FreeRTOS configuration to the default at sketch level by adding an extra configuration in a file named `STM32FreeRTOSConfig_extra.h`.
25+
2026
Heap allocation schemes are provided by FreeRTOS, see [Memory allocation implementations included in the RTOS source](https://www.freertos.org/a00111.html).
2127
To extend those schemes a thread-safe heap allocation using C runtime (Newlib) has been added based on Dave Nadler work:
2228

2329
http://www.nadler.com/embedded/newlibAndFreeRTOS.html
24-
30+
2531
By default, the `heap_useNewlib.c` is used. It can be changed thanks a define in the configuration file:
2632
```
2733
/* Define memory allocation implementations to use:
@@ -31,24 +37,51 @@ By default, the `heap_useNewlib.c` is used. It can be changed thanks a define in
3137
*/
3238
```
3339

40+
Since v10.0.1, CMSIS-RTOSv2 can be used instead of default CMSIS-RTOS.
41+
42+
`configUSE_CMSIS_RTOS_V2` has to be defined and set to `1` to use
43+
CMSIS-RTOSv2.
44+
45+
3446
## Limitations
3547

3648
* MPU: not supported.
49+
* No CMSIS-RTOSv2 support provided. It is provided as example.
3750

3851
## Files & Configuration
3952

4053
* STM32FreeRTOS.h : Must always be #include first. It references required include files.
4154
* STM32FreeRTOSConfig.h : If exist at sketch level, it contains the FreeRTOS configurations.
55+
* STM32FreeRTOSConfig_extra.h : If exist at sketch level, it contains extra FreeRTOS configurations.
4256
* FreeRTOSConfig_Default.h : Contains the default FreeRTOS configurations for this STM32 port if `STM32FreeRTOSConfig.h` doesn't exist.
4357

4458
## Test results (using [Arduino_Core_STM32](https://github.com/stm32duino/Arduino_Core_STM32))
59+
60+
### STM32FreeRTOS v9.0.x
4561
| Board | AnalogRead_DigitalRead | Blink_AnalogRead | frBlink | frBlinkPrint | frJitter | frLiuLayland |
4662
| --- | :---: | :---: | :---: | :---: | :---: | :---: |
4763
| [Nucleo F091RC](http://www.st.com/en/evaluation-tools/nucleo-f091rc.html) | PASSED | PASSED | PASSED | PASSED | PASSED | FAILED |
4864
| [Nucleo F103RB](http://www.st.com/en/evaluation-tools/nucleo-f103rb.html) | PASSED | PASSED | PASSED | PASSED | PASSED | PASSED |
4965
| [Nucleo F303RE](http://www.st.com/en/evaluation-tools/nucleo-f303re.html) | PASSED | PASSED | PASSED | PASSED | PASSED | PASSED |
5066
| [Nucleo F429ZI](http://www.st.com/en/evaluation-tools/nucleo-f429zi.html) | PASSED | PASSED | PASSED | PASSED | PASSED | PASSED |
5167
| [STM32F746G-DISCOVERY](http://www.st.com/en/evaluation-tools/32f746gdiscovery.html) | PASSED | PASSED | PASSED | PASSED | PASSED | PASSED |
52-
| [Nucleo L053R8](http://www.st.com/en/evaluation-tools/nucleo-l053r8.html) | PASSED | PASSED | PASSED | PASSED | PASSED | FAILED |
68+
| [Nucleo L053R8](http://www.st.com/en/evaluation-tools/nucleo-l053r8.html) | PASSED* | PASSED* | PASSED* | PASSED* | PASSED* | FAILED |
5369
| [Nucleo L152RE](http://www.st.com/en/evaluation-tools/nucleo-l152re.html) | PASSED | PASSED | PASSED | PASSED | PASSED | PASSED |
5470
| [B-L475E-IOT01A](http://www.st.com/en/evaluation-tools/b-l475e-iot01a.html) | PASSED | PASSED | PASSED | PASSED | PASSED | PASSED |
71+
72+
### STM32FreeRTOS v10.0.x
73+
| Board | AnalogRead_DigitalRead | frBlinkPrint | frLiuLayland | frBlink (CMSIS-RTOSv2) | Blinky (CMSIS-RTOSv2) |
74+
| --- | :---: | :---: | :---: | :---: | :---: |
75+
| [Nucleo F091RC](http://www.st.com/en/evaluation-tools/nucleo-f091rc.html) | PASSED | PASSED | FAILED | PASSED | PASSED |
76+
| [Nucleo F103RB](http://www.st.com/en/evaluation-tools/nucleo-f103rb.html) | PASSED | PASSED | PASSED | PASSED | PASSED |
77+
| [Nucleo F303RE](http://www.st.com/en/evaluation-tools/nucleo-f303re.html) | PASSED | PASSED | PASSED | PASSED | PASSED |
78+
| [Nucleo F429ZI](http://www.st.com/en/evaluation-tools/nucleo-f429zi.html) | PASSED | PASSED | PASSED | PASSED | PASSED |
79+
| [STM32F746G-DISCOVERY](http://www.st.com/en/evaluation-tools/32f746gdiscovery.html) | PASSED | PASSED | PASSED | PASSED | PASSED |
80+
| [Nucleo-G071RB](https://www.st.com/en/evaluation-tools/nucleo-g071rb.html) | PASSED | PASSED | FAILED | PASSED | PASSED |
81+
| [Nucleo H743ZI](https://www.st.com/en/evaluation-tools/nucleo-h743zi.html) | PASSED | PASSED | PASSED | PASSED | PASSED |
82+
| [Nucleo L053R8](http://www.st.com/en/evaluation-tools/nucleo-l053r8.html) | PASSED* | PASSED* | FAILED | PASSED | PASSED |
83+
| [Nucleo L152RE](http://www.st.com/en/evaluation-tools/nucleo-l152re.html) | PASSED | PASSED | PASSED | PASSED | PASSED |
84+
| [B-L475E-IOT01A](http://www.st.com/en/evaluation-tools/b-l475e-iot01a.html) | PASSED | PASSED | PASSED | PASSED | PASSED |
85+
| [P-Nucleo-WB55RG](https://www.st.com/en/evaluation-tools/p-nucleo-wb55.html) | PASSED | PASSED | FAILED | PASSED | PASSED |
86+
87+
\* PASSED with `configUSE_NEWLIB_REENTRANT` set to 0 due to small RAM.

library.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "STM32duino FreeRTOS",
3-
"version": "9.0.4",
3+
"version": "10.0.1",
44
"keywords": "rtos, timing, thread, task, mutex, semaphore",
55
"description": "Real Time Operating System implemented for STM32",
66
"repository": {

library.properties

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
name=STM32duino FreeRTOS
2-
version=9.0.4
2+
version=10.0.1
33
author=Richard Barry <[email protected]>
44
maintainer=stm32duino
55
sentence=Real Time Operating System implemented for STM32

0 commit comments

Comments
 (0)