The FreeRTOS Distribution（介绍、移植、类型定义）

1 Understand the FreeRTOS Distribution

1.1 Definition ：FreeRTOS Port

FreeRTOS目前可以在20种不同的编译器构建，并且可以在30多种不同的处理器架构上运行，每个受支持的编译器和处理器组合被认为是一个单独的FreeRTOS Port。

1.2 Building FreeRTOS

FreeRTOS可以被认为是一个库，为应用程序提供多任务处理能力。 FreeRTOS以一组C源文件的形式提供，一些文件对FreeRTOS Port是通用的。而另一些文件则是特定于某个FreeRTOS Port。

1.3 FreeRTOSCofig.h

FreeRTOSConfig.h是FreeRTOS的配置文件，用来定制FreeRTOS在特定应用程序中使用，用来裁剪和配置FreeRTOS使用那些功能和不使用那些功能，所以FreeRTOS必须配置在项目工程中

1.4 FreeRTOS的顶级目录

Source目录下式FreeRTOS的源文件，Demo文件下是FreeRTOS的例子

1.5 对所有FreeRTOS Port都通用的源文件

注：下面所说的文件都在FreeRTOS/Source目录中

• tasks.c和list.c文件是FreeRTOS的核心文件，对所有FreeRTOS Port都通用，总是要求包含在项目中。

• queue.c文件提供队列和信号量服务

• timers.c提供软定时器功能，如果项目工程中需要软定时器，将其包含在内就可以了。

• event_groups提供事件组功能

• croutine.c实现了FreeRTOS的协程功能，协程旨在用于非常小的微控制器。现在很少使用
  

由于文件名可能会导致命名空间冲突，FreeRTOS禁止更改的FreeRTOS的源文件名，会导致项目出错以及自动化工具和IDE插件的兼容性，所以我们自己的文件不要与FreeRTOS的文件名同名

1.6 可移植性

这里的可移植性指的是有两种情况：

针对不同的编译器和架构，要选择不同的port.c和portmacro.h文件。特定于FreeRTOS Port的源文件包含在FreeRTOS/Source/portable目录中，如果使用的编译器(如Keil)在特定架构（ARM的CM0）的处理器上运行FreeRTOS，那么除了FreeRTOS源文件外，还必须构建位于FreeRTOS/Source/portable/[compiler]/[architecture]的文件
。

堆内存管理方案。使用早于V9.0.0的FreeRTOS版本的项目必须包含堆内存管理器，从FreeRTOS9.0.0开始，只要FreeRTOSConfig.h中的configSUPPORT_DYNAMIC_ALLOCATION设置为1或configSUPPORT_DYNAMIC_ALLOCATION没有定义时，才需要内存管理器。
FreeRTOS提供了五个方案来分配内存，分别有heap_1到heap_5实现，包含在FreeRTOS/Source/portable/MemMang目录下，如果项目中FreeRTOS使用动态内存分配，则必须在项目中使用这5个方案中的一个。

1.7 Include Paths

FreeRTOS要求编译器的包含路径中包含三个目录：

核心FreeRTOS头文件路径，在FreeRTOS/Source/include文件夹下

特定于正在使用的 FreeRTOS 端口的源文件的路径。 如上所述，需要包含 FreeRTOS/Source/portable/[compiler]/[architecture]目录。

FreeRTOSConfig.h

1.8 头文件

使用 FreeRTOS API 的源文件必须包含“FreeRTOS.h”，后跟包含正在使用的 API 函数原型的头文件——“task.h”、“queue.h”、“semphr.h” 、“timers.h”或“event_groups.h”。

2 Creating a FreeRTOS Project

我们在Keil+STM32F4上面实现

Keil打开一个跑马灯实验，并可以下载到板子上正确运行。新建两个分组

FreeRTOS_Core存放的是核心文件，对每个FreeRTOS Port都一样，FreeRTOS_Protable是内存管理和特定于FreeRTOS Port的源文件，不同FreeRTOS Port可能会不同。

