Last edited 4 hours ago

STM32CubeMP13 ecosystem release note - v1.2.0

Applicable for STM32MP13x lines

This article describes the content of STM32CubeMP13 ecosystem release v1.2.0 of the STM32 Bare Metal - RTOS embedded software and its associated ecosystem.

1. Delivery purpose and scope[edit | edit source]

The STM32CubeMP13 release is dedicated to the STM32MP13x lines More info.png.
This release is a major maintenance release of STM32CubeMP13 ecosystem, based on components version listed in the embedded software chapter below. It provides a full STM32Cube MPU Bare metal - RTOS ecosystem for the STM32MP13x lines More info.png.

This ecosystem release consists of:

  • STM32CubeMP13 Package
  • STM32DDRFW-UTIL
  • STM32PRGFW-UTIL
  • STM32 referenced tools (more details are provided in the Referenced tools release notes chapter below):
    • STM32CubeIDE
    • STM32CubeMX
    • STM32CubeProgrammer
      • Keygen tool
      • Signing tool
  • Documentation
    • the present user guide in Wiki format
    • the documentation package (for more details refer to Reference documents chapter below)
  • STM32MP135x-DK Discovery kit More info green.png support

More details are provided in the supported hardware chapter below.

2. Intended audience[edit | edit source]

The targeted audience is STM32 MPU customers and partners.

3. Licensing[edit | edit source]

This software package is licensed under a SOFTWARE LICENSE AGREEMENT FOR ST MATERIALS (SLA). Customers should only use this package in compliance with SLA0048. The detailed content licenses can be found here.

4. Supported hardware[edit | edit source]

This software delivery is compatible with the following boards:

STM32MP13 boards
Boards PCBs list Main features Ordering
STM32MP135x-DK.png
STM32MP135F-DK Discovery kit
  • MB1635 (motherboard)
  • MB1897 (camera module board)
  • STM32MP135FAF7[1] Rev.Y
    • Arm®-based Cortex®-A7 1 GHz
    • Secure boot and cryptography
    • 4-Gbit DDR3L, 16 bits, 533 MHz
  • ST PMIC STPMIC1D
  • 4.3" TFT 480x272 pixels with LED backlight, and capacitive touch panel
  • 2-megapixel dual lane CSI-2 camera module with 15-pin FFC connector
  • Wi-Fi® 802.11b/g/n
  • Bluetooth® Low Energy 4.1

Discovery kit with STM32MP135F MPU


Info white.png Information
The STLINK embedded on the boards requires upgraded USB PC drivers: see this article

5. Release content[edit | edit source]

5.1. Embedded software[edit | edit source]

Embedded software STM32MP13x lines More info.png
STM32CubeMP13 (Arm® Cortex®-A7) Yes
STM32DDRFW-UTIL (Arm® Cortex®-A7) Yes
STM32PRGFW-UTIL (Arm® Cortex®-A7) Yes
STM32SSP-UTIL (Arm® Cortex®-A7) Yes

5.1.1. STM32CubeMP13 Package (Arm® Cortex®-A7)[edit | edit source]

STM32CubeMP13 Package v1.2.0 version.

5.1.1.1. Main features[edit | edit source]

The full content is available in STM32CubeMP13 Package content. This STM32CubeMP13 package can be then used as any STM32Cube package running on STM32.

5.1.1.2. Main changes[edit | edit source]

Main changes, compared to STM32CubeMP13-v1.1.0 package are:

  • FreeRTOS as middleware (in addition to AzureRTOS)
  • LwIp middleware
  • LwIp Dual ethernet example
  • USB Host based on USB OTG IP example
  • Interoperability with PRG_TOOLBOX_DFU
  • FSBLA project for IAR
  • External Loader as source code
  • OpenBootLoader as source code
  • Various fixes
  • CVE fixes

5.1.2. HAL drivers[edit | edit source]

  • Support for 2 ETH interface at same time.
  • Check overview and all available HAL drivers in HAL drivers

5.1.3. LL drivers[edit | edit source]

  • No major changes in LL drivers.
  • Check overview and all available LL drivers here LL drivers

5.1.4. BSP[edit | edit source]

  • No major changes in BSP drivers. 
  • Refer to BSP Drivers section here BSP drivers.

