STM32CubeProgrammer Release Note v2.7.0

Introduction

This release note is updated periodically to keep abreast of the STM32CubeProgrammer (STM32CubeProg) evolution, problems and limitations. Check the STMicroelectronics website at www.st.com/stm32softwaretools for the latest version. For the latest release summary, refer to Table 1.

Customer support

For more information or help concerning STM32CubeProgrammer, contact the nearest STMicroelectronics sales office or use the ST community at community.st.com. For a complete list of STMicroelectronics offices and distributors, refer to the www.st.com webpage.

Software updates

Software updates and all the latest documentation can be downloaded from the STMicroelectronics support webpage at www.st.com/stm32cubeprog.

General information

Overview

STM32CubeProgrammer is a tool that allows STM32 device programming through debug interfaces (JTAG and SWD) and bootloader interfaces (UART and USB). The tool offers a wide range of features to program STM32 internal memories (Flash, RAM, OTP and others) and external memories, verify the programming content (checksum, verify during and after programming, compare with file), and automate STM32 programming. The STM32CubeProgrammer package also offers the optional installation of the STM32 Trusted Package Creator tool, which is used to create secure firmware files for secure firmware install and update. For more information, refer to the STM32 Trusted Package Creator tool software description user manual (UM2238). STM32CubeProgrammer supports STM32 32-bit microcontrollers and microprocessors based on the Arm® Cortex® processor.

Arm is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.

Host PC system requirements

Supported operating systems and architectures

• Windows® 7, 8, and 10: 32 bits (x86) and 64 bits (x64)
• Linux® 64 bits (tested on Ubuntu® 64 bits)
• macOS® (minimum version OS X® Yosemite)

Note: Ubuntu® is a registered trademark of Canonical Ltd. macOS® is a trademark of Apple Inc. registered in the U.S. and other countries.

Software requirements

For STM32CubeProgrammer versions earlier than v2.6.0, the Java SE Run Time Environment 1.8 (version 1.8.0_121 or newer) must be installed by Oracle® (Only Java™ 8 is supported). Since STM32CubeProgrammer version v2.6.0, the tool can be installed without pre-requisite JRE installation, because the STM32CubeProgrammer release package contains a JRE bundling.

Note: After Oracle® announcement related to the “End of Public Updates for Oracle JDK 8”, access to OpenJDK is possible via adoptopenjdk.net.

Note: Oracle and Java are registered trademarks of Oracle and/or its affiliates. All other trademarks are the property of their respective owners.

Setup procedure

Refer to the STM32CubeProgrammer software description user manual (UM2237) available at www.st.com.

Licensing

STM32CubeProg is delivered under the Mix Ultimate Liberty+OSS+3rd-party V1 software license agreement (SLA0048). The software components used in the development of STM32CubeProgrammer and their licenses are listed in Table 2.

1. License identifier as defined by OSI (opensource.org/licenses) or SPDX (spdx.org/licenses).

The software bundled with STM32CubeProgrammer and their licenses are listed in Table 3.

STM32CubeProgrammer v2.7.0 release information

New features

• Added the support for the STM32WB15xx microcontrollers in the STM32WB Series
• Added the support for the microcontrollers with 64 Kbytes of Flash memory in the STM32G0 Series
• Added HardFault Analyzer support
• Added Register viewer support

Fixed issues

Known problems and limitations

• Installer: Insignificant message is returned during the installation when other instances are already installed.
• On some macOS® machines, the STM32CubeProgrammer GUI fails to launch (must be launched in CLI mode).
• STM32WB1xxx: Incorrect PCROP area management via SWD.
• STM32WB1xxx: STM32CubeProgrammer is closed when trying to apply FUS upgrade via the UART on macOS®. Only tty is supported.
• STM32WB5xxx: Making FUS upgrade via the SWD interface from recent to older version returns success message.
• Programming of Option Byte list is not completed when the SEC_SIZE Option Byte is programmed on some STM32 microcontroller or microprocessor series.
• STM32WB1xxx: STM32Key Provisioning/Double signature is not tested.

Previous release information

STM32CubeProgrammer v2.6.0 release information

New features

