【学习FreeRTOS】第15章——FreeRTOS队列集

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-读取队列集中的消息，并打印