Release Notes for STM32CubeL5 Firmware Package
Copyright © 2019 STMicroelectronics
License
Licensed by ST under ST license SLA0048 (the "License"); You may not use this package except in compliance with the License. You may obtain a copy of the License at:
Purpose
STM32L5 series will serve all applications requiring ultra low-power and security thanks to Cortex-M33 core with the TrustZone support.
STMCube 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 STM32CubeL5 for STM32L5 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
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 set of middleware components depends on the STM32 Series.
The HAL (Hardware Abstraction Layer) and LL (Low Layers) drivers provided within this package support the STM32L552xx/62xx lines.
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.
Update History
Main Changes
First release of STM32CubeL5 Firmware Package
Contents
- CMSIS Device STM32L5xx for STM32L552xx/STM32L562xx
- Note: default Security Attribut Unit (SAU) configuration in partition_stm32l552xx.h and partition_stm32l562xx.h is available from \Include\Templates
- default SAU setup is:
- SAU region 0: 0x0C03E000-0x0C03FFFF (Secure, Non-Secure Callable)
- SAU region 1: 0x08040000-0x0807FFFF (Non-Secure FLASH Bank2 (256 Kbytes))
- SAU region 2: 0x20018000-0x2003FFFF (Non-Secure RAM (2nd half SRAM1 + SRAM2 (160 Kbytes)))
- SAU region 3: 0x40000000-0x4FFFFFFF (Non-Secure Peripherals mapped memory)
- SAU region 4: 0x60000000-0x9FFFFFFF (Non-Secure external memories)
- SAU region 5: 0x0BF90000-0x0BFA8FFF (Non-Secure System memory)
- default SAU setup is:
- Note: default Security Attribut Unit (SAU) configuration in partition_stm32l552xx.h and partition_stm32l562xx.h is available from \Include\Templates
- HAL and LL drivers
- HAL drivers
- ADC, COMP, CORTEX, CRC, CRYP, DAC, DFSDM, DMA, EXTI, FDCAN, FLASH, GPIO, GTZC, HASH, I2C, ICACHE, IRDA, IWDG, LPTIM, MMC, NAND, NOR, OPAMP, OSPI, OTFDEC, PCD, PKA, PWR, RCC, RNG, RTC, SAI, SD, SMARTCARD, SMBUS, SPI, SRAM, TIM, TSC, UART, USART, WWDG
- Alternate TIM and RTC timebase templates (to be copied in user application)
- LL drivers
- ADC, BUS, COMP, CORTEX, CRC, CRS, CRYP, DAC, DMA, DMAMUX, EXTI, GPIO, I2C, IWDG, LPTIM, LPUART, OPAMP, PKA, PWR, RCC, RNG, RTC, SDMMC, SPI, SYSTEM, TIM, UCPD, USART, UTILS, WWDG
- HAL drivers
BSP board drivers for NUCLEO-L552ZE-Q (MB1361-C02), STM32L552E-EV (MB1372-C02) and STM32L562E-DK (MB1373-C01)
- Projects examples for TrustZone-disabled and TrustZone-enabled system configurations (refer to STM32CubeProjectsList.html for Projects list)
- Naming rule applied on Project Templates
- Templates/TrustZoneDisabled when TrustZone security is disabled in the system (Flash option bit TZEN=0)
- Templates/TrustZoneEnabled when TrustZone security is enabled in the system (Flash option bit TZEN=1)
- Naming rule applied on Project Examples
- "_TrustZone" suffix used for TrustZone-enabled projects (Flash option bit TZEN=1) except Trusted Firmware-M (TFM) applications, others are provided for default TrustZone-disabled system (Flash option bit TZEN=0) but can be easily ported to TrustZone-enabled system.
- Naming rule applied on Project Templates
Components
| Name | Version | License | Release note |
|---|---|---|---|
| Cortex-M CMSIS | V5.4.0 | Apache-2.0 | release notes |
| STM32L5xx CMSIS | V1.0.0 | Apache-2.0 | release notes |
| STM32L5xx HAL | V1.0.0 | BSD-3-Clause | release notes |
| BSP STM32L552E_EVAL | V1.0.0 | BSD-3-Clause | release notes |
| BSP STM32L562E-Discovery | V1.0.0 | BSD-3-Clause | release notes |
| BSP STM32L5xx_Nucleo | V1.0.0 | BSD-3-Clause | release notes |
| BSP Common | V6.0.1 | BSD-3-Clause | release notes |
| BSP cs42l51 | V2.0.1 | BSD-3-Clause | release notes |
| BSP ft6x06 | V2.0.0 | BSD-3-Clause | release notes |
| BSP hx8347i | V2.0.0 | BSD-3-Clause | release notes |
| BSP iss66wvh8m8 | V2.0.0 | BSD-3-Clause | release notes |
| BSP lsm6dso | V1.2.1 | BSD-3-Clause | release notes |
| BSP mfxstm32l152 | V3.0.1 | BSD-3-Clause | release notes |
| BSP mx25lm51245g | V2.0.1 | BSD-3-Clause | release notes |
| BSP stmpe811 | V3.0.0 | BSD-3-Clause | release notes |
| BSP st7789h2 | V2.0.0 | BSD-3-Clause | release notes |
| Name | Version | License | Release note |
|---|---|---|---|
| STM32 USB Device Library | V2.5.3 | SLA0044 | release notes |
| STM32 USBPD Core Library | V2.9.0 | SLA0044 | release notes |
| STM32 USBPD Device Library | V1.2.0 | SLA0044 | release notes |
| STM32 TouchSensing Library | V2.2.0 | SLA0044 | release notes |
| FatFS R0.12c ST modified 20191011 | R0.12c | BSD-3-Clause | FatFS release notes |
| ST modified 20191011 | BSD-3-Clause | ST release notes | |
| FreeRTOS | V10.2.1 | MIT | FreeRTOS release notes |
| ST modified 20191213 | BSD-3-Clause | ST release notes | |
| mbedTLS ST modified 20181221 | V2.14.1 | Apache-2.0 | release notes |
| ST modified 20181221 | BSD-3-Clause | ST release notes | |
| mbed-crypto ST modified 20191107 | V1.0.0 | Apache-2.0 | release notes |
| ST modified 20191107 | BSD-3-Clause | ST release notes | |
| trustedfirmware ST modified 20191202 | TF-Mv1.0-RC2 | BSD-3-Clause | Not available |
| ST modified 20191202 | BSD-3-Clause | ST release notes |
| Name | Version | License | Release note |
|---|---|---|---|
| basic_gui | V1.0.1 | BSD-3-Clause | release notes |
| Fonts | V2.0.0 | BSD-3-Clause | release notes |
| GUI_INTERFACE | V1.9.0 | BSD-3-Clause | release notes |
| TRACER_EMB | V1.2.0 | BSD-3-Clause | release notes |
Notes
- Caution on User Option bytes requirements for TZEN=1 prior to execution (see TrustZone project examples readme.txt file)
Known Limitations
- Projects partially available for RealView Microcontroller Development Kit (MDK-ARM) and STM32CubeIDE
- STM32L562E-DK demonstration firmware not available
Development Toolchains and Compilers
- IAR Embedded Workbench for ARM (EWARM) toolchain V8.32.3 + ST-Link
- EWARM patch EWARMv8_STM32L5xx_Support_V11.2 for STM32L5xx available from \Utilities\PC_Software
- Please note that administrator rights are required on Windows 10 at patch installation
- RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.27
- Pack Keil.STM32L5xx_DFP.1.0.9.pack available from \Utilities\PC_Software
- ST-Link usage requires
- ST-Link Keil DLL updates (ST-LINKIII-Keil_SWO_v3_0_5_RC2.zip)
- Keil TOOLS.INI update as indicated in the ST-Link Keil DLL update zip package
- ST-Link usage requires
- Pack Keil.STM32L5xx_DFP.1.0.9.pack available from \Utilities\PC_Software
- STM32CubeIDE V1.2.0
Supported Devices and HW boards
- STM32L552xx/STM32L562xx devices
- STM32L552E-EV Evaluation board (MB1372 C-02)
- STM32L562E-DK Discovery kit (MB1373 C-01)
- STM32L552ZE-Q Nucleo kit (MB1361 C-02)
Backward Compatibility
- Not applicable
Dependencies
- STM32CubeProgrammer V2.3.0
- This tool shall be used to enable the security on the devices (TZEN=1)
- For TrustZone projects, to match the CMSIS Device Template partition_stm32l552xx.h/partition_stm32l562xx.h for SAU declaration and secure project examples Flash configuration, please set the User Option bytes as follows before download and execution:
- TZEN=1
- DBANK=1
- SECWM1_STRT=0x0 SECWM1_PEND=0x7F meaning all 128 pages of Internal Flash Bank1 set as secure
- SECWM2_STRT=0x1 SECWM1_PEND=0x0 meaning no page of Flash Bank2 set as secure, hence Bank2 non-secure
- For other projects with no TrustZone, please set the User Option Bytes as follows before download and execution:
- TZEN=0
- DBANK=1
- STM32CubeMX V5.5.0
- Starter STM32CubeMX version V5.4.0 used for first project examples creation