• Added the support for dual-core microcontrollers in the STM32WL Series
• Extended the support for the STM32G0 Series to the new STM32G0Bxxx and STM32G0Cxxx microcontrollers
• Added SFI support via JTAG/UART/SPI for STM32WL5xxx microcontrollers
• Added SFI support via I2C/SPI for STM32L5 Series microcontrollers
• Added SFIx support via bootloader for STM32L5 Series microcontrollers
• Added Sigfox™ credential provisioning support for STM32WL5xxx microcontrollers
• Added multiple Flash loader support for STM32 microcontrollers
• Added the SWV feature update (color support)
• Added the support for the server client HSM feature
• Added DFU IAP using custom PID/VID support for all STM32 products
• Added installer JRE bundle (OpenJDK)

Fixed issues

Known problems and limitations

• [CubePRG] CubeProgrammer_API.h not up to date in last STM32CubeProgrammer: missing 100 bytes in debugConnectParameters struct.
• [CubePRG][0x451] Not possible to program STM32F765xG (Flash 1 Mbyte) using STM32CubeProgrammer v2.5.0.
• [STM32CubeProg-STM32G0][GUI] Remove NRST_MODE.
• [CubePRG] Cannot write 8 bytes in Flash memory using -w64 STM32CubeProgrammer CLI command.
• STM32MP1 mircoprocessor get certificate operation is not complete in the UART mode.
• Production programming issues occur when using multiple ST-LINK in parallel.
• Installer: Insignificant message is returned during the installation when other instances are already installed.
• On some macOS® machines, the STM32Cubeprogrammer GUI fails to launch (must be launched in CLI mode).
• The SFI operation via UART is not achieved and returns an error on macOS® machines.
• STM32WB55: When trying to upgrade more than one stack, the operation can be done only with a second try.
• SFIx operation for STM32L5: An exception appears while programming when the -elbl command is not the first one in the command line.

STM32CubeProgrammer v2.5.0 release information

New features

• Added the support for STM32G491xC and STM32G491xE microcontrollers
• Added the support for STM32H72xxx and STM32H73xxx microcontrollers
• Added SFI support for STM32H72xxx and STM32H73xxx microcontrollers
• Added SFIx support for STM32H72xxx and STM32H73xxx microcontrollers
• Added SFI support via UART for STM32L5 Series microcontrollers
• Added SFI support via USB for STM32L5 Series microcontrollers
• Added support of Serial Wire Viewer (SWV)
• Board automatic recognition
• Revision ID display

Fixed issues

Known problems and limitations

• For the STM32L5 Series, the Option Byte programming GUI is not intuitive enough. Refer to the STM32L552xx and STM32L562xx advanced Arm®-based 32-bit MCUs reference manual (RM0438) for permitted accesses.
• For STM32L4Pxxx and STM32L4Qxxx devices, Option Byte programming via bootloader interfaces presents some limitations.
• For STM32H7Axxx and STM32H7Bxxx devices, Option Byte programming via bootloader interfaces (USB) presents some limitations.
• STM32L5 Series programming presents limitation in macOS® when TZEN=1 and RDP=0x55.
• Display issues depending on the monitor used can occur with Linux®.
• SFI-HSM V2 get certificate fails with STM32L462xx devices.
• Parallel Flash programming fails in macOS® for microprocessors in the STM32MP1 Series.
• Issues can be reported with some specific .elf file in CRC calculation safety feature.
• STM32MP1 mircoprocessor programming via UART presents limitations to program the whole boot chain.
• STM32MP1 mircoprocessor get certificate operation is not completed via a UART connection.

STM32CubeProgrammer v2.4.0 release information

New features

• Added the support of the graphic user interface (GUI) for the firmware upgrade service (FUS) and stack upgrade for the entire STM32WB Series
• Support of HSM V2 on all STM32 microcontrollers and microprocessors supporting SFI/SSP

Fixed issues

Known problems and limitations

• For the STM32L5 Series, the connection via the ST-LINK protocol is allowed only when mode is set to hotplug with TZEN=1.
• For the STM32L5 Series, the Option Byte programming GUI is not intuitive enough. Refer to the STM32L552xx and STM32L562xx advanced Arm®-based 32-bit MCUs reference manual (RM0438) for permitted accesses.
• For STM32L4Pxxx and STM32L4Qxxx devices, Option Byte programming via bootloader interfaces presents some limitations.
• For STM32H7Axxx and STM32H7Bxxx devices, Option Byte programming via bootloader interfaces (USB) presents some limitations.
• STM32L5 series programming presents limitation in macOS® when TZEN=1 and RDP=0x55.
• With some small-screen resolutions, the graphical interface of STM32CubeProgrammer presents anomalies such as inaccessible buttons.
• Display issues depending on the monitor used can occur with Linux®.
• SFIx on STM32H743/753 devices fails via the debug interface.
• SFI-HSM V2 get certificate fails with STM32L462xx devices.
• Parallel Flash programming fails in macOS® for microprocessors in the STM32MP1 Series.

