Getting Started

1. Preperations

Requirements

SOM Development Kit or Proto
J-Link EDU Mini - Segger
Visual Studio Code
Windows Desktop with internet access

Set up your board

Insert the nano-SIM card into the nano-SIM card slot.
Attach the included U.FL cabled LTE-M Antenna.
Attach the included U.FL cabled GNSS Antenna.
Plug the SOM to SOM carrier board. (If you are using Proto you can just connect to the computer.)
Connect the SOM carrier board(or Proto) to the computer with a USB-C cable and J-Link EDU MINI.

2. Install - nRF Connect and J-Link

Download and Install 'nRF Connect for Desktop' from Nordic Website.

Download and Install 'J-Link Software' from SEGGER Website.

3. Install - CP2102n USB to UART Driver

When you connect the device to your computer via USB, you need to install the driver for CP2120N USB to UART Bridge Controller.

Download and Install CP201x VCP Windows from Silicon Labs Website.

Unzip the downloaded file and run the 'CP201xVCPInstaller_x64'.

If it appears under the Ports (COM & LPT), the driver has installed correctly.

4. SetUp - nRF Connect for VS Code

(1) Download and Install 'nRF Conenct For VS Code Extension Pack'

(2) Download and Install Toolchain and SDK

After installing the 'nRF Connect for VS Code Extension Pack', you can see the nRF Connect icon from the left side bar, click the nRF Connect icon, then select Manage SDKs.

Select Install SDK and nRF Connect SDK.

You can choose and install your preferred SDK version.

I'm currently using v3.1.1.

It takes about 10 minutes to install SDK. After installing SDK you need to install toolchain. Usually, installing the SDK also installs the toolchain. But, if it isn't installed, you can install it as follows:

You can choose and install your preferred Toolchain version.

I'm currently using v3.1.1.

After installing SDK and Toolchain you can see the ncs folder at C:\ncs.

Add the NCS folder path to your environment variables.

Then download and install 'nRF Util' from Nordic Website. And place the nRF Util file in the ncs folder.

Type nrfutil install device and nrfutil install completion in the Command Prompt.

If you see this log after running nrfutil list, the installation has completed successfully.

Command     Version  Description
completion  1.5.0
device      2.13.2   Device discovery, programming, and operations such as erase, reset, and recovery.

Found 2 installed command(s)

Now you are ready to create a new application!

5. Example - Hello World

Choose 'Create a new application' at nRF Connect Extension in VS Code and 'Create a black application'.

Then you can see this window.

Copy the board file to your project folder.

Add build configuration to make a build file.

You need to select SDK, Toolchain, Board target and Base configuration files.

After build the project you can flash the project to device.

If you see log like this, the flash has completed successfully.

-- west flash: using runner nrfutil
-- runners.nrfutil: reset after flashing requested
-- runners.nrfutil: Flashing file: D:\CocoLinx\Projects\Csom\csom_v1_examples\helloworld\build\merged.hex
-- runners.nrfutil: Erasing address ranges touched by firmware
-- runners.nrfutil: Programming image
-- runners.nrfutil: Verifying image
-- runners.nrfutil: Reset
-- runners.nrfutil: Board(s) with serial number(s) 801032619 flashed successfully.
 *  Terminal will be reused by tasks, press any key to close it.