STM32CubeMX, CMake and QtCreator

8 Feb

This is a short walk-through to setup a build configuration for STM32 projects using cmake and QtCreator.

STM32CubeMX on Linux

The STM32CubeMX software is available for Linux now! (last time I checked it was only for Windows). Download and install it. Then, click “New Project” and select the processor or board that you want to use. In my case, it’s the STM32F0 Discovery board.

Click OK and you will see a nice graphical display of your processor. You can change/tune a lot of stuff here, but for now leave it as it is. Go to Project->Settings and enter a project name. Also choose toolchain “Other Toolchains (GPDSC)”.

On the “Code Generator” tab, make sure to only add necessary library files.

After configuring these project settings, go to Project->Generate Code. If it is the first time, it will automatically download the required HAL package and install it to ~/STM32Cube/Repostory. The project folder will look similar to this:


Previously I used the team-gcc-arm-embedded ppa, but that’s now suddenly at version 6 and I still want to use version 5. Version 5 is available from launchpad. I just copied the folder into my home directory, so I got /home/bart/gcc-arm-none-eabi-5_4-2016q3.


As you can see, there is no makefile or whatsoever in the project directory. This time, I’ll use cmake to build the project. There is an awesome project out on github which makes life super-easy: stm32-cmake. Clone the repository to your preferred location. I cloned it to /home/bart/git/stm32-cmake.

The next thing to do is add a file CMakeLists.txt in the main directory of your project, for example /home/bart/testdir/stm32f0_example_project/CMakeLists.txt. For me it has the following content:

SET(STM32Cube_DIR /home/bart/STM32Cube/Repository/STM32Cube_FW_F0_V1.7.0)
SET(TOOLCHAIN_PREFIX /home/bart/gcc-arm-none-eabi-5_4-2016q3)
SET(CMAKE_TOOLCHAIN_FILE /home/bart/git/stm32-cmake/cmake/gcc_stm32.cmake)
SET(CMAKE_MODULE_PATH /home/bart/git/stm32-cmake/cmake)








You may need to change some of the lines to match your processor, installation locations and source files.


The next and final step is configuring QtCreator. I assume you already have the newest version installed. The setup is very similar as in a previous post. However this time it is important to clean the CMake configuration field!

Then, when this is configured, go to File->Open File or Project. Browse to your project folder and select CMakeLists.txt. A screen pops up where you have to select the build configuration which you have just created:

Then hit “Configure Project” and you are all setup!

Hit the hammer in the bottom left corner to build. The default build directory will be one level higher than your project directory. In my case, the build directory is at /home/bart/testdir/build-stm32f0_example_project-STM32-Default.


This process is still similar to the previous post. However there are some actions I had to take to make it work with the newest version of openocd (0.10).

  1. Download openocd from sourgeforce.
  2. Extract the archive to a directory of your choise.
  3. Install the libusb 1.0 dev package. Without this, the STLink did not work! “sudo apt install libusb-1.0-0-dev”
  4. Run “./configure” (not as root)
  5. Run “make”
  6. Run “sudo make install”
  7. “sudo cp contrib/60-openocd.rules /etc/udev/rules.d/”
  8. “sudo udevadm control –reload-rules”

It is also working in pipe mode now! So you don’t have to run openocd yourself in the background.

One Reply to “STM32CubeMX, CMake and QtCreator”

  1. Hi Bart,

    I am trying to get CubeMX, GCC ARM, QTCreator, and openocd running for STM32 build and debug.
    So far I managed to make QTCreator build my project as created by CubeMX.
    From the command line I can have GDB, upload my program then run it etc.
    No matter what I try however I cannot get debugging working from within QTCreator.
    I created 2 stubs such that I can see how python GDB and openocd are executed and what is communicated back and forth. I cannot get openocd to be started by QTCreator and when using openocd in ‘no startup’ mode QTCreator fails to send the commands to gdb to connect to openocd the load an run my program. I am using all the latest tools on lubuntu: QTcreater 5.10, ARM GCC&GDB 7-2017, openocd 0.10.0.
    Do you have any ideas?
    Can you please provide the version numbers of the various packages that you know that work.

Leave a Reply

Your email address will not be published. Required fields are marked *

Time limit is exhausted. Please reload CAPTCHA.

This site uses Akismet to reduce spam. Learn how your comment data is processed.