STM32-FreeRTOS快速学习之总结1

1. 基础知识
注意:在RTOS中是优先值越高则优先级越高(和ucos/linux的相反)
在移植的时候,主要裁剪FreeRTOS/Source/portable文件夹,该文件夹用来针对不同MCU做的一些处理,如下图所示,我们只需要使用:

1.1配置工程时,选择memMang时,一般使用heap_4.c

• heap_4: 优点在于可以有效的利用内存碎片来合并为一个大内存.缺点在于只能用来一个ram里.
• heap_5: 一般针对有外部RAM才用到,优点在于可以同时利用内部ram和外部ram来进行内存碎片合并.

最终添加的库文件有:

然后我们在分配释放内存的时候,就尽量使用RTOS带的函数来实现,分配/释放函数如下所示:

void *pvPortMalloc( size_t xWantedSize );    
void vPortFree( void *pv );

1.2 添加头文件路径

• 添加FreeRTOSinclude
• 添加FreeRTOSportableRVDSARM_CM3
• 并将原子中的FreeRTOSConfig.h也复制到我们项目的FreeRTOSinclude中(用来配置RTOS系统)

2. FreeRTOSConfig.h配置介绍
一般会写configXXXXX或者INCLUDE_XXXX类似的宏,这两个宏区别在于:

• configXXXXX

用来实现不同功能,比如定义configUSE_COUNTING_SEMAPHORES为1时,表示使用计数信号量

• INCLUDE_XXXX

用来是否将某个API函数编译进程序中.
比如定义INCLUDE_xTaskGetSchedulerState 为1 时,则将会编译xTaskGetSchedulerState()函数,如下图所示:

3. FreeRTOS任务状态

3.1 运行态
指当前任务正在运行.
3.2 就绪态
指当前任务正在等待调度,因为有个高优先级/同优先级的任务正在运行中
3.3 阻塞态
当前任务处于等待外部事件通知或通过vTaskDelay()函数进入休眠了,外部事件通知常见有信号量、等待队列、事件标志组、任务通知.
3.4 挂起态
类似于暂停,表示不会再参与任务调度了,通过vTaskSuspend()实现,重新恢复调度则使用xTaskResume()

4. FreeRTOS中断配置

4.1 回忆stm32 NVIC中断
Stm32可以设置NVIC中断组数为0~4,其中0~4区别在于如下图所示:、

比如我们设置为NVIC_PriorityGroup_4时:
表示抢占优先级为4bit(即为2^4,为0~15个抢占优先级),副优先级为0bit(表示没有).

4.2 抢占优先级和副优先级的区别:

• 1. 抢占优先级和副优先级的值越低,则优先级越高
• 2. 高的抢占优先级的中断可以直接打断低的抢占优先级的中断
• 3. 高的副优先级的中断不可以打断低的副优先级的中断(只是两个相同抢占优先级的中断同时来的时候,只会优先选择高的副优先级)

4.3 FreeRTOS中断配置宏

• configKERNEL_INTERRUPT_PRIORITY

用来配置中断最低抢占优先级,也就是可以FreeRTOS可以管理的最小抢占优先级,所以使用FreeRTOS时,我们尽量设置stm32为NVIC_PriorityGroup_4,这样就可以管理16个优先级了.

• configMAX_SYSCALL_INTERRUPT_PRIORITY

用来配置FreeRTOS能够安全管理的的最高优先级.比如原子的FreeRTOSConfig.h里就设置为5,而0~4的优先级中断就不会被FreeRTOS因为开关中断而禁止掉(一直都会有),并且不能调用RTOS中的”FromISR”结尾的API函数.比如喂看门狗中断函数就需要设置为0~4

• 如下图所示(来自原子手册):

4.3 FreeRTOS中断开关函数

portENABLE_INTERRUPTS();    
//开中断,将configMAX_SYSCALL_INTERRUPT_PRIORITY至 configKERNEL_INTERRUPT_PRIORITY之间的优先级中断打开

portDISABLE_INTERRUPTS();    
//关中断,将configMAX_SYSCALL_INTERRUPT_PRIORITY至 configKERNEL_INTERRUPT_PRIORITY之间的优先级中断禁止掉

5.任务常用API函数

5.1 xTaskCreate创建任务函数
定义如下:

