Known issues ¶

Missing Windows ST-Link driver for STM32CubeIDE for Visual Studio Code ¶

Issue : On a new Windows 11 PC, users who install Visual Studio Code and the STM32CubeIDE extension may experience issues detecting STM32 boards with ST-Link v2 or v2.1.

Symptoms :

No device appears in the STM32Cube Devices and Boards webview.
No device is detected with ST-Linkupgrade.exe.

Complex project creation ¶

Issue : Complex projects created using the empty project feature are incorrectly set up as non-complex.

Example : H7 dual-core projects are created as mono-core.

Cube command not available on Windows with Git Bash ¶

Issue : The cube command is not available when using Git Bash on Windows.

Workaround : Windows users must manually configure their environment, for example, by editing .bashrc or Visual Studio Code settings.

STLINK-V3 not working with macOS M architecture ¶

Issue : STLINK-V3 devices do not function properly on macOS with M architecture.

Workaround : Use a USB hub instead of a Type-C to Type-C cable.

libncurses5 dependency on Linux ¶

Issue : Debug sessions may fail due to a missing libncurses5 dependency.

Note : Fixed. Dedicated STM32Cube bundles serve GNU Tools for STM32 assets. Update if possible.

Workarounds :

Ubuntu 22.04 : Install with:
```
sudo apt-get install libncurses5
```

Ubuntu 24.04 : - Use the following commands to manually install the library:

             wget http://archive.ubuntu.com/ubuntu/pool/universe/n/ncurses/libtinfo5_6.4-2_amd64.deb && sudo dpkg -i libtinfo5_6.4-2_amd64.deb && rm -f libtinfo5_6.4-2_amd64.deb
wget http://archive.ubuntu.com/ubuntu/pool/universe/n/ncurses/libncurses5_6.4-2_amd64.deb && sudo dpkg -i libncurses5_6.4-2_amd64.deb && rm -f libncurses5_6.4-2_amd64.deb

Fedora 41 : Install the necessary libraries with:
```
sudo dnf install ncurses-compat-libs
```

Clangd indexing dependency on zstd Library on macOS ¶

Issue : Clangd indexing does not work on macOS due to a missing zstd library.

Workaround : Install Homebrew and then run:

brew install zstd

CMake error with Visual Studio Code installed via the Snap Store on Ubuntu ¶

Issue : CMake fails to discover projects when Microsoft Visual Studio Code is installed via the Snap Store.

Workaround : Install Visual Studio Code using a different method, for example, download the .deb package directly from the official website or use an alternative package manager such as apt or flatpak .

Using J-Link to debug on macOS ¶

Issue : Attempting to debug causes the error “JLinkConfig” is damaged and can’t be opened. You should move it to the Bin.”

Workaround : Go to the Privacy & Security setting and click Open Anyway for the JLinkConfig.app application.

Creating an empty project while offline ¶

Issue : When creating an empty project while offline, a faulty project is generated.

Workaround : Go online when creating the project. It is then safe to go back to offline mode.