3、移植环境搭建：开发工具链安装、调试器配置、工程模板创建

好，咱们进入第三章。环境搭建这事儿，说简单也简单，说复杂也复杂。我见过不少新手，上来就急着写代码，结果卡在编译报错上半天，最后发现是工具链没装对。嗯，咱们一步步来，把地基打牢。

3.1 开发工具链的选择与安装

嵌入式开发，说白了就是三大家：GCC、Keil、IAR。我个人习惯是，项目初期用GCC做快速验证，后期稳定了再用Keil或IAR做精细化调试。为什么？因为GCC免费、灵活，但调试体验差点；Keil和IAR收费，但人家IDE集成得好，调试器一插就能跑。

3.1.1 GCC工具链

GCC适合ARM Cortex-M系列，比如STM32、GD32这些。安装其实不复杂：

• Windows用户：下载ARM GCC工具链，解压到无中文路径的目录。我建议用arm-none-eabi-gcc这个版本，稳定。
• Linux用户：直接sudo apt-get install gcc-arm-none-eabi，省事。
• macOS用户：用Homebrew，brew install arm-none-eabi-gcc。

装完后，打开终端敲一句：

arm-none-eabi-gcc --version

能看到版本号，说明成了。我在项目中遇到过一个问题：有同事把工具链装到了带空格的路径下，结果makefile死活找不到编译器。嗯，路径里别带空格，这是血的教训。

3.1.2 Keil MDK

Keil在工业界用得很多，尤其是老工程师。安装时注意几点：

• 去官网下载MDK-ARM，版本建议5.38以上，对Cortex-M33支持更好。
• 安装时选好器件包（Device Family Pack），比如STM32F4系列的就勾上。
• 破解？嗯，我不多说，但建议买正版，公司项目别惹麻烦。

装完后，打开Keil，点Project -> Manage -> Pack Installer，把需要的芯片包更新一下。我曾经因为没更新包，编译时报了一堆未定义错误，折腾了两小时才发现是版本太旧。

3.1.3 IAR Embedded Workbench

IAR的编译器优化做得最好，代码密度小。但它的许可证管理比较烦人。安装步骤：

• 下载IAR for ARM，版本8.50以上。
• 安装时选择“License Server”或“Local License”，看公司情况。
• 记得勾选“Add IAR to PATH”，不然命令行用不了。

我个人觉得，IAR的调试器配置比Keil直观，但它的工程文件是.ewp格式，跟其他IDE不通用。如果你团队里有人用Keil有人用IAR，那最好统一用GCC + CMake，省得吵架。

3.2 调试器配置

调试器是嵌入式开发的“眼睛”。没有它，你只能靠printf猜问题。我常用的两种：J-Link和ST-Link。

3.2.1 J-Link配置

J-Link是SEGGER家的，速度快，支持芯片多。配置步骤：

1. 安装J-Link驱动，去官网下载J-Link Software and Documentation Pack。
2. 连接硬件：SWD接口只用4根线——SWDIO、SWCLK、GND、VCC（3.3V）。
3. 打开J-Link Commander，输入connect，选择芯片型号。

如果能识别到芯片ID，说明连接成功。我记得有一次，怎么连都连不上，最后发现是SWDIO和SWCLK接反了。嗯，这种低级错误，犯过一次就记住了。

3.2.2 ST-Link配置

ST-Link是ST官方调试器，便宜，但速度慢一点。配置方法：

• 安装STM32CubeProgrammer或ST-Link Utility。
• 连接方式跟J-Link一样，SWD四线。
• 在Keil里选Debug -> Settings -> ST-Link Debugger，速度选4MHz，别选太高，容易不稳定。

用ST-Link时，我建议把Reset and Run选项勾上。不然每次下载完程序，还得手动按复位键，烦不烦？

3.3 工程模板创建

环境搭好了，调试器也连上了，接下来就是建工程模板。一个好的模板，能让你后续移植省一半时间。

3.3.1 目录结构设计

我个人习惯的目录结构是这样的：

project/
├── app/          # 应用层代码
├── bsp/          # 板级支持包
├── kernel/       # RTOS内核源码
├── lib/          # 第三方库
├── startup/      # 启动文件、链接脚本
├── out/          # 编译输出
└── Makefile      # 或 .uvprojx / .ewp

为什么要这么分？你想想看，如果所有文件都堆在根目录，找起来多痛苦。尤其是RTOS移植，内核源码和BSP代码经常要改，分开管理清晰得多。

3.3.2 启动文件与链接脚本

启动文件是芯片上电后第一个执行的代码。对于ARM Cortex-M，一般用startup_stm32f4xx.s这种文件。链接脚本（.ld文件）定义了内存布局。

我建议直接从芯片厂商的SDK里复制启动文件和链接脚本，别自己写。为什么？因为中断向量表、堆栈初始化这些细节，自己写容易漏。我曾经手写过一次，结果中断进不去，查了两天才发现是向量表对齐问题。

3.3.3 创建第一个RTOS工程

以FreeRTOS为例，在Keil里创建模板：

1. 新建工程，选择芯片型号。
2. 添加FreeRTOS源码：tasks.c、queue.c、list.c等。
3. 添加移植层文件：port.c、portmacro.h。
4. 配置系统时钟，一般用HAL_Init()或直接操作寄存器。
5. 写一个简单的任务：

void vTask1(void *pvParameters)
{
    while(1)
    {
        // 任务代码
        HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}

编译通过后，下载到板子，如果LED开始闪烁，恭喜你，移植环境搭建成功了。

3.4 避坑指南

最后，分享几个我踩过的坑：

• 工具链版本不匹配：GCC 10.x编译的代码，用GCC 9.x的库链接，会报undefined reference。解决办法：统一版本。
• 调试器固件太旧：J-Link V9的旧固件不支持Cortex-M33。我曾经折腾了一下午，最后更新固件就好了。
• 工程模板里忘了加FreeRTOSConfig.h：这个文件定义了堆大小、任务优先级等。不加的话，编译能过，但运行会死机。

嗯，环境搭建这部分就到这里。下一章咱们开始真正移植RTOS内核，那才是重头戏。