<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head></head><body><h3>Introduction</h3>
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).<br>
<br>
STM32CubeMX has the following key features:<br><ul><li>
Easy microcontroller selection
covering whole STM32 portfolio.</li><li>Board selection from a list of STMicroelectronics boards.</li><li>Easy microcontroller configuration (pins, clock tree, peripherals,
middleware) and generation of the corresponding initialization C code.</li><li>Easy switching to another microcontroller belonging to the same
series by importing a previously-saved configuration to a new MCU
project.</li><li>Generation of configuration reports.</li><li>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.</li><li>Power consumption calculation for a user-defined application sequence.</li><li>Self-updates allowing the user to keep the STM32CubeMX up-to-date.</li><li>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).</li></ul>
<br><h3>Installing and running STM32CubeMX 5.3.0<br></h3><h4>Supported operating systems and architectures</h4><ul><li>Windows® 7: 32-bit (x86), 64-bit (x64)</li><li>Windows® 8: 32-bit (x86), 64-bit (x64)</li><li>Windows® 10: 32-bit (x86), 64-bit (x64)</li><li>Linux®: 32-bit (x86) and 64-bit (x64) (tested on RedHat, Ubuntu and Fedora)<br>Since
STM32CubeMX is a 32-bit application, some versions of Linux 64-bit<br>
distributions require to install 32-bit compliant packages such as
ia32-libs.</li><li>MacOS: 64-bit (x64) (tested on OS X Yosemite)</li></ul><h4>Software requirements</h4>The Java Run Time Environment 1.8 must be installed.<br>Note that Java 9 and Java 10 are not supported and there is limited validation done with Java 11.<br>After Oracle announcement related to End of Public Updates for Oracle JDK 8, you can
access OpenJDK 8 via https://adoptopenjdk.net/.
<h4>Installing STM32CubeMX standalone version</h4>To install STM32CubeMX, follow the steps below:<br><ul><li>Download STM32CubeMX installation package from www.st.com/stm32cubemx.</li><li>Extract
(unzip) the whole content of the the latest STM32CubeMX installation
package from http://www.st.com/stm32cubemx into the same directory<br></li><li>Check your access rights and launch the installation wizard:<br></li><ul><li>on Windows</li><ul><li>Make sure you have administrators rights</li><li>Double click on the SetupSTM32CubeMX-5.3.0.exe file to launch the installation wizard</li></ul><li>On Linux</li><ul><li>Make sure you have access rights to the target installation
directory. You can run the installation as root (or sudo) to install STM32CubeMX in shared directories</li><li>Do "chmod 777 SetupSTM32CubeMX-5.0.0.linux" to change the properties, so
that the file is executable.</li><li>Double click on the SetupSTM32CubeMX-5.3.0.linux file or launch it from the console window.</li></ul><li>On MacOS</li><ul><li>Make sure you have administrators rights.
</li><li>Double click on the SetupSTM32CubeMX-5.3.0 application file to launch the wizard.<br>In case of error, launch the exe file with the following command :<br>sudo java -ar SetupSTM32CubeMX-4.14.0.exe<br></li></ul><li>Upon successful installation of STM32CubeMX on Windows, STM32CubeMX icon is
displayed on your desktop and STM32CubeMX application is available from the
Program menu. STM32CubeMX .ioc files are displayed with a cube icon. Double-click
them to open up them using STM32CubeMX.</li><li>Delete the content of the zip from your disk.</li></ul>Please refer to the STM32CubeMX user manual for more details on System requirements or other possible installations.</li></ul><h4>Running STM32CubeMX as standalone application</h4><ul><li>To run STM32CubeMX as a standalone application on Windows: </li><ul><li>Select STM32CubeMX from Program Files > ST Microelectronics > STM32CubeMX.</li><li>Or double-click STM32CubeMX icon on your desktop.</li></ul><li>To run STM32CubeMX as a standalone application on Linux, launch the STM32CubeMX
executable from STM32CubeMX installation directory</li><li>To run STM32CubeMX as a standalone application on macOS®, launch the STM32CubeMX
application from the launchpad.</li><br></ul><h4>Uninstalling STM32CubeMX standalone version<br></h4><h5>Uninstalling STM32CubeMX on macOS</h5><blockquote>To uninstall STM32CubeMX on macOS use the following command line:<br>java -jar <i>STM32CubeMX installation path</i>/Uninstaller/uninstaller.jar.</blockquote><h5>Uninstalling STM32CubeMX on Linux</h5><blockquote>There are two different ways to uninstall STM32CubeMX on Linux:</li><li>By using the following command line
java -jar <i>STM32CubeMX installation path</i>/Uninstaller/uninstaller.jar.</li><li>Through a Windows Explorer window:</li><ul><li>Use a file explorer.<li>Go to the Uninstaller directory of STM32CubeMX installation.</li><li>Double-click the start uninstall desktop shortcut.</blockquote></ul></li>
<h5>Uninstalling STM32CubeMX on Windows</h5><blockquote>
There are three different ways to uninstall STM32CubeMX on Windows:</li><li>By using the following command line
java -jar <i>STM32CubeMX installation path</i>/Uninstaller/uninstaller.jar.</li><li>Through a Windows Explorer window:</li><ul><li>Use a file explorer.<li>Go to the Uninstaller directory of STM32CubeMX installation.</li><li>Double-click the start uninstall desktop shortcut.</ul></li>
<li>Through the Windows Control Panel:</li><ul><li>Select Programs and Features from the Windows Control Panel to display the
list of programs installed on your computer.<li>Right-click STM32CubeMX and select uninstall.</blockquote></li></ul>
<br></li></body></html>
