# STM32 Cube IDE

The ST Nucleo board hosts a microcontroller that is both:

* highly *configurable*, in the sense that some of its electrical pins can be rerouted in software and assigned to specific function
* *programmable at a high level,* since we can use C code and use a compiler to produce the microcode that will be uploaded onboard

To handle this great flexibility, ST provides us with an integrated development environment (IDE) that we can use to manage both aspects of Nucleo programming. This is the [**STM32CubeIDE**](https://www.st.com/en/development-tools/stm32cubeide.html)**,** an Eclipse-based IDE for programming STM32 microcontrollers. From the description webpage:

> STM32CubeIDE is an all-in-one multi-OS development tool, which is part of the STM32Cube software ecosystem. STM32CubeIDE is an advanced C/C++ development platform with peripheral configuration, code generation, code compilation, and debug features for STM32 microcontrollers and microprocessors. It is based on the ECLIPSE™/CDT framework and GCC toolchain for the development, and GDB for the debugging.

The IDE includes a chip configuration graphical interface called CubeMX:

![Figure: Screenshot of STM32CubeMX](https://1958907383-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lu3g0bb8nPq-K9HlS53%2F-LyEeE-FCneQbFkG3CPY%2F-LyEeG5IBXAWQtxERRhY%2Fscreenshot-2019-09-25-at-17.51.49-1-1.png?generation=1578663246999723\&alt=media)

and an Eclipse-based programming environment:

![Figure: Screenshot of STM32CubeIDE.](https://1958907383-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lu3g0bb8nPq-K9HlS53%2F-LyEeE-FCneQbFkG3CPY%2F-LyEeG5KKAaVOe28KuWz%2Fscreenshot-2019-09-25-at-12.18.18-1.png?generation=1578663245092449\&alt=media)

## Installation

*Note: these instruction and images were produced on October 1, 2019.*

The following steps are the same for Windows, Linux, and MacOS and they simply consist of downloading the installation files.

### Download instructions

Please refer to the distributor website for detailed installation instructions. Please refer to the next subsection for additional remarks for MaxOS users.

1\) Go on [ST official download page](https://www.st.com/en/development-tools/stm32cubeide.html) with your favorite browser.

2\) Select the download link according to your operating system.

![](https://1958907383-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lu3g0bb8nPq-K9HlS53%2F-LyEeE-FCneQbFkG3CPY%2F-LyEeG5MhpS16CqAuppr%2Fscreenshot-2019-09-25-at-12.14.38-2-1.png?generation=1578663246149547\&alt=media)

4\) You will be asked to log-in in order to continue with the download; please create an account and follow the instructions.

5\) When you will have completed the log-in, the download will normally start.

6\) Open the installer and follow the steps. You need to perform a standard installation. Some driver will also be installed during the process. Don't skip this, otherwise you will not be able to download your code into the microcontroller.

[Here](https://hwlab.learndsp.org/microcontroller/ide/tips), we provide some useful shortcuts tips when working with Eclipse-based tools like SW4STM32.

### Specific instructions for MacOS

*Note: the instructions were tested using MacOS Mojave, Version 10.14 on October 1, 2019.*

You may encounter the following dialog on macOS, please follow the instructions below if it is your case.

![](https://1958907383-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lu3g0bb8nPq-K9HlS53%2F-LyEeE-FCneQbFkG3CPY%2F-LyEeG5ORcBNL4yzxrq6%2Fscreenshot-2019-09-25-at-17.06.48-1.png?generation=1578663246765469\&alt=media)

1\) Open your *System Preferences* and navigate to *Security & Privacy*

2\) In the *General* tab, click *Open Anyway*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hwlab.learndsp.org/microcontroller/ide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.