On your Zephyr-based Nordic Semiconductor development board
Last updated
Last updated
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 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 or higher.
Make sure you followed the tutorial, and have a trained impulse. Also, make sure you have a working Zephyr build environment, including the following tools:
Either the which includes Zephyr and all its dependencies (v1.6.0 or higher), or a .
The .
Optional: The and . These command line tools are required if you use the to upload firmware to your target board.
We created an example repository which contains a small application that compliments the 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 or import the repository using Git:
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-sdk
model-parameters
tflite-model
Your final folder structure should look like this:
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:
And use west or your usual method to build the application:
Invalid choice: 'build'
If you try to build the application but it throws an 'invalid choice' error like:
On macOS / Linux
If 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:
otherwise 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.
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.
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:
This will show you the output of the signal processing pipeline and the results of the classification:
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!
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 tutorial, then load a testing sample, and click on a row under 'Detailed result'.
You'll need to set up your environment variables correctly (). You can do so by opening a command prompt or terminal window and running the commands below from the zephyr parent directory: On Windows
For the nRF9160DK, you also have to make sure the at least once.
Now that you have verified that the impulse works with hard-coded inputs, you should be ready to plug live sensors from your board. A demonstration on how to plug sensor values into the classifier can be found here: .
