【FreeRTOS 应用开发笔记】移植FreeRTOS 到STM32（一）

最新推荐文章于 2024-03-27 21:03:58 发布
最新推荐文章于 2024-03-27 21:03:58 发布
阅读量1.7k 收藏 9
点赞数 1
分类专栏： RTOS 文章标签： stm32 arm 嵌入式硬件
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_29031103/article/details/121009014
版权

一、移植freeRTOS的前期准备

1、STM32 的裸机工程模板。

2、下载 FreeRTOS V9.0.0 源码。

官网：http://www.freertos.org/ 

 代码托管网站 ：https://sourceforge.net/projects/freertos/files/FreeRTOS/

以上是获取源码的两种方式，这里选用第二种方式，下载是V9.0.0版本，有两种格式，选择zip格式即可。

二、源码文件简单介绍

这里主要介绍一下我们需要的文件所在的文件夹。

1、demo文件夹：FreeRTOSConfig.h 这个头文件就是从这里拷贝过来的。因为我们使用的keil编译器，采用芯片是stm32f103vet6，所以FreeRTOSConfig.h从下图这个指示的文件夹中获取。

2、sourse文件夹：序号1和3，包含freeRTOS通用的头文件和C文件，这两部分的文件试用于各种编译器和处理器。序号2，需要移植的头文件和 C文件这个文件夹。

 需要注意的是序号2 portable文件夹中的文件，我们不需要全部移植，里面很多与编译器相关的文件夹，在不同的编译器中使用不同的支持文件。序号1和序号3内容一致的，所以在移植时只需要移植序号2 Memmang 和序号3 RVDS。

 三、往裸机工程添加 FreeRTOS 源码

1、在裸机工程根目录下，新建freeRTOS文件夹，并在文件夹中新建include，port，src三个文件夹。

 2、将freeRTOS源码sourse文件夹中的文件添加到裸机工程相应文件夹。其中序号2 portable文件夹中，只需要拷贝 文件夹MemMang和RVDS即可。根据下图指示

 3、将freeRTOS源码demo文件中FreeRTOSConfig.h 文件到裸机工程user 文件夹。因为我们使用的keil编译器，采用芯片是stm32f103vet6，所以FreeRTOSConfig.h从下图这个指示的文件夹中获取。

 3、打开工程文件，新建FreeRTOS/src 和 FreeRTOS/port 组，并添加刚才拷贝好的freeRTOS源码到工程组文件夹。

 4、指定头文件路径，FreeRTOS 的源码里面只有 FreeRTOS\include 和FreeRTOS\port\RVDS\ARM_CM3这两个文件夹下面有头文件，只需要将这两个头文件的路径在开发环境里面指定即可。

 5、 修改 FreeRTOSConfig.h。
FreeRTOSConfig.h 是直接从 demo 文件夹下面拷贝过来的，该头文件对裁剪整个FreeRTOS 所需的功能的宏均做了定义，有些宏定义被使能，有些宏定义被失能，一开始我 们只需要配置最简单的功能即可。

注意：实际应用中FreeRTOSConfig.h 文件内容是从野火的例程拷贝的，与freeRTOS源码的内容区别在于是添加了一些中文注释，并且把相关的头文件进行分类，方便查找宏定义已经阅读。同时在FreeRTOSConfig.h 中实现了断言操作，需要打印一些信息，所以需要包含我们的串口的头文件“bsp_usart.h”。

FreeRTOSConfig.h内容：

#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H

#include "stm32f10x.h"
#include "bsp_usart.h"


//针对不同的编译器调用不同的stdint.h文件
#if defined(__ICCARM__) || defined(__CC_ARM) || defined(__GNUC__)
    #include <stdint.h>
    extern uint32_t SystemCoreClock;
#endif

//断言
#define vAssertCalled(char,int) printf("Error:%s,%d\r\n",char,int)
#define configASSERT(x) if((x)==0) vAssertCalled(__FILE__,__LINE__)

/************************************************************************
 *               FreeRTOS基础配置配置选项 
 *********************************************************************/
