### 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 5.0.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-5.0.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-5.0.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-5.0.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