包含头文件：

第一个是核心FreeRTOS头文件路径，在FreeRTOS/Source/include文件夹下
第二个是FreeRTOSConfig.h文件以及特定于正在使用的 FreeRTOS 端口的源文件的路径FreeRTOS/Source/portable/[compiler]/[architecture]

到这里就配置好了，下面配置的是由于FreeRTOS和HAL库一些函数名重复或者与HAL库配置不符合

修改FreeRTOSConfig.h，第45行

port.c文件和stm32f4xx_it.c有重复定义的函数：PendSV_Handler、SVC_Handler、Systick_Handler，将stm32f4xx_it.c里面的这些函数屏蔽掉

在FreeRTOSConfig.h将configUSE_IDLE_HOOK、configUSE_TICK_HOOK、configUSE_MALLOC_FAILED_HOOK和configCHECK_FOR_STACK_OVERFLOW定义为0，这个宏定义为1的话，我们需要写一个函数，不然会报错，我们修改为0，就用定义这些函数了。

由于我用了正点原子的库文件，还需要修改sys.h文件和delay.c文件以及usart.c文件
sys.h

#ifndef _SYS_H #define _SYS_H #include "stm32f4xx.h"// //本程序只供学习使用，未经作者许可，不得用于其它任何用途 //ALIENTEK STM32F429开发板 //系统时钟初始化 //包括时钟设置/中断管理/GPIO设置等 //正点原子@ALIENTEK //技术论坛:www.openedv.com //创建日期:2015/6/10 //版本：V1.0 //版权所有，盗版必究。 //Copyright(C) 广州市星翼电子科技有限公司 2014-2024 //All rights reserved //******************************************************************************** //修改说明 //无 // //0,不支持os //1,支持os #define SYSTEM_SUPPORT_OS 1 //定义系统文件夹是否支持OS /// //定义一些常用的数据类型短关键字 typedef int32_t s32; typedef int16_t s16; typedef int8_t s8;typedef const int32_t sc32; typedef const int16_t sc16; typedef const int8_t sc8; typedef __IO int32_t vs32; typedef __IO int16_t vs16; typedef __IO int8_t vs8;typedef __I int32_t vsc32; typedef __I int16_t vsc16; typedef __I int8_t vsc8; typedef uint32_t u32; typedef uint16_t u16; typedef uint8_t u8;typedef const uint32_t uc32; typedef const uint16_t uc16; typedef const uint8_t uc8; typedef __IO uint32_t vu32; typedef __IO uint16_t vu16; typedef __IO uint8_t vu8;typedef __I uint32_t vuc32; typedef __I uint16_t vuc16; typedef __I uint8_t vuc8; //位带操作,实现51类似的GPIO控制功能 //具体实现思想,参考<<CM3权威指南>>第五章(87页~92页).M4同M3类似,只是寄存器地址变了. //IO口操作宏定义 #define BITBAND(addr, bitnum) ((addr & 0xF0000000)+0x2000000+((addr &0xFFFFF)<<5)+(bitnum<<2)) #define MEM_ADDR(addr) *((volatile unsigned long *)(addr)) #define BIT_ADDR(addr, bitnum) MEM_ADDR(BITBAND(addr, bitnum)) //IO口地址映射 #define GPIOA_ODR_Addr (GPIOA_BASE+20) //0x40020014 #define GPIOB_ODR_Addr (GPIOB_BASE+20) //0x40020414 #define GPIOC_ODR_Addr (GPIOC_BASE+20) //0x40020814 #define GPIOD_ODR_Addr (GPIOD_BASE+20) //0x40020C14 #define GPIOE_ODR_Addr (GPIOE_BASE+20) //0x40021014 #define GPIOF_ODR_Addr (GPIOF_BASE+20) //0x40021414 #define GPIOG_ODR_Addr (GPIOG_BASE+20) //0x40021814 #define GPIOH_ODR_Addr (GPIOH_BASE+20) //0x40021C14 #define GPIOI_ODR_Addr (GPIOI_BASE+20) //0x40022014 #define GPIOJ_ODR_ADDr (GPIOJ_BASE+20) //0x40022414 #define GPIOK_ODR_ADDr (GPIOK_BASE+20) //0x40022814#define GPIOA_IDR_Addr (GPIOA_BASE+16) //0x40020010 #define GPIOB_IDR_Addr (GPIOB_BASE+16) //0x40020410 #define GPIOC_IDR_Addr (GPIOC_BASE+16) //0x40020810 #define GPIOD_IDR_Addr (GPIOD_BASE+16) //0x40020C10 #define GPIOE_IDR_Addr (GPIOE_BASE+16) //0x40021010 #define GPIOF_IDR_Addr (GPIOF_BASE+16) //0x40021410 #define GPIOG_IDR_Addr (GPIOG_BASE+16) //0x40021810 #define GPIOH_IDR_Addr (GPIOH_BASE+16) //0x40021C10 #define GPIOI_IDR_Addr (GPIOI_BASE+16) //0x40022010 #define GPIOJ_IDR_Addr (GPIOJ_BASE+16) //0x40022410 #define GPIOK_IDR_Addr (GPIOK_BASE+16) //0x40022810 //IO口操作,只对单一的IO口! //确保n的值小于16! #define PAout(n) BIT_ADDR(GPIOA_ODR_Addr,n) //输出 #define PAin(n) BIT_ADDR(GPIOA_IDR_Addr,n) //输入 #define PBout(n) BIT_ADDR(GPIOB_ODR_Addr,n) //输出 #define PBin(n) BIT_ADDR(GPIOB_IDR_Addr,n) //输入 #define PCout(n) BIT_ADDR(GPIOC_ODR_Addr,n) //输出 #define PCin(n) BIT_ADDR(GPIOC_IDR_Addr,n) //输入 #define PDout(n) BIT_ADDR(GPIOD_ODR_Addr,n) //输出 #define PDin(n) BIT_ADDR(GPIOD_IDR_Addr,n) //输入 #define PEout(n) BIT_ADDR(GPIOE_ODR_Addr,n) //输出 #define PEin(n) BIT_ADDR(GPIOE_IDR_Addr,n) //输入#define PFout(n) BIT_ADDR(GPIOF_ODR_Addr,n) //输出 #define PFin(n) BIT_ADDR(GPIOF_IDR_Addr,n) //输入#define PGout(n) BIT_ADDR(GPIOG_ODR_Addr,n) //输出 #define PGin(n) BIT_ADDR(GPIOG_IDR_Addr,n) //输入#define PHout(n) BIT_ADDR(GPIOH_ODR_Addr,n) //输出 #define PHin(n) BIT_ADDR(GPIOH_IDR_Addr,n) //输入#define PIout(n) BIT_ADDR(GPIOI_ODR_Addr,n) //输出 #define PIin(n) BIT_ADDR(GPIOI_IDR_Addr,n) //输入#define PJout(n) BIT_ADDR(GPIOJ_ODR_Addr,n) //输出 #define PJin(n) BIT_ADDR(GPIOJ_IDR_Addr,n) //输入#define PKout(n) BIT_ADDR(GPIOK_ODR_Addr,n) //输出 #define PKin(n) BIT_ADDR(GPIOK_IDR_Addr,n) //输入void Stm32_Clock_Init(u32 plln,u32 pllm,u32 pllp,u32 pllq);//时钟系统配置 //以下为汇编函数 void WFI_SET(void); //执行WFI指令 void INTX_DISABLE(void);//关闭所有中断 void INTX_ENABLE(void); //开启所有中断 void MSR_MSP(u32 addr); //设置堆栈地址 #endif

