2、开发环境搭建：交叉编译工具链安装、CMake与Ninja构建系统配置、VS Code + Cortex-Debug调试环境
好，咱们正式开始动手了。这一章我带你把开发环境搭起来。说实话，嵌入式开发最怕的就是环境配了半天，最后发现是工具链版本不对。我当年刚入行时，光装一个交叉编译器就折腾了两天，后来才发现是路径写错了……嗯，咱们今天把这些坑都填平。
2.1 交叉编译工具链安装
先说说什么是交叉编译。你想想看，你的电脑是x86架构，但蓝牙芯片是ARM Cortex-M系列。你在电脑上写的代码，得编译成ARM能跑的机器码。这就是交叉编译。
我个人习惯用 ARM GNU Toolchain，官方出品，稳定可靠。咱们以Cortex-M4为例，选 gcc-arm-none-eabi 这个包。
2.1.1 下载与安装
- 下载地址：ARM官网的「GNU Arm Embedded Toolchain」页面。选最新稳定版，别追新，我吃过亏。
- 解压：
tar -xjf gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2
sudo mv gcc-arm-none-eabi-10.3-2021.10 /opt/
- 配置环境变量：
export PATH=$PATH:/opt/gcc-arm-none-eabi-10.3-2021.10/bin
记得把这行加到 ~/.bashrc 或 ~/.zshrc 里，不然每次开终端都要重新export。
2.1.2 验证安装
arm-none-eabi-gcc --version
看到版本号输出，就说明装好了。如果提示「command not found」，别慌，检查一下路径写没写对。
which arm-none-eabi-gcc 确认一下当前用的是哪个。
2.2 CMake与Ninja构建系统配置
说实话，早期做蓝牙协议栈移植，大家都是写Makefile。但项目一复杂，Makefile就变成了天书。后来我全面转向CMake + Ninja，编译速度快，配置也清晰。
2.2.1 为什么选CMake + Ninja？
| 构建系统 | 优点 | 缺点 |
|---|---|---|
| Make | 系统自带，简单项目够用 | 跨平台差，依赖处理慢 |
| CMake + Make | 跨平台，生态好 | 编译速度一般 |
| CMake + Ninja | 编译极快，并行度好 | 需要额外安装Ninja |
我个人强烈推荐CMake + Ninja。尤其是你反复修改代码、频繁编译调试时，Ninja的增量编译速度能让你少等很多时间。
2.2.2 安装CMake
sudo apt install cmake
cmake --version
版本至少3.16以上，太老的不支持一些新特性。
2.2.3 安装Ninja
sudo apt install ninja-build
ninja --version
装完就完事了？嗯，差不多。但要注意，Ninja本身不生成构建规则，它需要CMake来生成。
2.2.4 配置交叉编译的CMake工具链文件
这是关键。你需要写一个 toolchain.cmake 文件，告诉CMake用哪个编译器。
# toolchain.cmake
set(CMAKE_SYSTEM_NAME Generic)
set(CMAKE_SYSTEM_PROCESSOR cortex-m4)
set(TOOLCHAIN_PREFIX arm-none-eabi-)
set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}gcc)
set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PREFIX}g++)
set(CMAKE_ASM_COMPILER ${TOOLCHAIN_PREFIX}gcc)
set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY)
然后在项目根目录执行：
cmake -B build -G Ninja -DCMAKE_TOOLCHAIN_FILE=toolchain.cmake
cmake --build build
toolchain.cmake 放在项目根目录的 cmake/ 文件夹下，这样多个项目可以共用。另外，记得把编译选项（如 -mcpu=cortex-m4 -mthumb）也写进去，不然默认编译出来可能跑不了。
2.3 VS Code + Cortex-Debug调试环境
调试嵌入式程序，说实话，以前全靠串口打印。后来有了J-Link和OpenOCD，配合VS Code的Cortex-Debug插件，终于可以像调试桌面程序一样打断点了。
2.3.1 安装VS Code插件
- C/C++：微软官方，提供语法高亮、智能提示
- Cortex-Debug：专门调试ARM Cortex-M芯片
- CMake Tools：方便在VS Code里直接构建
2.3.2 配置调试器
你需要一个调试器硬件，比如J-Link、ST-Link或DAP-Link。我个人偏爱J-Link，稳定，速度快。
在项目根目录创建 .vscode/launch.json：
{
"version": "0.2.0",
"configurations": [
{
"name": "Cortex Debug",
"type": "cortex-debug",
"request": "launch",
"servertype": "jlink",
"cwd": "${workspaceRoot}",
"executable": "${workspaceRoot}/build/ble_app.elf",
"device": "STM32F407VG",
"interface": "swd",
"runToMain": true
}
]
}
这里要注意几点：
executable路径要指向你编译出来的 .elf 文件device要写对，写错了连不上调试器runToMain设为 true，启动后自动停在 main 函数入口
2.3.3 开始调试
按下 F5，VS Code 会自动启动J-Link GDB Server，然后连接目标板。你会看到代码停在 main 函数第一行。这时候你可以：
- 按 F10 单步执行
- 在行号左侧点击设置断点
- 在「变量」窗口查看寄存器值
2.3.4 常见问题与避坑
- 连不上调试器：检查驱动是否安装，J-Link的USB线是否插好。我遇到过USB线质量差导致断连的情况。
- 断点不生效：确认编译时加了
-g选项，并且没有开优化（至少先用-O0）。 - 调试器报错「No source available」：说明 .elf 文件路径不对，或者源码路径变了。检查 launch.json 里的路径。
好了，环境搭完了。下一章咱们开始真正移植蓝牙协议栈。你想想看，有了这套环境，后面调试起来会顺手很多。嗯，咱们继续。