Hi3861 OpenHarmony嵌入式应用入门--LiteOS Event

CMSIS 2.0接口使用事件标志是实时操作系统（RTOS）中一种重要的同步机制。事件标志是一种轻量级的同步原语，用于任务间或中断服务程序（ISR）之间的通信。每个事件标志对象可以包含多个标志位，通常最多为31个（因为第31位通常保留）。

注意事项

在使用事件标志时，需要注意避免竞态条件，确保在多任务环境中正确同步。

osEventFlagsWait函数支持超时机制，可以根据需要设置合适的超时时间。

可以在中断服务程序（ISR）中安全地调用与事件标志相关的函数，但需要注意中断嵌套和优先级问题。

通过CMSIS 2.0接口的事件标志功能，开发人员可以更加灵活地实现任务间的同步和通信，提高系统的效率和稳定性。

EventFlags API分析

osEventFlagsId_t osEventFlagsNew(const osEventFlagsAttr_t *attr)

描述：

osEventFlagsNew函数创建了一个新的事件标志对象，用于跨线程发送事件，并返回事件标志对象标识符的指针，或者在出现错误时返回NULL。可以在RTOS启动(调用 osKernelStart)之前安全地调用该函数，但不能在内核初始化 (调用 osKernelInitialize)之前调用该函数。

注意 :不能在中断服务调用该函数。

参数：

参数名	描述
attr	事件标志属性;空:默认值.

uint32_t osEventFlagsSet(osEventFlagsId_t ef_id,uint32_t flags)

描述：

osEventFlagsSet函数在一个由参数ef_id指定的事件标记对象中设置由参数flags指定的事件标记。

注意 :不能在中断服务调用该函数。

参数：

参数名	描述
ef_id	事件标志由osEventFlagsNew获得的ID 。
flags	指定设置的标志。

uint32_t osEventFlagsWait(osEventFlagsId_t ef_id,uint32_t flags,uint32_t options,uint32_t timeout)

描述：

osEventFlagsWait函数挂起当前运行线程，直到设置了由参数ef_id指定的事件对象中的任何或所有由参数flags指定的事件标志。当这些事件标志被设置，函数立即返回。否则，线程将被置于阻塞状态。

注意 :如果参数timeout设置为0，可以从中断服务例程调用。

参数：

参数名	描述
ef_id	事件标志由osEventFlagsNew获得的ID。
flags	指定要等待的标志。
options	指定标记选项。
timeout	超时时间，0表示不超时。

代码编写

修改D:\DevEcoProjects\test\src\vendor\rtplay\rt_hi3861\demo\BUILD.gn文件

