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

摘要

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

文章目录

[2025最新超详细FreeRTOS入门教程：第一章 FreeRTOS移植到STM32](#2025最新超详细FreeRTOS入门教程：第一章 FreeRTOS移植到STM32)
- 摘要
- 一、移植前的准备工作
- - 硬件/软件条件
  - 文件准备
- 二、移植步骤
- - 步骤1：拷贝核心文件
  - 步骤2：添加配置文件
  - 步骤3：选择内存管理方案
  - [步骤4：配置中断和 SysTick](#步骤4：配置中断和 SysTick)
  - 步骤5：创建最小任务
- 三、移植验证
- - [3.1 观察 LED 闪烁](#3.1 观察 LED 闪烁)
  - [3.2 调试技巧](#3.2 调试技巧)
- 四、常见移植问题及解决方案
- 五、经验分享
- 六、总结

一、移植前的准备工作

⚡ 提示：移植 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/ 目录。

text 复制代码

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

步骤2：添加配置文件

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

常见配置项：

c 复制代码

#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：

c 复制代码

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

步骤5：创建最小任务

c 复制代码

#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 正常闪烁检查SysTick & 堆内存

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

问题	原因	解决方法
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任务创建 ------我们将学习如何创建多个任务，设置优先级，并观察调度效果。