2025最新超详细FreeRTOS入门教程：第一章 FreeRTOS移植到STM32

摘要

在开始学习 FreeRTOS 之前，第一步就是移植到具体硬件平台。本章将以 STM32（Cortex-M3/M4） 为例，详细介绍移植步骤、常见问题和验证方法。移植完成后，你就能在开发板上运行第一个基于 FreeRTOS 的任务，这是学习 RTOS 的重要里程碑。

---

一、移植前的准备工作

⚡ 提示：移植 RTOS 前，确保你已经能在 STM32 裸机工程下点亮 LED，这样说明基础工程环境是稳定的。

硬件/软件条件

条件	推荐配置
MCU	STM32F103C8T6 / STM32F407VET6 / STM32F429
IDE	Keil MDK5 或 IAR EWARM
库选择	HAL库 或 标准外设库
FreeRTOS版本	v10.5.x (AWS FreeRTOS 最新版)

文件准备

• 从官网下载 FreeRTOS 内核源码：FreeRTOS/Source

• 移植时至少需要以下模块：

  • tasks.c
  • queue.c
  • list.c
  • timers.c
  • event_groups.c
  • portable/GCC/ARM_CM3/port.c（根据编译器选择不同端口文件）
  • heap_x.c（选择一种内存管理方案）

---

二、移植步骤

步骤1：拷贝核心文件

将 FreeRTOS/Source 下必要的文件拷贝至工程 Middlewares/FreeRTOS/ 目录。

Project
 ├── Core
 ├── Drivers
 ├── Middlewares
 │   └── FreeRTOS
 │       ├── Source
 │       └── FreeRTOSConfig.h

步骤2：添加配置文件

FreeRTOSConfig.h 是项目级配置文件，需放在 Inc/ 或 Middlewares/FreeRTOS/Config/ 下。

常见配置项：

#define configUSE_PREEMPTION            1
#define configUSE_IDLE_HOOK             0
#define configUSE_TICK_HOOK             0
#define configCPU_CLOCK_HZ              (SystemCoreClock)
#define configTICK_RATE_HZ              ((TickType_t)1000)
#define configMAX_PRIORITIES            (5)
#define configMINIMAL_STACK_SIZE        ((unsigned short)128)
#define configTOTAL_HEAP_SIZE           ((size_t)(10*1024))
#define configMAX_TASK_NAME_LEN         (16)
#define configUSE_16_BIT_TICKS          0
#define configIDLE_SHOULD_YIELD         1

---

步骤3：选择内存管理方案

FreeRTOS 提供 5 种堆管理实现 (heap_1.c ~ heap_5.c)：

文件	特点	适用场景
heap_1.c	最简单，只分配不释放	超小内存单任务
heap_2.c	可释放，简单链表	小型系统
heap_3.c	调用 malloc/free	与C库一致
heap_4.c	最常用，合并相邻空闲块	推荐
heap_5.c	多段内存区域管理	复杂系统

推荐使用 heap_4.c

---

步骤4：配置中断和 SysTick

在 stm32fxxx_it.c 中修改 SysTick_Handler：

void SysTick_Handler(void)
{
    HAL_IncTick();
    if (xTaskGetSchedulerState() != taskSCHEDULER_NOT_STARTED)
    {
        xPortSysTickHandler();
    }
}

---

步骤5：创建最小任务

#include "FreeRTOS.h"
#include "task.h"

void vTaskBlink(void *pvParameters)
{
    while(1)
    {
        HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
        vTaskDelay(500);
    }
}

int main(void)
{
    HAL_Init();
    SystemClock_Config();

    xTaskCreate(vTaskBlink, "LED", 128, NULL, 1, NULL);
    vTaskStartScheduler();

    while(1) {}
}

---

三、移植验证

3.1 观察 LED 闪烁

当 LED 以 500ms 频率闪烁时，说明 FreeRTOS 内核调度器已正常运行。

3.2 调试技巧

• 使用 uxTaskGetStackHighWaterMark() 检查栈余量
• 使用 vTaskList() 打印任务状态

---

四、常见移植问题及解决方案

问题	原因	解决方法
LED 不闪烁	调度器未启动	确认 vTaskStartScheduler() 执行
HardFault	堆/栈不足	增大 configTOTAL_HEAP_SIZE
卡死在 vPortSVCHandler	向量表未配置	确认启动文件定义正确
延时不准确	SysTick 配置错误	检查 HAL_IncTick() 与 xPortSysTickHandler()

---

五、经验分享

📌 经验提示

• 初学者建议先只创建 一个任务 验证调度器
• 推荐阅读 FreeRTOS 内核中的 list.c 和 queue.c，理解链表和队列机制
• heap_4.c 是最稳妥的内存分配方式，避免调试困难

---

六、总结

通过以上步骤，我们成功将 FreeRTOS 移植到 STM32 开发板，并运行了第一个任务。完成本章学习后，你应该已经具备：

• 独立完成 FreeRTOS 移植的能力
• 了解配置文件和内存管理方式
• 能够用 LED 任务验证调度器

这为后续学习 任务管理、消息队列、信号量 等功能打下坚实基础。

---

🔗 FreeRTOS专栏👉 下一章：2025最新超详细FreeRTOS入门教程：第二章 FreeRTOS任务创建 ——我们将学习如何创建多个任务，设置优先级，并观察调度效果。

---