xanderhendriks/stm32cube-extension repository overview

⁠stm32cube-extension

stm32cube-extension⁠: STM32 Cube extension docker container for local development and github actions build.

Please let me know in the issues⁠ what you think. I'm also happy for improvements ideas to the current setup as well.

⁠Build

Download STM32CubeMX⁠ and STMCUFinder⁠ and place them in this directory. Update the versions in the Dockerfile if needed.

To update the image xanderhendriks/stm32cube-extension, execute the following commands in the docker-stm32cube-extension folder:

rm -r .local/share/*
docker build -t xanderhendriks/stm32cube-extension:init .

Now run the docker image with the devcontainer to get the stm32cube extension and its bundles installed. This will populate the .local/share/ directory again which will be included inside the docker image.

To create the updated docker run:

docker build -t xanderhendriks/stm32cube-extension:<version> .

To push it to the docker hub:

docker push docker push xanderhendriks/stm32cube-extension:<version>

Make sure to update the versions at the end of this file.

⁠Run

$ docker pull xanderhendriks/stm32cube-extension:<version>

$ docker run -it --name stm32cube-extension \
    -v c:\GIT\repo:/workspace \
    xanderhendriks/stm32cube-extension:<version>

⁠Running with GUI support (Required for running STM32CubeMX and STMCUFinder)

$ docker run -it --name stm32cube-extension \
    -v c:\GIT\repo:/workspace \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    xanderhendriks/stm32cube-extension:<version>

⁠Start stm32cubemx when running the docker

$ docker run -it --name stm32cube-extension \
    -e DISPLAY=$DISPLAY \
    -v c:\GIT\repo:/workspace \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    xanderhendriks/stm32cube-extension:<version> /usr/local/STMicroelectronics/STM32Cube/STM32CubeMX/STM32CubeMX

⁠Usage

To build your application from the command line execute the following commands:

cmake --preset Release cmake --build --preset Release

⁠Example code

To see how to use this docker image in a github ci pipeline have a look at stm32-sample-application⁠.

⁠STM32 Cube Extension tool versions

⁠STMCubeMX

• STMCubeMX: 6.16.0

⁠STMCUFinder

• STMCUFinder: 6.1.0

⁠Cube extension bundles

• adoptium-jre: 17.0.15+6.st.1
• cmake: 4.0.1+st.3
• cube-cmsis-scanner: 1.1.3
• cube-code-doc: 0.0.5+st.1
• cube-code-manifest: 1.0.6+st.1
• gnu-gdb-for-stm32: 13.3.1+st.10
• gnu-tools-for-stm32-13_3_1-description: 1.0.1+st.1
• gnu-tools-for-stm32: 13.3.1+st.9
• ninja: 1.13.1+st.1
• node: 20.19.4+st.1
• pack-manager-snapshot: 2025.8.6
• pack-manager: 0.3.12
• programmer: 2.20.0
• rtos-proxy: 0.17.0+st.3
• st-arm-clangd: 19.1.2+st.3
• stlink-gdbserver: 7.11.0+st.1
• stlink-server: 2.1.1+st.7
• stlink-upgrader: 3.16.8+st.3