xTaskCreate(    TaskFunction_t pxTaskCode,     //任务函数,用来供给函数指针调用的
const char * const pcName,   　　　　　　　　　　 //任务的字符串别名
const uint16_t usStackDepth,    　　　　　　　　 //任务堆栈深度,实际申请到的堆栈是该参数的4倍
void * const pvParameters,    　　　　　　　　   //函数参数,用来供给指针调用的
UBaseType_t uxPriority,    　　　　　　　　　　　　//优先级,越高优先级高,范围为0~configMAX_PRIORITIES-1 
　　　　　　　　　　　　　　　　　　　　　　　　　　　　//注意优先级0会创建为空闲任务, 优先级configMAX_PRIORITIES-1会创建一个软件定时器服务任务(管理定时器的)
TaskHandle_t * const pxCreatedTask ); //任务句柄,该句柄可以用于挂起/恢复/删除对应的任务

//返回值 errCOULD_NOT_ALLOCATE_REQUIRED_MEMORY(-1):表示创建任务堆空间不足pdPASS(1):创建成功

5.2 taskENTER_CRITICAL()和taskEXIT_CRITICAL()
用于任务中进入/退出临界区,调用taskENTER_CRITICAL()主要会关闭其他任务调度.而taskEXIT_CRITICAL()则会恢复任务调度,一般用于初始化外设等.

5.3 taskENTER_CRITICAL_FROM_ISR()和taskEXIT_CRITICAL_FROM_ISR()
用于在中断函数中进入/退出临界区,作用和上面一样

5.4 挂起/恢复/删除任务函数

void vTaskSuspend( TaskHandle_t xTaskToSuspend );  　　    //挂起一个任务,参数为挂起任务的句柄,如果为NULL则表示挂起自身任务


void vTaskResume( TaskHandle_t xTaskToResume );   　　　　//恢复一个任务


BaseType_t xTaskResumeFromISR( TaskHandle_t xTaskToResume);//从中断函数中恢复一个任务,返回1表示恢复成功


void vTaskDelete( TaskHandle_t xTaskToDelete );    　　//删除一个任务,如果从任务函数中退出的话,则需要调用vTaskDelete(NULL)来删除自身任务

5.5 vTaskDelay()延时函数

void vTaskDelay( const TickType_t xTicksToDelay );    //参数表示延时的系统滴答数

比如延时500ms可以写为: vTaskDelay( 500/portTICK_RATE_MS );
portTICK_RATE_MS是个宏,表示当前系统的1个滴答需要多少ms,而500/portTICK_RATE_MS则表示当前500ms需要多少个系统滴答数.

6. 队列
6.1简介
队列用于任务与任务或者任务与中断之间的通信.比如key任务检测到按键按下时,则可以通过队列向lcd显示任务发送信息,使得lcd切换界面.
队列采用先进先出存储机制.队列发送数据可以有两种方式:浅拷贝、深拷贝.

• 数据量不大的情况下,都使用深拷贝(会分配新的空间,并进行数据拷贝,缺点在于耗时)
• 数据量大的情况下,都使用浅拷贝(通过指针方式,前提是要发送的数据必须不会被释放的)

6.2队列的优点
队列可以通过任何任务或者中断进行访问,可以随时存取数据消息.
并且出入队的时候可以进行任务阻塞,比如某个任务进行读消息出队时,如果没有消息,则可以实现进入休眠状态,直到有消息才唤醒任务.

 

6.3队列创建删除相关API

QueueHandle_t xQueueCreate( uxQueueLength, uxItemSize );    
 //动态创建队列,内存会交给RTOS自动分配
 // uxQueueLength:队列长度(表示队列中最大多少条消息),uxItemSize:每个队列消息的长度(以字节为单位)
 //返回值: NULL(0, 表示分配失败),非0(表示返回该队列分配好的地址)
 //注意:使用自动分配时,需要配置configSUPPORT_DYNAMIC_ALLOCATION宏为1,否则只能由用户来分配.


QueueHandle_t xQueueCreateStatic( uxQueueLength, uxItemSize, pucQueueStorage, pxQueueBuffer );
//静态创建队列,内存需要由用户事先分配好
// uxQueueLength:队列长度(表示队列中最大多少条消息),uxItemSize:每个队列消息的长度(以字节为单位)
// pucQueueStorage:指向用户事先分配好的存储区内存(必须为uint8_t型)
// pxQueueBuffer:指向队列结构体,用来提供给RTOS初始化.然后给用户使用
//返回值: NULL(0, 表示分配失败),非0(表示返回该队列分配好的地址)

vQueueDelete( QueueHandle_t xQueue );
//删除队列,并释放空间

xQueueReset( xQueue );
//将队列里的消息清空一次,也就是恢复初始状态

6.4队列出入队相关API