delay.c

#include "delay.h" #include "sys.h" // //如果使用OS,则包括下面的头文件即可. #if SYSTEM_SUPPORT_OS #include "FreeRTOS.h" //FreeRTOS使用 #include "task.h" #endifstatic u32 fac_us=0; //us延时倍乘数#if SYSTEM_SUPPORT_OS static u16 fac_ms=0; //ms延时倍乘数,在os下,代表每个节拍的ms数 #endifextern void xPortSysTickHandler(void); //systick中断服务函数,使用OS时用到 void SysTick_Handler(void) { if(xTaskGetSchedulerState()!=taskSCHEDULER_NOT_STARTED)//系统已经运行{xPortSysTickHandler(); }HAL_IncTick(); }//初始化延迟函数 //当使用ucos的时候,此函数会初始化ucos的时钟节拍 //SYSTICK的时钟固定为AHB时钟 //SYSCLK:系统时钟频率 void delay_init(u8 SYSCLK) {u32 reload;HAL_SYSTICK_CLKSourceConfig(SYSTICK_CLKSOURCE_HCLK);//SysTick频率为HCLKfac_us=SYSCLK; //不论是否使用OS,fac_us都需要使用reload=SYSCLK; //每秒钟的计数次数 单位为K reload*=1000000/configTICK_RATE_HZ; //根据configTICK_RATE_HZ设定溢出时间//reload为24位寄存器,最大值:16777216,在180M下,约合0.745s左右 fac_ms=1000/configTICK_RATE_HZ; //代表OS可以延时的最少单位 SysTick->CTRL|=SysTick_CTRL_TICKINT_Msk;//开启SYSTICK中断SysTick->LOAD=reload; //每1/configTICK_RATE_HZ断一次 SysTick->CTRL|=SysTick_CTRL_ENABLE_Msk; //开启SYSTICK } //延时nus //nus:要延时的us数. //nus:0~190887435(最大值即2^32/fac_us@fac_us=22.5) void delay_us(u32 nus) { u32 ticks;u32 told,tnow,tcnt=0;u32 reload=SysTick->LOAD; //LOAD的值 ticks=nus*fac_us; //需要的节拍数 told=SysTick->VAL; //刚进入时的计数器值while(1){tnow=SysTick->VAL; if(tnow!=told){ if(tnow<told)tcnt+=told-tnow; //这里注意一下SYSTICK是一个递减的计数器就可以了.else tcnt+=reload-tnow+told; told=tnow;if(tcnt>=ticks)break; //时间超过/等于要延迟的时间,则退出.} }; } //延时nms,会引起任务调度 //nms:要延时的ms数 //nms:0~65535 void delay_ms(u32 nms) { if(xTaskGetSchedulerState()!=taskSCHEDULER_NOT_STARTED)//系统已经运行{ if(nms>=fac_ms) //延时的时间大于OS的最少时间周期 { vTaskDelay(nms/fac_ms); //FreeRTOS延时}nms%=fac_ms; //OS已经无法提供这么小的延时了,采用普通方式延时 }delay_us((u32)(nms*1000)); //普通方式延时 }//延时nms,不会引起任务调度 //nms:要延时的ms数 void delay_xms(u32 nms) {u32 i;for(i=0;i<nms;i++) delay_us(1000); }