/* 置1：RTOS使用抢占式调度器；置0：RTOS使用协作式调度器（时间片）
 * 
 * 注：在多任务管理机制上，操作系统可以分为抢占式和协作式两种。
 * 协作式操作系统是任务主动释放CPU后，切换到下一个任务。
 * 任务切换的时机完全取决于正在运行的任务。
 */
#define configUSE_PREEMPTION					  1

//1使能时间片调度(默认式使能的)
#define configUSE_TIME_SLICING					1		

/* 某些运行FreeRTOS的硬件有两种方法选择下一个要执行的任务：
 * 通用方法和特定于硬件的方法（以下简称“特殊方法”）。
 * 
 * 通用方法：
 *      1.configUSE_PORT_OPTIMISED_TASK_SELECTION 为 0 或者硬件不支持这种特殊方法。
 *      2.可以用于所有FreeRTOS支持的硬件
 *      3.完全用C实现，效率略低于特殊方法。
 *      4.不强制要求限制最大可用优先级数目
 * 特殊方法：
 *      1.必须将configUSE_PORT_OPTIMISED_TASK_SELECTION设置为1。
 *      2.依赖一个或多个特定架构的汇编指令（一般是类似计算前导零[CLZ]指令）。
 *      3.比通用方法更高效
 *      4.一般强制限定最大可用优先级数目为32
 * 一般是硬件计算前导零指令，如果所使用的，MCU没有这些硬件指令的话此宏应该设置为0！
 */
#define configUSE_PORT_OPTIMISED_TASK_SELECTION	        1                       
                                                                        
/* 置1：使能低功耗tickless模式；置0：保持系统节拍（tick）中断一直运行
 * 假设开启低功耗的话可能会导致下载出现问题，因为程序在睡眠中,可用以下办法解决
 * 
 * 下载方法：
 *      1.将开发版正常连接好
 *      2.按住复位按键，点击下载瞬间松开复位按键
 *     
 *      1.通过跳线帽将 BOOT 0 接高电平(3.3V)
 *      2.重新上电，下载
 *    
 * 			1.使用FlyMcu擦除一下芯片，然后进行下载
 *			STMISP -> 清除芯片(z)
 */
#define configUSE_TICKLESS_IDLE													0   

/*
 * 写入实际的CPU内核时钟频率，也就是CPU指令执行频率，通常称为Fclk
 * Fclk为供给CPU内核的时钟信号，我们所说的cpu主频为 XX MHz，
 * 就是指的这个时钟信号，相应的，1/Fclk即为cpu时钟周期；
 */
#define configCPU_CLOCK_HZ						  (SystemCoreClock)

//RTOS系统节拍中断的频率。即一秒中断的次数，每次中断RTOS都会进行任务调度
#define configTICK_RATE_HZ						  (( TickType_t )1000)

//可使用的最大优先级
#define configMAX_PRIORITIES					  (32)

//空闲任务使用的堆栈大小
#define configMINIMAL_STACK_SIZE				((unsigned short)128)
  
//任务名字字符串长度
#define configMAX_TASK_NAME_LEN					(16)

 //系统节拍计数器变量数据类型，1表示为16位无符号整形，0表示为32位无符号整形
#define configUSE_16_BIT_TICKS					0                      

//空闲任务放弃CPU使用权给其他同优先级的用户任务
#define configIDLE_SHOULD_YIELD					1           

//启用队列
#define configUSE_QUEUE_SETS					  0    

//开启任务通知功能，默认开启
#define configUSE_TASK_NOTIFICATIONS    1   

//使用互斥信号量
#define configUSE_MUTEXES						    0    

//使用递归互斥信号量                                            
#define configUSE_RECURSIVE_MUTEXES			0   

//为1时使用计数信号量
#define configUSE_COUNTING_SEMAPHORES		0

/* 设置可以注册的信号量和消息队列个数 */
#define configQUEUE_REGISTRY_SIZE				10                                 
                                                                       
#define configUSE_APPLICATION_TASK_TAG		  0                       
                      

