1.队列集简介
一个队列只允许任务间传递的消息为同一种数据类型,如果需要在任务间传递不同数据类型的消息时,那么就可以使用队列集,作用:用于对多个队列或信号量进行“监听”,其中不管哪一个消息到来,都可让任务退出阻塞状态
【个人理解:将多个队列/信号量并行放在同一个容器内,监听容器内的信号,有任意一个队列/信号量来信号都可以推出阻塞】
2.队列集相关API函数介绍
- xQueueCreateSet():创建队列集
- xQueueAddToSet():队列添加到队列集中
- xQueueRemoveFromSet():从队列集中移除队列
- xQueueSelectFromSet():获取队列集中有效消息的队列
- xQueueSelectFromSetFromlSR():在中断中获取队列集中有有效消息的队列
2.1.创建队列集xQueueCreateSet()
QueueSetHandle_t xQueueCreateSet(const UBaseType_t uxEventQueueLength);
- 形参uxEventQueueLength:队列集可容纳的队列数量
- 返回值:NULL,队列集创建失败;其他值,队列集创建成功,返回队列集句柄
2.2.队列添加到队列集中xQueueAddToSet()
BaseType_t xQueueAddToSet( QueueSetMemberHandle_t xQueueOrSemaphore ,
QueueSetHandle_t xQueueSet);
- 注意,队列在被添加到队列集之前,队列中不能有有效的消息
- 形参xQueueOrSemaphore:待添加的队列句柄
- 形参xQueueSet:队列集(或信号量)
- 返回值:pdPASS,队列集添加队列成功;pdFAIL,队列集添加队列失败
2.3.从队列集中移除队列xQueueRemoveFromSet()
BaseType_t xQueueRemoveFromSet( QueueSetMemberHandle_t xQueueOrSemaphore ,
QueueSetHandle_t xQueueSet );
- 注意,队列在被添加到队列集之前,队列中不能有有效的消息
- 形参xQueueOrSemaphore:待添加的队列句柄
- 形参xQueueSet:队列集
- 返回值:pdPASS,队列集移除队列成功;pdFAIL,队列集移除队列失败
2.4.获取队列集中有效消息的队列xQueueSelectFromSet()
QueueSetMemberHandle_t xQueueSelectFromSet( QueueSetHandle_t xQueueSet,
TickType_t const xTicksToWait )
- 形参xQueueSet:队列集
- 形参xTicksToWait:阻塞超时事件
- 返回值:pdPASS,获取消息成功;pdFAIL,获取消息失败
3.队列集操作实验
- 实验目的:学习 FreeRTOS 的队列集相关API的使用。
- 实验设计:将设计三个任务:start_task、task1、task2
start_task-用来创建其它任务,并创建队列集,队列/信号量,将队列/信号量添加到队列集中
task1-用于扫描按键,当KEY0按下,往队列写入数据,当KEY1按下,释放二值信号量
task2-读取队列集中的消息,并打印