> For the complete documentation index, see [llms.txt](https://cocolinx.gitbook.io/cocolinx-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cocolinx.gitbook.io/cocolinx-docs/development/nrf9151-or-getting-started.md).

# nRF9151 | Getting Started

한글버전: <https://blog.naver.com/cocolinx/224066989089>

## 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

1. Insert the nano-SIM card into the nano-SIM card slot.
2. Attach the included U.FL cabled LTE-M Antenna.
3. Attach the included U.FL cabled GNSS Antenna.
4. Plug the SOM to SOM carrier board. (If you are using Proto you can just connect to the computer.)
5. 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.

{% embed url="<https://www.nordicsemi.com/Products/Development-tools/nRF-Connect-for-Desktop/Download>" %}
nRF Connect for Desktop Download Link
{% endembed %}

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

{% embed url="<https://www.segger.com/downloads/jlink/>" %}
J-Link/J-Trace Download link
{% endembed %}

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FfGBPz8jFRkCjyNT1d33W%2F%EC%8A%A4%ED%81%AC%EB%A6%B0%EC%83%B7%202025-09-16%20165139.png?alt=media&amp;token=0f4ef544-a9bf-4551-a311-7fac048cd609" alt=""><figcaption><p>Installing J-link SEGGER</p></figcaption></figure>

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2Fe9VM8M5O0bMd2n94wS7B%2Fimage.png?alt=media&amp;token=bab2d370-35c8-4e42-8b64-ef5ce2b63031" alt=""><figcaption><p>Installing J-link SEGGER</p></figcaption></figure>

## 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.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FMavTob48YIEbpnYJe7mT%2Fimage.png?alt=media&amp;token=952bbba9-356d-495e-a9e7-aca20f342380" alt=""><figcaption><p>Device Controller</p></figcaption></figure>

{% embed url="<https://www.silabs.com/software-and-tools/usb-to-uart-bridge-vcp-drivers?tab=downloads>" %}
CP2012N USB to UART Bridge Controller Download Link
{% endembed %}

Download and Install CP201x VCP Windows from Silicon Labs Website.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FlMaHuvb7fGE9MrLNTRQs%2Fimage.png?alt=media&amp;token=28c40686-b863-485b-a568-6e18b6d1bd74" alt=""><figcaption><p>Installing CP2102N USB to UART Driver</p></figcaption></figure>

Unzip the downloaded file and run the 'CP201xVCPInstaller\_x64'.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FCkZpFZifzQXlFyMSlGLi%2Fimage.png?alt=media&amp;token=63d63ce4-8199-4fe3-a53e-fa274508a314" alt=""><figcaption><p>Installing CP2102N USB to UART Driver</p></figcaption></figure>

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

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FgQkUTY56oquVhWcyY9BD%2Fimage.png?alt=media&amp;token=c61e4481-e62b-4129-8c69-d01d9be07e4a" alt=""><figcaption><p>Installing CP2102N USB to UART Driver</p></figcaption></figure>

## 4. SetUp - nRF Connect for VS Code

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

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FnArvai7nJ5evoAeLIBWy%2Fimage.png?alt=media&amp;token=f8c4bdcb-0c4f-4263-a294-cd5e4b0646bd" alt=""><figcaption><p>Setup nRF Connect for VS Code</p></figcaption></figure>

#### (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.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FEOyRW5h3T96Cx6xd5uaH%2Fimage.png?alt=media&amp;token=cd95a88b-e8df-462d-810e-1c628c475bd2" alt=""><figcaption><p>Setup nRF Connect for VS Code</p></figcaption></figure>

Select Install SDK and nRF Connect SDK.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FIB9vefhzzG3au9MT0QYg%2Fimage.png?alt=media&amp;token=88811cf9-7ac4-4a6d-bb50-c5e0b2b4a38a" alt=""><figcaption><p>Setup nRF Connect for VS Code</p></figcaption></figure>

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FvPuEAjdqjIPxiUInekSr%2Fimage.png?alt=media&amp;token=24552db3-d9ce-451a-bc21-1f912b96f31b" alt=""><figcaption><p>Setup nRF Connect for VS Code</p></figcaption></figure>

You can choose and install your preferred SDK version.

I'm currently using v3.1.1.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FdHWzVvPW97hi5p2A9rsz%2Fimage.png?alt=media&amp;token=80551a49-88dc-4eb7-91da-39793dee059b" alt=""><figcaption><p>Setup nRF Connect for VS Code</p></figcaption></figure>

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:

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FW9HU7WIFQhhUZU3S7TE9%2Fimage.png?alt=media&amp;token=33d10ea2-5f29-4890-92d7-df22a03418b1" alt=""><figcaption></figcaption></figure>

You can choose and install your preferred Toolchain version.

I'm currently using v3.1.1.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FbZOltdqadlrzjfMHNTMI%2Fimage.png?alt=media&amp;token=c0cd82eb-1a75-4338-9335-83fa86d6816a" alt=""><figcaption></figcaption></figure>

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.

{% embed url="<https://www.nordicsemi.com/Products/Development-tools/nRF-Util>" %}
nRF Util Download Link
{% endembed %}

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FtspktRSJBjd2uZs7NT2J%2Fimage.png?alt=media&amp;token=59c26eee-6753-45cf-8f43-69ff8f94fa14" alt=""><figcaption></figcaption></figure>

Add the `C:\ncs` path to the PATH environment variable.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FwnwPeNVpKxhQr8TOyZft%2Fimage.png?alt=media&amp;token=62665e46-1768-4133-ad80-14794f2df532" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FDrZZ9b2CGpbR8EoXjUvj%2Fimage.png?alt=media&amp;token=2d200132-bc3b-4510-8815-490adee9cf75" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2Fr6Rxn1KmADcQzFN71DoE%2Fimage.png?alt=media&amp;token=016af1fc-c98a-4408-9057-78e7963b8bbd" alt=""><figcaption></figcaption></figure>

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'.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FX43OWdzBWJll5FUt5xQK%2Fimage.png?alt=media&amp;token=0062cb42-6b73-4484-adf0-e847a8a42ce1" alt=""><figcaption><p>Example - Hello World</p></figcaption></figure>

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FuTZIVR03fy7Df9A6JSFZ%2Fimage.png?alt=media&amp;token=7eb85b42-fea6-4b5e-b547-28b94719e21c" alt=""><figcaption><p>Example - Hello World</p></figcaption></figure>

Then you can see this window.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2Fo0asDAmfB2h6Gh0Ts8Jj%2Fimage.png?alt=media&amp;token=25bdb6d6-f41e-435d-978d-d7417727d664" alt=""><figcaption><p>Example - Hello World</p></figcaption></figure>

Copy the board file to your project folder.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FBAgHhhXxamj9IPsiHlfE%2Fimage.png?alt=media&amp;token=51d3c124-8432-4876-b3ad-8a01999cbb4a" alt=""><figcaption><p>Example - Hello World</p></figcaption></figure>

Add build configuration to make a build file.

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2FKqd0YN7381KCuWClRG9A%2Fimage.png?alt=media&amp;token=77f97e3f-e33f-401c-9402-048c99c1e5ef" alt=""><figcaption><p>Example - Hello World</p></figcaption></figure>

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

<figure><img src="https://4012614526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuolW15Ii136DOeL4XvSy%2Fuploads%2F7Wziptg3hIJ1YYFtEadd%2Fimage.png?alt=media&amp;token=9e701a33-7bc1-4cd5-a191-0bef38117605" alt=""><figcaption><p>Example - Hello World</p></figcaption></figure>

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. 
```