Installing Mbed OS Portenta boards

Installing Mbed OS Portenta boards

In this tutorial, we will go through a few simple steps on installing the core needed for Mbed OS Portenta boards. This installation is necessary to use your board with the offline Arduino IDE.

This tutorial uses the Arduino IDE. You can download the editor easily from our software page.

If you are using the Web Editor, you can follow the getting started with the Web Editor tutorial.

IMPORTANT: Please make sure to update the bootloader to the most recent version to benefit from the latest improvements. How to do so is explained in the "Updating the Portenta Bootloader" tutorial

Boards using the Mbed core

• Arduino Portenta H7
• Arduino Portenta Machine Control
• Arduino Portenta H7 Lite
• Arduino Portenta H7 Lite Connected

Downloading and installing

1. First, we need to download the Arduino IDE, which can be done from the software page.

2. Install the Arduino IDE on your local machine.

3. Open the Arduino IDE.

Installing the Mbed OS core for Portenta boards

After we have downloaded, installed and opened the Arduino IDE, let's continue to install the core needed.

When we open the editor, we will see an empty sketch.

Here we need to navigate to Tools > Board > Board Manager.

This will open up a new window, with all available cores. Find the one named Arduino Mbed OS Portenta Boards and install it.

This process may take some time, and you may need to accept the installation window that comes up (depending on your operative system). When it is finished, it should say

"INSTALLED"

under the title.

Note: This process may take several minutes.

Exit the board manager, and go to Tools > Board > Arduino Mbed OS Portenta Boards. Here you can see all the Mbed boards listed, where you can select the board you are using. You have now successfully installed the core.

Selecting the port

Now, let's make sure that our board is found by our computer, by selecting the port. Regardless what kind of program we are uploading to the board, we always need to choose the port for the board we are using. This is simply done by navigating to Tools > Port, where you select your board from the list.

This will look different depending on what kind of operative system you are using.

For Windows users, it could look like this:

• <COM14> (Arduino Portenta H7 (M7 core))

For MAC users, it could look like this:

• /dev/cu.usbmodem14112 (Arduino Portenta H7 (M7 core))

Uploading a simple example

You are now ready to start using your board! The easiest way to check that everything is working, is to upload just a simple blink example to your board. This is done by navigating to File > Examples > 01.Basics > Blink.

To upload the sketch, simply click on the arrow in the top left corner. This process takes a few seconds, and it is important to not disconnect the board during this process.

When the code is uploaded, the text

"Done uploading."

is visible in the bottom left corner.

If you look closely at your board, you will notice an green LED blink with an interval of one second. This means you have successfully uploaded a program to your board.