Introduction

STM32CubeMX is a graphical tool for 32-bit ARM® Cortex® STM32 microcontrollers. It is part of STMCube" initiative and is available either as a standalone application or as an Eclipse plug-in for integration in Integrated Development Environments (IDEs).

STM32CubeMX has the following key features:

Easy microcontroller selection covering whole STM32 portfolio.
Board selection from a list of STMicroelectronics boards.
Easy microcontroller configuration (pins, clock tree, peripherals, middleware) and generation of the corresponding initialization C code.
Easy switching to another microcontroller belonging to the same series by importing a previously-saved configuration to a new MCU project.
Generation of configuration reports.
Generation of IDE ready projects for a selection of integrated development environment tool chains. STM32CubeMX projects include the generated initialization C code, STM32 HAL drivers, the middleware stacks required for the user configuration, and all the relevant files needed to open and build the project in the selected IDE.
Power consumption calculation for a user-defined application sequence.
Self-updates allowing the user to keep the STM32CubeMX up-to-date.
Download and update of STM32Cube" embedded software required for user application development (see Appendix E: STM32Cube embedded software packages for details on STM32Cube embedded software offer).

Installing and running STM32CubeMX 4.25.0

Supported operating systems and architectures

Windows® 7: 32-bit (x86), 64-bit (x64)
Windows® 8: 32-bit (x86), 64-bit (x64)
Windows® 10: 32-bit (x86), 64-bit (x64)
Linux®: 32-bit (x86) and 64-bit (x64) (tested on RedHat, Ubuntu and Fedora)
Since STM32CubeMX is a 32-bit application, some versions of Linux 64-bit
distributions require to install 32-bit compliant packages such as ia32-libs.
MacOS: 64-bit (x64) (tested on OS X Yosemite)

Software requirements

On Windows and Linux: Java Run Time Environment (minimum version 1.7.0_45)
On MacOS: Java Development Kit (minimum version 1.7.0_45)

Installing STM32CubeMX

To install STM32CubeMX, follow the steps below:

Extract (unzip) the whole content of the the latest STM32CubeMX installation package from http://www.st.com/stm32cubemx into the same directory
on Windows

Make sure you have administrators rights
Double click on the SetupSTM32CubeMX-4.25.0.exe file

On Linux

Make sure you have access rights to the target installation directory, you can run the installation as root (or sudo) to install STM32CubeMX on shared directories
Double click (or launch from the console window) on the SetupSTM32CubeMX-4.25.0.linux file

On MacOS

Make sure you have access rights to the target installation directory, you can run the installation as root (or sudo) to install STM32CubeMX on shared directories
Double click (or launch from the console window) on the SetupSTM32CubeMX-4.25.0 application

After the installation you can safely remove the content of the zip from your disk.
Please refer to the STM32CubeMX user manual for more details on System requirements or other possible installations.

Running STM32CubeMX

on Windows

Select STM32CubeMX from Program Files > ST Microelectronics > STM32CubeMX.
Or double-click STM32CubeMX icon on your desktop.

on Linux

launch the STM32CubeMX executable from the STM32CubeMX installation directory

on MacOS

launch the STM32CubeMX application from the launchpad

Uninstalling STM32CubeMX

To uninstall STM32CubeMX, follow the steps below:

on Windows

Open the Windows Control panel.
Select Programs and Features to display the list of programs installed on your computer.
Right click on STM32CubeMX and select the uninstall function.

on Linux

use a file explorer, go in the Uninstaller directory of the STM32CubeMX installation and double click on the startuninstall desktop shortcut
or launch manually the uninstallation with java -jar <install path>/Uninstaller/uninstaller.jar

on MacOS

use a file explorer, go in the Uninstaller directory of the STM32CubeMX installation and double click on the uninstaller.jar
or directly move the STM32CubeMX application in the recycle bin