HarmonyOS系统内核中使用事件标志的方法
大家好,今天主要和大家聊一聊,如何利用HarmonyOS系统中事件标志。
目录
第一:事件标志简介
第二:事件标志API分析
第三:软件设计
第四:编译与调试
第五:运行结果
第一:事件标志简介
每个事件标志由一个位表示,每个事件标志按照32个字节为一组的形式排列,线程可以同时对组中的所有32个事件标记执行操作。
第二:事件标志API分析
osEventFlagsNew()
osEventFlagsId_t osEventFlagsNew(const osEventFlagsAttr_t *attr)
功能描述:
osEventFlagsNew函数创建了一个新的事件标志对象,用于跨线程发送事件,并返回事件标志对象标识符的指针,或者在出现错误时返回NULL。可以在RTOS启动(调用osKernelStart)之前安全地调用该函数,但不能在内核初始化(调用osKernellnitialize)之前调用该函数。
注意:不能在中断服务函数中调用。
参数:
名字 | 描述 |
---|---|
attr | 事件标志属性;空:默认值. |
osEventFlagsSet()
uint32_t osEventFlagsSet(osEventFlagsId_t ef_id,uint32_t flags)
功能描述:osEventFlagsSet函数在一个由参数ef_id指定的事件标记对象中设置由参数flags指定的事件标记。
注意:不能在中断服务中调用该函数
参数:
名字 | 描述 |
---|---|
ef_id | 事件标志由osEventFlagsNew获得的ID. |
flags | 指定设置的标志. |
osEventFlagsWait()
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表示不超时 |
第三:软件设计
在Event_example函数中,通过osEventFlagsNew()函数创建了事件标记ID,Thread_EventReceiver()函数中通过osEventFlagsWait()函数一直将线程置于阻塞状态,等待事件标记。在Thread_EventSender()函数中通过osEventFlagsSet()函数每隔1S设置的标志,实现任务间的同步。
void Thread_EventSender (void *argument) { (void)argument; while (1) { osEventFlagsSet(evt_id, FLAGS_MSK1); osThreadYield();// suspend thread osDelay(100); }} void Thread_EventReceiver (void *argument) { (void)argument; uint32_t flags; while (1) { flags = osEventFlagsWait(evt_id, FLAGS_MSK1, osFlagsWaitAny, osWaitForever); printf("Receive Flags is %d\n",flags); }} static void Event_example (void) { evt_id = osEventFlagsNew(NULL); if (evt_id == NULL) { printf("Falied to create EventFlags!\n"); } osThreadAttr_t attr; attr.attr_bits = 0U; attr.cb_mem = NULL; attr.cb_size = 0U; attr.stack_mem = NULL; attr.stack_size = 1024*4; attr.priority = 25; attr.name = "Thread_EventSender"; if (osThreadNew(Thread_EventSender, NULL, &attr) == NULL) { printf("Falied to create Thread_EventSender!\n"); } attr.name = "Thread_EventReceiver"; if (osThreadNew(Thread_EventReceiver, NULL, &attr) == NULL) { printf("Falied to create Thread_EventReceiver!\n"); }}
第四:编译与调试
修改 BUILD.gn 文件
修改 applications\BearPi\BearPi-HM_Nano\sample
路径下 BUILD.gn 文件,指定 event_example
参与编译。
#"A1_kernal_thread:thread_example",#"A2_kernel_timer:timer_example","A3_kernel_event:event_example",#"A4_kernel_mutex:mutex_example",#"A5_kernel_semaphore:semaphore_example",#"A6_kernel_message:message_example",
第五:运行结果
示例代码编译烧写后,按下开发板的RESET按键,通过串口助手查看日志,会每隔1S输出一次日志。
Receive Flags is 1Receive Flags is 1Receive Flags is 1Receive Flags is 1Receive Flags is 1