/*****************************************************************
              FreeRTOS与内存申请有关配置选项                                               
*****************************************************************/
//支持动态内存申请
#define configSUPPORT_DYNAMIC_ALLOCATION        1    
//支持静态内存
#define configSUPPORT_STATIC_ALLOCATION					0					
//系统所有总的堆大小
#define configTOTAL_HEAP_SIZE					((size_t)(36*1024))    


/***************************************************************
             FreeRTOS与钩子函数有关的配置选项                                            
**************************************************************/
/* 置1：使用空闲钩子（Idle Hook类似于回调函数）；置0：忽略空闲钩子
 * 
 * 空闲任务钩子是一个函数，这个函数由用户来实现，
 * FreeRTOS规定了函数的名字和参数：void vApplicationIdleHook(void )，
 * 这个函数在每个空闲任务周期都会被调用
 * 对于已经删除的RTOS任务，空闲任务可以释放分配给它们的堆栈内存。
 * 因此必须保证空闲任务可以被CPU执行
 * 使用空闲钩子函数设置CPU进入省电模式是很常见的
 * 不可以调用会引起空闲任务阻塞的API函数
 */
#define configUSE_IDLE_HOOK						0      

/* 置1：使用时间片钩子（Tick Hook）；置0：忽略时间片钩子
 * 
 * 
 * 时间片钩子是一个函数，这个函数由用户来实现，
 * FreeRTOS规定了函数的名字和参数：void vApplicationTickHook(void )
 * 时间片中断可以周期性的调用
 * 函数必须非常短小，不能大量使用堆栈，
 * 不能调用以”FromISR" 或 "FROM_ISR”结尾的API函数
 */
 /*xTaskIncrementTick函数是在xPortSysTickHandler中断函数中被调用的。因此，vApplicationTickHook()函数执行的时间必须很短才行*/
#define configUSE_TICK_HOOK						0           

//使用内存申请失败钩子函数
#define configUSE_MALLOC_FAILED_HOOK			0 

/*
 * 大于0时启用堆栈溢出检测功能，如果使用此功能 
 * 用户必须提供一个栈溢出钩子函数，如果使用的话
 * 此值可以为1或者2，因为有两种栈溢出检测方法 */
#define configCHECK_FOR_STACK_OVERFLOW			0   


/********************************************************************
          FreeRTOS与运行时间和任务状态收集有关的配置选项   
**********************************************************************/
//启用运行时间统计功能
#define configGENERATE_RUN_TIME_STATS	        0             
 //启用可视化跟踪调试
#define configUSE_TRACE_FACILITY				      0    
/* 与宏configUSE_TRACE_FACILITY同时为1时会编译下面3个函数
 * prvWriteNameToBuffer()
 * vTaskList(),
 * vTaskGetRunTimeStats()
*/
#define configUSE_STATS_FORMATTING_FUNCTIONS	1                       
                                                                        
                                                                        
/********************************************************************
                FreeRTOS与协程有关的配置选项                                                
*********************************************************************/
//启用协程，启用协程以后必须添加文件croutine.c
#define configUSE_CO_ROUTINES 			          0                 
//协程的有效优先级数目
#define configMAX_CO_ROUTINE_PRIORITIES       ( 2 )                   


/***********************************************************************
                FreeRTOS与软件定时器有关的配置选项      
**********************************************************************/
 //启用软件定时器
#define configUSE_TIMERS				            0                              
//软件定时器优先级
#define configTIMER_TASK_PRIORITY		        (configMAX_PRIORITIES-1)        
//软件定时器队列长度
#define configTIMER_QUEUE_LENGTH		        10                               
//软件定时器任务堆栈大小
#define configTIMER_TASK_STACK_DEPTH	      (configMINIMAL_STACK_SIZE*2)    

