FreeRTOS移植到STM32F103步骤与注意事项

FreeRTOS · 发表于 2016-6-25 13:45:55

本帖最后由 FreeRTOS 于 2016-6-25 13:49 编辑

前言：
由于之前听过太多人抱怨移植FreeRTOS到STM32有各种各样的问题，小灯经过一年多对FreeRTOS的研究并在公司产品中应用，多少有些心得，接下来就由小灯以最新版的FreeRTOS为例一步一步移植到STM32F103上，并提醒大家某些需要注意的事项。本文档为非正式技术文档，故排版会有些凌乱，希望大家能提供宝贵意见以供小灯参考改进。
下面先以IAR移植为例，说明移植过程中的诸多注意事项，最后再以MDK移植时不再重复说明，所以还是建议大家先花些时间看IAR的移植过程，哪怕你不使用IAR，最好也注意下那一大堆注意事项！

一、从官网下载最新版的FreeRTOS源码
下面的网址是官方最新源码的下载地址：

https://sourceforge.net/projects/freertos/files/latest/download?source=files

目前官方提供的最新版本是v9.0.0， FreeRTOS源码在解压目录下的路径为
FreeRTOS_V9.0.0rc2\FreeRTOS\Source

FreeRTOS组织为了抢用户也是拼了命的，不信你打开Demo文件夹看看，里面提供了FreeRTOS在各种单片机上已经移植好的工程，如果建工程时遇到什么问题，可以参考下这些Demo。
不过小灯现在着重于自己动手移植FreeRTOS，考虑到原子哥@正点原子的用户比较多，绝大多数习惯了使用MDK来开发STM32，因此小灯分别以IAR和MDK两种使用比较广泛的开发环境来移植FreeRTOS。说到IAR和MDK，不得不提的是小灯自从用了IAR之后就果断放弃了MDK，相信很多人有这个经历，哈哈！
 
在开始移植FreeRTOS之前，先介绍下FreeRTOS的源码：

FreeRTOS的源码比较少，源文件也远没有UCOS多，不过麻雀虽小五脏俱全，FreeRTOS的短小精悍也是最令小灯着迷的，虽然缺少了很多组成部分，例如GUI、网络协议栈、文件系统等，不过这些统统都不是问题，因为完全可以移植第三方的组件！
一不小心牛逼又吹大了，哈哈！回归正题，FreeRTOS的源码核心部分是tasks.c和list.c，其余的几个文件功能都是可选的，例如软件定时器、队列、协程等等，小灯就不介绍了，有兴趣的话可以到官网上看介绍。include文件夹里面的文件是操作系统相关的头文件，而portable这个文件夹有些奇葩，先看看里面有啥：

这里的文件几乎都是与平台相关的，如果你要删掉这里的文件时就必须小心了，因为不是所有文件都能删除的。
注意文件夹MemMang，里面存放的是FreeRTOS自带的内存管理方案的源文件：

关于内存管理方案的选择，小灯以后再跟大家讨论，现在只需要知道这些文件不能删就好。

接下来看看IAR文件夹的内容，里面都是跟单片机底层相关的，由于我们以STM32F103为例，因此只需要保留ARM_CM3文件夹即可，其余可选择性删除。ARM_CM3文件夹里只有几个文件，这几个文件是操作系统最最底层的部分：

接下来再看看Keil文件夹的内容，里面只有一个文件，文件提示See-also-the-RVDS-directory，意思是让我们参照RVDS目录下的文件。其实我们以MDK建工程时，就是拿RVDS目录下的文件来替代的，因此我们应该把RVDS目录下的文件拷贝到Keil目录下，跟上面IAR文件夹一样我们只拷贝ARM_CM3文件夹即可：

到这里我们可以把其他无用的文件统统删掉了，portable目录下只保留下面几个文件夹的文件即可：

现在已经把源码整理好了，接下来就开始移植工作吧！

二、IAR下移植FreeRTOS
事先说明下，小灯使用的IAR版本是

关于IAR下如何创建STM32基础工程，小灯就偷下懒不介绍了，这入门级的知识还是交给卖开发板的人来传播吧，小灯就以自己平常用的简单工程为例：

工程当中只有一个LED.c是小灯额外添加的，小灯一直停留在跑灯的水平，习惯用LED来观察现象，希望各位大神莫怪。工程源码结构如下：