xQueueSend( xQueue, pvItemToQueue, xTicksToWait );
//插入队尾,和xQueueSendToBack函数效果一致
// xQueue:队列句柄
//PvItemToQueue:消息数据,会通过数据拷贝到队列中,如果想使用浅拷贝,则可以发送一个变量来存储要真正发送的缓冲区地址即可.
// xTicksToWait:阻塞时间,单位为RTOS时钟滴答值,如果configTICK_RATE_HZ是1000,则填入的值表示阻塞的是多少ms,否则的话需要通过X/portTICK_RATE_MS来转换一下,才能实现阻塞Xms.
//xTicksToWait==0:表示入队满了,则直接退出该函数
// xTicksToWait==portMAX_DELAY:表示一直阻塞,直到队列有空位为止.
//注意: INCLUDE_vTaskSuspend宏必须为1,否则任务无法进入休眠状态实现阻塞效果.
//返回值: errQUEUE_FULL(队列已满) pdPASS(通过)


xQueueSendToFront( xQueue, pvItemToQueue, xTicksToWait );
//插入队头,参数和上面描述一致


xQueueSendToBack( xQueue, pvItemToQueue, xTicksToWait );
//插入队尾,参数和上面描述一致

xQueueOverwrite( xQueue, pvItemToQueue );
//将之前未出队的旧数据全部清空,然后再入队,该函数适用于长度为1的队列

xQueueReceive( xQueue, pvBuffer, xTicksToWait );
//从队列头部读出一个消息,并且这个消息会出队(删除掉)

xQueuePeek( xQueue, pvBuffer, xTicksToWait );
//从队列头部读出一个消息,但是这个消息不会出队(不会删除)

PS:这些API函数只能用于任务里调用,如果要在中断服务函数中调用,则在函数名后添加FromQueue即可,比如xQueueSendFromQueue()函数

6.5 中断发送/读取消息队列时,要注意的事情

使用中断相关的读写队列相关的API时,第3个参数是不一样的,比如xQueueSendFromISR():

 

• PxHigherPriorityTaskWoken

用来标记退出该函数后是否需要进行任务切换,因为我们发送队列时,有可能会将某个阻塞任务退出阻塞态,而此时又在中断中,所以当PxHigherPriorityTaskWoken为pdTRUE时,我们则必须进行一次任务切换.

可以通过portYIELD_FROM_ISR()来进行任务切换,并且我们不需要去判断PxHigherPriorityTaskWoken是否为pdTRUE,因为该函数内部有判断的,如下图所示: 

来个中断函数发送队列示例:

extern QueueHandle_t Message_Queue;                          //信息队列句柄

void USART1_IRQHandler(void)                       //串口1中断服务程序
{
         BaseType_t xHigherPriorityTaskWoken;          //定义任务切换标志位
         if(USART_GetITStatus(USART1, USART_IT_RXNE) != RESET) 
         {
                   //处理中断接收数据
         }


         if (Message_Queue!=NULL)             //判断Message_Queue是否已创建
         {
                   xQueueSendFromISR(Message_Queue, RX_BUF,&xHigherPriorityTaskWoken);
                         //向队列Message_Queue中发送RX_BUF
                   portYIELD_FROM_ISR(xHigherPriorityTaskWoken);
                         //通过portYIELD_FROM_ISR()判断是否需要切换任务
         }
}

PS:尽量将portYIELD_FROM_ISR()写在中断函数末尾处

6.6示例-任务之间的伪代码

按键任务向打印任务发送按键消息队列,代码如下:

QueueHandle_t Key_Queue; //按键值消息队列句柄

int main()
{
   //...省略N行代码

   Key_Queue=xQueueCreate(1,sizeof(u8)); //创建消息Key_Queue,长度为1
   
   //创建两个任务:key_task()、print_task()
   //...省略N行代码
}