usart.c

#include "usart.h" #include "delay.h" // //如果使用os,则包括下面的头文件即可. #if SYSTEM_SUPPORT_OS #include "FreeRTOS.h" //os 使用 #endif//加入以下代码,支持printf函数,而不需要选择use MicroLIB //#define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f) #if 1 #pragma import(__use_no_semihosting) //标准库需要的支持函数 struct __FILE { int handle; }; FILE __stdout; //定义_sys_exit()以避免使用半主机模式 void _sys_exit(int x) { x = x; } //重定义fputc函数 int fputc(int ch, FILE *f) { while((USART1->SR&0X40)==0);//循环发送,直到发送完毕 USART1->DR = (u8) ch; return ch; } #endif #if EN_USART1_RX //如果使能了接收 //串口1中断服务程序 //注意,读取USARTx->SR能避免莫名其妙的错误 u8 USART_RX_BUF[USART_REC_LEN]; //接收缓冲,最大USART_REC_LEN个字节. //接收状态 //bit15， 接收完成标志 //bit14， 接收到0x0d //bit13~0， 接收到的有效字节数目 u16 USART_RX_STA=0; //接收状态标记 u8 aRxBuffer[RXBUFFERSIZE];//HAL库使用的串口接收缓冲 UART_HandleTypeDef UART1_Handler; //UART句柄//初始化IO 串口1 //bound:波特率 void uart_init(u32 bound) { //UART 初始化设置UART1_Handler.Instance=USART1; //USART1UART1_Handler.Init.BaudRate=bound; //波特率UART1_Handler.Init.WordLength=UART_WORDLENGTH_8B; //字长为8位数据格式UART1_Handler.Init.StopBits=UART_STOPBITS_1; //一个停止位UART1_Handler.Init.Parity=UART_PARITY_NONE; //无奇偶校验位UART1_Handler.Init.HwFlowCtl=UART_HWCONTROL_NONE; //无硬件流控UART1_Handler.Init.Mode=UART_MODE_TX_RX; //收发模式HAL_UART_Init(&UART1_Handler); //HAL_UART_Init()会使能UART1HAL_UART_Receive_IT(&UART1_Handler, (u8 *)aRxBuffer, RXBUFFERSIZE);//该函数会开启接收中断：标志位UART_IT_RXNE，并且设置接收缓冲以及接收缓冲接收最大数据量}//UART底层初始化，时钟使能，引脚配置，中断配置 //此函数会被HAL_UART_Init()调用 //huart:串口句柄void HAL_UART_MspInit(UART_HandleTypeDef *huart) {//GPIO端口设置GPIO_InitTypeDef GPIO_Initure;if(huart->Instance==USART1)//如果是串口1，进行串口1 MSP初始化{__HAL_RCC_GPIOA_CLK_ENABLE(); //使能GPIOA时钟__HAL_RCC_USART1_CLK_ENABLE(); //使能USART1时钟GPIO_Initure.Pin=GPIO_PIN_9; //PA9GPIO_Initure.Mode=GPIO_MODE_AF_PP; //复用推挽输出GPIO_Initure.Pull=GPIO_PULLUP; //上拉GPIO_Initure.Speed=GPIO_SPEED_FAST; //高速GPIO_Initure.Alternate=GPIO_AF7_USART1; //复用为USART1HAL_GPIO_Init(GPIOA,&GPIO_Initure); //初始化PA9GPIO_Initure.Pin=GPIO_PIN_10; //PA10HAL_GPIO_Init(GPIOA,&GPIO_Initure); //初始化PA10#if EN_USART1_RXHAL_NVIC_EnableIRQ(USART1_IRQn); //使能USART1中断通道HAL_NVIC_SetPriority(USART1_IRQn,3,3); //抢占优先级3，子优先级3 #endif }}void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {if(huart->Instance==USART1)//如果是串口1{if((USART_RX_STA&0x8000)==0)//接收未完成{if(USART_RX_STA&0x4000)//接收到了0x0d{if(aRxBuffer[0]!=0x0a)USART_RX_STA=0;//接收错误,重新开始else USART_RX_STA|=0x8000; //接收完成了 }else //还没收到0X0D{ if(aRxBuffer[0]==0x0d)USART_RX_STA|=0x4000;else{USART_RX_BUF[USART_RX_STA&0X3FFF]=aRxBuffer[0] ;USART_RX_STA++;if(USART_RX_STA>(USART_REC_LEN-1))USART_RX_STA=0;//接收数据错误,重新开始接收 } }}} }//串口1中断服务程序 void USART1_IRQHandler(void) { u32 timeout=0;u32 maxDelay=0x1FFFF;HAL_UART_IRQHandler(&UART1_Handler); //调用HAL库中断处理公用函数timeout=0;while (HAL_UART_GetState(&UART1_Handler) != HAL_UART_STATE_READY)//等待就绪{timeout++;超时处理if(timeout>maxDelay) break; }timeout=0;while(HAL_UART_Receive_IT(&UART1_Handler, (u8 *)aRxBuffer, RXBUFFERSIZE) != HAL_OK)//一次处理完成之后，重新开启中断并设置RxXferCount为1{timeout++; //超时处理if(timeout>maxDelay) break; } } #endif /*下面代码我们直接把中断控制逻辑写在中断服务函数内部。*/ /*//串口1中断服务程序 void USART1_IRQHandler(void) { u8 Res;if((__HAL_UART_GET_FLAG(&UART1_Handler,UART_FLAG_RXNE)!=RESET)) //接收中断(接收到的数据必须是0x0d 0x0a结尾){HAL_UART_Receive(&UART1_Handler,&Res,1,1000); if((USART_RX_STA&0x8000)==0)//接收未完成{if(USART_RX_STA&0x4000)//接收到了0x0d{if(Res!=0x0a)USART_RX_STA=0;//接收错误,重新开始else USART_RX_STA|=0x8000; //接收完成了 }else //还没收到0X0D{ if(Res==0x0d)USART_RX_STA|=0x4000;else{USART_RX_BUF[USART_RX_STA&0X3FFF]=Res ;USART_RX_STA++;if(USART_RX_STA>(USART_REC_LEN-1))USART_RX_STA=0;//接收数据错误,重新开始接收 } }} }HAL_UART_IRQHandler(&UART1_Handler); } #endif */

