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.

  • If you pin the STM32CubeMX2 shortcut to the OS toolbar, the shortcut currently points to :

    $INSTALL_FOLDER/resources/stm32cubemx-application/$installed_version/dist/STM32CubeMX2.exe

    instead of the main launcher :

    $INSTALL_FOLDER/stm32cubemx2.exe

    This may cause the shortcut to stop working after a STM32CubeMX2 update, because the referenced executable can be replaced or removed.

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 1.0.0 version after installing CubeMX2 1.0.1 version will uninstall both versions. Please uninstall STM32CubeMX2 1.0.0 version before installing STM32CubeMX2 1.0.1.

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.

  • .ioc2 files created with STM32CubeMX2 1.0.0 version cannot be opened by double-clicking on it starting from STM32CubeMX2 1.0.1 version.

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.

Middleware

  • Only the FreeRTOS middleware is available in STM32CubeMX2.