# NCS 安装指南（Windows）

## 前置要求

### 1. 安装 Python 3.8+

**下载地址**：https://www.python.org/downloads/

**安装时注意事项**：
- ✅ 勾选 "Add Python to PATH"
- ✅ 选择 "Install for all users"（可选）

**验证安装**：
```powershell
python --version
# 应该显示：Python 3.x.x
```

### 2. 安装 Git

**下载地址**：https://git-scm.com/download/win

**验证安装**：
```powershell
git --version
# 应该显示：git version x.x.x
```

## 安装 West

### 方法 1：使用 pip（推荐）

```powershell
# 安装 West
python -m pip install west

# 验证安装
west --version
# 应该显示：west x.x.x
```

### 方法 2：如果 pip 不在 PATH 中

```powershell
# 使用完整路径
python -m pip install --user west

# 然后需要将 Python Scripts 目录添加到 PATH
# 通常是：C:\Users\您的用户名\AppData\Local\Programs\Python\Python3x\Scripts
```

**添加到 PATH**：
1. 按 `Win + R`，输入 `sysdm.cpl`
2. 点击"高级" -> "环境变量"
3. 在"用户变量"中找到 `Path`，点击"编辑"
4. 添加 Python Scripts 目录（例如：`C:\Users\TH\AppData\Local\Programs\Python\Python39\Scripts`）
5. 重启 PowerShell

## 初始化 NCS

### 步骤 1：选择安装目录

选择一个目录来安装 NCS，例如：
- `C:\ncs`
- `D:\ncs`
- `C:\nrf-connect-sdk`

### 步骤 2：初始化 NCS

```powershell
# 进入选择的目录
cd C:\

# 初始化 NCS
west init -m https://github.com/nrfconnect/sdk-nrf --mr main

# 进入 nrf 目录
cd nrf

# 更新所有模块
west update
```

**注意**：`west update` 可能需要较长时间（10-30 分钟），因为需要下载大量文件。

### 步骤 3：设置环境变量

**临时设置（当前 PowerShell 会话）**：
```powershell
$env:NRF_CONNECT_SDK_PATH = "C:\nrf"
$env:ZEPHYR_BASE = "C:\nrf\zephyr"
```

**永久设置（推荐）**：
1. 按 `Win + R`，输入 `sysdm.cpl`
2. 点击"高级" -> "环境变量"
3. 在"用户变量"中点击"新建"：
   - 变量名：`NRF_CONNECT_SDK_PATH`
   - 变量值：`C:\nrf`（您的 NCS 路径）
4. 再新建一个：
   - 变量名：`ZEPHYR_BASE`
   - 变量值：`C:\nrf\zephyr`（您的 Zephyr 路径）
5. 重启 PowerShell

## 验证安装

```powershell
# 检查 West
west --version

# 检查环境变量
echo $env:NRF_CONNECT_SDK_PATH
echo $env:ZEPHYR_BASE

# 检查 NCS 目录
ls C:\nrf
# 应该看到：nrf, zephyr, bootloader, modules 等目录
```

## 常见问题

### Q: `west: 無法辨識 'west' 詞彙`
**A**: West 未安装或不在 PATH 中
- 检查 Python 是否安装
- 运行 `python -m pip install west`
- 确保 Python Scripts 目录在 PATH 中

### Q: `python: 無法辨識 'python' 詞彙`
**A**: Python 未安装或不在 PATH 中
- 下载并安装 Python 3.8+
- 安装时勾选 "Add Python to PATH"
- 或手动添加 Python 到 PATH

### Q: `west update` 很慢或失败
**A**: 网络问题
- 使用 VPN 或代理
- 或使用国内镜像（如果有）

### Q: 环境变量设置后仍然无效
**A**: 需要重启 PowerShell
- 关闭所有 PowerShell 窗口
- 重新打开 PowerShell
- 或重启计算机

## 下一步

安装完成后，继续：
1. 安装 VSCode 扩展：nRF Connect Extension Pack
2. 在 VSCode 中打开 `firmware-ncs` 目录
3. 配置 NCS 路径
4. 编译项目