STM32CubeProgrammer v2.3.0 release information

New features

• Added the support of the STM32L4Pxxx and STM32L4Qxxx microcontrollers
• Added the support of the STM32H7Axxx and STM32H7Bxxx microcontrollers
• Added the beta support of the STM32WL Series microcontrollers
• Added the official support of the STM32L5 Series microcontrollers
• Added the support of HSM V1 SFI/SFIx for STM32H7Axxx microcontrollers
• Added the support of HSM V1 SFI/SFIx for STM32L5 Series microcontrollers

Fixed issues

Known problems and limitations

• For the STM32L5 Series, the connection via the ST-LINK protocol is allowed only when mode is set to hotplug.
• For the STM32L5 Series, the Option Byte programming GUI is not intuitive enough. Refer to the STM32L552xx and STM32L562xx advanced Arm®-based 32-bit MCUs reference manual (RM0438) for permitted accesses.
• For STM32L4Pxxx and STM32L4Qxxx devices, Option Byte programming via bootloader interfaces presents some limitations.

STM32CubeProgrammer v2.2.1 release information

New features

No new feature is reported for this release. Minor release v2.2.1 is dedicated to issue correction (refer to Fixed issues).

Fixed issues

Known problems and limitations

• For the STM32L5 Series, the connection via the ST-LINK protocol is allowed only when mode is set to hotplug.
• For the STM32L5 Series, the Option Byte programming GUI is not intuitive enough. Refer to the STM32L552xx and STM32L562xx advanced Arm®-based 32-bit MCUs reference manual (RM0438) for permitted accesses.
• For the STM32L5 Series, Option Byte programming via bootloader interfaces presents some limitations.
• STM32CubeProgrammer does not work under Ubuntu® 18.04.
• With some small-screen resolutions, the graphical interface of STM32CubeProgrammer presents anomalies such as inaccessible buttons.
• Display issues depending on the monitor used can occur with Linux®.

STM32CubeProgrammer v2.2.0 release information

New features

• Added the support of the STM32L5 Series
• Added the support of HSMv2
• Added the support of IAP for the USB-DFU interface
• STM32WB firmware upgrade via the ST-LINK interface
• Added the support of OTP for the STM32L5 Series
• Added the support of SSP for the STM32MP1 Series

Fixed issues

STM32CubeProgrammer v2.1.0 release information

Fixed issues

Known problems and limitations

• For the STM32L5 Series, the connection via the ST-LINK protocol is allowed only when mode is set to hotplug.
• For the STM32L5 Series, the Option Byte programming GUI is not intuitive enough. Refer to the STM32L552xx and STM32L562xx advanced Arm®-based 32-bit MCUs reference manual (RM0438) for permitted accesses.
• For the STM32L5 Series, Option Byte programming via bootloader interfaces presents some limitations.
• STM32CubeProgrammer does not work under Ubuntu® 18.04.
• With some small-screen resolutions, the graphical interface of STM32CubeProgrammer presents anomalies such as inaccessible buttons.

STM32CubeProgrammer v2.0.0 release information

New features

• Added support of STM32G4 Series
• Added support of STM32G03x/STM32G04x microcontrollers
• Added support of dual-core microcontrollers in the STM32H7 Series
• Added support of secure firmware install (SFI)

Fixed issues

Known problems and limitations

• The use of the UART bootloader prevents from increasing the RDP level and programming the second bank of Option Bytes, or from enabling the two user secure areas simultaneously on STM32H7 microcontrollers.
• Programming over USB bootloader is not reliable with USB2.0 for some devices.
• External memory programming in only available with ST-LINK.
• Installing multiple instances of the same version of the tool in the same directory under Windows® leads to issues when uninstalling.
• UART flashing of devices in the STM32MP1 Series may fail with big partitions.
• Programming issues are observed with the STM32H7 Series when the STLINK-V3 I2C interface is used.
• GUI issues are sometimes observed with the OTA programming of devices in the STM32WB Series.

STM32CubeProgrammer v1.4.0 release information

New features

• Added support of STM32MP1 Series
• Added support of STM32WB Series
• Added support of Automatic Mode for programming devices in a loop
• Added support of OTA programming for the STM32WB Series

Fixed issues

Known problems and limitations

• The use of the UART bootloader prevents from increasing the RDP level and programming the second bank of Option Bytes, or from enabling the two user secure areas simultaneously on STM32H7 microcontrollers.
• Programming over USB bootloader is not reliable with USB2.0 for some devices.
• External memory programming in only available with ST-LINK.
• Installing multiple instances of the same version of the tool in the same directory under Windows® leads to issues when uninstalling.
• UART flashing of devices in the STM32MP1 Series may fail with big partitions.
• Programming issues are observed with the STM32H7 Series when the STLINK-V3 I2C interface is used.
• GUI issues are sometimes observed with STM32WB Series OTA programming.
• Linux® 32 bits is not covered.
• STM32 Trusted Package Creator: only the CLI version is supported on macOS®.
• Mass Erase is not working with the SPI bootloader interface on the STM32WB Series.
• Mass Erase is not working with the I2C bootloader interface on the STM32G4 Series; errors can occur when writing via the SPI interface.
• Shared mode: board detection failure is observed after multiple refresh operations.
• Writing 8-bit data in RAM on STM32L496G devices is not possible.

STM32CubeProgrammer v1.3.0 release information

New features

• Add support of STM32F7x0 Value line and STM32H750 Value line
• Add support of M29W128GL external Flash memory programming on STM32H743I-EVAL
• Dump device memory into an hex/srec/bin file
• Add Core debug commands in command-line interface
• Add support of data EEPROM programming on STM32L0 Series and STM32L1 Series

Known problems and limitations

• The use of the UART bootloader prevents from increasing the RDP level and from programming the second bank of Option Bytes, or from enabling the two user secure areas simultaneously on STM32H7 microcontrollers.
• Programming over USB bootloader is not reliable with USB2.0 for some devices.
• External memory programming in only available with ST-LINK.
• Installing multiple instances of the same version of the tool in the same directory under Windows® leads to issues when uninstalling.
• STLinkV3-I2C bridge may not work correctly with STM32F4 Series, STM32F7 Series, and STM32H7 Series.

STM32CubeProgrammer v1.1.0 release information

New features

• STM32 Flash programming and erasing over ST-LINK debug probe (JTAG/SWD) and over bootloader interfaces UART and USB DFU
• STM32 option bytes detailed display with description of each bit field
• Option bytes programming over ST-LINK debug probe (JTAG/SWD) and over bootloader interfaces UART and USB DFU
• External memories programming over ST-LINK debug probe (JTAG/SWD) for STM32 microcontroller evaluation and discovery boards
• Read, display and programming of binary files, ELF files, Intel hex files and Motorola Srecord files
• Read and display of STM32 microcontroller memory content
• Command line and graphical user interface
• Generation of secure firmware using the STM32 Trusted Package Creator tool

Known problems and limitations

• The use of the UART bootloader prevents from increasing the RDP level and from programming the second bank of Option Bytes, or from enabling the two user secure areas simultaneously on STM32H7 microcontrollers.
• Programming over USB bootloader is not reliable with USB2.0 for some devices.
• The erase command is not supported with data EEPROM on STM32L0 and STM32L1.
• External memory programming in only available with ST-LINK.
• Installing multiple instances of the same version of the tool in the same directory under Windows® leads to issues when uninstalling.

STM32CubeProgrammer v1.0.0 release information

New features

• STM32 Flash programming and erasing over ST-LINK debug probe (JTAG/SWD) and over bootloader interfaces UART and USB DFU
• STM32 option bytes detailed display with description of each bit field
• Option bytes programming over ST-LINK debug probe (JTAG/SWD) and over bootloader interfaces UART and USB DFU
• External memories programming over ST-LINK debug probe (JTAG/SWD) for STM32 microcontroller evaluation and discovery boards
• Read, display and programming of binary files, ELF files, Intel hex files and Motorola Srecord files
• Read and display of STM32 microcontroller memory content
• Command line and graphical user interface
• Generation of secure firmware using the STM32 Trusted Package Creator tool

Known problems and limitations

• The use of the UART bootloader prevents from increasing the RDP level and from programming the second bank of Option Bytes, or from enabling the two user secure areas simultaneously on STM32H7 microcontrollers.
• Programming over USB bootloader is not reliable with USB2.0 for some devices.
• The erase command is not supported with data EEPROM on STM32L0 and STM32L1.
• External memory programming in only available with ST-LINK.
• Installing multiple instances of the same version of the tool in the same directory under Windows® leads to issues when uninstalling.

Document revision history