3. 固件开发环境搭建：SDK获取、IDE安装与编译链配置

做蓝牙网关开发，第一步就是把吃饭的家伙备齐。我见过不少新手，上来就写代码，结果编译报错半天找不到原因——最后发现是SDK版本和编译器不匹配。这种坑，踩一次就够了。

这一章，咱们把环境搭得明明白白。主要讲两套方案：nRF5 SDK + Keil 和 ESP-IDF + VS Code。前者是Nordic的老牌组合，适合做低功耗蓝牙网关；后者是乐鑫的生态，适合做Wi-Fi+蓝牙双模网关。你根据项目选就行。

核心原则：SDK、IDE、编译链，三者版本必须对齐。别图新，也别守旧，选官方长期支持的版本。

固件开发环境搭建总览 方案一：nRF5 + Keil SDK：nRF5 SDK 17.1.0 IDE：Keil MDK v5.38 编译链：ARMCC v6.18 适用：低功耗蓝牙网关、信标、传感器节点 方案二：ESP-IDF + VS Code SDK：ESP-IDF v5.1.x IDE：VS Code + 插件 编译链：GCC + CMake + Ninja 适用：Wi-Fi+蓝牙双模网关、边缘计算节点

3.1 SDK获取：nRF5 SDK

Nordic的nRF5 SDK，是蓝牙开发的老牌劲旅。我个人习惯用17.1.0版本，这个版本对nRF52832和nRF52840支持最稳。你问为什么不用最新的？我在项目里试过18.0，结果一些老外设驱动不兼容，回退到17.1才解决问题。

获取方式很简单：

  1. 去Nordic官网注册账号（免费）
  2. 进入"Downloads"页面，找到nRF5 SDK
  3. 选择版本17.1.0，下载ZIP压缩包
  4. 解压到无中文路径，比如 C:\nRF5_SDK_17.1.0

我的习惯：解压后别急着用。先打开 examples\ble_peripheral 目录，看看有没有你芯片的例程。比如做网关，重点关注 ble_app_uart 和 ble_app_multilink 这两个。

SDK目录结构你得熟悉一下：

目录 作用
components 核心组件：协议栈、驱动、库文件
examples 官方例程，开发起点
external 第三方库，比如FreeRTOS、FatFS
integration IDE和编译链的配置文件

3.2 SDK获取：ESP-IDF

乐鑫的ESP-IDF，这几年发展很快。如果你做的是Wi-Fi+蓝牙双模网关，那它比nRF5更合适。我建议用v5.1.x系列，这个分支对ESP32-S3和ESP32-C3支持最好。

获取方式有两种：

  • 在线安装（推荐）：用乐鑫的 ESP-IDF Tools Installer，一键装完SDK、编译链和依赖。
  • 手动克隆：用Git拉取，适合有代理或需要定制版本的情况。
# 手动克隆示例（Linux/Mac）
git clone -b v5.1.2 --recursive https://github.com/espressif/esp-idf.git
cd esp-idf
./install.sh esp32s3

注意：ESP-IDF的 install.sh 会下载大量工具链和Python包。我曾经在公司网络下卡了半小时，后来发现是代理没配好。建议先配好Git代理，或者用离线安装包。

装完后，运行 export.sh 设置环境变量。这一步很多人忘，结果编译时找不到命令。

# 设置环境变量（每次新终端都要执行）
source ~/esp/esp-idf/export.sh

3.3 IDE安装：Keil MDK

Keil MDK是nRF5开发的老搭档。说实话，它的界面有点复古，但调试功能确实扎实。我建议用v5.38版本，太新的版本对旧SDK支持不好。

安装步骤：

  1. 从ARM官网下载Keil MDK安装包
  2. 安装时勾选"ARM Compiler"和"Device Support"
  3. 安装Nordic设备包：在Pack Installer里搜索"nRF"并安装
  4. 破解或申请评估版License（评估版有32KB代码限制）

避坑：Keil的工程文件默认用 .uvprojx 格式。如果你从旧项目迁移，可能会遇到 .uvproj 格式，记得用Keil的"Project - Migrate"功能转换一下。

Keil里配置nRF5 SDK工程时，要注意几个关键路径：

配置项 路径示例
SDK根目录 C:\nRF5_SDK_17.1.0
SoftDevice路径 ...\components\softdevice\s140\hex
链接脚本 ...\examples\ble_peripheral\ble_app_uart\pca10056\s140\armgcc

3.4 IDE安装：VS Code

VS Code是ESP-IDF的官方推荐IDE。轻量、免费、插件生态好。我个人觉得，用VS Code写代码比Keil舒服多了，尤其是代码补全和Git集成。

安装步骤：

  1. 下载VS Code并安装
  2. 安装 C/C++ 扩展（微软官方）
  3. 安装 ESP-IDF Extension（乐鑫官方）
  4. 在扩展里配置ESP-IDF路径和工具链

配置完成后，按 F1 输入 ESP-IDF: Show Examples，就能看到官方例程列表。选一个创建工程，VS Code会自动生成 CMakeLists.txt 和 sdkconfig。

我的经验：VS Code的ESP-IDF扩展有个"一键烧录"功能，点一下就能编译、烧录、打开串口监视器。调试时特别方便，不用来回切窗口。

3.5 编译链配置

编译链是环境搭建里最容易出问题的一环。说白了，它就是一套把C代码变成机器码的工具。不同SDK用的编译链不一样。

nRF5 + Keil：ARMCC

Keil自带ARMCC编译器，版本v6.18左右。你不需要单独安装，但要在工程设置里选对版本。

  • 打开工程选项 Project - Options for Target
  • 在 Target 标签页，选择 ARM Compiler: V6.18
  • 在 C/C++ 标签页，添加预定义宏：NRF52840_XXAA、SOFTDEVICE_PRESENT

我曾经踩过的坑：ARMCC v6对C99标准支持不太好。如果你用了一些C11的语法（比如匿名结构体），编译会报错。解决办法是加编译选项 --c99，或者在代码里避免用新特性。

ESP-IDF + VS Code：GCC + CMake + Ninja

ESP-IDF的编译链是GCC交叉编译器，配合CMake和Ninja做构建管理。安装ESP-IDF时，这些工具会自动装好。

验证编译链是否正常：

# 查看GCC版本
xtensa-esp32s3-elf-gcc --version

# 查看CMake版本
cmake --version

# 查看Ninja版本
ninja --version

如果命令找不到，说明环境变量没设置。重新执行 export.sh 就行。

编译一个例程试试：

cd ~/esp/hello_world
idf.py set-target esp32s3
idf.py menuconfig   # 配置项目参数
idf.py build        # 编译
idf.py -p /dev/ttyUSB0 flash   # 烧录

小技巧：第一次编译会很慢，因为要编译SDK库。之后改代码只编译增量部分，速度就快了。我一般用 idf.py build -j4 开启4线程编译，能快不少。

3.6 环境验证清单

环境搭完，别急着写代码。先跑一个官方例程，验证整个链路通不通。我列个清单，你照着检查：

检查项 nRF5 + Keil ESP-IDF + VS Code
SDK路径 无中文、无空格 Git子模块完整
IDE配置 设备包已安装 ESP-IDF扩展已配置
编译链 ARMCC版本正确 GCC、CMake、Ninja可用
例程编译 0错误0警告 build成功
烧录测试 LED闪烁或串口输出 Hello World打印

嗯，到这步，你的开发环境就算搭好了。后面写代码、调协议栈，都不会被环境问题卡住。记住，环境搭建花的时间，后面都会省回来。

← 上一章 📖 返回目录 下一章 →