STM32Cube Command-Line Toolset Release Note v1.15.0

Introduction

This release note is updated periodically to keep abreast of the STM32Cube command-line toolset (STM32CubeCLT) 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.

Table 1. STM32CubeCLT v1.15.0 release summary

Customer support

For more information or help concerning STM32Cube command-line toolset, 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/stm32cubeclt.

General information

1.1 Overview

The STM32Cube command-line toolset (STM32CubeCLT) is a single package composed of:

• CLI (command-line interface) versions of ST tools like toolchain, probe connection utility, and flash memory programming utility
• Up-to-date system view descriptor (SVD) files
• Any other IDE relevant metadata

STM32CubeCLT is derived from STM32CubeIDE. It is packaged for command-prompt use by third-party IDEs. The toolset offers a wide range of features to build, program, and debug STM32 MCU applications through the command line. Continuous integration and continuous development can benefit from the reduced CLI toolset package compared to a large bulk IDE package. The STM32CubeCLT targets STM32 32-bit microcontrollers based on the Arm^® Cortex^®-M processor.

The STM32Cube command-line toolset allows:

• Building a program for STM32 MCU devices using an enhanced GNU toolchain for STM32
• Programming STM32 MCU internal memories (flash memory, RAM, OTP, and others) and external memories
• Verifying the programming content (checksum, verification during and after programming, comparison with file)
• Automating the STM32 MCU programming
• Debugging applications through the interface of STM32 MCU products, which provides access to MCU internal resources using basic debug features

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

1.2 Package content

Table 2. Content of STM32CubeCLT

1.3 Host PC system requirements

Supported operating systems and architectures

• Windows® 10 and 11, 64 bits (x64)
• Linux®: Ubuntu® LTS 20.04 and LTS 22.04, and Fedora® 37
• macOS® 13 (Ventura), macOS® 14 (Sonoma)

Note: Windows is a trademark of the Microsoft group of companies. Linux® is a registered trademark of Linus Torvalds. Ubuntu® is a registered trademark of Canonical Ltd. Fedora® is a trademark of Red Hat, Inc. macOS® is a trademark of Apple Inc., registered in the U.S. and other countries and regions.

Memory and storage

• RAM: 1 Gbyte recommended
• Hard-disk space: 1.7 Gbyte of free space

1.4 Setup procedure

Refer to the STM32CubeCLT installation guide (UM3089) available at www.st.com.

1.5 Licensing

STM32CubeCLT is delivered under the Mix Ultimate Liberty+OSS+3rd-party V1 software license agreement (SLA0048). The open-source and third-party software components used in the development of STM32CubeCLT and their licenses are listed in a zip file available from the product page at STMicroelectronics www.st.com web site.

Table 3. Complementary component licenses

2 STM32CubeCLT v1.15.0 release information

2.1 New features

• CMake integration
• Ninja integration
• Versioned STM32CubeCLT installation: the default installation directory contains the version of STM32CubeCLT

2.2 Fixed issues

A second installation overwrites the first installation folder.

2.3 Known problems and limitations

The user must specify the path of STM32CubeProgrammer/bin as argument when executing ST-LINK_gdbserver as shown in the example below:

ST-LINK_gdbserver.exe -cp /c/ST/STM32CubeCLT/STM32CubeCLT/STM32CubeProgrammer/bin

3 Previous release information

3.1 STM32CubeCLT v1.14.0 release information

3.1.1 New features

• ST-LINK firmware upgrade only via command line
• Signed macOS® installer

3.1.2 Fixed issues

No fixed issues in this release.

3.1.3 Known problems and limitations

The user must specify the path of STM32CubeProgrammer/bin as argument when executing ST-LINK_gdbserver as shown in the example below:

ST-LINK_gdbserver.exe -cp /c/ST/STM32CubeCLT/STM32CubeCLT/STM32CubeProgrammer/bin

3.2 STM32CubeCLT v1.13.0 release information

3.2.1 New features

• Aligned with STM32CubeMX v6.9.0
• Added the STLinkUpgrade command that launches a graphical utility to update the ST-LINK firmware.
• Added a contextual alert warning the users that the PATH variable is not going to be updated with STM32CubeCLT paths if they choose another location than the default one. This alert allows the users to step back and choose the default location.
• Added the -j option to the STM32CubeCLT_metadata command to generate a JSON file containing the location of STM32CubeCLT metadata files, such as SVD and STM32 targets, and the other dependencies.

3.2.2 Fixed issues

No fixed issues in this release.

3.2.3 Known problems and limitations

