SDK Setup (Linux - Ubuntu)

This page is all about getting your Linux machine compiling code for the nRF9160 Feather. Run into trouble during the process? Post your questions on the community forum.

Installing Extension

If you didn't already, install Visual Studio code. You can download directly from the Ubuntu Software Install utility. (or similar)

Ubuntu software install

Then we can continue installing the extension!

Marketplace

Fortunately, it's a bit easier to get started with the VSCode extension. The VSCode is required along with a Python 3 and Git on your system before continuing.

Once Visual Studio code is installed, download the extension here. 👈

Once loaded it will also install all necessary VSCode dependencies.

Then, install Git, Python, and Pip.

For example on Ubuntu:

sudo apt install git python3 python3-pip

Run Setup

Then open the command window (COMMAND+SHIFT+P on Mac or CTRL+SHIFT+P on other systems) and type Zephyr Tools: Setup

Setup

Init the repo

Then initialize this repo using the Zephyr Tools: Init Repo command:

Init repo

Make sure you use https://github.com/circuitdojo/nrf9160-feather-examples-and-drivers.git as the URL. It's best to select an empty folder to initialize the project to.

Then build the sample!

Build

You'll be prompted for a project and board. Make sure the board matches the supported boards. Current supported board targets include:

Here's what it will look like:

Choosing board Choosing app

Once the build completes you should get a Build complete! popup along with some success messages in the the terminal.

newtmgr (Used to load your application via USB serial bootloader)

newtmgr is the command line utility for loading code to your device. It is automatically installed with the VSCode extension. Lets configure it the rest of the way.

Configuring is simple as running the Zephyr Tools: Setup Newtmgr command

Setup newtmgr

Select your serial port:

Select serial port

Then select the BAUD. (Use the default of 1000000) Once complete you're ready to run the Zephyr Tools: Load via Bootloader command.

Select baud

Fixing serial port errors

Note if you get a Error: open /dev/ttyUSB0: permission denied error. You may need to add your user to the dialout group:

sudo usermod -a -G dialout <username>

This allows you to open a serial port without having to use sudo.

For more info in using newtmgr checkout the programming section of this documentation.

Testing it

You can quickly test if your SDK is set up correctly by checking out the samples.