/************************************************************
            FreeRTOS可选函数配置选项                                                     
************************************************************/
#define INCLUDE_xTaskGetSchedulerState       1                       
#define INCLUDE_vTaskPrioritySet		         1
#define INCLUDE_uxTaskPriorityGet		         1
#define INCLUDE_vTaskDelete				           1
#define INCLUDE_vTaskCleanUpResources	       1
#define INCLUDE_vTaskSuspend			           1
#define INCLUDE_vTaskDelayUntil			         1
#define INCLUDE_vTaskDelay				           1
#define INCLUDE_eTaskGetState			           1
#define INCLUDE_xTimerPendFunctionCall	     0
//#define INCLUDE_xTaskGetCurrentTaskHandle       1
//#define INCLUDE_uxTaskGetStackHighWaterMark     0
//#define INCLUDE_xTaskGetIdleTaskHandle          0


/******************************************************************
            FreeRTOS与中断有关的配置选项                                                 
******************************************************************/
#ifdef __NVIC_PRIO_BITS
	#define configPRIO_BITS       		__NVIC_PRIO_BITS
#else
	#define configPRIO_BITS       		4                  
#endif
//中断最低优先级
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY			15     

//系统可管理的最高中断优先级
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY	5 

#define configKERNEL_INTERRUPT_PRIORITY 		( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )	/* 240 */

#define configMAX_SYSCALL_INTERRUPT_PRIORITY 	( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )


/****************************************************************
            FreeRTOS与中断服务函数有关的配置选项                         
****************************************************************/
#define xPortPendSVHandler 	PendSV_Handler
#define vPortSVCHandler 	SVC_Handler


/* 以下为使用Percepio Tracealyzer需要的东西，不需要时将 configUSE_TRACE_FACILITY 定义为 0 */
#if ( configUSE_TRACE_FACILITY == 1 )
#include "trcRecorder.h"
#define INCLUDE_xTaskGetCurrentTaskHandle               1   // 启用一个可选函数（该函数被 Trace源码使用，默认该值为0 表示不用）
#endif


#endif /* FREERTOS_CONFIG_H */
首先为了能够实现断言操作，将 bsp_usart.h，bsp_usart.c文件拷贝到工程指定文件夹（usart文件夹需要新建），路径如下图。同时在工程界面将bsp_usart.c添加到user组中，并指定头文件路径（方法同上）。

6、修改 stm32f10x_it.c。

因为需要使用到freeRTOS中的函数所以需要包含相关的头文件。

#include "stm32f10x_it.h"
#include "FreeRTOS.h"					//FreeRTOS使用		  
#include "task.h"

PendSV_Handler()与 SVC_Handler()这两个很重要的函 数都帮我们实现了，在 port.c 文件中已经实现 xPortPendSVHandler()与 vPortSVCHandler() 函数，防止我们自己实现不了，那么在 stm32f10x_it.c 中就需要我们注释掉PendSV_Handler()与 SVC_Handler()这两个函数了。

FreeRTOS 帮我们实现了 SysTick 的启动的配置：在 port.c 文件中已经实现vPortSetupTimerInterrupt()函数，并且 FreeRTOS 通用的 SysTick 中断服务函数也实现了：在 port.c 文件中已经实现 xPortSysTickHandler()函数，所以移植的时候只需要我 们在 stm32f10x_it.c 文件中实现我们对应（STM32）平台上的 SysTick_Handler()函数即可。

extern void xPortSysTickHandler(void);
void SysTick_Handler(void)
{
	#if (INCLUDE_xTaskGetSchedulerState  == 1 )
      if (xTaskGetSchedulerState() != taskSCHEDULER_NOT_STARTED)
      {
    #endif  /* INCLUDE_xTaskGetSchedulerState */  
        xPortSysTickHandler();
    #if (INCLUDE_xTaskGetSchedulerState  == 1 )
      }
    #endif  /* INCLUDE_xTaskGetSchedulerState */
}

7、修改 main.c 。

我们将原来裸机工程里面 main.c 的文件内容全部删除。

#include "stm32f10x.h"
#include "FreeRTOS.h"					//FreeRTOS使用		  
#include "task.h" 


/**
  * @brief  主函数
  * @param  无  
  * @retval 无
  */
