X-CUBE-FREERTOS FreeRTOS Software Expansion for STM32Cube
This repository has been created using the git submodule command. Please refer to the “How to use” section for more details.
With FreeRTOS complementing the extensive STM32Cube ecosystem providing free development tools, software bricks, and software expansion packages, STM32 users can also leverage the rich services of FreeRTOS which meet the needs of tiny, smart, connected devices.
X-CUBE-FREERTOS (FreeRTOS RTOS Software Expansion for STM32Cube) provides a full integration of FreeRTOS in the STM32Cube environment for the STM32U5, STM32H5, STM32WBA , STM32C0, STM32U0, STM32U3 and STM32N6 series of microcontrollers.
Ready-to-run applicative examples are also provided for the NUCLEO-H563ZI, NUCLEO-U575ZI-Q, NUCLEO-WBA55CG, NUCLEO-WBA65RI, NUCLEO-WBA25CE1, NUCLEO-C031C6, NUCLEO-U083RC, NUCLEO-U385RG-Q and NUCLEO-N657X0-Q, thus reducing the learning curve and ensuring a smooth application development experience with FreeRTOS RTOS and STM32U5, STM32H5, STM32WBA, STM32C0, STM32U0, STM32U3 or STM32N6 MCUs.
Prerequisites
One of the following toolchains:
- IAR Embedded Workbench for ARM (EWARM) toolchain 9.20.1 + ST-LINKV3 for STM32U5, STM32H5, STM32C0 and STM32U0
- IAR Embedded Workbench for ARM (EWARM) toolchain 9.20.4 + ST-LINKV3 for STM32U3
- IAR Embedded Workbench for ARM (EWARM) toolchain 9.40.1 + ST-LINKV3 for STM32N6
- IAR Embedded Workbench for ARM (EWARM) toolchain 9.60.3 + ST-LINKV3 for STM32WBA
- STM32CubeIDE V2.2.0 + ST-LINKV3
- RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.39 + ST-LINKV3
Supported Devices and Boards by applications
Repository structure
The STMicroelectronics GitHub X-CUBE-FREERTOS repository consists of the following repositories:
- Drivers: contains STM32U5, STM32H5, STM32WBA, STM32C0, STM32U0 STM32U3 and STM32N6 CMSIS and HAL drivers.
- Middlewares: contains FreeRTOS Middleware files.
- Projects: provides ready-to-run applicative examples for FreeRTOS RTOS on the supported boards. Projects are structured as follows:
Documentation
More comprehensive documentation is available on FreeRTOS FreeRTOS documentation.
License
None
Release note
Details about the content of this release are available in the release note here.
Applications
| STM32H5 Applications |
Short Description |
| FreeRTOS_Mutex |
This application demonstrates the use of mutexes to serialize access to a shared resource. readme |
| FreeRTOS_MPU |
This application demonstrates the use of the MPU with FreeRTOS to control memory/peripheral access for tasks. readme |
| FreeRTOS_Queues_ThreadFlags_TrustZone |
This application demonstrates the use of message queues, thread flags with CMSIS_RTOS2 API along with the use of FreeRTOS when the TrustZone feature is enabled (TZEN=1) readme |
| FreeRTOS_Semaphore_LowPower |
This application demonstrates the use of FreeRTOS tickless low power mode and semaphoresreadme |
| STM32U5 Applications |
Short Description |
| FreeRTOS_Mutex |
This application demonstrates the use of mutexes to serialize access to a shared resource. readme |
| FreeRTOS_MPU |
This application demonstrates the use of the MPU with FreeRTOS to control memory/peripheral access for tasks. readme |
| FreeRTOS_Queues_ThreadFlags_TrustZone |
This application demonstrates the use of message queues, thread flags with CMSIS_RTOS2 API along with the use of FreeRTOS when the TrustZone feature is enabled (TZEN=1) readme |
| FreeRTOS_Semaphore_LowPower |
This application demonstrates the use of FreeRTOS tickless low power mode and semaphoresreadme |
| STM32WBA Applications |
Short Description |
| FreeRTOS_Mutex |
This application demonstrates the use of mutexes to serialize access to a shared resource. readme |
| FreeRTOS_MPU |
This application demonstrates the use of the MPU with FreeRTOS to control memory/peripheral access for tasks. readme |
| FreeRTOS_Queues_ThreadFlags_TrustZone |
This application demonstrates the use of message queues, thread flags with CMSIS_RTOS2 API along with the use of FreeRTOS when the TrustZone feature is enabled (TZEN=1) readme |
| FreeRTOS_Semaphore_LowPower |
This application demonstrates the use of FreeRTOS tickless low power mode and semaphoresreadme |
| FreeRTOS_Mutex |
This application demonstrates the use of mutexes to serialize access to a shared resource. readme |
| FreeRTOS_MPU |
This application demonstrates the use of the MPU with FreeRTOS to control memory/peripheral access for tasks. readme |
| FreeRTOS_Queues_ThreadFlags_TrustZone |
This application demonstrates the use of message queues, thread flags with CMSIS_RTOS2 API along with the use of FreeRTOS when the TrustZone feature is enabled (TZEN=1) readme |
| FreeRTOS_Semaphore_LowPower |
This application demonstrates the use of FreeRTOS tickless low power mode and semaphoresreadme |
| FreeRTOS_Mutex |
This application demonstrates the use of mutexes to serialize access to a shared resource. readme |
| FreeRTOS_MPU |
This application demonstrates the use of the MPU with FreeRTOS to control memory/peripheral access for tasks. readme |
| FreeRTOS_Queues_ThreadFlags_TrustZone |
This application demonstrates the use of message queues, thread flags with CMSIS_RTOS2 API along with the use of FreeRTOS when the TrustZone feature is enabled (TZEN=1) readme |
| FreeRTOS_Semaphore_LowPower |
This application demonstrates the use of FreeRTOS tickless low power mode and semaphoresreadme |
| STM32C0 Applications |
Short Description |
| FreeRTOS_Mutex |
This application demonstrates the use of mutexes to serialize access to a shared resource. readme |
| FreeRTOS_Queues_ThreadFlags |
This application demonstrates the use of message queues, thread flags with CMSIS_RTOS2 API readme |
| FreeRTOS_Semaphore_LowPower |
This application demonstrates the use of FreeRTOS tickless low power mode and semaphoresreadme |
| STM32U0 Applications |
Short Description |
| FreeRTOS_Mutex |
This application demonstrates the use of mutexes to serialize access to a shared resource. readme |
| FreeRTOS_Queues_ThreadFlags |
This application demonstrates the use of message queues, thread flags with CMSIS_RTOS2 API readme |
| FreeRTOS_Semaphore_LowPower |
This application demonstrates the use of FreeRTOS tickless low power mode and semaphoresreadme |
| STM32U3 Applications |
Short Description |
| FreeRTOS_Mutex |
This application demonstrates the use of mutexes to serialize access to a shared resource. readme |
| FreeRTOS_MPU |
This application demonstrates the use of the MPU with FreeRTOS to control memory/peripheral access for tasks. readme |
| FreeRTOS_Queues_ThreadFlags_TrustZone |
This application demonstrates the use of message queues, thread flags with CMSIS_RTOS2 API along with the use of FreeRTOS when the TrustZone feature is enabled (TZEN=1) readme |
| FreeRTOS_Semaphore_LowPower |
This application demonstrates the use of FreeRTOS tickless low power mode and semaphoresreadme |
| STM32N6 Applications |
Short Description |
| FreeRTOS_Mutex |
This application demonstrates the use of mutexes to serialize access to a shared resource. readme |
| FreeRTOS_MPU |
This application demonstrates the use of the MPU with FreeRTOS to control memory/peripheral access for tasks. readme |
| FreeRTOS_Queues_ThreadFlags_TrustZone |
This application demonstrates the use of message queues, thread flags with CMSIS_RTOS2 API along with the use of FreeRTOS when the TrustZone feature is enabled (TZEN=1) readme |
| FreeRTOS_Semaphore_LowPower |
This application demonstrates the use of FreeRTOS tickless low power mode and semaphoresreadme |
How to use
This repository intrinsically contains the applications (projects and source files) located under folder ./Projects.
It also contains the CMSIS Core files under folder ./Drivers/CMSIS/Include for size optimization reason.
Other dependencies such as the HAL drivers, or the middleware libraries themselves are linked using the git submodule command.
Please check the instructions below for a proper use.
- To clone the repository, run the command below
git clone --recursive https://github.com/STMicroelectronics/x-cube-freertos.git
- To pull the latest updates, run the commands below from the root of the repository
git pull
git submodule update --init --recursive
- If GitHub “Download ZIP” option is used instead of the
git clone command, then the different submodules have to be collected and added manually.
Troubleshooting
Caution : The issues are strictly limited to submit problems or suggestions related to the software delivered in this repository.
For any other question related to the product, the hardware performance or characteristics, the tools, the environment, you can submit it to the ST Community on the STM32 MCUs related page.
评论