3、FreeRTOS内核移植：源码目录结构、port层配置、启动文件修改
好，咱们进入正题。这一章讲的是FreeRTOS移植最核心的三个动作：看懂源码怎么摆的、改好port层、调通启动文件。说白了，就是把一个跑在PC上的系统，硬塞进你的飞控MCU里。
我刚开始做移植那会儿，也踩过不少坑。有一次在STM32F4上折腾了三天，结果发现是port层一个宏定义没开。嗯，咱们今天就把这些坑提前填上。
3.1 源码目录结构：别被文件夹吓到
你下载FreeRTOS源码后，第一眼看到那一堆文件夹，可能会有点懵。其实核心就三个部分：
- Source：内核本体，所有任务调度、队列、信号量都在这里
- Portable：移植层，针对不同MCU的适配代码
- Demo：示例工程，参考用的
我个人习惯，真正干活时只关心前两个。Demo里的东西，说白了就是给你抄作业的。
关键目录速查表
| 目录 | 内容 | 移植时是否修改 |
|---|---|---|
| Source/include | FreeRTOS.h、task.h等头文件 | 不改 |
| Source/tasks.c | 任务调度核心 | 不改 |
| Source/portable/MemMang | heap_1.c ~ heap_5.c | 选一个用 |
| Source/portable/[编译器]/[MCU] | port.c、portmacro.h | 重点修改 |
你想想看，整个FreeRTOS内核其实就几个.c文件。真正跟硬件绑死的，全在portable目录里。所以移植的核心，就是搞定这个目录下的东西。
3.2 port层配置：硬骨头在这里
port层，全称是「移植层」。它负责把FreeRTOS的通用调度逻辑，翻译成你的MCU能听懂的中断、栈操作和上下文切换。
port层主要包含两个文件：
- port.c：上下文切换、中断处理、栈初始化
- portmacro.h：数据类型定义、临界区、开关中断的宏
我的经验：如果你用的是ARM Cortex-M系列，直接拿官方现成的port文件改。别自己从头写，除非你想体验什么叫「调试到怀疑人生」。
portmacro.h里有个东西特别重要——configCPU_CLOCK_HZ和configTICK_RATE_HZ。这两个宏决定了系统时钟节拍。我在项目中遇到过，有人把时钟频率写错了，结果任务调度像抽风一样，时快时慢。
// 典型的portmacro.h配置片段
#define portCHAR char
#define portFLOAT float
#define portDOUBLE double
#define portLONG long
#define portSHORT short
#define portSTACK_TYPE uint32_t
#define portBASE_TYPE long
// 重点：系统节拍配置
#define configCPU_CLOCK_HZ ( ( unsigned long ) 168000000 ) // 168MHz
#define configTICK_RATE_HZ ( ( TickType_t ) 1000 ) // 1ms一个tick
嗯，这里要注意：configTICK_RATE_HZ设成1000，意味着每秒1000次tick中断。飞控里我建议别低于1000，否则控制环路的实时性会受影响。
3.3 启动文件修改：让系统跑起来的第一步
启动文件（startup_xxx.s）是MCU上电后执行的第一段代码。它负责初始化堆栈、设置中断向量表、调用main函数。
移植FreeRTOS时，启动文件需要改两个地方：
- 堆栈大小：给FreeRTOS的任务栈留够空间
- 中断向量表：把PendSV、SVC、SysTick的中断处理函数指向FreeRTOS的port层函数
我曾经踩过的坑：有一次我忘了改堆栈大小，默认的0x400（1KB）根本不够用。结果系统一跑多任务就死机，查了两天才发现是栈溢出。从那以后，我习惯把主栈设到0x1000（4KB）以上。
启动文件里，中断向量表长这样：
; 启动文件中的中断向量表片段
__Vectors DCD __initial_sp ; 栈顶指针
DCD Reset_Handler ; 复位中断
DCD NMI_Handler ; NMI
DCD HardFault_Handler ; 硬错误
; ... 其他中断 ...
DCD SVC_Handler ; SVC中断 -> 改为 vPortSVCHandler
DCD DebugMon_Handler
DCD PendSV_Handler ; PendSV中断 -> 改为 xPortPendSVHandler
DCD SysTick_Handler ; SysTick中断 -> 改为 xPortSysTickHandler
你需要把这三个中断处理函数的名字，改成FreeRTOS port层里定义的名字：
SVC_Handler→vPortSVCHandlerPendSV_Handler→xPortPendSVHandlerSysTick_Handler→xPortSysTickHandler
为什么？因为FreeRTOS的port层里，已经用这些名字实现了上下文切换和系统节拍。不改的话，中断来了找不到入口，系统直接跑飞。
快速检查清单
- ✅ portmacro.h中configCPU_CLOCK_HZ是否匹配实际晶振？
- ✅ portmacro.h中configTICK_RATE_HZ是否满足飞控实时性？
- ✅ 启动文件中堆栈大小是否足够？
- ✅ 中断向量表中SVC/PendSV/SysTick是否已改名？
- ✅ heap_x.c是否已选好并加入工程？
做完这三步，FreeRTOS基本就能在你的飞控板上跑起来了。当然，跑起来只是第一步，后面还有任务优先级、中断嵌套、临界区保护这些细节要调。但至少，你已经把最难啃的骨头啃下来了。
下一章，咱们聊聊任务创建和调度器启动。到时候我会分享一个我调试无人机飞控时遇到的「任务饿死」案例，挺有意思的。