5.1.5. CMSIS[edit | edit source]

  • Bit and registers definition for STM32MP13x lines More info.png.
  • Support for IAR workbench has been added.
  • For more details, refer main section CMSIS

5.1.6. Middleware[edit | edit source]

  • AzureRTOS (ThreadX, LevelX, FileX, USBX, NetXDuo)
  • USB Library (Device and Host)
  • OpenBootloader
  • LWIP
  • Free RTOS
  • Check overview of middleware's in STM32CubeMP13 Package article

5.1.7. Projects[edit | edit source]

  • Check project section here Projects for details of projects implemented.
Info white.png Information
Note: For detailed information, read file Release_Notes.html delivered with the STM32CubeMP13 Package.


5.1.7.1. Restrictions[edit | edit source]
  • None.


5.1.8. STM32DDRFW-UTIL (Arm® Cortex®-A7)[edit | edit source]

STM32DDRFW-UTIL-v1.2.0 version version - Updated .

STM32DDRFW-UTIL provides utilities for DDR.

5.1.8.1. Main changes[edit | edit source]

5.1.9. STM32PRGFW-UTIL (Arm® Cortex®-A7)[edit | edit source]

STM32PRGFW-UTIL-v1.1.2 version - Updated .

Warning DB.png Important
It is mandatory to use STM32PRGFW-UTIL version v1.1.1 and above, to avoid bricking of your device.

This new version v1.1.2 has some dependencies with STM32CubeIDE 1.16.1 (and higher version) and STM32CubeProgrammer v2.18.0 for PMIC NVM programming, it is mandatory to update also those 2 other ST tools

The STM32PRGFW-UTIL is an STMicroelectronics original initiative to manage the One-time Programmable (OTP) memories and also supports STPMIC programming.

Functionalities are available through 4 applications:

  • STM32CubeProgrammer based application,
  • Standalone STM32CubeIDE based application,
  • 2 other applications for development purpose:
    • UART configuration for the Standalone application,
    • Run mode for STM32CubeProgrammer application.
5.1.9.1. Main changes[edit | edit source]
  • Flashing stability improved in USB mode for STM32MP13x lines More info.png and STM32MP15x lines More info.png
  • STPMIC automatic detection supported on ST Boards
5.1.9.2. Main features[edit | edit source]
  • STM32CubeProgrammer based application (in Serial boot mode)
    • OTP v2 structure
    • STM32CubeProgrammer UART interface and USB DFU
  • OTP Console based application (in Dev boot mode)
    • OTP CLI implemented based on STM32CubeProgrammer OTP CLI with OTP v2 structure
    • UART and STM32CubeIDE Semihosting interface
  • STPMIC1 NVM programming
5.1.9.3. Restrictions[edit | edit source]

MP15 boards fail sometimes to connect to STM32CubeProgrammer via UART (reset the board and try again).

5.2. Tools[edit | edit source]

5.2.1. Programming tools[edit | edit source]

5.2.1.1. STM32CubeProgrammer[edit | edit source]

STM32CubeProgrammer v2.18 version.

STM32CubeProgrammer package contains several tools, including Programmer, Signing tool, Keygen, and Trusted Package Creator.

5.2.1.1.1. Main changes[edit | edit source]
  • Hash of (RoT Public Keys + Algo) hashes (256 bits, ROTPK) generation with KeyGen tool
  • OTP programming via CLI/GUI (using STM32PRGFW-UTIL firmware binary on target)
    • PMIC NVM full read / write support (using STM32PRGFW-UTIL firmware binary on target)
5.2.1.1.2. Supported operating systems and architectures[edit | edit source]
  • Windows® 7, 8, 10, and 11: 32 bits (x86) and 64 bits (x64)
  • Linux® 64 bits (tested on Ubuntu® 64 bits)
5.2.1.1.3. Main Information[edit | edit source]
5.2.1.1.4. Restrictions[edit | edit source]

None

5.2.1.2. STM32PRG-TOOLBOX[edit | edit source]

STM32PRG-TOOLBOX-DFU - Version v2.0.0 version - New.

STM32PRG-TOOLBOX-DFU is an open-source tool provided by STMicroelectronics. This tool automates the preparation of STM32 MPU devices through the USB DFU protocol, with the purpose to fuse OTP memory, and to to write into external flash memory (like eMMC, SDMMC…).