其中FreeRTOS文件夹下就是FreeRTOS的源码：

接下来在工程里面添加FreeRTOS文件：

文件清单如下：
FreeRTOS\tasks.c
FreeRTOS\list.c
FreeRTOS\portable\IAR\ARM_CM3\port.c
FreeRTOS\portable\IAR\ARM_CM3\portasm.s
FreeRTOS\portable\MemMang\heap_4.c

这时有人可要问为何没有把FreeRTOS的所有文件都添加进去，原因我上面提过了，FreeRTOS的核心部分是tasks.c和list.c，其余的几个文件是可选部分，在此小灯就先不添加这些可选部分以简化我们的工程。小灯建议大家使用内存管理的方案四heap_4.c，因为该方案具有内存块碎片合并功能，比heap_2.c的最优内存块分配方案要稳定很多，这是小灯经过很长时间测试对比出来的，公司的产品也是一直使用heap_4.c，稳定性无懈可击！
 
接下来非常重要的一步就是添加头文件路径：

头文件路径如下：
$PROJ_DIR$\..\Source\FreeRTOS\include
$PROJ_DIR$\..\Source\FreeRTOS\portable\IAR\ARM_CM3

好了这时我们可以尝试编译下整个工程了，编译结果提示缺少了个头文件：

FreeRTOS组织也真是奇葩，居然连这么重要的文件都不提供在源码里面！！！前面提醒过大家，新建工程时碰到问题一定要参考官方提供的Demo，既然Demo是一堆成品的工程，那么里面绝对有我们所需的这个FreeRTOSConfig.h
我们就选择打开Demo\CORTEX_STM32F103_IAR下的这个工程吧，果不其然里面真的有我们需要的这个头文件：

把这文件放哪里好呢，这是一直纠结小灯的问题，官方直接把这文件放在工程目录下，但这么重要的配置文件这么随便放似乎不太好吧。在小灯看来，这个文件的重要性和打开的概率绝不比FreeRTOS内核文件低，所以还是把它放在源码里面比较合理：

在C/C++ Compiler下添加头文件路径：
$PROJ_DIR$\..\Source\FreeRTOS

还有一个地方一定要十分注意，因为操作系统的最最底层的几个文件也需要用到FreeRTOSConfig.h头文件，而底层文件是用汇编来写的，因此必须在Assembler下添加FreeRTOSConfig.h头文件路径：

好了再编译一次：

0个错误0个警告，程序员最欢喜的莫过于看见这个结果了，哈哈！

在编写系统任务前，有必要对配置文件FreeRTOSConfig.h进行检查。FreeRTOSConfig.h里面几乎都是一些宏定义，关于这些宏定义的具体用法，可以在官网上查阅：http://www.freertos.org/a00110.html
小灯只以其中几个比较重要的参数作特别说明，下面以小灯修改过的FreeRTOSConfig.h为例作为说明：

（1）定义系统底层相关的函数

其中SVC中断时操作系统启动时进入的中断，而PendSV中断手动切换任务时进入的中断，SysTick中断不用我多说了，@正点原子的基础例程几乎都使用这个定时器定时，在这里SysTick是作为操作系统的心脏。由于FreeRTOS对这几个中断的名称做了自己的定义，因此必须要重定义这几个函数才能正常进入中断，但这么做又会跟ST提供的stm32f10x_it.c文件当中定义的中断相冲突，因此必须将stm32f10x_it.c下对应的几个中断服务函数屏蔽掉，否则编译会提示函数重定义：

（2）修改系统可屏蔽的中断优先级阈值
FreeRTOS提供的可屏蔽中断优先级阈值是191，对应的十六进制数是0xBF：
#define configMAX_SYSCALL_INTERRUPT_PRIORITY 191
由于STM32F103的优先级分组只有4个位，而CM3的优先级是以MSB对齐的，也就是说STM32F103的优先级寄存器只有最高4位有效，低四位是无效的。当操作系统进入临界区时，会把上面的可屏蔽中断优先级阈值写入BASEPRI寄存器以屏蔽部分中断：

