STM32CubeIDE
STMicroelectronics' free IDE for STM32 microcontrollers: build, flash and debug C and C++ firmware with GCC and GDB through the ST-LINK on every Nucleo board. From version 2.0 it works alongside the standalone STM32CubeMX for pin and clock configuration. Runs on Windows, macOS and Linux.
2.2.0 (2026)
ST Community · Sept 2026
Tool
Other
STMicroelectronics
Setup in an hour, used daily
Intermediate
Free
What STM32CubeIDE is
STM32CubeIDE is ST's official integrated development environment for STM32 microcontrollers. Based on Eclipse, it gives you a C and C++ editor, the GCC toolchain for Arm, and a debugger that talks to ST-LINK probes, including the one built into every STM32 Nucleo and Discovery board. You can build a project, flash it and step through it line by line with one USB cable. The debugger also shows peripheral registers, RTOS task views and a fault analyser for HardFaults, which makes it one of the best places to learn what a microcontroller is really doing.
What changed in version 2.0
Older tutorials show STM32CubeMX, the graphical tool for configuring pins, clocks and peripherals, built into the IDE. ST announced that from STM32CubeIDE 2.0.0 this is no longer the case: STM32CubeMX is now a standalone tool, and the two work together in the same way CubeMX works with other IDEs. Opening a project's .ioc file from the IDE launches the standalone CubeMX if it is installed. ST gave smaller installation size and better performance as reasons for the change. If you follow an older course, install both tools and expect CubeMX to open in its own window.
ST also offers an official alternative for people who prefer VS Code: STM32CubeIDE for Visual Studio Code, a set of extensions with building and debugging support.
Is it worth your time?
If you are learning STM32, yes. It is free, officially supported, and it is what most STM32 tutorials, including ST's own wiki articles, use. Learning to debug properly here, with breakpoints, register views and fault analysis, is a skill that transfers to any Arm Cortex-M job.
Prerequisites and time
You should know basic C. Installing the IDE and CubeMX and blinking an LED on a Nucleo board takes an hour or two the first time. Plan a few more sessions to become comfortable with the debugger.
What you can do with it
- Generate a project with STM32CubeMX and write your code between the USER CODE markers so regeneration keeps it.
- Build, flash and debug over the on-board ST-LINK.
- Inspect variables, memory and peripheral registers while stepping through code.
- Diagnose HardFaults and view FreeRTOS tasks during a debug session.
Free or paid?
STM32CubeIDE is free to download from st.com after accepting the licence. It runs on Windows, macOS and Linux.
Common questions
Do I need STM32CubeMX? Not strictly, but it saves a great deal of clock and peripheral setup. Most learners use it.
Which board should I start with? A Nucleo board, because it includes the ST-LINK debugger.
Best for: anyone learning or building on STM32, from a first blinking LED to an RTOS-based project.
Ready to start?
Opens on STMicroelectronics in a new tab.
Stuck on something specific?
Writing only gets you so far. If you want an answer to your situation rather than the general case, book a session and we will work through it together. Sessions are free for approved Sefism members, and a few slots open each week.
Follow along
New writing, resources and project ideas land here first.