In this article:

This page covers how to install the minimum tools in order to integrate the HyperPulse library and to build the  examples. It consists basically in the nRF Util and its sdk-manager plugin, the SDK Toolchain and the SDK Source Code.

nRF Util

This is the Nordic command line tool that manages the installation of the more specific tools, software and libraries needed for the build and programming of the devices.

You can download it from here.

There is no need for installation, but you need to add the tool to the PATH in order to call it from various directories:

For Linux, create a folder ncs:

cd ~
mkdir ncs

Copy the downloaded nrfutil file inside it.

Enter in the folder and change the permission of the file to be executable:

cd ncs
chmod +x nrfutil

Now you need to add this folder to the PATH, to do this, add the following line at the end of the configuration file of the shell you are using:

export PATH="$PATH:$HOME/ncs"

Save it and reload the shell file, here the example if you are using ZSH:

source ~/.zshrc

Try to execute nrfutil --version, you should see this if it`s working:

sdk-manager plugin

The plugin can be installed by running nrfutil install sdk-manager:

nRF Connect SDK Toolchain

The version that needs to be installed for HyperPulse library is the 3.0.2, you can install it by running:

nrfutil sdk-manager toolchain install --ncs-version v3.0.2

Inside the NCS directory, a folder toolchains will be created, and inside of it, another one with the hash of the version will be created.

Go to the NCS directory, run the commands to create a folder env and create the script that sets the paths of the toolchain:

mkdir env
nrfutil sdk-manager toolchain env --ncs-version v3.0.2 --as-script sh > env/ncs_3.0.2.sh

To load the paths with the script just created, run:

source env/ncs_3.0.2.sh

To confirm, you can run echo $PATH and check if the paths of the toolchain are set.

The script sets the paths only for the current opened terminal, you need to run it every time in order to use the toolchain.

nRF Connect SDK Source Code

The same version 3.0.2 of the source code needs to be installed. To do it, first have the toolchain paths in the PATH as explained in the previous section.

If a folder .west exists under your user's directory, you can remove it to have all tools and source code concentrated in ~/ncs and in the separated SDK version folder.

To install the code for version 3.0.2, run the following commands:

west init -m https://github.com/nrfconnect/sdk-nrf --mr v3.0.2 v3.0.2
cd v3.0.2
west update

It will take a while, and at the end you should see something like:

Also run west zephyr-export, to easy the creation of Zephyr based applications: