STM32CubeIDE Release Note v1.7.0
Introduction
This release note is updated periodically to keep abreast of STM32CubeIDE 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.
| Type | Summary |
|---|---|
| Major release |
|
Customer support
For more information or help concerning STM32CubeIDE, 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/stm32cubeide.
General information
Overview
STM32CubeIDE is an integrated development environment (IDE) based on the Eclipse® framework. It is aimed at users developing embedded software in C/C++ for the STMicroelectronics STM32 products. It uses an enhanced GNU tool chain for STM32, based on GNU Arm Embedded. It has an integrated version of STM32CubeMX and MCUFinder, which allows easy project configuration as well as the generation of the corresponding initialization C code through a step-by-step process. Furthermore, STM32CubeIDE integrates the command-line version of STM32CubeProgrammer (STM32CubeProg) for Flash memory handling while using the ST-LINK GDB server. This allows the STM32 device programming through debug interfaces (JTAG and SWD).
STM32CubeIDE is based on the following technology, with STMicroelectronics-specific enhancements:
- Eclipse® 2021-03 and CDT™ version 10.2.0
- GNU Tools for STM32, based on GNU Tools for Arm Embedded Processors 9-2020-q2-update 9.3.1 20200408 (release)
- GNU GDB (GNU Tools for STM32 9-2020-q2-update) 8.1.0.20180315-git
- AdoptOpenJDK Runtime Environment (build 11.0.10+9, 64-bit)
- ST-LINK_gdbserver 5.9.0, supporting ST-LINK/V2 and STLINK-V3
- SEGGER J-Link GDB Server V7.22a
- Open On-Chip Debugger 0.11.0-rc2+dev-00044-g8340bb0
Windows® specific build tools:
- BusyBox v1.31.0.st_20200221-0903_longpath: mkdir.exe, rm.exe, echo.exe
- make-4.2.1_st_20200221-0903_longpath: make.exe
Linux® specific build tools:
- make-4.2.1_st_20200221-0903: make
macOS® specific build tools:
- make-4.2.1_st_20200221-0903: make
STM32CubeIDE supports STM32 32-bit products based on the Arm® Cortex® processor.
Note: Eclipse is a registered trademark of the Eclipse foundation. macOS® is a trademark of Apple Inc. registered in the U.S. and other countries. Linux® is a registered trademark of Linus Torvalds. 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: 64 bits (x64)
- Linux® (tested on Ubuntu® LTS 18.04, LTS 20.04, Fedora® 29 and Fedora® 31, 64 bits)
- macOS® 10.12 (Sierra), 10.14 (Mojave), 10.15 (Catalina)
Note: Ubuntu® is a registered trademark of Canonical Ltd. Fedora® is a trademark of Red Hat, Inc. All other trademarks are the property of their respective owners.
Memory and storage
- RAM: 4 Gbytes recommended
- Hard-disk space: 6 Gbytes of free space for non STM32 MPU OpenSTLinux developers, 15 Gbytes for STM32 MPU OpenSTLinux usage
Setup procedure
Refer to the STM32CubeIDE installation guide (UM2563), STM32CubeIDE quick start guide (UM2553), and STM32CubeIDE user guide (UM2609) available at www.st.com.
Licensing
STM32CubeIDE 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 STM32CubeIDE and their licenses are listed in a zip file available from the product page in STMicroelectronics www.st.com web site. Table 2 provides the description of the licenses of additional components in STM32CubeIDE.
| Name | Version | Copyright | License | Detail |
|---|---|---|---|---|
| STLink-USB-Driver | STMicroelectronics | Proprietary | Refer to the global software license agreement | |
| STLink-USB-Driver-lib | STMicroelectronics | Proprietary | Refer to the global software license agreement | |
| ST-LINK Server | 2.0.2-3 | STMicroelectronics | Proprietary | Refer to the global software license agreement |
Cross-selector data disclaimer
The information presented in the cross-reference tool is intended to help the users to narrow their search of STMicroelectronics products based on similarity to other available products. The information is based on data published by other semiconductor manufacturers and might contain errors. STMicroelectronics provides the information "as is" and does not make any representations or warranties as to its accuracy or suitability for any particular purpose. STMicroelectronics recommends that the users make their purchase decision based on their review of STMicroelectronics datasheets and other product documentation. Any pricing information is an estimate for budgetary purposes only.
STM32CubeIDE v1.7.0 release information
New feature
- Eclipse® update 2021-03 (Q1 release) with improved macOS® Big Sur support
- STM32CubeMX v6.3.0 integration
- RTOS support improvements: full call stack for all tasks in the Debug view
- New feature highlight in the Information Center
- Projectless debug support: debug is possible with an elf file and no STM32 project
- Thread-safe malloc solution
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.4.x or later versions. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
With STM32CubeIDE v1.5.0, the option "Disable thread-safe initialization of local static objects (-fno-threadsafe-statics)" has changed default value from "true" to "false". This means that both Flash memory and RAM usages are slightly increased with respect to previous versions of STM32CubeIDE, with the benefit of removing a potential race condition in the embedded code. To preserve the old behavior, make sure that the checkbox for the option is checked under [Project properties]>[C/C++ Build]>[Settings]>[Tool Settings]>[MCU G++ Compiler]>[Optimization].
Fixed issues
Refer to the STM32 microcontrollers wiki at wiki.st.com/stm32mcu/wiki/Category:STM32CubeIDE_errata.
Known problems and limitations
Refer to the STM32 microcontrollers wiki at wiki.st.com/stm32mcu/wiki/Category:STM32CubeIDE_errata.
Previous release information
STM32CubeIDE v1.6.1 release information
New feature
- STM32CubeMX v6.2.1 integration
- Updated to OpenSTLinux v3.0.0 including FIP image generation
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.4.x or later versions. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
With STM32CubeIDE v1.5.0, the option "Disable thread-safe initialization of local static objects (-fno-threadsafe-statics)" has changed default value from "true" to "false". This means that both Flash memory and RAM usages are slightly increased with respect to previous versions of STM32CubeIDE, with the benefit of removing a potential race condition in the embedded code. To preserve the old behavior, make sure that the checkbox for the option is checked under [Project properties]>[C/C++ Build]>[Settings]>[Tool Settings]>[MCU G++ Compiler]>[Optimization].
Fixed issues
| ID | Summary |
|---|---|
| 101797 | Updating the .ioc file no longer opens multiple project files on MPU projects. |
| 102318 | The Manage Embedded Software dialog now works correctly on macOS®. |
STM32CubeIDE v1.6.0 release information
New feature
- STM32CubeMX v6.2.0 integration
- New GNU Tools for STM32 toolchain v9.3.1
- Toolchain selector extension allowing third-party GCC toolchain selection
- Azure® RTOS kernel aware debug
- Pinout compatible search feature
- STM32MP1 application/library user land development
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.4.x or later versions. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
With STM32CubeIDE v1.5.0, the option "Disable thread-safe initialization of local static objects (-fno-threadsafe-statics)" has changed default value from "true" to "false". This means that both Flash memory and RAM usages are slightly increased with respect to previous versions of STM32CubeIDE, with the benefit of removing a potential race condition in the embedded code. To preserve the old behavior, make sure that the checkbox for the option is checked under [Project properties]>[C/C++ Build]>[Settings]>[Tool Settings]>[MCU G++ Compiler]>[Optimization].
STM32CubeIDE v1.5.1 release information
New feature
- STM32CubeMX v6.1.1 integration
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.4.x or later versions. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
Fixed issues
| ID | Summary |
|---|---|
| 97133 | [STM32CubeMX] Baud rate calculator issue. |
STM32CubeIDE v1.5.0 release information
New feature
- STM32CubeMX v6.1.0 integration
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.4.x or later versions. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
Fixed issues
| ID | Summary |
|---|---|
| 89316 | Build system improvements with respect to incremental builds. The build system now detects additional GUI option changes. |
| 90364 | Fixed issue with STM32CubeMX building libraries in the wrong order. |
| 93375 | Kubuntu®/Ubuntu®: Fixed issue with dependency on libwebkit2gtk-4.0-37 allowing proper rendering of the Information Center. |
| 95784 | Linux® tar.gz generic installer packages now report if the installation failed due to insufficient disk space. |
| 96347 | STM32CubeMX no longer reverts C++ projects to C projects upon the next code generate operation. |
| 98703 | STM32CubeIDE 1.6.0 bundles a new JRE™™ supporting Java® 11 fixing issues with Eclipse® Marketplace plug-ins such as eGit. |
| 98999 | STM32H7 Series: fixed issue with missing memory regions in linker scripts. |
| 99421 | STM32WB30xx: fixed issue with memory region Ram_Shared being set to the wrong address. |
| 99537 | STM32Cube project generation outside the "default location" no longer cleans the folder in case of folder access permission issues. |
| 99857 | The Toolchain Manager supports Eclipse CDT™™™ projects. |
| 100002 | FreeRTOST™ and Azure® RTOS ThreadX debug views now support dark theme. |
| 100209 | Fixed issue leading to main.c being generated in the wrong folder for hierarchical projects. |
STM32CubeIDE v1.4.2 release information
New feature
- STM32CubeMX v6.1.1 integration
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.4.x or later versions. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
Fixed issues
| ID | Summary |
|---|---|
| 97133 | [STM32CubeMX] Baud rate calculator issue. |
STM32CubeIDE v1.4.1 release information
Fixed issues
| ID | Summary |
|---|---|
| 90636 | [STM32CubeMX] IRQ priorities for some "Non-System" IPs are set to minimal values after project migration. |
| 90727 | [STM32CubeIDE] Fixed issue with OpenOCD not being able to use with third-party debug probes. |
| 90934 | [STM32CubeMX] Some boards do not boot after enabling FreeRTOST™. |
STM32CubeIDE v1.4.0 release information
New feature
- STM32CubeMX v6.0.0 integration
- Additional support for STM32MP1 devices: STM32 MPU OpenSTLinux 2.0 SDK and project support
- Additional support for STM32H7 devices
- Additional support for STM32G4 devices
- OpenOCD support improvements
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.2.0 or later versions. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
Fixed issues
| ID | Summary |
|---|---|
| 47930 | STM32CubeIDE Serial Wire Viewer selecting large amounts of data to copy to the clipboard no longer crashes STM32CubeIDE. |
| 62821 | Debug configuration for STM32L4+ is missing low-power and watchdog selections for ST-LINK GDB server. |
| 87084 | Debugging a project using ST-LINK GDB server on a board and having multiple boards connected to the PC works if Shared ST-LINK is selected. |
| 72289 | An STM32MP1 project generated with STM32CubeMX can be debugged in both the engineering and production modes. |
| 73302 | STM32L5 projects are generated properly when FreeRTOST™ is activated. |
| 79065 | Using OpenOCD with ST-LINK checks and forces ST-LINK firmware update at debug launch. |
| 79853 | Improved sysmem.c function sbrk. |
| 85191 |
STM32CubeIDE v1.3.1 release information
New feature
- STM32CubeMX v5.6.1 integration
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.2.0 or later versions. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
Fixed issues
| ID | Summary |
|---|---|
| 79013 | Changing the call order in the Advanced Settings tab can now be saved. |
| 81455 | It is now possible to save the DDR tuning configuration. |
STM32CubeIDE v1.3.0 release information
New feature
- STM32CubeMX v5.6.0 integration
- Additional support for STM32WB devices
- Run configurations support, allowing the user to download an application and reset the target without launching a full debug session
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.2.0 or later versions. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
Fixed issues
| ID | Summary |
|---|---|
| 63770 | The Linux® installers no longer install any packages before the license agreement is accepted. |
| 64277 | The run configuration and [Run] button now allow the user to download and reset the device without launching a full debug session. |
| 66769 | Importing the .ioc file created by stand-alone STM32CubeMX is now fully supported. |
| 72960 | Peripherals are correctly initialized when creating an STM32CubeIDE project for several STM32G4 boards. |
| 72978 | Now all STM32CubeIDE projects for STM32H7 boards can be built. |
| 73657 | Pin assigment in ioc-editor pinout view on STM32L5, STM32MP1 and STM32H7 devices now works and leads to a dirty ioc file no longer requiring the user to manually generate code with the Alt + K shortcut. |
| 75322 | It is now possible to adjust JTAG/SWD frequency through the UI for ST-LINK GDB server. |
| 75927 | Debug in low-power modes are now selectable in the debug configuration dialog when using ST-LINK GDB server. |
| 75934 | It is now possible to configure watchdog counters during debugging for ST-LINK GDB server. |
| 76789 | Fix for external Flash loaders. Added option -external-init to the ST-LINK GDB server. Use this option to call Init() after reset. Calling Init() was previously the default behavior. |
| 80498 | It is now possible to use absolute paths to .elf files in the debug configuration. |
STM32CubeIDE v1.2.0 release information
New feature
- STM32CubeMX v5.5.0 integration
- Support for STM32L5 devices
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.2.0. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
Fixed issues
| ID | Summary |
|---|---|
| 62132 | The macOS® installer displays incompatible version dialog when installing the stlink-server package. This can safely be ignored. |
| 66327 | Updating field [HCLK] in tab Clock Configuration is difficult. |
| 69113 | Importing a project from an earlier version into the current one will hang STM32CubeIDE when opening the ioc editor. This only affects macOS®. |
| 69233 | In the STM32CubeMX .ioc editor under [Project Manager]>[Code Generator], there is a [settings] button that is not yet implemented. |
| 70529 | Null Pointer Exception occurs when trying to create a new debug configuration on a hierarchical root project, selecting OpenOCD debug probe, and changing some options. |
| 73310 | For importing an MPU project, consult application note Getting started with projects based on the STM32MP1 Series in STM32CubeIDE (AN5360). |
| 73521 | For STM32H7 devices using OpenOCD, the Cortex®-M7 must launch the debug session first. |
| 73635 | Projects with a debug configuration from a previous version of STM32CubeIDE need to disable, click [apply], and then enable SWV and Live Expressions. |
| 73652 | ST-LINK GDB-server debugger may lose control over STM32H7 dual-core devices during reset operations. This is less prevalent if Flash loading is disabled. Preferrably use multiple use case oriented debug configurations. |
| 73785 | ST-LINK GDB-server debugger may fail while attaching to a core in a low-power state, even if option Halt all cores is enabled. This is circumvented by waiting to attach to the core until the application has exited any low-power state. |
| 73790 | The [Reset] toolbar button might fail during a multi-core debug scenario. Restart of the debug session is then required. |
| 73890 | ST-LINK GDB-server does not work properly with the macOS® version of STM32CubeIDE. The use of OpenOCD or J-Link is required. |
| 78587 | STM32L5 empty projects have incorrect linker scripts. |
STM32CubeIDE v1.1.0 release information
New feature
- STM32CubeMX v5.4.0 integration
- Support for STM32MP1 devices
- Beta support for STM32L5 devices(1)
- Support for STM32H7 devices
(1) Beta support only. Contact the local STMicroelectronics sales office or distributor (refer to www.st.com/content/st_com/en/contact-us.html) to get STM32CubeL5 MCU Package V0.7.0.
Important: STMicroelectronics recommends that a new workspace is created for the work done with STM32CubeIDE v1.1.0. Existing projects made with a previous version of STM32CubeIDE must be imported and copied into the new workspace.
Fixed issues
| ID | Summary |
|---|---|
| 64364 | The [Help]>[Data refresher] can be invoked several times without pop-up dialog. |
| 65331 | The creation of static libraries with the option add libraries as reference leads to the unintended generation of the Drivers folder. |
| 65482 | Creating a BOARD project with Code generator options add necessary library files as reference.. and initialize all peripherals with default settings can cause build errors if BOARD depends on the USB library. |
| 66391 | The Generate code operation re-includes excluded files in folders that are created by STM32CubeMX. |
| 68131 | The user cannot change Application Structure from Basic to Advanced or vice versa without losing user's code. |
| 69380 | When creating an empty project, the FPU is enabled in the build settings, but the project is generated without a SystemInit function to initialize FPU at run-time. |
| 71371 | Pre- and post-build steps, build configuration, and non-STM32CubeMX generated files inside project and others get deleted when project is regenerated. |
STM32CubeIDE v1.0.2 release information
New feature
- STM32CubeMX v5.3.0 integration.
Fixed issues
| ID | Summary |
|---|---|
| 56619 | Conditional breakpoints do not work. Fixed in ST-LINK and J-Link provided that Live expressions is enabled. |
| 61897 | On macOS®, the .ioc editor does not show the Peripheral categories frame on the left side by default. |
| 62712 | Opening one .ioc file and trying to open a second .ioc file while the first one loads causes the IDE to crash. |
| 65141 | The uninstaller sometimes does not work on non-English Windows® installations. |
| 65335 | The font size menu is not available for .ioc editor content. |
| 65452 | Changing from HAL to LL driver or vice versa in the .ioc editor does not save the .ioc file. |
| 65458 | The USE HAL DRIVER symbol is not properly removed when switching from HAL to LL driver, which can cause build failure. |
| 66949 | TeamSynchronizing perspective remains hidden after Git™ is installed. |
| 67089 | Creating a C project after having created a C++ project results in C++ nature set in all future projects in the active workspace. |
| 67458 | The -u_printf_float in [MCU Settings] generates a warning about being disabled despite being enabled. |
| 67679 | Al software pack projects are not generated properly. |
STM32CubeIDE v1.0.1 release information
New feature
- STM32CubeMX v5.2.1 integration including latest MCUFinder evolution.
Fixed issues
| ID | Summary |
|---|---|
| 59230 | X-CUBE-AI links properly. |
| 65403 | On Windows®: BusyBox sh.exe pwd command fixed. |
| 65897 | Fixed loss of source files upon regeneration of code with dependencies on STM32Cube Expansion Packages. |
| 66212 | Integrated STM32CubeMX 5.2.1 supporting latest .ioc file format. |
| 66986 | Fixed project nature warning message when importing SW4STM32 projects. |
| 67014 | Fixed project nature warning message when importing SW4STM32 projects. |
| 67155 | Fixed _estack value on newly generated projects to be correctly aligned. |
| 67664 | Removed shortcut to non-existing readme.txt from Windows® start menu. |
STM32CubeIDE v1.0.0 release information
Features
- Integration of STM32CubeMX that provides services for: STM32 microcontroller selection, Pinout, clock, IP, and middleware configuration, Project creation and generation of the initialization code
- Based on Eclipse®/CDT, with support of Eclipse® add-ons
- GNU C/C++ for Arm® toolchain and GDB debugger: GNU Arm Embedded, GNU tools for STM32, with enhancements compared to the standard toolchain
- Additional advanced features including: Build Analyzer view, Static Stack Analyzer view, CPU core, IP register, and memory views, Live Expressions view, System analysis and real-time tracing views (SWV), Fault Analyzer view, ITM software tracing, SFR view
- Support of STMicroelectronics ST-LINK/V2 and STLINK-V3: ST-LINK_gdbserver 5.2.2, OpenOCD 0.10.0+dev00021-g524e8c8
- Support of SEGGER J-Link: SEGGER J-Link gdbserver v6.44c
- Import of projects from Atollic® TrueSTUDIO® and AC6 System Workbench for STM32
Revision history
| Date | Revision | Changes |
|---|---|---|
| 19-Apr-2019 | 1 | Initial release. |
| 11-Jun-2019 | 2 | Added information related to STM32CubeIDE v1.0.1: STM32CubeIDE v1.0.1 release information, Cross-selector data disclaimer |
| 16-Jul-2019 | 3 | Added information related to STM32CubeIDE v1.0.2: STM32CubeIDE v1.0.2 release information |
| 15-Oct-2019 | 4 | Added information related to STM32CubeIDE v1.1.0: STM32CubeIDE v1.1.0 release information |
| 8-Jan-2020 | 5 | Added information related to STM32CubeIDE v1.2.0: STM32CubeIDE v1.2.0 release information |
| 20-Feb-2020 | 6 | Added information related to STM32CubeIDE v1.3.0: STM32CubeIDE v1.3.0 release information |
| 10-Apr-2020 | 7 | Added information related to STM32CubeIDE v1.3.1: STM32CubeIDE v1.3.1 release information |
| 27-Jul-2020 | 8 | Added information related to STM32CubeIDE v1.4.0: STM32CubeIDE v1.4.0 release information, Updated Overview and Host PC system requirements |
| 20-Aug-2020 | 9 | Added information related to STM32CubeIDE v1.4.1 and v1.4.2: STM32CubeIDE v1.4.1 release information, STM32CubeIDE v1.4.2 release information |
| 17-Nov-2020 | 10 | Added information related to STM32CubeIDE v1.5.0: STM32CubeIDE v1.5.0 release information |
| 17-Dec-2020 | 11 | Added information related to STM32CubeIDE v1.5.1: STM32CubeIDE v1.5.1 release information |
| 18-Feb-2021 | 12 | Added information related to STM32CubeIDE v1.6.0: STM32CubeIDE v1.6.0 release information |
| 25-Mar-2021 | 13 | Added information related to STM32CubeIDE v1.6.1: STM32CubeIDE v1.6.1 release information |
| 5-Jul-2021 | 14 | Added information related to STM32CubeIDE v1.7.0: STM32CubeIDE v1.7.0 release information |
