# NCS 项目设置指南

## 快速开始

### 1. 安装 NCS

**Windows**：
```powershell
# 1. 安装 Python 3.8+ 和 Git
# 2. 安装 West
pip3 install west

# 3. 初始化 NCS（选择一个目录，例如 C:\ncs）
cd C:\
west init -m https://github.com/nrfconnect/sdk-nrf --mr main
cd nrf
west update

# 4. 设置环境变量（在 PowerShell 中）
$env:NRF_CONNECT_SDK_PATH = "C:\nrf"
$env:ZEPHYR_BASE = "C:\nrf\zephyr"
```

### 2. 安装 VSCode 扩展

1. 打开 VSCode
2. 安装 **nRF Connect Extension Pack**
3. 重启 VSCode

### 3. 配置 VSCode

1. 打开 `firmware-ncs` 目录
2. 按 `Ctrl+Shift+P`
3. 输入 "nRF Connect: Set up nRF Connect SDK"
4. 选择 NCS 路径（例如：`C:\nrf`）

### 4. 编译项目

**方法 1：使用 VSCode**
1. 按 `Ctrl+Shift+P`
2. 输入 "nRF Connect: Build"
3. 选择板子：`nrf52832dk_nrf52832`

**方法 2：使用命令行**
```bash
cd firmware-ncs
west build -b nrf52832dk_nrf52832
```

### 5. 烧录

**方法 1：使用 VSCode**
1. 按 `Ctrl+Shift+P`
2. 输入 "nRF Connect: Flash"

**方法 2：使用命令行**
```bash
west flash
```

## 环境变量设置

在 PowerShell 中设置（每次打开终端都需要）：

```powershell
$env:NRF_CONNECT_SDK_PATH = "C:\nrf"
$env:ZEPHYR_BASE = "C:\nrf\zephyr"
```

或者添加到系统环境变量（永久设置）。

## 常见问题

### Q: 编译错误 "找不到 Zephyr"
A: 确保设置了 `ZEPHYR_BASE` 环境变量

### Q: VSCode 无法识别 NCS
A: 使用 `Ctrl+Shift+P` -> "nRF Connect: Set up nRF Connect SDK" 重新配置

### Q: ANT 配置不生效
A: 检查 `prj.conf` 中的 ANT 配置，确保格式正确

## 下一步

1. ✅ 项目框架已创建
2. ⏭️ 开始迁移基础模块（config.c/h）

