本文基于野火 FreeRTOS 教程,内容是关于 FreeRTOS 官方代码的移植的注意事项,并将野火例程中 STM32F103RC 代码移植到 STM32F103C8。
所谓移植,本意是将代码适配我们需要使用的单片机,也就是软件得和硬件相匹配的过程。
但是在这里,和硬件相匹配的接口文件 port.c 已经由官方写好了,我们需要的只是将这些文件放入我们的 keil 工程中,实际上是使用官方的移植的过程。
详细的工程添加文件过程,请查看野火的教程。
在 FreeRTOSConfig.h
中,有如下这些代码:
/******************************************************************
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 是在 STM32 原有的架构上实现的,也就是说,我们在考虑 FreeRTOS 的各种细节的时候不能忘记 STM32 裸机的各种细节。比如裸机上的优先级分配等等。
configLIBRARY_LOWEST_INTERRUPT_PRIORITY:用于配置 STM32 的中断最低优先级,这里配置为 15,也就是总共有 0 - 15 共 16 个优先级。
注意,这里说的 STM32 的中断优先级和 FreeRTOS 的中断优先级不同,注意区分。
STM32 的中断优先级:Cortex 内核的各种优先级,越小优先级越高
FreeRTOS 的中断优先级:在 STM32 的中断优先级上实现的任务优先级,越大优先级越高
configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY:用于配置 FreeRTOS 可以管理的最高的中断优先级。这里配置为 5,结合上面 STM32 的中断优先级配置共 15 级,那么意味着 FreeRTOS 可以管理的 STM32 的中断优先级为 5 - 15,而0 - 4 FreeRTOS 就管不了。
Q:那为什么 FreeRTOS 要对 STM32 的优先级进行管理呢?
A:很重要的一点是前几篇文章提到过的临界段的保护。
还记得吗,由于 FreeRTOS 的并发性,FreeRTOS 需要确保执行一些代码的时候不能被中断打断,很常见的就是对共享资源的访问,比如全局变量的修改。在访问共享资源前我们需要先屏蔽中断,修改完毕后再开启,这就是临界端的保护,也就是 FreeRTOS 要对 STM32 的中断进行管理的原因。
这里贴上临界段保护的文章:临界段保护
由于野火的例程中并没有 STM32F1C8T6 这个芯片,所以我们只能自己移植。
我们使用 STM32F1RC 这个芯片进行移植。可以看到 C 表示 256K 字节的闪存,而 C8T6 只有 64K 字节。移植主要是根据不同的闪存容量进行配置的。
根据不同容量,有 ld、md、hd 三种缩写:
我们需要把 RC 中所有的 hd 都修改为 md进行移植。
移植分为基础的编译器移植设置和针对 FreeRTOS 的代码修改两个步骤:
这个启动文件就是在执行 main 函数之前执行的一个文件。
需要从 startup_stm32f10x_hd.s
换为 startup_stm32f10x_md.s
C:\Keil\ARM\PACK\Keil\STM32F1xx_DFP\2.2.0\Device\Source\ARM
这个路径下找..\..\Output\Fire_FreeRTOS.axf: Error: L6406E: No space in execution regions with .ANY selector matching heap_4.o(.bss).
..\..\Output\Fire_FreeRTOS.axf: Error: L6406E: No space in execution regions with .ANY selector matching startup_stm32f10x_md.o(STACK).
..\..\Output\Fire_FreeRTOS.axf: Error: L6406E: No space in execution regions with .ANY selector matching tasks.o(.bss).
..\..\Output\Fire_FreeRTOS.axf: Error: L6406E: No space in execution regions with .ANY selector matching tasks.o(.data).
..\..\Output\Fire_FreeRTOS.axf: Error: L6406E: No space in execution regions with .ANY selector matching heap_4.o(.data).
..\..\Output\Fire_FreeRTOS.axf: Error: L6406E: No space in execution regions with .ANY selector matching system_stm32f10x.o(.data).
..\..\Output\Fire_FreeRTOS.axf: Error: L6406E: No space in execution regions with .ANY selector matching stm32f10x_rcc.o(.data).
..\..\Output\Fire_FreeRTOS.axf: Error: L6406E: No space in execution regions with .ANY selector matching port.o(.data).
..\..\Output\Fire_FreeRTOS.axf: Error: L6406E: No space in execution regions with .ANY selector matching stdout.o(.data).
..\..\Output\Fire_FreeRTOS.axf: Error: L6407E: Sections of aggregate size 0x9770 bytes could not fit into .ANY selector(s).
Not enough information to list image symbols.
Not enough information to list load addresses in the image map.
Finished: 2 information, 0 warning and 10 error messages.
"..\..\Output\Fire_FreeRTOS.axf" - 10 Error(s), 0 Warning(s).
Target not created.
Build Time Elapsed: 00:00:02
这是由于 FreeRTOS 中对于容量的配置出错,接着往下看。
打开 FreeRTOSConfig.h
文件进行配置,找到这个宏定义,它的作用是在 FreeRTOS 中定义系统可用的整个堆的大小,如果设置得太大了就会出现上文所说的空间不足的报错。
原来设置的大小是 ((size_t)(36*1024)) ,这里的 size_t 是 unsigned int,也就是 4 个字节,在 STM32 中是 1 个字的大小。
#define configTOTAL_HEAP_SIZE ((size_t)(36*1024))
修改为 ((size_t)(10*1024)) 即可,也就是 10K 字的大小:
//系统所有总的堆大小
#define configTOTAL_HEAP_SIZE ((size_t)(10*1024))
这样,我们所有的修改就完成了,尝试编译吧!
如果您觉得本文写得不错,可以点个赞激励一下作者!
如果您发现本文的问题,欢迎在评论区或者私信共同探讨!
共勉!