之前介紹了使用信號(hào)量來完成同步,但是使用信號(hào)量來同步的話,任務(wù)只能與單個(gè)的事件或任務(wù)進(jìn)行同步。有時(shí)候某個(gè)任務(wù)可能會(huì)需要與多個(gè)事件或任務(wù)進(jìn)行同步,此時(shí)信號(hào)量就無能為力了。FreeRTOS 提供了一個(gè)可選的解決方法,那就是事件標(biāo)志組。
事件標(biāo)志位可以理解為一個(gè)Bit位,多個(gè)事件位就組成了事件標(biāo)志組,F(xiàn)reeRTOS可選8個(gè)事件標(biāo)志位或者24個(gè)事件標(biāo)志位,具體是由configUSE_16_BIT_TICKS來確定,它為1的時(shí)候是8個(gè)標(biāo)準(zhǔn)位,為0時(shí)是24個(gè)標(biāo)志位!
創(chuàng)建標(biāo)志組
EventGroupHandle_t xEventGroupCreate( void );
返回值:
創(chuàng)建失敗返回NULL,創(chuàng)建成功返回句柄
置位API函數(shù)
EventBits_t xEventGroupSetBits( EventGroupHandle_t xEventGroup,
const EventBits_t uxBitsToSet );
xEventGroup:需要操作的事件標(biāo)志組的句柄
uxBitsToSet:寫入數(shù)值,例如0x09就表示置位第0位和第三位
讀取事件組的位
EventBits_t xEventGroupWaitBits( const EventGroupHandle_t xEventGroup,
const EventBits_t uxBitsToWaitFor,
const BaseType_t xClearOnExit,
const BaseType_t xWaitForAllBits,
TickType_t xTicksToWait );
參數(shù):
xEventGroup:事件標(biāo)志組的句柄
uxBitsToWaitFor:需要等待的標(biāo)志位
xClearOnExit:是否需要清除標(biāo)志位
xWaitForAllBits:是否等待所有設(shè)定標(biāo)志位
xTicksToWait:最大等待時(shí)間
注意:更多API函數(shù),請(qǐng)參考官方相關(guān)
附上簡(jiǎn)單使用應(yīng)用
#include "stm32f10x.h"
#include
#include "FreeRTOS.h"
#include "task.h"
#include "event_groups.h"
#define START_TASK_PRIO 1 //任務(wù)優(yōu)先級(jí)
#define START_STK_SIZE 128 //任務(wù)堆棧大小
TaskHandle_t StartTask_Handler; //任務(wù)句柄
void start_task(void *pvParameters);//任務(wù)函數(shù)
#define LED0_TASK_PRIO 2 //任務(wù)優(yōu)先級(jí)
#define LED0_STK_SIZE 50 //任務(wù)堆棧大小
TaskHandle_t LED0Task_Handler; //任務(wù)句柄
void led0_task(void *p_arg); //任務(wù)函數(shù)
EventGroupHandle_t Event_Handle = NULL;//事件標(biāo)志組的句柄
void LED_Init(void)
{
GPIO_InitTypeDef GPIO_InitStructure; //定義結(jié)構(gòu)體變量
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC,ENABLE); //開啟時(shí)鐘
GPIO_InitStructure.GPIO_Pin=GPIO_Pin_0; //選擇你要設(shè)置的IO口
GPIO_InitStructure.GPIO_Mode=GPIO_Mode_Out_PP; //設(shè)置推挽輸出模式
GPIO_InitStructure.GPIO_Speed=GPIO_Speed_50MHz; //設(shè)置傳輸速率
GPIO_Init(GPIOC,&GPIO_InitStructure); //初始化GPIO
GPIO_SetBits(GPIOC,GPIO_Pin_0); //將LED端口拉高,熄滅LED
}
int main( void )
{
NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);//設(shè)置系統(tǒng)中斷優(yōu)先級(jí)分組 4
LED_Init(); //初始化 LED
//創(chuàng)建任務(wù)標(biāo)志組
Event_Handle = xEventGroupCreate();
//置位標(biāo)志位
xEventGroupSetBits( ( EventGroupHandle_t) Event_Handle,
( EventBits_t ) 0x08 );
//創(chuàng)建開始任務(wù)
xTaskCreate(
(TaskFunction_t )start_task, //任務(wù)函數(shù)
(const char* )"start_task", //任務(wù)名稱
(uint16_t )START_STK_SIZE, //任務(wù)堆棧大小
(void* )NULL, //傳遞給任務(wù)函數(shù)的參數(shù)
(UBaseType_t )START_TASK_PRIO, //任務(wù)優(yōu)先級(jí)
(TaskHandle_t* )&StartTask_Handler //任務(wù)句柄
);
vTaskStartScheduler(); //開啟調(diào)度
}
//開始任務(wù)函數(shù)
void start_task(void *pvParameters)
{
taskENTER_CRITICAL(); //進(jìn)入臨界區(qū)
//創(chuàng)建 LED0 任務(wù)
xTaskCreate(
(TaskFunction_t )led0_task,
(const char* )"led0_task",
(uint16_t )LED0_STK_SIZE,
(void* )NULL,
(UBaseType_t )LED0_TASK_PRIO,
(TaskHandle_t* )&LED0Task_Handler
);
vTaskDelete(StartTask_Handler); //刪除開始任務(wù)
taskEXIT_CRITICAL(); //退出臨界區(qū)
}
//LED0 任務(wù)函數(shù)
void led0_task(void *pvParameters)
{
while(1)
{
xEventGroupWaitBits( ( EventGroupHandle_t ) Event_Handle, //句柄
( EventBits_t ) 0x08, //需要等待的位
( BaseType_t ) pdTRUE , //需要清零
( BaseType_t ) pdTRUE, //等待所有設(shè)定標(biāo)志位
( TickType_t ) portMAX_DELAY );//死等待
if(GPIO_ReadInputDataBit( GPIOC, GPIO_Pin_0))
{
GPIO_ResetBits( GPIOC, GPIO_Pin_0);
}
else
{
GPIO_SetBits( GPIOC, GPIO_Pin_0);
}
//置位標(biāo)志位
xEventGroupSetBits( ( EventGroupHandle_t) Event_Handle,
( EventBits_t ) 0x08 );
vTaskDelay(400);
}
}
注意:如果LED0任務(wù)中的置位函數(shù),那么LED0函數(shù)只會(huì)運(yùn)行一次,因?yàn)闃?biāo)志位已經(jīng)清除了,需要再次置位標(biāo)志位才會(huì)繼續(xù)運(yùn)行!
--END--
-
FreeRTOS
+關(guān)注
關(guān)注
12文章
484瀏覽量
62278 -
信號(hào)量
+關(guān)注
關(guān)注
0文章
53瀏覽量
8364 -
事件標(biāo)志組
+關(guān)注
關(guān)注
0文章
3瀏覽量
1304
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
評(píng)論