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.

  • The installer does not permit overwriting an existing installation. This restriction prevents installation if the software is already present. Users must uninstall the previously installed version.

  • 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

  • There is no graphical user interface to uninstall STM32CubeMX2. To uninstall STM32CubeMX2, refer How to start - Uninstallation.

  • The STM32CubeMX2 uninstall on Linux should be launched via terminal. Double-click on uninstall application does not work.

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.

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.

  • Using a FreeRTOS example downloaded through the Example Library service on https://st.com, the STM32CubeMX2 project generation overwrites the mx_freertos_app.c and mx_freertos_app.h files without information to user (generatedmiddlewarefreertos folder). To keep example functional, those files should be copied from the original example zip file into the generated project.