5.2.1.2.1. Main features[edit | edit source]
  • STM32PRG-TOOLBOX-DFU
    • Install U-Boot with/without launching Fastboot mode
    • OTP Fuse: Read and write operations.
    • OTP management with STM32PRGFW-UTIL software tool
    • Supported target memory: SD Card, eMMC
5.2.1.2.2. Supported boards[edit | edit source]
  • STM32MP135x-DK
5.2.1.2.3. Supported operating systems and architectures[edit | edit source]
  • Windows® 7, 8, 10, and 11: 32 bits (x86) and 64 bits (x64)
  • Linux® 64 bits (tested on Ubuntu® 64 bits)
5.2.1.2.4. Restrictions[edit | edit source]
  • None

5.2.2. STM32CubeMX[edit | edit source]

STM32CubeMX-6.13 version.

5.2.2.1. Main changes[edit | edit source]
  • Various fixes
5.2.2.2. Code generation[edit | edit source]
  • Support of STM32CubeMP13 package running on the Arm® Cortex®-A7 processor.
  • Support for Azure RTOS ThreadX and FileX for STM32CubeMP13 package release
5.2.2.3. Supported operating systems and architectures[edit | edit source]
  • Windows® 10 and 11
  • Linux®: Ubuntu® LTS 20.04 and LTS 22.04
  • macOS®
5.2.2.4. Supported toolchains[edit | edit source]

STM32CubeMX generates project files for the following toolchains:

  • STM32CubeIDE by STMicroelectronics
5.2.2.5. Main Information[edit | edit source]
5.2.2.6. Main restrictions[edit | edit source]

5.2.3. STM32CubeIDE[edit | edit source]

STM32CubeIDE-v1.17 version.

5.2.3.1. Main changes[edit | edit source]
  • Updated to Eclipse® 2023-12
5.2.3.2. Main information[edit | edit source]
  • Refer to release note: STM32CubeIDE release note
  • Support for projects running on Arm® Cortex®-A: STM32CubeMP13 MPU Package projects or Project Utilities.
  • GCC 12 as a default toolchain
  • Updated to Eclipse® 2023-12
5.2.3.3. Main restrictions[edit | edit source]
  • None

5.3. Miscellaneous[edit | edit source]

Detailed features are available in the release notes of the different components that constitute this delivery:

Moreover, the software workarounds implemented to provide solutions to the STM32MP13x lines More info.png errata are listed in STM32MP13 ecosystem errata sheet.

6. Minor release updates[edit | edit source]

  • None

7. Reference documents[edit | edit source]

7.1. STM32MP13 resources[edit | edit source]


All the resources for the STM32MP1 series are located in the STM32MP1 series web page.

Info white.png Information
The different STM32MP13 microprocessor part numbers available (with their corresponding internal peripherals, security options and packages) are described in the STM32MP13 microprocessor part numbers.


