# 超简单四步完成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)"则移植成功。

相关推荐
欢乐熊嵌入式编程14 天前
嵌入式 + MQTT:数据上传到阿里云实战(从0到1完整教程)
stm32·单片机·mqtt·freertos·嵌入式架构·efr32
离凌寒15 天前
一、关于zephyr的开发环境搭建。
freertos
欢乐熊嵌入式编程18 天前
第2讲:什么是优秀的软件架构?
stm32·单片机·freertos·低功耗蓝牙·嵌入式架构·efr32
bbaydnog1 个月前
FreeRTOS学习笔记 18:调试方法论——HardFault排查、栈溢出检测、运行时统计,RTOS调试三板斧
笔记·单片机·freertos
一支闲人1 个月前
Free RTOS:任务通知实验
freertos
一支闲人1 个月前
Free RTOS:任务通知的两类函数
freertos
007张三丰1 个月前
AIoT与嵌入式系统深度解析:2026软考案例核心考点全攻略
物联网·mqtt·kafka·freertos·时序数据库·tdengine·aiot
╰⋛⋋⊱⋋翅膀⋌⊰⋌⋚╯1 个月前
FreeRTOS--CPU利用率
stm32·freertos
追兮兮1 个月前
MCUQuickStart v1.1.0发布,一键生成Keil工程+RTOS模板
stm32·单片机·嵌入式硬件·freertos·gd32·keil5
山木嵌入式1 个月前
【嵌入式】裸机VS RTOS 核心对比+落地选型指南
freertos·嵌入式开发·rtos·裸机编程