Edge Impulse Docs

Edge Impulse Documentation

Welcome to the Edge Impulse documentation. You'll find comprehensive guides and documentation to help you start working with Edge Impulse as quickly as possible, as well as support if you get stuck. Let's jump right in!

Arduino Portenta H7 + Vision shield (preview)


Preview support

This page contains information about preview support for the Arduino Portenta H7. This board is not fully supported yet by Edge Impulse.

The Portenta H7 is a powerful development board from Arduino with both a Cortex-M7 microcontroller and a Cortex-M4 microcontroller, a BLE/WiFi radio, and an extension slot to connect the Portenta vision shield - which adds a camera and dual microphones. At the moment the Portenta H7 is partially supported by Edge Impulse, letting you collect data from the camera, build computer vision models, and deploy trained machine learning models back to the development board. The Portenta H7 and the vision shield are available directly from Arduino for ~$150 in total.

There are two versions of the vision shield: one that has an Ethernet connection and one with a LoRa radio. Both of these can be used with Edge Impulse.

Portena H7 development boardPortena H7 development board

Portena H7 development board

Installing dependencies

To set this device up in Edge Impulse, you will need to install the following software:

  1. Edge Impulse CLI.
  2. Arduino CLI.
  3. On Linux:
    • GNU Screen: install for example via sudo apt install screen.


Problems installing the CLI?

See the Installation and troubleshooting guide.

Connecting to Edge Impulse

With all the software in place it's time to connect the development board to Edge Impulse.

1. Connect the vision shield

Using the vision shield using two edge connectors on the back Portena H7.

Portenta vision shield (with a LoRa radio) connected to the Portenta H7.Portenta vision shield (with a LoRa radio) connected to the Portenta H7.

Portenta vision shield (with a LoRa radio) connected to the Portenta H7.

2. Connect the development board to your computer

Use a USB-C cable to connect the development board to your computer. Then, double-tap the RESET button to put the device into bootloader mode. You should see the green LED on the front pulsating.

3. Update the firmware

The development board does not come with the right firmware yet. To update the firmware:

  1. Download the latest Edge Impulse firmware, and unzip the file.
  2. Open the flash script for your operating system (flash_windows.bat, flash_mac.command or flash_linux.sh) to flash the firmware.
  3. Wait until flashing is complete, and press the RESET button once to launch the new firmware.

4. Setting keys

From a command prompt or terminal, run:


This will start a wizard which will ask you to log in, and choose an Edge Impulse project. If you want to switch projects run the command with --clean.

Alternatively, recent versions of Google Chrome and Microsoft Edge can collect data directly from your development board, without the need for the Edge Impulse CLI. See this blog post for more information.

5. Verifying that the device is connected

That's all! Your device is now connected to Edge Impulse. To verify this, go to your Edge Impulse project, and click Devices. The device will be listed here.

Device connected to Edge Impulse.Device connected to Edge Impulse.

Device connected to Edge Impulse.

Next steps: building a machine learning model

With everything set up you can now build your first machine learning model with these tutorials:

Looking to connect different sensors? The Data forwarder lets you easily send data from any sensor into Edge Impulse.

Deploying back to device

While the Portenta H7 support is in preview you can currently not build binaries to the development board from the Studio. To deploy your impulse back to your device you can however use:

  • The example-portenta-lorawan example. This is an end-to-end example that classifies data and then sends the result over LoRaWAN.
  • Or, use the Running your impulse locally: On your Arduino tutorial. However, this requires you to feed the data from the camera into the impulse yourself (and we rely on preview libraries which might not be accessible to you yet). This will be updated with a complete example sketch once full support for the Portenta H7 is released.

Updated 5 months ago

Arduino Portenta H7 + Vision shield (preview)

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.