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

一、资源准备

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

二、FreeRTOS源码文件夹详解

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

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

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

三、详细移植步骤

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

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

  • 新建分组:在工程左侧"Project"窗口右键→"Manage Project Items",新建两个分组:FreeRTOS_CORE(内核文件)和FreeRTOS_PORTABLE(硬件适配文件)。
  • 向FreeRTOS_CORE添加文件:选择FreeRTOS文件夹下的所有.c文件(如task.c、queue.c、semphr.c,croutine.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_CM4F(port.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_Handler、SVC_Handler、SysTick_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)"则移植成功。

相关推荐
qq_401700413 天前
FreeRTOS 堆内存管理源码剖析:释放一块内存,空闲块数量反而变少了?
单片机·freertos
List<String> error_P5 天前
使用FreeRTOS搭建工程项目(一)
freertos
@嵌入式扫地僧13 天前
RTOS 面试实战:任务状态切换原理
freertos·rtos·时间片轮转·任务状态切换·抢占式调度
WWJA王文举20 天前
Bootloader、App 和升级分区之间是什么关系?
stm32·freertos·嵌入式开发·在线升级
怀民民民20 天前
嵌入式软件学习路线与项目实践记录:STM32、FreeRTOS、Linux 与 OpenMV
stm32·freertos·嵌入式软件·嵌入式linux·openmv
长江后浪博客1 个月前
ESP32-SOLO-1 在 ESP-IDF v5.5 下启动不断重启问题分析与解决
单片机·嵌入式硬件·嵌入式·esp32·freertos·esp-idf
WWJA王文举1 个月前
FreeRTOS动态创建任务和静态创建任务详解:xTaskCreate与xTaskCreateStatic区别
操作系统·freertos·嵌入式开发
离凌寒1 个月前
一、关于rtthread nano使用上的细节总结
freertos
桃蹊、1 个月前
串口/网络透传实战:FreeRTOS 多任务架构与连接池设计
stm32·物联网·wifi·freertos
虎王物联1 个月前
ESP32 FreeRTOS多任务优先级翻转与互斥量保护实战
物联网·嵌入式·esp32·freertos