Release limitations

STM32 series configuration and code generation limitations

STM32 series

Configuration and code generation limitations

STM32C5

C5 limitations.

Generic STM32CubeMX2 limitations

Display

  • 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.

Installer

  • 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.

Uninstaller

  • 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

Documentation

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

Project manager

  • 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:\’

Packs management

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

Project generation

  • During project regeneration, STM32CubeMX2 does not automatically merge IDE project files, such as OpenCMSIS csolution, EWARM .ewp, and CMake 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).

  • The release build target is not available from the UI, but it can be added using the CLI command.

    cube mx ide-project generate –project-path <projectPath> –build-target <buildTarget> –destination <destination> –format <format> –source <source>

    BuildTarget format: [projectName][.buildType][+targetType]

    example:

    cube mx ide-project generate -p MyProject.ioc2 –build-target .debug_GCC+STM32C562RET6 .release_GCC+STM32C562RET6 –destination MyIDEProject –format CMake –source include-packs-from-local

Code Preview

  • 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.

Clock

  • The RTCPRE input is not grayed out as expected when HSE is disabled.