1. 环境准备与工程搭建

第一次接触FreeRTOS移植的朋友可能会觉得无从下手，其实只要掌握几个关键步骤，整个过程就会变得清晰明了。我以STM32F103C8T6最小系统板为例，使用Keil MDK开发环境，手把手带你完成移植。

首先需要准备以下材料：

• STM32标准外设库或HAL库基础工程（建议先用裸机程序点个LED测试通过）
• FreeRTOS源码包（官网最新稳定版，我用的V10.4.3）
• 串口调试工具（用于后续任务调试）

工程目录结构调整很关键，我习惯这样组织：

Project/
├── Drivers/          // STM32驱动库
├── Middlewares/
│   └── FreeRTOS/     // 存放移植文件
│       ├── include/  // 头文件
│       ├── portable/ // 平台相关代码
│       └── src/      // 内核源码
└── User/             // 用户代码

实际操作时，先在工程中创建FreeRTOS分组，然后按以下顺序添加文件：

1. 将FreeRTOS/Source下的所有.c文件添加到src分组
2. 将FreeRTOS/Source/portable/RVDS/ARM_CM3中的port.c添加到portable分组
3. 从MemMang文件夹选择一种内存管理方案（新手推荐heap_4.c）

提示：MemMang文件夹下的5种内存管理方案区别很大，heap_1最简单但不支持内存释放，heap_4支持碎片整理但稍耗资源，具体选择要根据项目需求。

2. 关键配置文件修改

FreeRTOSConfig.h是移植的核心，这个文件决定了系统的行为特性。我从官方Demo里找了个STM32F1的模板，修改了几个关键参数：

#define configCPU_CLOCK_HZ      72000000    // 根据实际时钟设置
#define configTICK_RATE_HZ      1000        // 系统心跳频率(Hz)
#define configTOTAL_HEAP_SIZE   10240       // 堆空间大小(字节)
#define configMAX_PRIORITIES    5           // 最大任务优先级

// 中断优先级配置（必须与NVIC分组匹配）
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY     15
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 5

中断处理是另一个重点，需要修改stm32f10x_it.c文件：

1. 注释掉原有的SVC_Handler、PendSV_Handler和SysTick_Handler
2. 添加外部声明：

extern void xPortPendSVHandler(void);
extern void xPortSysTickHandler(void);
extern void vPortSVCHandler(void);

在delay.c文件中，需要重写延时函数以兼容FreeRTOS。这里有个坑我踩过：STM32的SysTick默认时钟源是HCLK/8，但FreeRTOS需要直接使用HCLK时钟。修改方法是在delay_init()中加入：

SysTick_CLKSourceConfig(SysTick_CLKSource_HCLK);

3. 多任务调度测试实战

移植完成后，我用LED闪烁和串口打印做了个基础测试。创建了三个任务：

1. LED1任务：500ms间隔闪烁（优先级2）
2. LED2任务：快闪模式（200ms亮，800ms灭）
3. 串口任务：定时发送系统运行状态

任务创建代码示例：

void StartDefaultTask(void const * argument)
{
  /* 创建LED任务 */
  xTaskCreate(led1_task, "LED1_Task", 128, NULL, 2, NULL);
  xTaskCreate(led2_task, "LED2_Task", 128, NULL, 3, NULL);
  
  /* 删除自身任务 */
  vTaskDelete(NULL);
}

void led1_task(void *pvParameters)
{
  while(1) {
    HAL_GPIO_TogglePin(LED1_GPIO_Port, LED1_Pin);
    vTaskDelay(500);  // 使用FreeRTOS延时
  }
}

测试时发现一个典型问题：如果任务栈空间分配不足，会导致硬件错误。通过uxTaskGetStackHighWaterMark()函数可以检查栈使用情况，我一般会预留20%的余量。

4. 常见问题排查指南

内存不足是最常见的问题之一。症状包括：

• 任务创建失败（返回errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY）
• 系统运行一段时间后崩溃

解决方法：

1. 增大configTOTAL_HEAP_SIZE
2. 检查每个任务的栈分配是否合理
3. 换用更高效的内存管理方案（如从heap_1改为heap_4）

中断优先级冲突也很棘手。FreeRTOS要求：

• SysTick和PendSV必须设为最低优先级
• 调用FreeRTOS API的中断优先级必须≤configMAX_SYSCALL_INTERRUPT_PRIORITY

我遇到过一个案例：移植后USB设备无法正常工作，最后发现是USB中断优先级设置过高，调整到允许范围内就正常了。

5. 进阶优化技巧

当系统稳定运行后，可以考虑以下优化：

Tickless模式能大幅降低功耗：

#define configUSE_TICKLESS_IDLE  1

但需要实现vApplicationSleep()函数，并注意外设的唤醒处理。

任务通知比信号量更高效：

xTaskNotifyGive(taskHandle);  // 代替信号量give
ulTaskNotifyTake(pdTRUE, portMAX_DELAY);  // 代替信号量take

栈溢出检测对稳定性很重要：

#define configCHECK_FOR_STACK_OVERFLOW 2

需要实现vApplicationStackOverflowHook回调函数。

最后分享一个调试小技巧：在FreeRTOSConfig.h中开启运行统计功能，然后通过串口打印任务状态：

void print_task_stats()
{
  char buf[256];
  vTaskList(buf);  // 获取任务状态表
  printf("%s\n", buf);
}

移植完成后，建议跑个72小时压力测试，我通常会创建几个任务不断动态创建删除对象，同时用LED和串口观察系统状态。只有经过长期运行验证，才能确认移植真正稳定可靠。