Reference Name Link
Application notes
AN2834 How to get the best ADC accuracy in STM32 microcontrollers AN2834.pdf
AN4803 High-speed SI simulations using IBIS and board-level simulations using HyperLynx® SI on STM32 MCUs and MPUs AN4803.pdf
AN5027 Interfacing PDM digital microphones using STM32 MCUs and MPUs AN5027.pdf
AN5036 Thermal management guidelines for STM32 applications AN5036.pdf
AN5168 How to configure DDR on STM32MP1 MPUs AN5168.pdf
AN5225 USB Type-C® Power Delivery using STM32 MCUs and MPUs AN5225.pdf
AN5275 USB DFU/USART protocols used in STM32MP1 series bootloaders AN5275.pdf
AN5348 Introduction to FDCAN peripherals for STM32 product classes AN5348.pdf
AN5431 The STPMIC1 PCB layout guidelines AN5431.pdf
AN5438 STM32MP1 series lifetime estimates AN5438.pdf
AN5510 Overview of the secure secret provisioning (SSP) on STM32MP1 series AN5510.pdf
AN5827 Guidelines for entering RMA state on STM32MP1 series MPUs AN5827.pdf
AN4879 USB hardware and PCB guidelines using STM32 MCUs AN4879.pdf
AN5474 Getting started with STM32MP13 series hardware development AN5474.pdf
AN5475 Migration of applications from STM32MP15x lines to STM32MP13x lines microprocessor AN5475.pdf
AN5036 Thermal management guidelines for STM32 applications AN5036.pdf
AN5478 Camera-CSI (DCMI-PP) in STM32MP13x microprocessors AN5478.pdf
AN5565 STM32MP13 lines using low-power modes AN5565.pdf
AN5586 STM32MP13x MPU product line discrete power supply hardware integration AN5586.pdf
AN5587 STM32MP13x MPU product lines and STPMIC1D / STPMIC1A integration on a wall adapter supply AN5587.pdf
AN5692 DDR memory routing guidelines for STM32MP13x product lines AN5692.pdf
AN5787 STM32MP13x product lines system power consumption AN5787.pdf
UM1720 STM32Cube USB host library user manual UM1720.pdf
UM1734 STM32Cube USB device library user manual UM1734.pdf
Datasheets[2]
DS12792 STPMIC1 datasheet
DS12792.pdf
DS13483 STM32MP135C/F Datasheet (STM32MP135C/F)
(secure)
DS13483.pdf
DS13874 STM32MP135A/D Datasheet (STM32MP135A/D)
(non secure)
DS13874.pdf
DS13875 STM32MP133C/F Datasheet (STM32MP133C/F)
(secure)
DS13875.pdf
DS13876 STM32MP133A/D Datasheet (STM32MP133A/D)
(non secure)
DS13876.pdf
DS13877 STM32MP131C/F Datasheet (STM32MP131C/F)
(secure)
DS13877.pdf
DS13878 STM32MP131A/D Datasheet (STM32MP131A/D)
(non secure)
DS13878.pdf
Errata sheets
ES0539 STM32MP13x device errata ES0539.pdf
Reference manuals[2]
RM0475 STM32MP13x reference manual
(STM32MP135 advanced Arm®-based 32-bit MPUs)
RM0475.pdf
Boards schematics
MB1635 schematics STM32MP135F-DK motherboard schematics
MB1635-E02 board schematics (Discovery kit)
MB1635-E02.pdf
Boards user manuals
UM2993 STM32MP135F-DK discovery board user manual UM2993.pdf
Tools user manuals
UM2563 STM32CubeIDE installation guide UM2563.pdf
UM2579 Migration guide from System Workbench to STM32CubeIDE UM2579.pdf
UM2553 STM32CubeIDE quick start guide UM2553.pdf
UM2609 STM32CubeIDE user guide UM2609.pdf
UM1718 STM32CubeMX user manual UM1718.pdf
UM2237 STM32CubeProgrammer tool user manual UM2237.pdf
UM2238 STM32 Trusted Package Creator tool user manual UM2238.pdf
UM2542 STM32 series Key Generator tool user manual UM2542.pdf
UM2543 STM32 series Signing tool user manual UM2543.pdf
AN5360 Getting started with projects based on the STM32MP1 series in STM32CubeIDE AN5360.pdf

8. How to download the software and start with this release?[edit | edit source]

The list of embedded software packages available for download depends on the selected packages.

The table below provides the available board part numbers as well as information in order to:

  • get started with the board
  • find the associated embedded software distributions
  • download source code
  • build a piece of embedded software.
Supported board Jump to
STM32MP135x-DK Discovery kit More info green.png STM32MP13 Discovery kits - getting started, including software download

9. Referenced tools release notes[edit | edit source]

The table below lists the available tools, and provides links to the corresponding release notes.

Each release note gives information on how to install and use the corresponding tool.

Tools Release notes Host PC
Linux® version Windows version
STM32CubeIDE STM32CubeIDE release note 1.17.0 1.17.0
STM32CubeMX STM32CubeMX release note 6.13.0 6.13.0
STM32CubeProgrammer STM32CubeProgrammer release note 2.18.0 2.18.0
STM32PRG-TOOLBOX-DFU STM32CubeProgrammer release note 2.0.0 2.0.0


The table below lists the available embedded software utilities and provides links to the corresponding release notes. Each release note gives information on how to flash and to use the corresponding embedded software utility/tool.

Tools Release notes Host PC
Linux® version Windows version
STM32DDRFW-UTIL STM32DDRFW-UTIL release note 1.2.0 1.2.0
STM32PRGFW-UTIL STM32PRGFW-UTIL release note 1.1.2 1.1.2
STM32SSP-UTIL STM32SSP-UTIL release note 1.0.0 1.0.0

10. References[edit | edit source]