因此当进入临界区时，优先级对应0xB~0xF的中断均被屏蔽，而优先级处于0xB前面的中断不受影响。这个跟CM0有区别，也是最值得注意的地方。
上述的基础知识不是小灯要重点提的，对CM3的优先级不熟悉的朋友建议查阅《Cortex-M3权威指南》，接下来才是小灯要重点提的。由于使用@正点原子的开发板的用户比较多，很多人直接把FreeRTOS移植到原子哥的工程下，然后出现了各种各样的诡异问题，一直无解。其中一个非常严重的问题就是小灯上面提及到的中断屏蔽的问题，下面小灯就这个问题进行一个简单的分析，先贴上@正点原子的部分代码：

这是原子哥最常用的中断优先级分组方式，采用分组方式2，2位抢占优先级2位亚优先级。但是在移植FreeRTOS时必须要修改成优先级分组方式4：

把STM32的优先级分组的4个位均设成抢占优先级，也就是说完全放弃亚优先级。为何要这么设置？其实这得怪FreeRTOS机构里面被驴踢过的逗逼，这些逗逼为了自己省事，直接默认不使用亚优先级，下面让大家见识下这群逗逼的解释：

不过站在他们的角度来思考，其实我们也应该给他们那么一丁点儿理解，毕竟他们采取了一个比较简单的方法来获取不同厂商的单片机的有效优先级位数，算法是通过对优先级寄存器组的某一个寄存器写入0xFF，然后再读出来看实际上有多少位写入成功，然后根据实际的有效位数来重设优先级分组寄存器的分组方式（上面提到的分组方式4）。有兴趣的可以研究下他们的算法，代码截图在下面：

不知不觉越扯越远了，回归正题，到底为何要重设可屏蔽的中断优先级阈值，我们重新把思路理一下。根据STM32的中断优先级的设计，只有高4位有效，还有FreeRTOS默认将4个优先级位均划分为抢占优先级。由于FreeRTOS官方提供的中断优先级阈值是191（对应实际的0xB），也就是11~15的优先级均可被操作系统屏蔽。但我们实际使用时设置的中断优先级一般不会使用到11打后的，例如@正点原子的基础例程里面使用最多的1~3，所以我们必须要修改这个值，否则我们要重新修改所有底层驱动的优先级。
那么怎么修改比较合理？这个就得看实际应用需要了，其实使用宏configMAX_SYSCALL_INTERRUPT_PRIORITY来屏蔽部分中断是比较合理的，相对于CM3，CM0没有中断优先级阈值寄存器，只能简单粗暴的开启全局中断和关闭全局中断。操作系统在执行十分重要的工作时一般不能打断这个工作，尤其是这时在中断里面调用了操作系统的API函数，这都会严重影响系统的稳定性。小灯对configMAX_SYSCALL_INTERRUPT_PRIORITY的理解是，这个数值打后的所有中断均划入操作系统管理，而这个数值打前的中断则归由用户自己管理，但用户必须十分小心地处理这些中断，用户可以使用这些中断来处理一些跟操作系统无关的工作。这纯属个人理解，如有错误之处还请大家指出，小灯会尽快修改！

分析完configMAX_SYSCALL_INTERRUPT_PRIORITY的作用后，下面小灯提供一个参考值：

由于优先级寄存器是高四位有效，因此上述的屏蔽阈值实际上是0x1，也就是说优先级在1~15之间的中断均可被操作系统屏蔽，而优先级0归由用户自己控制。值得注意的是configMAX_SYSCALL_INTERRUPT_PRIORITY的高四位绝对不能设为0，下面小灯给出0x0F的仿真结果：

当configMAX_SYSCALL_INTERRUPT_PRIORITY设为0x0F时系统在进入临界区时BASEPRI寄存器的值一直为0，没有更新。下面给出0x1F时的仿真结果：

当configMAX_SYSCALL_INTERRUPT_PRIORITY设为0x1F时系统在进入临界区时BASEPRI寄存器的值更新为0x10，中断优先级阈值寄存器起作用了！原因在上面也解释过了，因为STM32F103的优先级寄存器是高四位有效的，对应的BASEPRI也是高四位能够写入而低四位无法写入，而BASEPRI有一个特点——对它写0会取消屏蔽所有中断（相当于禁用了该寄存器），因此BASEPRI的高四位一定不能设为0，否则不会屏蔽任何中断，这点注意下就好了。
（3）添加参数检测功能