之后就可以运行了

3 Data Types and Coding Style Guide

3.1 Data Types

FreeRTOS的每个port都有一个唯一的portmacro.h头文件，其中包含TickType_t 和BaseType_t。
TickType_t 是用于保存滴答计数值和指定时间的数据类型。TickType_t 可以是无符号 16 位类型，也可以是无符号 32 位类型，具体取决于 FreeRTOSConfig.h 中 configUSE_16_BIT_TICKS 的设置。 如果 configUSE_16_BIT_TICKS 设置为 1，则 TickType_t 定义为 uint16_t。 如果 configUSE_16_BIT_TICKS 设置为 0，则 TickType_t 定义为 uint32_t。
使用 16 位类型可以大大提高 8 位和 16 位架构上的效率，但严重限制了可以指定的最大块周期。 没有理由在 32 位架构上使用 16 位类型。
BaseType_t 通常用于只能取非常有限范围的值的返回类型，以及 pdTRUE/pdFALSE 类型的布尔值。这始终被定义为体系结构最有效的数据类型。 通常，这是 32 位架构上的 32 位类型，16 位架构上的 16 位类型，以及 8 位架构上的 8 位类型。

3.2 Variable Names

变量以其类型为前缀：‘c’ for char，‘s’ for int16_t(short），‘l’ for int32_t(long)，and ‘x’ for BaseType_t和其他非标准类型。
如果一个变量是无符号的，以’u’为前缀，如果变量是指针，以’p’为前缀，比如’pc’代表字符指针类型

3.3 Function Names

函数以他们返回的类型和它们在其中定义的文件名为前缀，比如：
vTaskPrioritySet（）:返回类型为void，定义在task.c文件中
xQueueReceive()：返回值为BaseType_t类型，定义在queue.c文件中

3.4 Macro Names

大多数宏都是大写的，并以小写字母作为前缀，指示宏的定义位置。信号量API几乎完全是作为一组宏编写的，但遵循函数命名的约定。下面的四个宏用于整个FreeRTOS中

总结

以上是生活随笔为你收集整理的The FreeRTOS Distribution（介绍、移植、类型定义）的全部内容，希望文章能够帮你解决所遇到的问题。

如果觉得生活随笔网站内容还不错，欢迎将生活随笔推荐给好友。