key_task()    //获取按键值
{
　　while(1)
　　{
　　　　key=KEY_Scan(0); //扫描按键
　　　　if((Key_Queue!=NULL)&&(key))    //消息队列Key_Queue创建成功,并且按键被按下
　　　　{
　　　　　　err=xQueueSend(Key_Queue,&key,10);
　　　　　　if(err==errQUEUE_FULL) //发送按键值
　　　　　　{
　　　　　　　　printf("队列Key_Queue已满，数据发送失败!
");
　　　　　　}
　　　　}
　　　　vTaskDelay(10); //延时10个时钟节拍
　　}
}

print_task()    //打印按键值
{
　　u8 key;
　　while(1)
　　{
　　　　if(Key_Queue!=NULL)
　　　　{
　　　　　　if(xQueueReceive(Key_Queue,&key,portMAX_DELAY))//请求消息Key_Queue
　　　　　　{
　　　　　　　　printf("key=%d
",key);
　　　　　　}
　　　　} 
　　　　vTaskDelay(10); //延时10个时钟节拍    
　　}
}

7. RTOS软件定时器

7.1简介
在之前的任务创建的时候有讲到过,RTOS会自动创建一个优先级configMAX_PRIORITIES-1的软件定时器服务任务(管理定时器的).
所以我们写一个定时器回调函数时,则会被该定时器服务任务调用,所以在我们软件定时器函数中不能使用vTaskDelay()阻塞之类的API函数,否则会将系统中的定时器服务函数给阻塞掉.

7.2 FreeRTOSConfig.h相关的定时器配置

#define configUSE_TIMERS 1 　　　　　　　　　　   //为1时启用软件定时器


#define configTIMER_TASK_PRIORITY    31 　　   //设置软件定时器优先级可设置的值范围为0~31


#define configTIMER_QUEUE_LENGTH    5 　　　　  //软件定时器队列长度


#define configTIMER_TASK_STACK_DEPTH    200    //设置每个软件定时器任务堆栈大小

7.3定时创建相关API

TimerHandle_t xTimerCreateStatic(const char * const pcTimerName,    //定时器字符串别名
　　　　　　　　　　　　　　　　　　　　const TickType_t xTimerPeriodInTicks, 　　　　　　　　　
　　　　　　　　　　　　　　　　　　   //需要定时的周期值,比如通过200/ portTICK_RATE_MS来转换实现定时200毫秒
　　　　　　　　　　　　　　　　　　　　const UBaseType_t uxAutoReload, 　　　　　　　
　　　　　　　　　　　　　　　　　　　//是否重载(周期性/单次性),若为pdTRUE(1)表示为周期性,为pdFALSE(0)表示为单次
　　　　　　　　　　　　　　　　　　　　void * const pvTimerID, 
　　　　　　　　　　　　　　　　　　　　//定时器ID号,一般用于多个定时器共用一个定时器回调函数,否则填0即可
　　　　　　　　　　　　　　　　　　　　TimerCallbackFunction_t pxCallbackFunction);//定时器回调函数

xTimerDelete( xTimer, xTicksToWait );
//删除定时器
//xTicksToWait:指定该定时器在多少时钟节拍数之前删除掉,为0则立即删除,一般设为100(如果设为0,则如果在该操作之前还有其它设置定时器操作的话,则不会进行阻塞等待,从而返回false)

7.4 定时器其它常用API

xTimerChangePeriod( xTimer, xNewPeriod, xTicksToWait );
//修改定时器周期,在中断中则使用xTimerChangePeriodFromISR()
// xNewPeriod:要修改的周期值 
//xTicksToWait:指定该定时器在多少时钟节拍数之前修改好,为0则立即删除
//xTimerReset( xTimer, xTicksToWait );
//复位定时器,让定时器重新计数,在中断中则使用xTimerResetFromISR()
// xTicksToWait:和上面内容类似

xTimerStart( xTimer, xTicksToWait );
//启动定时器,如果定时器正在运行的话调用该函数的结果和xTimerReset()一样, 在中断中则使用xTimerResetFromISR ()

xTimerStop( xTimer, xTicksToWait );
//停止定时器, 在中断中则使用xTimerStopFromISR ()

 PS:在中断中使用定时器API时,同样和队列一样,也需要在函数末尾通过portYIELD_FROM_ISR()进行一次任务切换判断

 

8. 信号量

在项目中我们一般用二值信号量,用来同步数据的.

比如任务A要向任务B发送一个很大的数据buf,而用队列的话会进行复制拷贝,从而占用大量时间.

此时我们不妨定义一个全局数据buf,任务A修改这个buf,发送一个信号量给任务B,任务B就去读取这个全局数据buf即可.从而省去了队列复制拷贝的时间.

8.1定义信号量举例

SemaphoreHandle_t BinarySemaphore;       //二值信号量句柄

BinarySemaphore=xSemaphoreCreateBinary();            //创建二值信号量

 8.2在中断中发送信号量过程

BaseType_t xHigherPriorityTaskWoken;

xSemaphoreGiveFromISR(BinarySemaphore,&xHigherPriorityTaskWoken);
//发送二值信号量

portYIELD_FROM_ISR(xHigherPriorityTaskWoken);//如果需要的话进行一次任务切换

 8.3在任务中发送信号量过程

xSemaphoreGive(BinarySemaphore);
//返回值: pdPASS(0, 表示发送成功,如果信号量一直未处理,则会返回值失败FULL)

8.4 在任务中接收信号量过程

err=xSemaphoreTake(BinarySemaphore,portMAX_DELAY);          //获取信号量
// portMAX_DELAY:进入阻塞态一直等待获取
//返回值为pdTRUE(OK)  pdFALSE(err)