The user must specify the path of STM32CubeProgrammer/bin as argument when executing ST-LINK_gdbserver as shown in the example below:

ST-LINK_gdbserver.exe -cp /c/ST/STM32CubeCLT/STM32CubeCLT/STM32CubeProgrammer/bin

3.3 STM32CubeCLT v1.12.1 release information

3.3.1 New features

• Alignment with STM32CubeMX v6.8.1

3.3.2 Fixed issues

Fixed the issue concerning the deletion of the variable path when installing STM32CubeCLT, which occurred in some cases because of a path length limitation in Windows®

3.3.3 Known problems and limitations

The user must specify the path of STM32CubeProgrammer/bin as argument when executing ST-LINK_gdbserver as shown in the example below:

ST-LINK_gdbserver.exe -cp /c/ST/STM32CubeCLT/STM32CubeCLT/STM32CubeProgrammer/bin

3.4 STM32CubeCLT v1.12.0 release information

3.4.1 New features

• Aligned with STM32CubeIDE v1.12.0
• Added the command STM32CubeCLT_metadata that returns the path to the STM32CubeCLT metadata files, such as SVD and STM32 targets

3.4.2 Fixed issues

Corrected the default installation path (dropped the double STM32CubeCLT/STM32CubeCLT)

3.4.3 Known problems and limitations

The user must specify the path of STM32CubeProgrammer/bin as argument when executing ST-LINK_gdbserver as shown in the example below:

ST-LINK_gdbserver.exe -cp /c/ST/STM32CubeCLT/STM32CubeCLT/STM32CubeProgrammer/bin

3.5 STM32CubeCLT v1.11.1 release information

3.5.1 New features

The STM32Cube command-line toolset release v1.11.1 is the first release:

• Windows®, Linux®, and macOS® installers
• STM32CubeCLT integrates:
  • STM32CubeProgrammer (STM32CubeProg)
  • GCC complete toolchain with related libraries
  • ST-LINK GDB server with ST-LINK server ability to attach multiple clients
  • ST-LINK USB driver
  • SVD files for all STM32 MCU products

STM32CubeCLT v1.11.1 provides the same tool versions as STM32CubeIDE v1.11.0.

3.5.2 Known problems and limitations

The user must specify the path of STM32CubeProgrammer/bin as argument when executing ST-LINK_gdbserver as shown in the example below:

ST-LINK_gdbserver.exe -cp /c/ST/STM32CubeCLT/STM32CubeCLT/STM32CubeProgrammer/bin

Revision history

Table 4. Document revision history

Contents

1 General information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.2 Package content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.3 Host PC system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.4 Setup procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.5 Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 STM32CubeCLT v1.15.0 release information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.1 New features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.2 Fixed issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2.3 Known problems and limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3 Previous release information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.1 STM32CubeCLT v1.14.0 release information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.1.1 New features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.1.2 Fixed issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.1.3 Known problems and limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.2 STM32CubeCLT v1.13.0 release information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.2.1 New features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.2.2 Fixed issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.2.3 Known problems and limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.3 STM32CubeCLT v1.12.1 release information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.3.1 New features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.3.2 Fixed issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.3.3 Known problems and limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.4 STM32CubeCLT v1.12.0 release information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.4.1 New features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.4.2 Fixed issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.4.3 Known problems and limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.5 STM32CubeCLT v1.11.1 release information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.5.1 New features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.5.2 Known problems and limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

List of tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

List of tables

Table 1. STM32CubeCLT v1.15.0 release summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Table 2. Content of STM32CubeCLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Table 3. Complementary component licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Table 4. Document revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

IMPORTANT NOTICE - READ CAREFULLY

STMicroelectronics NV and its subsidiaries ("ST") reserve the right to make changes, corrections, enhancements, modifications, and improvements to ST products and/or to this document at any time without notice. Purchasers should obtain the latest relevant information on ST products before placing orders. ST products are sold pursuant to ST's terms and conditions of sale in place at the time of order acknowledgment.

Purchasers are solely responsible for the choice, selection, and use of ST products and ST assumes no liability for application assistance or the design of purchasers' products.

No license, express or implied, to any intellectual property right is granted by ST herein.

Resale of ST products with provisions different from the information set forth herein shall void any warranty granted by ST for such product.

ST and the ST logo are trademarks of ST. For additional information about ST trademarks, refer to www.st.com/trademarks. All other product or service names are the property of their respective owners.

Information in this document supersedes and replaces information previously supplied in any prior versions of this document.

©2024 STMicroelectronics - All rights reserved