Release Notes for
STM32CubeWL Firmware Package
Copyright © 2020 STMicroelectronics
Purpose
STM32WL series will serve all applications requiring Sub-GHz (LoRaWAN, Sigfox) capabilities in a low-power context with an open dual core architecture offer.
STM32Cube is an STMicroelectronics original initiative to ease developers life by reducing development efforts, time and cost.
STM32Cube covers STM32 portfolio.
STM32Cube Version 1.x includes:
- The STM32CubeMX, a graphical software configuration tool that allows to generate C initialization code using graphical wizards.
- A comprehensive embedded software platform, delivered per series (such as STM32CubeWL for STM32WL series)
- The STM32Cube HAL, an STM32 abstraction layer embedded software, ensuring maximized portability across STM32 portfolio
- A consistent set of middleware components such as RTOS, USB, TCP/IP, Graphics, LoRaWAN, Sigfox
All embedded software utilities come with a full set of examples.
The STM32Cube firmware solution offers a straightforward API with a modular architecture, making it simple to fine tune custom applications and scalable to fit most requirements.
The HAL (Hardware Abstraction Layer) & LL (Low Layers) drivers provided within this package supports the following STM32WLxx product:
- STM32WL55xx
- STM32WL54xx
- STM32WLE5xx
- STM32WLE4xx
- STM32WL5Mxx
The HAL and LL drivers provided within this package are compliant with MISRA-C®:2012 guidelines, and have been reviewed with a static analysis tool to eliminate possible run-time errors. Reports are available on demand.
For quick getting started with the STM32CubeWL firmware package, refer to UM2643 and you can download firmware updates and all the latest documentation from www.st.com/stm32cubefw
Here is the list of references to user documents:
- UM2786 : STM32CubeWL demonstration firmware
- UM2643 : Getting started with STM32CubeWL for STM32WLxx Series.
- UM2642 : Description of STM32WL HAL and low-layer drivers.
- AN5409 : STM32Cube MCU Package examples for STM32WL Series.
- AN5406 : How to build a LoRa® application with STM32CubeWL.
- AN5481 : LoRaWAN® AT commands for STM32CubeWL
- AN5554 : LoRaWAN® firmware update over the air with STM32CubeWL
- AN5480 : How to build a Sigfox™ application with STM32CubeWL.
- AN5682 : How to secure LoRaWAN® and Sigfox™ with STM32CubeWL
- AN5687 : Long-packet operation with STM32CubeWL
- UM2767 : Getting started with the SBSFU of STM32CubeWL.
- AN5556 : Getting started with STM32WL dual core using IAR™ and Keil®.
- UM1721 : Developing Applications on STM32Cube with FatFs.
- UM1722 : Developing Applications on STM32Cube with RTOS.
Update History
Main Changes
Maintenance release of STM32CubeWL MCU package
In the STM32CubeWL MCU Package, examples and applications projects are generated with the STM32CubeMX tool to initialize the system, peripherals and middleware stacks. User can open the provided ioc file in STM32CubeMX to modify the settings, add additional peripherals and/or middleware, to build his final application.
Security and RF Applications updates
- Support for new B-WL5M-SUBG1 module
- RF Physical layer: new LR-FHSS modulation support
- FUOTA: possibility to download image in external flash to maximize memory size of User Application
- Secure Counters: Management of protected counters for Metering use case
- Secure Storage: capability to encrypt and decrypt objects in Non Volatile Memory (NVM)
- KMS: Allow dynamic ID objects to be stored in NVM or VM (RAM)
Contents
- CMSIS Device updates
- Refer to release notes for further details
- HAL/LL Drivers updates
- Update HAL/LL drivers to include latest corrections
- Update of ADC, CORTEX, CRC, CRYP, DAC, Generic, I2C, IRDA, LPTIM, RCC, RTC, SMARTCARD, SUBGHZ, TIM, UART, USART, UTILS drivers
- Refer to release notes for further details
- Update HAL/LL drivers to include latest corrections
- Middlewares updates
- Update Security middlewares to include latest corrections and evolutions
- Refer to Key Management Services release notes and Secure Engine release notes for further details
- Update RF middlewares to include latest corrections and evolutions
- Refer to LoRaWAN ST release notes and SubGhz_Phy release notes for further details
- Update Security middlewares to include latest corrections and evolutions
- Projects updates
- New B-WL5M-SUBG1 applications:
- LoRaWAN_AT_Slave, LoRaWAN_End_Node, LoRaWAN_End_Node_DualCore
- Sigfox_AT_Slave, Sigfox_PushButton, Sigfox_PushButton_DualCore
- SubGHz_Phy_Per, SubGHz_Phy_PingPong_DualCore
- New B-WL5M-SUBG1 LoRaWAN FUOTA DualCore project with External Flash usage for Download Slot
- New B-WL5M-SUBG1 Demonstration project
- New NUCLEO-WL55 SubGHz_Phy_AT_Slave and SubGHz_Phy_LrFhss applications
- Change the KMS dynamic objects feature for all Sigfox applications from NVM to VM
- Enable the NVM Secure Storage feature (encrypt blob) in the LoRaWAN_FUOTA_DualCore_ExtFlash and LoRaWAN_SBSFU_1_Slot_DualCore
- New B-WL5M-SUBG1 applications:
| Name | Version | Release notes |
|---|---|---|
| Projects | V1.3.0 | release notes |
Components
The components flagged by “” have changed since the previous release. “” are new.
Drivers
| Name | Version | Release note |
|---|---|---|
| Cortex-M CMSIS | V5.6.0_cm4 | release notes |
| STM32WL CMSIS | V1.2.0 | release notes |
| STM32WLxx_HAL_Driver | V1.3.0 | release notes |
| STM32WLxx_Nucleo | V1.3.0 | release notes |
| B-WL5M-SUBG | V1.0.0 | release notes |
| BSP Common | V7.2.1 | release notes |
| BSP stts22h | V1.3.0 | release notes |
| BSP ism330dhcx | V1.2.2 | release notes |
| BSP iis2mdc | V1.2.0 | release notes |
| BSP ilps22qs | V1.0.0 | release notes |
| BSP mx25l4006 | V1.0.0 | release notes |
Middlewares
| Name | Version | Release note |
|---|---|---|
| FatFS | R0.12c | release notes |
| ST modified 20191011 | ST release notes | |
| FreeRTOS | V10.2.1 | release notes |
| ST modified 20200117 | ST release notes | |
| LoRaWAN | V4.6.0 | release notes |
| V2.5.0 | ST release notes | |
| SubGHz_Phy | V1.3.0 | release notes |
| Sigfox | V1.8.0 | release notes |
| STM32_Key_Management_Services | V1.1.9 | release notes |
| STM32_Secure_Engine | V2.5.3 | release notes |
| mbed-crypto | V1.1.0 | release notes |
| ST modified 20191107 | ST release notes |
Utilities
| Name | Version | Release note |
|---|---|---|
| conf | V1.6.0 | release notes |
| lcd | V2.0.1 | release notes |
| Fonts | V2.0.1 | release notes |
| tiny_lpm | V1.4.2 | release notes |
| sequencer | V1.6.0 | release notes |
| adv_trace | V1.3.0 | release notes |
| timer | V1.2.0 | release notes |
| misc | V1.1.1 | release notes |
Known Limitations
- Projects: Few projects not available at CubeMx format (with .ioc) as not eligible (due to CubeMx limitations)
- The Low Power mode is disabled in the LoRaWAN_FUOTA_DualCore_ExtFlash and LoRaWAN_SBSFU_1_Slot_DualCore due to NVM Secure Storage feature with HAL_RNG limitations
Development Toolchains and Compilers
- IAR Embedded Workbench for ARM (EWARM) toolchain V9.20.1 + Patch EWARM
- RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.36 + Keil DFP V1.1.1 Pack
- Support of ARM Compiler 6 (AC-5 like warnings) for HAL/LL/BSP drivers and STMicroelectronics Middleware components
- STM32CubeIDE 1.11.0 (GNU Tools for STM32 10.3-2021.10)
- STM32CubeProgrammer 2.12.0
Supported Devices and Boards
- STM32WLE5xx, STM32WLE4xx, STM32WL54xx, STM32WL55xx & STM32WL5MOCHxx devices
- NUCLEO-WL55JC1 & NUCLEO-WL55JC2 (except Sigfox applications) ecosystem boards - Nucleo kit RevC (MB1389-HIGHBAND-E02 or MB1389-LOWBAND-E02)
- B-WL5M-SUBG1 ecosystem boards (MB1779-HIGHBAND-A01)
Dependencies
- STM32CubeMX 6.7.0
Main Changes
Maintenance release of STM32CubeWL MCU package
In the STM32CubeWL MCU Package, examples and applications projects are generated with the STM32CubeMX tool to initialize the system, peripherals and middleware stacks. User can open the provided ioc file in STM32CubeMX to modify the settings, add additional peripherals and/or middleware, to build his final application.
Contents
- General updates
- All source files: update disclaimer to add reference to the new license agreement
- CMSIS Device updates
- Refer to release notes for further details
- HAL/LL Drivers updates
- Update HAL/LL drivers to include latest corrections
- Update of ADC, CORTEX, CRC, GPIO, I2C, IRDA, LPTIM, LPUART, RCC, RNG, SMARTCARD, SMBUS, TIM, UART, USART, UTILS drivers
- Refer to release notes for further details
- Update HAL/LL drivers to include latest corrections
- Middlewares updates
- Update RF middlewares to include latest corrections and evolutions
- Refer to LoRaWAN ST release notes and Sigfox release notes for further details
- Update RF middlewares to include latest corrections and evolutions
- Utilities updates
- Update on sequencer to include latest corrections
- Refer to release notes for further details
- Update on sequencer to include latest corrections
- Projects updates
- Update of FW projects following changes in latest version of HAL/LL and Middlewares
- New LoRaWAN_End_Node_FreeRTOS project
- All Sigfox projects moved to Projects/NUCLEO-WL55JC1
| Name | Version | Release notes |
|---|---|---|
| Projects | V1.2.0 | release notes |
Components
The components flagged by “” have changed since the previous release. “” are new.
Drivers
| Name | Version | Release note |
|---|---|---|
| Cortex-M CMSIS | V5.6.0_cm4 | release notes |
| STM32WL CMSIS | V1.1.1 | release notes |
| STM32WLxx_HAL_Driver | V1.2.0 | release notes |
| STM32WLxx_Nucleo | V1.2.0 | release notes |
Middlewares
| Name | Version | Release note |
|---|---|---|
| FatFS | R0.12c | release notes |
| ST modified 20191011 | ST release notes | |
| FreeRTOS | v10.2.1 | release notes |
| ST modified 20200117 | ST release notes | |
| LoRaWAN | V4.5.2 | release notes |
| V2.4.0 | ST release notes | |
| SubGHz_Phy | V1.2.0 | release notes |
| Sigfox | V1.7.1 | release notes |
| STM32_Key_Management_Services | v1.1.8 | release notes |
| STM32_Secure_Engine | v2.5.2 | release notes |
| mbed-crypto | V1.1.0 | release notes |
| ST modified 20191107 | ST release notes |
Utilities
| Name | Version | Release note |
|---|---|---|
| conf | V1.6.0 | release notes |
| lcd | V2.0.1 | release notes |
| Fonts | V2.0.1 | release notes |
| tiny_lpm | V1.4.0 | release notes |
| sequencer | V1.6.0 | release notes |
| adv_trace | V1.3.0 | release notes |
| timer | V1.2.0 | release notes |
| misc | V1.1.0 | release notes |
Known Limitations
- Projects: Few projects not available at CubeMx format (with .ioc) as not eligible (due to CubeMx limitations)
Development Toolchains and Compilers
- IAR Embedded Workbench for ARM (EWARM) toolchain V8.30.1 + Patch EWARM
- RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.31
- Support of ARM Compiler 6 (AC-5 like warnings) for HAL/LL/BSP drivers and STMicroelectronics Middleware components
- STM32CubeIDE 1.9.0 (native GNU ARM 10.3-2021-10 or optional GNU ARM 9-2020-q2-update)
- STM32CubeProgrammer 2.9.0
Supported Devices and Boards
- STM32WLE5xx, STM32WLE4xx, STM32WL54xx & STM32WL55xx devices
- NUCLEO-WL55JC1 & NUCLEO-WL55JC2 (except Sigfox applications) ecosystem boards - Nucleo kit RevC (MB1389-HIGHBAND-E02 or MB1389-LOWBAND-E02)
Backward Compatibility
SBSFU appli not compatible with CubeIDE v1.8
Dependencies
- STM32CubeMX 6.5.0
Main Changes
Maintenance release of STM32CubeWL MCU package
In the STM32CubeWL MCU Package, examples and applications projects are generated with the STM32CubeMX tool to initialize the system, peripherals and middleware stacks. User can open the provided ioc file in STM32CubeMX to modify the settings, add additional peripherals and/or middleware, to build his final application.
Contents
- CMSIS Device updates
- Update CMSIS device to include latest corrections
- Refer to release notes for further details
- HAL/LL Drivers updates
- Update HAL/LL drivers to include latest corrections
- Update of ADC, COMP, CORTEX, CRYP, EXTI, GPIO, HSEM, I2C, IRDA, IWDG, LPUART, LPTIM, PWR, RCC, RNG, RTC, SMARTCARD, SMBUS, SPI, SUBGHZ, TIM, UART, USART drivers
- Update of HAL SMBUS driver to introduce fast mode and fast mode plus
- New extension files: stm32wlxx_hal_smbus_ex.h/.c for new APIs
- Refer to release notes for further details
- Update HAL/LL drivers to include latest corrections
- Middlewares updates
- Update Security middlewares to include latest corrections and evolutions
- Refer to Key Management Services release notes and Secure Engine release notes for further details
- Update RF middlewares to include latest corrections and evolutions
- Refer to LoRaWAN ST release notes and Sigfox release notes for further details
- Update Security middlewares to include latest corrections and evolutions
- Utilities updates
- Update on adv_trace to include latest corrections
- Refer to release notes for further details
- Update on adv_trace to include latest corrections
- Projects updates
- Update of FW projects following changes in latest version of HAL/LL and Middlewares
- New BFU application in 2 Slot configuration (1 download slot associated to 1 execution slot)
- New SBSFU application in 1 slot configuration (new image is written directly into the execution slot)
- New LoRaWAN_FUOTA_DualCore STM32CubeIDE project
- New LoRaWAN_FUOTA Single Core project
- New RF Secure projects: LoRaWAN_SBSFU_1_Slot_DualCore and Sigfox_SBSFU_1_Slot_DualCore
- New SubGHz_Phy_Per Project. Optionally featuring long packet mode (FSK payload > 255 bytes) on stm32wl revision Y
- The STM32CubeWL Firmware package comes with a rich set of examples running on STMicroelectronics boards, organized by board and provided with preconfigured projects for the main supported toolchains.
- The exhaustive list of projects is provided in this table (STM32CubeProjectsList.html).
- The STM32CubeWL Firmware offers full scope of Examples & Applications targeted, developed using STM32CubeMx & ported on 3 toolchains
| Name | Version | Release notes |
|---|---|---|
| Projects | V1.1.0 | release notes |
Components
The components flagged by “” have changed since the previous release. “” are new.
Drivers
| Name | Version | Release note |
|---|---|---|
| Cortex-M CMSIS | V5.6.0_cm4 | release notes |
| STM32WL CMSIS | V1.1.0 | release notes |
| STM32WLxx_HAL_Driver | V1.1.0 | release notes |
| STM32WLxx_Nucleo | V1.1.0 | release notes |
Middlewares
| Name | Version | Release note |
|---|---|---|
| FatFS | R0.12c | release notes |
| ST modified 20191011 | ST release notes | |
| FreeRTOS | v10.2.1 | release notes |
| ST modified 20200117 | ST release notes | |
| LoRaWAN | V4.4.7 | release notes |
| V2.3.0 | ST release notes | |
| SubGHz_Phy | V1.1.0 | release notes |
| Sigfox | V1.7.0 | release notes |
| STM32_Key_Management_Services | v1.1.6 | release notes |
| STM32_Secure_Engine | v2.5.0 | release notes |
| mbed-crypto | V1.1.0 | release notes |
| ST modified 20191107 | ST release notes |
Utilities
| Name | Version | Release note |
|---|---|---|
| conf | V1.4.1 | release notes |
| lcd | V2.0.1 | release notes |
| Fonts | V2.0.1 | release notes |
| tiny_lpm | V1.3.1 | release notes |
| sequencer | V1.5.1 | release notes |
| adv_trace | V1.2.0 | release notes |
| timer | V1.1.2 | release notes |
| misc | V1.0.2 | release notes |
Known Limitations
- Projects: Few projects not available at CubeMx format (with .ioc) as not eligible (due to CubeMx limitations)
Development Toolchains and Compilers
- IAR Embedded Workbench for ARM (EWARM) toolchain V8.30.1 + Patch EWARM + ST-Link
- RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.31 + ST-Link
- Support of ARM Compiler 6 (AC-5 like warnings) for HAL/LL/BSP drivers and STMicroelectronics Middleware components
- STM32CubeIDE 1.7.0 + ST-Link
Supported Devices and Boards
- STM32WLE5xx, STM32WLE4xx, STM32WL54xx & STM32WL55xx devices
- NUCLEO-WL55JC1 & NUCLEO-WL55JC2 (except Sigfox applications) ecosystem boards - Nucleo kit RevC (MB1389-HIGHBAND-E02 or MB1389-LOWBAND-E02)
Backward Compatibility
Not applicable
Dependencies
- STM32CubeMX 6.3.0
Main Changes
First Official Release
In the STM32CubeWL MCU Package, examples and applications projects are generated with the STM32CubeMX tool to initialize the system, peripherals and middleware stacks. User can open the provided ioc file in STM32CubeMX to modify the settings, add additional peripherals and/or middleware, to build his final application.
Contents
- Projects updates
- The STM32CubeWL Firmware package comes with a rich set of examples running on STMicroelectronics boards, organized by board and provided with preconfigured projects for the main supported toolchains.
- The exhaustive list of projects is provided in this table (STM32CubeProjectsList.html).
- The STM32CubeWL Firmware offers full scope of Examples & Applications targeted, developed using STM32CubeMx & ported on 3 toolchains
| Name | Version | Release notes |
|---|---|---|
| Projects | V1.0.0 | release notes |
Components
The components flagged by “” have changed since the previous release. “” are new.
Drivers
| Name | Version | Release note |
|---|---|---|
| Cortex-M CMSIS | V5.6.0_cm4 | release notes |
| STM32WL CMSIS | V1.0.0 | release notes |
| STM32WLxx_HAL_Driver | V1.0.0 | release notes |
| STM32WLxx_Nucleo | V1.0.0 | release notes |
Middlewares
| Name | Version | Release note |
|---|---|---|
| FatFS | R0.12c | release notes |
| ST modified 20191011 | ST release notes | |
| FreeRTOS | V10.2.1 | release notes |
| ST modified 20200117 | ST release notes | |
| LoRaWAN | V4.4.4 | release notes |
| V2.2.1 | ST release notes](Middlewares/Third_Party/LoRaWAN/st_readme.txt) | |
| SubGHz_Phy | V1.0.0 | release notes |
| Sigfox | V1.6.1 | release notes |
| STM32_Key_Management_Services | v1.1.5 | release notes |
| STM32_Secure_Engine | v2.4.1 | release notes |
| mbed-crypto | V1.1.0 | release notes |
| ST modified 20191107 | ST release notes |
Utilities
| Name | Version | Release note |
|---|---|---|
| conf | V1.4.1 | release notes |
| lcd | V2.0.1 | release notes |
| Fonts | V2.0.1 | release notes |
| tiny_lpm | V1.3.1 | release notes |
| sequencer | V1.5.1 | release notes |
| adv_trace | V1.0.5 | release notes |
| timer | V1.1.2 | release notes |
| misc | V1.0.0 | release notes |
Known Limitations
- Projects: Few projects not available at CubeMx format (with .ioc) as not eligible (due to CubeMx limitations)
- Projects: LoRaWAN_FUOTA application not ported on CubeIDE
Development Toolchains and Compilers
- IAR Embedded Workbench for ARM (EWARM) toolchain V8.30.1 + Patch EWARM + ST-Link
- RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.28 + Patch MDK-ARM + ST-Link
- STM32CubeIDE 1.5.0 + ST-Link
Supported Devices and Boards
- STM32WLE5xx, STM32WLE4xx, STM32WL54xx & STM32WL55xx devices
- NUCLEO-WL55JC1 & NUCLEO-WL55JC2 (except Sigfox applications) ecosystem boards - Nucleo kit RevC (MB1389-HIGHBAND-C01 or MB1389-LOWBAND-C01)
Backward Compatibility
Not applicable
Dependencies
- STM32CubeMX 6.1.0