Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

Getting Started with Nordic nRF5 SDK

Jump To:

Installation on Windows

Installation on Linux & OS X

Installation on Windows

This guide covers installation on Windows.

Get MinGW

  • Download MinGW for windows for linux command line utilities.

  • Run mingw-get-setup.exe

  • Install at default location: C:\MinGW

  • Select following packages under Basic Setup:

  • Select: Installation > Apply Changes > Apply

  • Add: C:\MinGW\bin and C:\MinGW\msys\1.0\bin path to environment variable separated by a semi-colon(;).

Get nRF SDK12.2

Get nRFGo Studio

  • Download nRFGo Studio.

  • Go to: Downloads and select nRFgo-Studio-Winxx as per your installed Windows OS.

  • Run: nrfgostudio_win-64-xxx_installer

  • Install the software with "typical" configurations.

  • Post installation, Install: nRF5x-Command-Line-Tools


  • Download GNU-ARM-GCC (version 6-2016-q4) compiler.

  • Run: gcc-arm-none-eabi.exe

  • Check "Add path to environment variable" and click on "Finish"

Get Eclipse Mars 2

Set up the environment to compile code

  • Using Windows Explorer, open arm-gcc install directory. In my system, it is installed in C:\Program Files (x86)\GNU Tools ARM Embedded.

GNU Tools ARM Embedded includes installed ARM-GCC compilers. In this case, 6.2 2016q4. This folder tells you the compiler version.

For exact version of currently installed ARM-GCC compiler, run: arm-none-eabi-gcc --version

  • Go to: nRF5_SDK_12.2.0_f012efa\components\toolchain\gcc

  • Open Makefile.Windows in a text editor.

  • Update:

GNU_INSTALL_ROOT := C:/Program Files (x86)/GNU Tools ARM Embedded/6.2 2016q4


GNU_VERSION := 6.2.1

  • Go to: <nRF5_Install_Directory>\examples\ble_peripheral\ble_app_hrs\pca10040\s132\armgcc

  • Issue make command to compile the project.

  • Add SHELL=C:/Windows/System32/cmd.exe in Makefile.Windows if following error occurs.

Installation on Linux & OS X

Linux and OS X already come with tooks luke make. You just need to install ARM GCC, Nordic nRF5 SDK, and some Nordic utilities like nrfutil. This is all covered in the Nordic tutorial - Development with GCC and Eclipse.