# nRF Connect SDK 开发环境搭建笔记

**Repository Path**: mingkjl/ncs_setup_note

## Basic Information

- **Project Name**: nRF Connect SDK 开发环境搭建笔记
- **Description**: nRF Connect SDK 开发环境搭建笔记
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 2
- **Created**: 2023-05-02
- **Last Updated**: 2025-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# nRF Connect SDK 开发环境搭建

这里分享了nRF Connect SDK的开发环境搭建的过程，以及一些可能又得到的网站和一些个人的见解建议，希望能够帮助到大家。需要注意的是NCS更新的速度非常的快，越来越完善和越做越好，这里的教程可能会有些过时，所以这里仅给大家一个参考。

## 0 目录

- [nRF Connect SDK 开发环境搭建](#nrf-connect-sdk-开发环境搭建)
  - [0 目录](#0-目录)
  - [1 安装步骤](#1-安装步骤)
    - [1.1 安装 VSCode](#11-安装-vscode)
    - [1.2 安装 nRF Command Line Tools](#12-安装-nrf-command-line-tools)
    - [1.3 安装 nRF Connect for Desktop](#13-安装-nrf-connect-for-desktop)
    - [1.4 下载 nRF Connect SDK](#14-下载-nrf-connect-sdk)
    - [1.5 安装 nRF Connect for VS Code插件](#15-安装-nrf-connect-for-vs-code插件)
  - [2 Hello World](#2-hello-world)
  - [3 用得到的网站](#3-用得到的网站)
    - [3.1 开发资料](#31-开发资料)
    - [3.2 开发工具](#32-开发工具)

## 1 安装步骤

### 1.1 安装 VSCode

- [官方下载地址](https://code.visualstudio.com/)
- 全部默认就可以了，没什么注意事项

### 1.2 安装 nRF Command Line Tools

- [官方下载地址](https://www.nordicsemi.com/Software-and-tools/Development-Tools/nRF-Command-Line-Tools)
- 全部默认就可以了，但是需要注意，会弹出一个JLink驱动的安装界面你需要停一下
- 如果你使用的是正版的JLink或Nordic官方的开发板，那么全部默认安装就可以了
- 如果你不清楚你的JLink是否为正版，那么nRF Command Line Tools附带的这个JLink驱动版本(V7.x以上)可能会将你的JLink锁死，导致你的JLink无法使用。建议你点击取消，不要安装附带的这个JLink驱动
- 至于没有随nRF Command Line Tools更新至新版本的驱动，我了解到的是，会对nRF5340的开发造成影响，其他不知道

### 1.3 安装 nRF Connect for Desktop

- [官方下载地址](https://www.nordicsemi.com/Software-and-tools/Development-Tools/nRF-Connect-for-desktop)
- 全默认就可以了，不过它也附赠了一个JLink驱动更新包，处理同上
- 安装nRF Connect for Desktop的插件，这里我们需要安装Toolchain Manager和Programmer
- 官方推荐是使用Toolchain Manager安装SDK，Toolchain Manager是使用git来拉取SDK的，一键搞定全部依赖，不过这个过程可能会比较慢，而且因为网络问题，可能会缺文件

### 1.4 下载 nRF Connect SDK

- 官方推荐的Toolchain Manager安装SDK
- [inii的博客](https://www.cnblogs.com/iini/p/14174427.html)里面有留百度云盘的链接，可以在百度云盘上下载SDK的文件，解压到nRF Connect for Desktop的工作目录下，这里我也留一个链接，不过我不保证这个链接会一直有效，如果失效了，可以在inii的博客里面找到最新的链接。
- 将百度云盘下载的SDK覆盖到Toolchain Manager的工作路径中
- 如果没有意外的话，打开Toolchain Manager，就可以看到SDK的版本栏多了"First steps"和"Open VS Code"两个选项，说明SDK的工作路径已经设定成功了
- 这里建议点击Open VS Code旁边的下拉菜单按钮，打开bash，输入west update并运行，确保SDK的依赖文件都已经下载完毕

### 1.5 安装 nRF Connect for VS Code插件

- 点击SDK栏上的Open VS Code，Toolchain Manager会在打开VS Code之前，自动安装nRF Connect for VS Code插件
- 如果没有安装成功，可以在VS Code的插件商店里面搜索nRF Connect for VS Code，进行安装

## 2 Hello World

开发环境搭建完成了，我们来写一个Hello World程序，看看能不能编译通过

- 打开VS Code左侧栏中的nRF Connect for VS Code, "WELCOME"中的"Create a new application"
- 在"New Application"页面中选择Freestanding,
- 在"Application location"设定新工程的路径
- 在"Application template"选择"zephyr/samples/hello_world"
- 在"Application name"中输入工程名称"hello_world"
- 点击"Create Application"，就可以创建一个新的工程了
- 重新进入nRF Connect for VS Code，点击"APPLICATIONS"，就可以看到我们刚刚创建的工程了
- 点击工程下的"No build configur..."
- 在Board中选择你的开发板，我这里选择的是nRF52840dk_nrf52840
- 点击"Build Configurations",这时开始编译新的工程
- 如果编译成功，在工程文件下会生成一个build文件夹
- 也会多出一个工程文件夹的栏，里面包含了Source files/Input files/Output files三个文件夹
- 在"ACTIONS"中的"Flash",就可以将编译好的程序烧录到开发板上了
- 打开串口助手，就可以看到开发板上的Hello World了

## 3 用得到的网站

### 3.1 开发资料

- [nRF Connect SDK 开发手册](https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/nrf/introduction.html) -- 官方的开发手册，包含了所有的 API 介绍，以及各种例程
- [DevZone 论坛](https://devzone.nordicsemi.com/) -- 官方论坛，有官方的工程师回答问题，效率挺高的，就是有时差
- [Nordic Infocenter](https://infocenter.nordicsemi.com/index.jsp) -- Nordic 的硬件资料，包括芯片的 datasheet, reference manual, errata 等
- [iini 的博客](https://www.cnblogs.com/iini/p/14174427.html) -- 最详细最官方的中文介绍资料,应该是诺迪克官方的工程师写的 -- 资料会随着 nRF Connect SDK 的更新而更新  -- 强烈建议第一次接触的先看这个
- [nRF Connect SDK Github](https://github.com/nrfconnect) -- 这里可以看到最新的SDK变化
- [Nordic semi 官网](https://www.nordicsemi.com/)

### 3.2 开发工具

- [Visual Studio Code](https://code.visualstudio.com/)
- [nRF Command Line Tools](https://www.nordicsemi.com/Software-and-tools/Development-Tools/nRF-Command-Line-Tools)
- [nRF Connect for Desktop](https://www.nordicsemi.com/Software-and-tools/Development-Tools/nRF-Connect-for-desktop)
- [nRF Connect SDK 百度云盘 y8fb](https://pan.baidu.com/share/init?surl=FKTfY3Q_zBVvviO7KC7Gyg#list/path=%2Fblog)