STM32

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 添加头文件路径

• 添加FreeRTOS\include

• 添加FreeRTOS\portable\RVDS\ARM_CM3

• 并将原子中的FreeRTOSConfig.h也复制到我们项目的FreeRTOS\include中(用来配置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 挂起/恢复/删除任务函数

 vTaskSuspend( TaskHandle_t xTaskToSuspend );  　　    

 vTaskResume( TaskHandle_t xTaskToResume );   　　　　BaseType_t xTaskResumeFromISR( TaskHandle_t xTaskToResume); vTaskDelete( TaskHandle_t xTaskToDelete );    　　

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,因为该函数内部有判断的,如下图所示: 

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

 QueueHandle_t Message_Queue;                           USART1_IRQHandler()                       
         (USART_GetITStatus(USART1, USART_IT_RXNE) != (Message_Queue!=NULL)             &

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已满，数据发送失败!\r\n'); 　　　　　　} 　　　　} 　　　　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\r\n',key); 　　　　　　} 　　　　} 　　　　vTaskDelay(10); //延时10个时钟节拍 　　} }

7. RTOS软件定时器

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

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

 configUSE_TIMERS 1 　　　　　　　　　　    configTIMER_TASK_PRIORITY    31 　　    configTIMER_QUEUE_LENGTH    5 　　　　   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)