该参数检测功能是官方提供的一个参考，很多人为了省事不使用参数检测，但小灯劝诫各位千万不能干这蠢事！说了半天想必大家也累了，那么接下来就开始我们跑灯之旅吧！

下面就以LED创建两个闪烁任务：

至于LED底层驱动代码在工程里面提供了，在这不详细解释，读者可自行修改。在main函数里首先设置中断优先级分组方式4，然后创建2个LED任务，堆栈深度40个字（160字节）即可，然后启动任务调度器，整个操作系统就能够跑起来了。

重新编译下工程，这时会提示有错误：

接下来我们需要屏蔽这些编译错误：

在C/C++ Compiler的Diagostics里面添加Pa082,Pe191,Pe167
重新编译一次：

编译通过，下载到板子上后就能够看到2个LED按照一定的频率闪烁了！

三、MDK下移植FreeRTOS
由于在上面IAR移植过程中已经把需要注意的事项详细，再次就不累述了，只给出移植过程。小灯使用的MDK版本是：

至于MDK工程的新建，请参照@正点原子的教程资料，小灯就不抢原子哥风头了，哈哈！

工程沿袭了小灯一贯的简约作风：

（1）添加FreeRTOS源文件：

源文件清单路径如下：
FreeRTOS\tasks.c
FreeRTOS\list.c
FreeRTOS\portable\Keil\ARM_CM3\port.c
FreeRTOS\portable\MemMang\heap_4.c
注意这里的FreeRTOSConfig.h的来源小灯在上面IAR移植里面已经详细说明了，而且对FreeRTOSConfig.h里面的内容做了大篇幅的分析，读者请自行翻查，在此不再累述。

（2）添加头文件路径：

（3）修改stm32f10x_it.c文件：

至于为了要修改该文件，小灯在上面IAR移植里面已经详细说明了，读者请自行翻查，在此不再累述。

（4）创建两个LED闪烁任务：

代码的解释在IAR移植里面已经详细说明了，读者请自行翻查，在此不再累述。

（5）编译工程：

在MDK移植FreeRTOS相对来说顺利很多，因为不会出现一大堆警告和错误。接下来下载到板子，效果跟IAR移植后一样，2个LED按照预定的频率闪烁！

总结：
FreeRTOS的移植难度并不大，只是有些地方需要注意，否则出问题了也完全找不出问题出在哪里。由于小灯习惯了使用IAR，习惯使用MDK的用户如果看IAR的移植步骤可能会很不习惯，但两者移植过程相仿，读者只需要注意对应的事项就好。鉴于小灯水平有限，文档难免会有出错的地方，小灯也很希望各位能指出错误之处或提供宝贵意见，小灯会及时修改，不胜感激！

FreeRTOS的官方网址为：http://www.freertos.org/

FreeRTOS移植到STM32F103步骤与注意事项.pdf (682.14 KB, 下载次数: 2827)

无痕幽雨 · 发表于 2016-6-25 13:52:51

不错，不错，支持。。。。。。

xianshasaman · 发表于 2016-6-25 14:02:01

非常有用，多谢楼主分享，楼主辛苦了

负西弱 · 发表于 2016-6-25 14:23:34

不错哦，支持一下

zuozhongkai · 发表于 2016-6-25 15:03:35

不错，很有用。不知楼主是FreeRTOS官方的还是自己学习用的

FantaSy_ · 发表于 2016-6-25 15:39:17

好东西啊！！！

FreeRTOS · 发表于 2016-6-25 15:39:20

zuozhongkai 发表于 2016-6-25 15:03
不错，很有用。不知楼主是FreeRTOS官方的还是自己学习用的

回大大，小弟渣渣一枚

swanegong · 发表于 2016-6-25 15:44:49

赞，mark

jiayubao12 · 发表于 2016-6-25 17:39:11

赞一个！！！正在研究这个东西。。

qsgang · 发表于 2016-6-25 20:28:43

谢谢分享

Electronic · 发表于 2016-6-26 03:16:40

哈哈，楼主我认识。给个赞！

ianhom · 发表于 2016-6-26 11:17:49

怒赞*32！

it_do_just · 发表于 2016-6-26 17:59:22

学习，讲解的很细，谢谢分享！！！

