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!

Nordic Semi nRF9160 DK

The Nordic Semiconductor nRF9160 DK is a development board with an nRF9160 SIP incorporating a Cortex M-33 for your application, a full LTE-M/NB-IoT modem with GPS along with 1 MB of flash and 256 KB RAM. It also includes an nRF52840 board controller with Bluetooth Low Energy connectivity. The Development Kit is fully supported by Edge Impulse. You'll be able to sample raw data, build models, and deploy trained machine learning models directly from the studio. As the nRF9160 DK does not have any built-in sensors we recommend you to pair this development board with the X-NUCLEO-IKS02A1 shield (with a MEMS accelerometer and a MEMS microphone). The nRF9160 DK is available for around 150 USD from a variety of distributors including Digikey and Mouser.

If you don't have the X-NUCLEO-IKS02A1 shield you can use the Data forwarder to capture data from any other sensor, and then follow the Running your impulse locally: On your Zephyr-based Nordic Semiconductor development board tutorial to run your impulse. Or, you can modify the example firmware (based on nRF Connect) to interact with other accelerometers or PDM microphones that are supported by Zephyr.

The Edge Impulse firmware for this development board is open source and hosted on GitHub: edgeimpulse/firmware-nrf-91.

The Edge Impulse firmware for this development board is open source and hosted on GitHub: edgeimpulse/firmware-nrf916.

Installing dependencies

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

  1. Edge Impulse CLI.
  2. 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. Plugging in the X-NUCLEO-IKS02A1 MEMS expansion shield

Remove the pin header protectors on the nRF9160 DK and plug the X-NUCLEO-IKS02A1 shield into the development board.

X-NUCLEO-IKS02A1 shield plugged in to the nRF9160 DKX-NUCLEO-IKS02A1 shield plugged in to the nRF9160 DK

X-NUCLEO-IKS02A1 shield plugged in to the nRF9160 DK

Note: Make sure that the shield does not touch any of the pins in the middle of the development board. This might cause issues when flashing the board or running applications. You can also remove the shield before flashing the board.

Make sure the shield does not touch any of the pins in the middle of the development board.Make sure the shield does not touch any of the pins in the middle of the development board.

Make sure the shield does not touch any of the pins in the middle of the development board.

2. Connect the development board to your computer

Use a micro-USB cable to connect the development board to your computer. There are two USB ports on the development board, use the one on the short side of the board. Then, set the power switch to 'on'.

Connect a micro USB cable to the short USB port on the short side of the board (red). Make sure the power switch is toggled on.Connect a micro USB cable to the short USB port on the short side of the board (red). Make sure the power switch is toggled on.

Connect a micro USB cable to the short USB port on the short side of the board (red). Make sure the power switch is toggled on.

3. Update the firmware

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

  1. The development board is mounted as a USB mass-storage device (like a USB flash drive), with the name JLINK. Make sure you can see this drive.
  2. Install the nRF Command Line Tools.
  3. Download the latest Edge Impulse firmware.
  4. Flash the board controller, you only need to do this once. Go to step 4 if you've performed this step before.
    • Ensure that the PROG/DEBUG switch is in nRF52 position.
    • Copy board-controller.bin to the JLINK mass storage device.
Ensure that the PROG/DEBUG switch is in nRF52 position to flash the board controller.Ensure that the PROG/DEBUG switch is in nRF52 position to flash the board controller.

Ensure that the PROG/DEBUG switch is in nRF52 position to flash the board controller.

  1. Flash the application:
    • Ensure that the PROG/DEBUG switch is in nRF91 postion.
    • Run the flash script for your Operating System.
  2. Wait 20 seconds and press the BOOT/RESET button.

4. Setting keys

From a command prompt or terminal, run:

edge-impulse-daemon

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

The nRF9160 DK exposes multiple UARTs. If prompted, choose the top one:

? Which device do you want to connect to? (Use arrow keys)
❯ /dev/tty.usbmodem0009601707951 (SEGGER)
   /dev/tty.usbmodem0009601707953 (SEGGER)
   /dev/tty.usbmodem0009601707955 (SEGGER)

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.

Updated 10 days ago


Nordic Semi nRF9160 DK


Suggested Edits are limited on API Reference Pages

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