# 超简单四步完成FreeRTOS移植到STM32

一、资源准备

  • FreeRTOS源码:推荐FreeRTOSv9.0.0(稳定性高,适配STM32F4系列,可从官网或正点原子/野火等开源仓库获取)

二、FreeRTOS源码文件夹详解

下载的FreeRTOS压缩包解压后,核心文件夹说明如下:

文件夹 作用说明
FreeRTOS 核心源码文件夹,移植的主要操作对象
Demo 针对不同MCU/开发板的示例工程(如CORTEX_M4F_STM32F407ZG-SK是STM32F407的参考例程)
License 开源许可协议(MIT许可证,商业/非商业使用均需遵守)
Source FreeRTOS内核源码,移植的核心文件
include 通用头文件(如FreeRTOS.htask.h,所有工程都需包含)
portable 硬件适配层(连接内核与具体MCU的"桥梁",需按需保留以下子文件夹)
Keil Keil编译器适配文件(确保编译兼容)
MemMang 内存管理实现(提供5种内存分配策略,heap_4.c最常用,支持动态分配与碎片管理)
RVDS 针对ARM架构的芯片适配(STM32F407为Cortex-M4F内核,需保留ARM_CM4F文件夹)

FreeRTOS-Plus:扩展功能包(如TCP/IP、FAT文件系统等),基础移植无需使用。

三、详细移植步骤

1. 工程结构搭建
  • 打开基础裸机工程,在工程根目录新建FreeRTOS文件夹(与UserLibrary等文件夹同级)。
  • 复制FreeRTOS源码中FreeRTOS/Source下的所有文件 (包括task.cqueue.csemphr.c等)到新建的FreeRTOS文件夹。
  • 进入FreeRTOS/portable目录,删除无关文件夹 (仅保留KeilMemMangRVDS,其他如GCCIAR等非Keil环境的文件夹可删除)。
2. 工程文件添加

打开Keil工程,按以下步骤添加文件:

  • 新建分组:在工程左侧"Project"窗口右键→"Manage Project Items",新建两个分组:FreeRTOS_CORE(内核文件)和FreeRTOS_PORTABLE(硬件适配文件)。
  • FreeRTOS_CORE添加文件:选择FreeRTOS文件夹下的所有.c文件(如task.cqueue.csemphr.ccroutine.c(协程功能)若不使用可不添加,减少编译体积)。
  • FreeRTOS_PORTABLE添加文件:MemMang文件夹下的heap_4.c(推荐,支持内存碎片管理)、RVDS/ARM_CM4F文件夹下的port.c(Cortex-M4F内核适配文件)。
3. 头文件路径配置
  • 在Keil中点击"Options for Target"(魔术棒图标)→"C/C++"→"Include Paths",添加:
    • ./FreeRTOS/include(FreeRTOS通用头文件路径);
    • ./FreeRTOS/portable/RVDS/ARM_CM4Fport.c对应的头文件路径)。
4. 编译报错及解决(逐步处理)
报错1:缺少FreeRTOSConfig.h
  • 解决:从源码FreeRTOS/Demo/CORTEX_M4F_STM32F407ZG-SK文件夹复制FreeRTOSConfig.h,粘贴到工程FreeRTOS/include目录。
报错2:SystemCoreClock未定义
  • 解决:打开FreeRTOSConfig.h,修改条件编译,添加SystemCoreClock声明:

    c 复制代码
    #if defined(__ICCARM__) || defined(__CC_ARM__) || defined(__GNUC__)
        #include <stdint.h>
        extern uint32_t SystemCoreClock;  // 声明系统时钟变量
    #endif
报错3:中断服务函数重复定义(PendSV_HandlerSVC_HandlerSysTick_Handler
  • 解决:打开stm32f4xx_it.c,注释掉这3个函数的实现(FreeRTOS的port.c已实现,需用FreeRTOS版本)。
报错4:钩子函数未定义
  • 解决:打开FreeRTOSConfig.h,关闭未实现的钩子函数:

    c 复制代码
    #define configUSE_IDLE_HOOK          0
    #define configUSE_TICK_HOOK          0
    #define configUSE_MALLOC_FAILED_HOOK 0
    #define configCHECK_FOR_STACK_OVERFLOW 0
5. 编译验证

点击Keil"Rebuild",显示"0 Error(s), 0 Warning(s)"则移植成功。

相关推荐
研猛男6 天前
0、FreeRTOS编码和命名规则
笔记·stm32·freertos
宁静致远20217 天前
stm32 freertos下基于hal库的模拟I2C驱动实现
stm32·嵌入式硬件·freertos
宁静致远20218 天前
FreeRTOS任务同步与通信--事件标志组
stm32·嵌入式·freertos
一枝小雨10 天前
FreeRTOS下STM32双缓冲ADC数据采集与处理
stm32·单片机·dma·嵌入式·arm·freertos·adc
一枝小雨18 天前
FreeRTOS内存分配与STM32内存布局详解
stm32·单片机·嵌入式·freertos·嵌入式系统·cortex-m3/m4
pQAQqa1 个月前
FreeRTOS项目(2)摇杆按键检测
stm32·单片机·嵌入式硬件·freertos
猫头虎1 个月前
2025最新超详细FreeRTOS入门教程:第一章 FreeRTOS移植到STM32
stm32·单片机·嵌入式硬件·机器人·硬件架构·freertos·嵌入式实时数据库
自激振荡器1 个月前
14,FreeRTOS二值信号量操作
freertos·信号量
微风扬!1 个月前
STM32手动移植FreeRTOS
stm32·单片机·freertos