1. 移植前的准备：了解FreeRTOS内核架构，准备MCU开发环境（以STM32为例），下载FreeRTOS源码
好，咱们正式开始。移植FreeRTOS这件事，说白了就是让一个为通用处理器写的RTOS内核，在你的具体MCU上跑起来。很多人一上来就对着代码改，结果跑飞了都不知道从哪查。我的习惯是——先搞清楚你要移植的东西长什么样，再把工具备齐。磨刀不误砍柴工嘛。
1.1 FreeRTOS内核架构速览
FreeRTOS的核心代码其实非常精简。我当年第一次打开源码包时也愣了一下——真正和硬件相关的文件就那么几个。它的架构可以分成三层：
- 应用层：你写的任务代码、队列、信号量调用。
- 内核层：任务调度、时间管理、内存管理，这部分是平台无关的C代码。
- 移植层：与MCU硬件直接打交道的部分，包括中断控制、上下文切换、系统时钟。
移植工作，99%的精力都花在移植层。内核层你基本不用动，除非你要改调度算法——但说实话，我做了这么多年，还没见过谁需要动那块的。
核心认知：移植不是重写内核，而是为内核提供一套正确的“硬件接口”。你写对了，FreeRTOS就能在你的MCU上像在官方开发板上一样稳定运行。
下面这张图可以帮你快速建立整体印象：
1.2 移植层到底要改什么？
很多新手会问：移植层就三个文件，改起来应该很快吧？嗯，理论上是的。但每个文件里藏着的细节，够你折腾好几天。我列个表，你看一眼就明白了：
| 文件 | 核心职责 | 移植时你需要做的事 |
|---|---|---|
| portmacro.h | 数据类型重定义、临界区宏、栈增长方向 | 根据MCU架构定义TickType_t、BaseType_t等类型；实现portENTER_CRITICAL/portEXIT_CRITICAL宏 |
| port.c | 系统节拍配置、中断处理、栈初始化 | 配置SysTick定时器；实现xPortSysTickHandler；实现prvTaskExitError等辅助函数 |
| portasm.s（或port.c中的汇编） | 上下文切换（PendSV处理）、启动第一个任务 | 实现vPortSVCHandler（启动任务）、xPortPendSVHandler（任务切换） |
我的经验：portmacro.h里的临界区宏最容易写错。我曾经在一个项目里把portENTER_CRITICAL写成了关总中断，结果高优先级中断丢了数据，查了整整两天。记住：临界区要支持嵌套，不能简单关中断了事。
1.3 准备MCU开发环境（以STM32为例）
环境准备这件事，我建议你一步到位。不要用Keil MDK的默认配置，也不要从网上随便找个模板。我的做法是：
- 选IDE：STM32CubeIDE（免费，官方维护，GCC编译器）或者Keil MDK（如果你公司买了License）。我个人更推荐CubeIDE，因为调试器集成得好，而且HAL库更新快。
- 装工具链：如果选CubeIDE，它自带ARM GCC。如果选Keil，记得装ARM Compiler 6（基于Clang）。
- 配调试器：ST-LINK（开发板自带）或J-Link。我习惯用J-Link，调试速度快，而且支持RTT日志输出。
- 建工程模板：用CubeMX生成一个最小工程——只配时钟（HSE + PLL到72MHz或168MHz）、SysTick、USART1（打印用）、GPIO（LED）。其他外设先别开，移植阶段越简单越好。
避坑指南：我曾经在移植时发现任务切换总是不成功，查到最后是CubeMX生成的SystemClock_Config里把SysTick的时钟源配成了HCLK/8，而FreeRTOS默认用的是HCLK。时钟不对，节拍就不对，调度全乱。所以移植前，务必确认你的SysTick时钟源和频率。
1.4 下载FreeRTOS源码
源码去哪下？官方GitHub仓库是最靠谱的。别去第三方网站下，版本可能被改过，或者少文件。我一般这样操作：
- 官方地址：
https://github.com/FreeRTOS/FreeRTOS - 版本选择：选最新的LTS版本（比如V10.4.x或V10.5.x）。不要追最新版，LTS经过充分测试，稳定。
- 下载方式：直接点“Code” -> “Download ZIP”，或者用git clone。
下载完后，你看到的目录结构大概是这样的：
FreeRTOS/
├── FreeRTOS-Plus/ # 扩展组件（TCP/IP、FAT等，移植用不到）
├── FreeRTOS/
│ ├── Demo/ # 官方示例工程（可以参考，但别直接复制）
│ ├── License/ # 许可证文件
│ ├── Source/ # 核心源码（我们要用的）
│ │ ├── include/ # 内核头文件
│ │ ├── portable/ # 移植层代码（重点！）
│ │ └── tasks.c # 任务管理
│ └── Test/ # 测试代码
└── README.md移植时，你只需要从 Source/ 目录里拿东西。具体来说：
| 你需要复制的文件 | 来源路径 | 说明 |
|---|---|---|
| tasks.c, queue.c, list.c, timers.c, event_groups.c, croutine.c | FreeRTOS/Source/ | 内核核心代码，直接复制到你的工程 |
| FreeRTOS.h, task.h, queue.h 等头文件 | FreeRTOS/Source/include/ | 所有.h文件，复制到工程include目录 |
| port.c, portmacro.h | FreeRTOS/Source/portable/GCC/ARM_CM3/ | 以STM32F1为例（Cortex-M3），选对应架构的文件夹 |
| portasm.s（或port.c中的汇编部分） | 同上目录 | 汇编文件，有些版本直接写在port.c里 |
| heap_4.c | FreeRTOS/Source/portable/MemMang/ | 内存管理方案，heap_4最常用，支持碎片合并 |
关键提醒：portable目录下有很多子文件夹，对应不同编译器（GCC/IAR/Keil）和不同MCU架构（ARM_CM3/ARM_CM4F/RX600等）。选对编译器+架构的组合，不要拿GCC的port.c放到Keil工程里，汇编语法不一样，编译直接报错。
1.5 移植前的最后检查清单
在动手改代码之前，我建议你花10分钟过一遍这个清单。我每次移植前都会走一遍，省得中途发现少了东西：
- ✅ MCU开发板能正常下载和调试（点个LED确认）
- ✅ 串口能打印信息（方便调试时输出日志）
- ✅ 时钟配置正确（特别是SysTick的时钟源和频率）
- ✅ FreeRTOS源码已下载，并确认版本
- ✅ 选对了portable目录下的编译器+架构组合
- ✅ 准备好一个空的main.c，只包含一个while(1)循环