knightman · 发表于 2016-6-26 22:45:47

楼主是牛人！谢谢分享！

jim_ · 发表于 2016-8-4 14:26:34

mark!谢谢楼主分享

chicheng_smile · 发表于 2016-8-9 14:44:23

mark，谢谢楼主分享

MuchMoney · 发表于 2016-8-21 17:13:32

楼主，你好。我在移植的时候出现了这个问题，要怎么解决呢

MuchMoney · 发表于 2016-8-21 17:55:09

#include 加载错了

翼落天使 · 发表于 2016-9-12 11:22:41

原子哥的论坛真是神了,我想要什么都有什么啊.大写的佩服,另外,楼主好人,哈哈

:lol:lol:lol:lol

月嘉愚生 · 发表于 2016-9-19 22:59:06

32个赞

Nevermore · 发表于 2016-10-20 16:07:11

楼主，请问你在16K RAM的STM32F030上移植freeRtos，移植完后系统还能长长工作吗？我的任务函数可能需要4K的ram去处理数据，才能保证堆栈不会溢出。

FreeRTOS · 发表于 2016-10-20 16:27:19

Nevermore 发表于 2016-10-20 16:07
楼主，请问你在16K RAM的STM32F030上移植freeRtos，移植完后系统还能长长工作吗？我的任务函数可能需要4K的 ...

我没在030移植过，我是在051上移植的，跟030基本配置一样，不过只有8K的SRAM，机子没出过啥大问题
至于堆栈溢出，freertos有自身的检测方案，你开启就可以了

Nevermore · 发表于 2016-10-20 16:51:00

FreeRTOS 发表于 2016-10-20 16:27
我没在030移植过，我是在051上移植的，跟030基本配置一样，不过只有8K的SRAM，机子没出过啥大问题
至于 ...

谢谢哥。

赖皮腾 · 发表于 2016-11-29 21:56:40

点一个赞

浪花雷雨 · 发表于 2016-11-30 08:33:23

厉害，官方论坛的资料还是太少了，难道国外就没有民间的freertos论坛吗?

371924221 · 发表于 2016-12-5 15:51:44

为什么我在keil上面移植遇到这个错误：
..\FreeRTOS\portable\Keil\ARM_CM3\portmacro.h(211): error: #1113: Inline assembler not permitted when generating Thumb code

位置：
static portFORCE_INLINE void vPortSetBASEPRI( uint32_t ulBASEPRI )
{
__asm
{
/* Barrier instructions are not used as this function is only used to
lower the BASEPRI value. */
msr basepri, ulBASEPRI
}
}
难道楼主没遇到过？

创微 · 发表于 2016-12-10 12:49:11

这里写到了很多细节。。特别关于优先级这一块。。。感谢

海贼刺客 · 发表于 2017-3-22 23:13:58

楼主，我是开始学FreeRTOS,我一直V9.0.0, FreeRTOSConfig.h的内容跟您这个不一样啊，该怎么配置？

FreeRTOS · 发表于 2017-3-23 08:25:50

海贼刺客发表于 2017-3-22 23:13
楼主，我是开始学FreeRTOS,我一直V9.0.0, FreeRTOSConfig.h的内容跟您这个不一样啊，该怎么配置？

如果对FreeRTOS功能不熟悉的，最好从Demo里面拷一个，因为Demo会裁剪掉很多功能，比较适合初学者。
这个配置文件的宏的功能，一般上官网就能查到，或者在文件里面就有解释，上面有提到网址，你找找看

下午茶924 · 发表于 2017-4-19 21:35:44

不错，牛人啊

勇敢的小铖铖 · 发表于 2017-4-27 09:37:41

本帖最后由勇敢的小铖铖于 2017-4-27 09:39 编辑

版主辛苦了！
我是个初学者，简单移植好以后，发现不添加启动文件一样可以运行，用的是IAR V7.8，不知道是什么原因？

FreeRTOS · 发表于 2017-4-27 16:13:42

勇敢的小铖铖发表于 2017-4-27 09:37
版主辛苦了！
我是个初学者，简单移植好以后，发现不添加启动文件一样可以运行，用的是IAR V7.8，不知道是 ...

开什么玩笑。。。没有启动文件整个工程没法初始化MCU的时钟的，而且没法跳到main函数

