On your Zephyr-based Nordic Semiconductor development board
Impulses can be deployed as a C++ library. This packages all your signal processing blocks, configuration and learning blocks up into a single package. You can include this package in your own application to run the impulse locally. In this tutorial you'll export an impulse, and build a Zephyr RTOS application for the nRF52840 DK / nRF5340 DK / nRF9160DK / Thingy:91 development board to classify sensor data.
A working Zephyr RTOS build environment is required
This tutorial assumes that you're already familiar with building applications for the nRF52840DK or other Zephyr RTOS supported board, and that you have your environment set up to compile applications for this platform. For this tutorial, you can use the nRF Connect SDK v1.6.0 or higher.
Prerequisites
Make sure you followed the Continuous motion recognition tutorial, and have a trained impulse. Also, make sure you have a working Zephyr build environment, including the following tools:
Either the nRF Connect SDK which includes Zephyr and all its dependencies (v1.6.0 or higher), or a manual installation of the Zephyr build environment.
Optional: The nRF comand line tools and Segger J-Link tools. These command line tools are required if you use the
westcommand line interface to upload firmware to your target board.
Cloning the base repository
We created an example repository which contains a small application that compliments the Continuous motion recognition tutorial. This application can take raw, hard-coded inputs as an argument, and print out the final classification to the serial port so it can be read from your development computer. You can either download the application or import the repository using Git:
git clone https://github.com/edgeimpulse/example-standalone-inferencing-zephyr.gitDeploying your impulse
Head over to your Edge Impulse project, and go to the Deployment page. From here you can obtain a packaged library containing the Edge Impulse C++ SDK, your impulse, and all required external dependencies. Select C++ library and click Build to create the library.
Download the .zip file and extract the contents. Now copy the following directories to the 'example-standalone-inferencing-zephyr' folder (which you downloaded above).
edge-impulse-sdkmodel-parameterstflite-model
Your final folder structure should look like this:
example-standalone-inferencing-zephyr
├── CMakeLists.txt
├── edge-impulse-sdk
├── model-parameters
├── prj.conf
├── README.md
├── sample.yaml
├── src
├── tflite-model
└── utilsRunning the impulse
With the project ready it's time to verify that the application works. Head back to the studio and click on Live classification in the project you created for the continuous motion recognition tutorial, then load a testing sample, and click on a row under 'Detailed result'.
To verify that the Zephyr application performs the same classification when running locally on your board, we need to use the same raw inputs as those provided to the Live classification for any given timestamp. To do so, click on the 'Copy to clipboard' button next to 'Raw features'. This will copy the raw values from this validation file, before any signal processing or inferencing happened.
Next, open src/main.cpp in the example directory and paste the raw features inside the static const float features[] definition. For example:
static const float features[] = {
-19.8800, -0.6900, 8.2300, -17.6600, -1.1300, 5.9700, ...
};And use west or your usual method to build the application:
# nRF52840 DK
$ west build -b nrf52840dk_nrf52840
# nRF5340 DK
$ west build -b nrf5340dk_nrf5340_cpuapp
# nRF9160DK
$ west build -b nrf9160dk_nrf9160ns
# Thingy:91
$ west build -b thingy91_nrf9160Invalid choice: 'build'
If you try to build the application but it throws an 'invalid choice' error like:
$ west build -b nrf52840dk_nrf52840
usage: west [-h] [-z ZEPHYR_BASE] [-v] [-V] <command> ...
west: error: argument <command>: invalid choice: 'build' (choose from 'init', 'update', 'list', 'manifest', 'diff', 'status', 'forall', 'help', 'config', 'topdir', 'selfupdate')You'll need to set up your environment variables correctly (more info). You can do so by opening a command prompt or terminal window and running the commands below from the zephyr parent directory: On Windows
$ zephyr\zephyr-env.cmdOn macOS / Linux
$ source zephyr/zephyr-env.shIf you have set up the Segger J-LINK tools and the board that comes with J-LINK debug probe, you can also flash this application with:
$ west flashotherwise if your board shows up as a mass storage device, you can find the build/zephyr/zephyr.bin file and drag it to the JLINK USB mass-storage device in the same way you do with a USB flash drive.
For the nRF9160DK, you also have to make sure the board controller has been flashed at least once.
Boards such as Thingy:91 and Thingy:53 do not come with in built J-LINK debug probe, and cannot be used with west flash directly. They do include connector that enable users to connect with external J-LINK debug probe and take advantage of west flash command.
Seeing the output
To see the output of the impulse, connect to the development board over a serial port on baud rate 115,200 and reset the board. You can do this with your favourite serial monitor or with the Edge Impulse CLI:
$ edge-impulse-run-impulse --rawThis will show you the output of the signal processing pipeline and the results of the classification:
Edge Impulse standalone inferencing (Zephyr)
Running neural network...
Predictions (time: 1 ms.):
idle: 0.015319
snake: 0.000444
updown: 0.006182
wave: 0.978056
Anomaly score (time: 0 ms.): 0.133557
Predictions (DSP: 18 ms., Classification: 1 ms., Anomaly: 0 ms.):
[0.01532, 0.00044, 0.00618, 0.97806, 0.134]The output should match the values you just saw in the studio. If it does, you now have your impulse running on your Zephyr development board!
Last updated
Was this helpful?