4、移植前的准备工作：选择合适的RTOS
说实话，很多新手一上来就急着写代码，结果做到一半发现RTOS选错了，或者源码版本不对，又得从头来。我见过太多次这种翻车现场了。
移植前的准备工作，说白了就是三件事：选对RTOS、拿到源码、读懂官方文档。这三步走稳了，后面移植就是按图索骥的事。
核心原则：移植工作80%的时间花在准备和调试上，真正写代码只占20%。准备越充分，踩坑越少。
4.1 选型：FreeRTOS vs RT-Thread
我个人习惯把RTOS选型比作「选工具」——没有最好的，只有最合适的。目前嵌入式领域最主流的两款开源RTOS就是FreeRTOS和RT-Thread。我直接给你列个对比表，你看完心里就有数了。
| 对比维度 | FreeRTOS | RT-Thread |
|---|---|---|
| 内核大小 | 极小，ROM 6-12KB | 标准版 20-50KB，Nano版 3-10KB |
| 任务数量 | 无限制（受内存限制） | 无限制（受内存限制） |
| 调度方式 | 抢占式+时间片轮转 | 抢占式+时间片轮转 |
| IPC机制 | 队列、信号量、互斥量、事件组 | 邮箱、消息队列、信号量、互斥量、事件集 |
| 内存管理 | 5种heap方案（heap_1~5） | 静态/动态内存池，支持slab |
| 组件生态 | 较少，需自行移植 | 丰富，内置文件系统、网络协议栈、设备驱动框架 |
| 学习曲线 | 平缓，API简洁 | 中等，功能多但文档齐全 |
| 商业许可 | MIT，无商业风险 | Apache 2.0，无商业风险 |
怎么选？我给你三个判断标准：
- 资源极度受限（Flash < 64KB，RAM < 16KB） → 选FreeRTOS，它轻量、稳定、全球社区大
- 需要丰富组件（文件系统、网络、GUI） → 选RT-Thread，它开箱即用，省去大量移植工作
- 团队经验 → 如果团队有人用过其中一个，优先选那个，减少学习成本
我的建议：如果你做的是物联网设备、智能家居这类需要联网和存储的产品，RT-Thread的组件生态能帮你省至少2周开发时间。如果是传感器节点、电机控制这类裸机升级项目，FreeRTOS更合适。
4.2 获取源码：版本选择与下载
选定了RTOS，下一步就是拿源码。这里有个坑——不要用最新版。我吃过这个亏：有一次用FreeRTOS最新版移植到STM32F103上，结果发现新版本改了调度器内部结构，跟老芯片的硬件兼容性出了问题，折腾了两天才定位到。
我的经验是：选稳定版，不要追新。具体做法：
- FreeRTOS：去GitHub的FreeRTOS/FreeRTOS仓库，选LTS版本或发布超过6个月的版本。目前推荐v10.4.x或v202112.00-LTS
- RT-Thread：去GitHub的RT-Thread/rt-thread仓库，选v4.0.x或v4.1.x的release版本。Nano版可以直接从官网下载zip包
下载后，目录结构长这样（以FreeRTOS为例）：
FreeRTOS/
├── FreeRTOS/Source/ # 内核源码
│ ├── include/ # 头文件
│ ├── portable/ # 移植层（关键！）
│ │ ├── GCC/ # GCC编译器相关
│ │ ├── IAR/ # IAR编译器相关
│ │ ├── Keil/ # Keil编译器相关
│ │ └── MemMang/ # 内存管理方案（heap_1~5.c）
│ ├── tasks.c # 任务管理
│ ├── queue.c # 队列
│ ├── timers.c # 软件定时器
│ └── event_groups.c # 事件组
├── FreeRTOS-Plus/ # 扩展组件（可选）
└── Demo/ # 官方示例（参考用）
注意：portable目录是移植的核心。里面按编译器分了子目录，每个子目录下又有对应MCU架构的移植文件。比如你要移植到ARM Cortex-M3，就找portable/GCC/ARM_CM3/下的port.c和portmacro.h。
4.3 熟悉官方移植指南
拿到源码后，别急着编译。先花半天时间把官方移植指南通读一遍。我每次移植新平台都会先做这件事，能避免至少一半的坑。
官方移植指南通常包含以下内容：
- 硬件要求：MCU需要满足什么条件（如定时器、中断控制器）
- 移植接口说明：需要实现哪些函数、宏定义
- 配置选项：FreeRTOSConfig.h中的宏定义含义
- 中断处理：SysTick、PendSV、SVC中断的配置方法
- 内存布局：堆栈设置、链接脚本修改
以FreeRTOS为例，移植指南里最核心的是这张图——它展示了FreeRTOS的架构分层：
从这张图可以清楚看到：移植层是唯一需要你动手改的部分。内核代码和API层基本不用动，你只需要实现port.c、portmacro.h和FreeRTOSConfig.h这三个文件。
4.4 移植前的关键检查清单
在动手之前，我建议你对照这个清单逐项确认。我曾经因为漏了其中一项，导致移植后系统跑飞，查了整整一天。
| 检查项 | 说明 | 优先级 |
|---|---|---|
| MCU架构确认 | 确认MCU是ARM Cortex-M0/M3/M4/M7还是RISC-V等 | 必须 |
| 编译器确认 | 确认使用GCC、IAR还是Keil，选择对应port目录 | 必须 |
| SysTick定时器 | 确认MCU有SysTick或可替代的硬件定时器 | 必须 |
| 中断优先级 | 确认MCU支持中断优先级嵌套（Cortex-M默认支持） | 必须 |
| RAM大小 | 确认RAM足够运行RTOS（至少预留4KB以上） | 必须 |
| 链接脚本 | 确认链接脚本中堆栈设置正确 | 建议 |
| 调试工具 | 确认有J-Link/ST-Link等调试器，方便定位问题 | 建议 |
我曾经踩过的坑：有一次移植FreeRTOS到国产MCU上，芯片手册说支持SysTick，结果实际硬件有bug，SysTick中断不触发。后来改用通用定时器替代才解决。所以，一定要先验证硬件定时器是否正常工作，写个裸机点灯程序确认一下。
4.5 搭建实验环境
准备工作最后一步——搭环境。我推荐用以下工具链：
- IDE：STM32CubeIDE（免费，集成GCC）或Keil MDK（商业，调试方便）
- 调试器：J-Link或ST-Link，二选一
- 串口工具：Putty或MobaXterm，用于打印调试信息
- 版本管理：Git，每次修改都提交，方便回溯
环境搭好后，先编译一个裸机工程，确认工具链没问题。然后再把RTOS源码加进去，编译通过就算环境就绪。
小技巧：在FreeRTOSConfig.h中把configUSE_TRACE_FACILITY设为1，可以启用运行时统计信息。配合Tracer工具，能直观看到任务调度情况，调试效率翻倍。
好了，准备工作就这些。选好RTOS、拿到源码、读懂移植指南、确认硬件没问题——接下来就可以正式进入移植环节了。