追月 · 发表于 2017-4-27 16:53:59

FreeRTOS 发表于 2017-4-27 16:13
开什么玩笑。。。没有启动文件整个工程没法初始化MCU的时钟的，而且没法跳到main函数

楼主，我的程序偶尔会有崩溃的现象，请问是不是我分配的栈空间太小的原因呢？

勇敢的小铖铖 · 发表于 2017-4-27 19:18:04

FreeRTOS 发表于 2017-4-27 16:13
开什么玩笑。。。没有启动文件整个工程没法初始化MCU的时钟的，而且没法跳到main函数

刚试了下，把启动文件删除了，真可以
运行了两个任务，一个LED，一个USART
但是USART一接收数据就HardFault，肯定是缺少启动文件的原因
为什么程序能下载运行呢？
main函数刚开始就进行的SystemInit();
版主说缺少启动文件main都进不了
疑惑中。。。

CEN_zm · 发表于 2017-4-27 23:15:45

MARK一下，致敬灯神

FreeRTOS · 发表于 2017-4-28 08:28:57

追月发表于 2017-4-27 16:53
楼主，我的程序偶尔会有崩溃的现象，请问是不是我分配的栈空间太小的原因呢？

如果你是跑系统的话，任务堆栈的估算需要些技巧，这个是后话
我碰过的多数情况并不是堆栈溢出，而是数组访问越界

FreeRTOS · 发表于 2017-4-28 08:44:51

勇敢的小铖铖发表于 2017-4-27 19:18
刚试了下，把启动文件删除了，真可以
运行了两个任务，一个LED，一个USART
但是USART一接收数据就HardF ...

MCU上电之后会跳到0x08000000处开始执行代码，你的main函数还是会在代码里面，如果没有启动文件，理论上并不是说不能跳转到main，而是不能正确跳转，相当于程序跑飞了之后，其实还会继续往下执行代码，只不过这时候执行的代码功能肯定是有问题的

追月 · 发表于 2017-4-28 09:00:16

FreeRTOS 发表于 2017-4-28 08:28
如果你是跑系统的话，任务堆栈的估算需要些技巧，这个是后话
我碰过的多数情况并不是堆栈溢出，而是数组 ...

我是跑的系统，我现在把堆栈加大了一些，加到256了，数据访问越界是什么意思？

不良苏 · 发表于 2017-6-2 15:27:53

mark一下

polun1 · 发表于 2017-6-23 17:26:42

请问斑竹，freertos能移植到stm32f101rbt6上吗？我这边提示空间不足

FreeRTOS · 发表于 2017-6-23 18:38:14

polun1 发表于 2017-6-23 17:26
请问斑竹，freertos能移植到stm32f101rbt6上吗？我这边提示空间不足

101也是M3架构的吧，这个不会有问题的，估计是你的系统底层没移植对，
如果想找到问题具体出在哪，你得啃下freertos源码了

super910906 · 发表于 2017-7-27 12:01:17

好东西，mark一下

conggoer · 发表于 2017-9-13 11:38:23

楼主你好，我按照你的过程在IAR上移植了一遍最后的结果是只有优先级最高的那个任务在运行不知道什么原因

FreeRTOS · 发表于 2017-9-13 13:34:23

conggoer 发表于 2017-9-13 11:38
楼主你好，我按照你的过程在IAR上移植了一遍最后的结果是只有优先级最高的那个任务在运行不知道什么原因

最高优先级的任务有让出CPU的使用权没？
还有注意下任务的堆栈有没有溢出

wangwang328 · 发表于 2017-10-30 11:42:53

不错，不错，支持灯哥

Derricker · 发表于 2018-1-5 21:22:38

正在学习，支持一下！！

simondz · 发表于 2018-9-22 11:59:17

参照楼主文章，已经成功移植FreeRTOSv10到stm32f103re（IAR），非常感谢！

wdliming · 发表于 2018-9-27 16:24:59

真厉害！！！！

陈皮皮 · 发表于 2018-9-27 17:12:05

马克一下

山峡 · 发表于 2018-10-6 13:18:39

学习学习，讲解的很细，谢谢分享！

帐号		自动登录	找回密码
密码			立即注册

FreeRTOS移植到STM32F103步骤与注意事项

原子哥极力推荐 /2