Release limitations ¶

STM32 series configuration and code generation limitations ¶

STM32 series	Configuration and code generation limitations
STM32C5	C5 limitations.
STM32G5	G5 limitations.
STM32H7P	H7P limitations.

STM32CubeMX2 is optimized for 15 inches / 1920*1080 display. Using lower resolution may lead to incomplete display on some panels. Use Zoom Out to adapt tool to your display.

Depending on your PC configuration, the first screen of the installer may take some time to appear.
You cannot install STM32CubeMX2 1.0.0 version if STM32CubeMX2 1.0.1 (or upper) version is already installed.
We recommend installing a new version of STM32CubeMX2 in a separate directory, rather than using one that already contains an installed version on your machine.
Installation as an administrator is not supported. Do NOT install STM32CubeMX2 with administrator access on Windows by right-clicking and selecting Run as administrator.
Users must install libwebkit2gtk-4.1-0 before launching the installer for Ubuntu 22.04.
STM32CubeMX2 cannot currently be launched on Debian systems using Wayland
- As a workaround, set the following environment variable before launching the app : ELECTRON_OZONE_PLATFORM_HINT=x11. This forces Electron to use XWayland instead of native Wayland.
- An alternative fallback is to launch the application with: --disable-gpu
On macOS, the installer’s See full log file option does not work.

Do not move the uninstaller from the original installation folder. Moving the uninstaller prevents it from running properly and can cause unintended deletion of the installation folder and its contents.
Uninstalling STM32CubeMX2 previous version after installing STM32CubeMX2 1.1.0 version will uninstall both versions. Please uninstall STM32CubeMX2 previous version version before installing STM32CubeMX2 1.1.0 version.
Recent Windows policy updates can prevent the uninstaller from running correctly. If issues occur, follow these steps:
- Manually delete the folder C:\Users\user_name\AppData\Local\STMicroelectronics\STM32CubeMX2\<Version_of_MX2>
- Open the control panel
- You should get STM32CubeMX2 unknown icon
- Double click on the STM32CubeMX2 unknown icon and confirm by yes
- After that, STM32CubeMX2 is fully removed from the PC

STM32CubeMX2 does not include documentation. Connect to the internet to access STM32CubeMX2 online documentation.

Project name must not contain any of the following characters: / : * ? “ < > | + . $ ¤ £ µ % ! § , ; & ~ ‘ ( ) [ ] ` @ { } = ^ and space and must not be composed only of numbers.
Project creation fails when the project directory is set to the root of the ‘C:\’
Running two instances of STM32CubeMX2 simultaneously with the same project open can cause synchronization issues and unexpected behavior, including project generation failures.
When a user opens an existing project or creates a new project from a template that uses STM32C5 2.1.0 packs, the clock tree interface displays errors for DAC1SH on STM32C5 boards, such as ETH1 on the STM32C5 1M board, even when neither IP is enabled.

Pack versions cannot be selected during project creation, latest packs are used by default.

While waiting for enhancements to STM32CubeMX2, a script is available to create STM32CubeMX2 projects using the STM32C5 v2.0.0 packs instead of the latest published pack version.
When the resolver selects a compatible release that is no longer available for download, STM32CubeMX2 might fail the update without trying another available release that also meets the requirements.

For example, if Pack A 1.1 requires Pack B 1.1 or later, STM32CubeMX2 might select Pack B 1.2 and stop when the release cannot be downloaded, even if Pack B 1.1 is available. In this case, the project remains unchanged.

During project regeneration, STM32CubeMX2 does not automatically merge project files. STM32CubeMX2 detects if files have been modified outside the tool since the last generation. The user can choose to overwrite, skip, or create a backup of the existing files.
EWARM: Only version 9.20 is supported.
The main.c and main.h files cannot be relocated.
STM32CubeMX2 cannot generate projects for the ST Arm® Clang toolchain (Clang/LLVM).
Project generation can take time and cannot be stopped. Wait for the generation to complete.
STM32CubeMX2 does not prevent configuration changes while project is being generated. Avoid changing project configuration during project generation.
When generating a project with the OpenCMSIS format, some file filtering is not properly applied, leading to a longer generation process and a larger project size than expected.
When generating code for a project started from an IOC2 extracted from a hardware abstraction layer (HAL) pack, the STM32CubeMX2 Output panel is more verbose than usual. This has no functional impact on the generated project.
STM32CubeIDE version 2.1.1 minimum is mandatory to build CMake projects generated by STM32CubeMX2.
CMakePresets.json and flags.cmake are not updated when the user chooses to add a Release or Debug build target through the command-line interface (CLI).

When an IP configuration is updated in Code Preview, the “Copy content to clipboard” action does not reflect the latest changes. It copies only the default generated code. As a workaround, manually select the full content by pressing [Ctrl+A] before copying.