int main(void)
{	
	/* 暂时没有在 main 任务里面创建任务应用任务 */
}

至此，我们的 FreeRTOS 基本移植完成了。

整个移植过程参考的野火《 FreeRTOS 内核实现与应用开发实战指南 》《STM32库开发实战指南》(标准库源码)，包括其中的涉及到的裸机代码， bsp_usart.h，bsp_usart.c，以及修改FreeRTOSConfig.h的内容。不得不说学习stm32，野火帮了大忙了，虽然有些视频确实讲的不咋地，但是结合书本来看，还是不错的。因为前段日子刚好有学习hal库以及STM32 cubemx，所以接下来有时间会更新一下通过STM32 cubemx移植freeRTOS，这里先占个位置。
———————————————STM32 cubemx移植freeRTOS——————————————


 

Hello_96_world
关注
  • 1
    点赞
  • 踩
  • 9
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
LVGL移植到STM32F407ZGT6，带FreeRTOS的移植
11-02
借鉴文章+参考官网的资料，把LVGL移植到FreeRTOS的STM32F407ZGT6上（其他F4系列的只要满足内部SRAM>64K，均可适用）。我用的是正点F4最小系统板+4.7寸电容屏（800*480）。上传是为了和大家共同学习探讨，后续会更新中文字库添加的方法。
将 FreeRTOS 移植到 STM32L475之跑马灯实验
11-06
本压缩包是将 FreeRTOS 移植到 STM32L475上的资源包。本压缩包是将 FreeRTOS 移植到 STM32L475上的资源包。
FreeRTOS系统移植——基于STM32F103
最新发布
eternal_xe的博客
03-27 969
该文章参考了，如有涉及侵权，将删除该文章。
FREERTOS移植STM32F407.rar
05-22
FreeRTOS移植到STM32F407，实现一个简单的流水灯功能，并附带移植教程和移植成功后的源码，欢迎下载，有任何疑问，博客联系~
FreeRTOS和FreeMODBUS移植到STM32F103傻瓜教程（Keil5）.pdf
12-26
【FreeRTOS和FreeMODBUS移植到STM32F103傻瓜教程（Keil5）.PDF】手把手教你一步步移植成功，图文并茂。先从大的方向讲解应该如何移植，要移植哪些，然后着重将移植过程中感到困惑的、容易忽略的地方进行了讲解，每一步关键点都有截屏。 【FreeRTOS和FreeMODBUS移植到STM32F103傻瓜教程（Keil5）.PDF】还有对应的源程序，CSDN链接：https://download.csdn.net/download/ba_wang_mao/12054203
FreeRTOS学习笔记——任务壮态或信息查询与任务运行时间统计
唯恋殊雨的博客
06-15 6423
前面几章我们花费了大量的精力来学习FreeRTOS 的任务管理，但是真正涉及到的与任务相关的API 函数只有那么几个。但是FreeRTOS 还有很多与任务相关的API 函数，不过这些API函数大多都是辅助函数了，本章我们就来看一下这些与任务相关的其他的API 函数。本章分为如下几部分：11.1 任务相关API 函数预览11.2 任务相关API 函数详解11.3 任务壮态查询API 函数实验11.1...
FreeRTOS系统配置文件详解
路过的熊的博客
03-20 2876
简介     在实际使用FreeRTOS 的时候我们时常需要根据自己需求来配置FreeRTOS，而且不同架构的MCU 在使用的时候配置也不同。FreeRTOS 的系统配置文件为FreeRTOSConfig.h，在此配置文件中可以完成FreeRTOS 的裁剪和配置，这是非常重要的一个文件，本章就来讲解这个这个文件，本章分为如下几部分： 3.1 FreeRTOSConfig.h 文件 3.2 “INCLUDE_”开始的宏 3.3 “config”开始的宏 3.1 FreeRTOSConfig.h 文件 Free
移植FreeRTOS时出现了Undefined symbol xTaskGetSchedulerState (referred from delay.o).
ZZXin_的博客
09-13 4051
当我们使用正点原子进行FreeRTOS移植实验时，会出现了freertos.axf: Error: L6218E: Undefined symbol xTaskGetSchedulerState (referred from delay.o). 这是因为在官方提供的源码中有一个地方需要我们对它进行修改，程序才能正确运行： 在FreeRTOS.h中改动以下地方，将“0”改为“1”； **#if...
FreeRTOS学习笔记【三】——FreeRTOS 系统配置
weixin_46545987的博客
10-30 2326
FreeRTOS 系统配置
FreeRTOS学习（四）任务调度与切换
la_fe_的博客
03-15 3541
文章目录1.SVC 和 PendSV1.1 SVC 中断1.2 PendSV 中断 1.SVC 和 PendSV   在上一节中也提到了这两个中断的中断服务函数的功能，这里再详细介绍一下。 1.1 SVC 中断   SVC是系统服务调用，由 SVC 指令触发调用。在 FreeRTOS 中用来在任务调度中开启第一个任务。触发指令： svc 0 1.2 PendSV 中断   与SVC相关的是PendSV中断，称为可悬起的系统调用。两者不同之处在于响
FreeRTOS_系统配置
light_2025的博客
05-17 832
默认情况下，FreeRTOS 使用抢占式调度器，这意味着调度器永远都在执行已经就绪了的最高优先级任务，优先级相同的任务在时钟节拍中断中进行切换，当宏 configUSE_TIME_SLICING 为 0 的时候不会在时钟节拍中断中执行相同优先级任务的任务切换，默认情况下宏 configUSE_TIME_SLICING 为1。当为 1 的时候空闲任务就会为处于同等优先级的用户任务让出 CPU 使用权，除非没有就绪的用户任务，这样花费在空闲任务上的时间就会很少，但是这种方法也带了副作用。方法一的优点就是快！
STM32F103C8T6移植FreeRTOS成功案例
05-23
1. 移植了FreeRTOS V9.00版本系统。 2. 已对FreeRTOS中的FreeRTOSconfig.h文件进行了详细的注释说明。 3. 资源包含详细解释为什么将ZET6的直接移植至C8T6却不能使用。 4. 已将LED程序更改为PC13管脚，可以直接下载进...
FreeRTOS笔记（仅供参考）
小电车没有名字
07-13 990
FreeRTOS笔记，仅供参考
FreeRTOS专栏10：FreeRTOS时间管理
dingyc_ee的博客
01-27 612
FreeRTOS时间管理
FreeRTOS内核应用开发手记
热门推荐
xfxuezhang.cn
06-25 1万+
FreeRTOS内核应用开发学习手记移植任务状态迁移任务创建与删除任务挂起与恢复任务延时消息队列信号量事件软件定时器任务通知内存管理FreeRTOS内核应用开发学习手记移植1、解压并添加...
STM32运行FreeRtos系统出现信号量错误
Psyduck_ing的博客
02-22 4202
现象： 在系统运行过程中，出现如下断言错误：
FreeRTOS 其他任务 API 函数
Bit_Dong的博客
04-19 712
1. 函数 uxTaskPriorityGet() 2. 函数 vTaskPrioritySet() 3. uxTaskGetSystemState() 4. 函数 vTaskGetInfo() 5. 函数 xTaskGetApplicationTaskTag() 6. 函数 xTaskGetCurrentTaskHandle() 7. 函数 xTaskGetHandle() 8. 函数 xTaskGetIdleTaskHandle() 9. 函数 uxTaskGetStackHighWaterMark()
基于HAL库的FREERTOS----------二.任务API函数
qq_52207268的博客
12-23 778
FEREERTOS任务函数
FreeRTOS托管网址
qq_68685893的博客
06-15 97
输入网址：
移植FreeRTOS到stm32
06-03
好的，下面是移植FreeRTOS到STM32的一些步骤： 1.选择适合的FreeRTOS版本：从FreeRTOS...以上是移植FreeRTOS到STM32的一些基本步骤，具体的移植过程还需要根据STM32芯片型号和具体的应用场景进行具体的调整和优化。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值