# Copyright (c) 2023 Beijing HuaQing YuanJian Education Technology Co., Ltd
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# 
#    http://www.apache.org/licenses/LICENSE-2.0
# 
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License. import("//build/lite/config/component/lite_component.gni")lite_component("demo") {features = [#"base_00_helloworld:base_helloworld_example",#"base_01_led:base_led_example",#"base_02_loopkey:base_loopkey_example",#"base_03_irqkey:base_irqkey_example",#"base_04_adc:base_adc_example",#"base_05_pwm:base_pwm_example",#"base_06_ssd1306:base_ssd1306_example",#"kernel_01_task:kernel_task_example",#"kernel_02_timer:kernel_timer_example","kernel_03_event:kernel_event_example",]
}

创建D:\DevEcoProjects\test\src\vendor\rtplay\rt_hi3861\demo\kernel_03_event文件夹

文件夹中创建D:\DevEcoProjects\test\src\vendor\rtplay\rt_hi3861\demo\kernel_03_event\kernel_event_example.c文件D:\DevEcoProjects\test\src\vendor\rtplay\rt_hi3861\demo\kernel_03_event\BUILD.gn文件

# Copyright (c) 2023 Beijing HuaQing YuanJian Education Technology Co., Ltd
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License. static_library("kernel_event_example") {sources = ["kernel_event_example.c",]include_dirs = ["//utils/native/lite/include","//kernel/liteos_m/kal/cmsis",]
}

/** Copyright (c) 2023 Beijing HuaQing YuanJian Education Technology Co., Ltd* Licensed under the Apache License, Version 2.0 (the "License");* you may not use this file except in compliance with the License.* You may obtain a copy of the License at**    http://www.apache.org/licenses/LICENSE-2.0** Unless required by applicable law or agreed to in writing, software* distributed under the License is distributed on an "AS IS" BASIS,* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.* See the License for the specific language governing permissions and* limitations under the License.*/#include <stdio.h>
#include <unistd.h>#include "ohos_init.h"
#include "cmsis_os2.h"osThreadId_t Task1_ID; //  任务1 ID
osThreadId_t Task2_ID; //  任务2 ID
osEventFlagsId_t event_ID;  // 事件 ID
uint32_t event1_Flags = 0x00000001U;  // 事件掩码 每一位代表一个事件
uint32_t event2_Flags = 0x00000002U;  // 事件掩码 每一位代表一个事件
uint32_t event3_Flags = 0x00000004U;  // 事件掩码 每一位代表一个事件
#define TASK_STACK_SIZE 1024
#define TASK_DELAY_TIME 1 // s/*** 注意： 任务延时不能使用osDelay，这个函数延时有问题*//*** @description: 任务1 用于发送事件* @param {*}* @return {*}*/
void Task1(void)
{while (1) {printf("enter Task 1.......\n");osEventFlagsSet(event_ID, event1_Flags);        // 设置事件标记printf("send eventFlag1.......\n");sleep(TASK_DELAY_TIME); // 1秒osEventFlagsSet(event_ID, event2_Flags);        // 设置事件标记printf("send eventFlag2.......\n");sleep(TASK_DELAY_TIME); // 1秒osEventFlagsSet(event_ID, event3_Flags);        // 设置事件标记printf("send eventFlag3.......\n");sleep(TASK_DELAY_TIME); // 1秒}
}
/*** @description: 任务2 用于接受事件* @param {*}* @return {*}*/
void Task2(void)
{uint32_t flags = 0;while (1) {// 永远等待事件标记触发，当接收到 event1_Flags 和 event2_Flags 和 event3_Flags时才会执行printf函数// osFlagsWaitAll ：全部事件标志位接收到    osFlagsWaitAny: 任意一个事件标志位接收到// 当只有一个事件的时候，事件的类型选择哪个都可以flags = osEventFlagsWait(event_ID,  event1_Flags | event2_Flags | event3_Flags, osFlagsWaitAll, osWaitForever);printf("receive event is OK\n");        // 事件已经标记}
}
/*** @description: 初始化并创建任务* @param {*}* @return {*}*/
static void kernel_event_example(void)
{printf("Enter kernel_event_example()!\n");event_ID = osEventFlagsNew(NULL);       // 创建事件if (event_ID != NULL) {printf("ID = %d, Create event_ID is OK!\n", event_ID);}osThreadAttr_t taskOptions;taskOptions.name = "Task1";              // 任务的名字taskOptions.attr_bits = 0;               // 属性位taskOptions.cb_mem = NULL;               // 堆空间地址taskOptions.cb_size = 0;                 // 堆空间大小taskOptions.stack_mem = NULL;            // 栈空间地址taskOptions.stack_size = TASK_STACK_SIZE;           // 栈空间大小 单位:字节taskOptions.priority = osPriorityNormal; // 任务的优先级Task1_ID = osThreadNew((osThreadFunc_t)Task1, NULL, &taskOptions);      // 创建任务1if (Task1_ID != NULL) {printf("ID = %d, Create Task1_ID is OK!\n", Task1_ID);}taskOptions.name = "Task2";              // 任务的名字Task2_ID = osThreadNew((osThreadFunc_t)Task2, NULL, &taskOptions);      // 创建任务2if (Task2_ID != NULL) {printf("ID = %d, Create Task2_ID is OK!\n", Task2_ID);}
}
SYS_RUN(kernel_event_example);

使用build，编译成功后，使用upload进行烧录。