鸿蒙轻内核M核源码分析系列十二事件Event

想了解更多内容，请访问：

公司专注于为企业提供成都做网站、网站建设、微信公众号开发、商城网站建设，小程序开发，软件按需网站建设等一站式互联网企业服务。凭借多年丰富的经验，我们会仔细了解各客户的需求而做出多方面的分析、设计、整合，为客户设计出具风格及创意性的商业解决方案，成都创新互联更提供一系列网站制作和网站推广的服务。

和华为官方合作共建的鸿蒙技术社区

https://harmonyos.

事件(Event)是一种任务间通信的机制，可用于任务间的同步。多任务环境下，任务之间往往需要同步操作，一个等待即是一个同步。事件可以提供一对多、多对多的同步操作。本文通过分析鸿蒙轻内核事件模块的源码，深入掌握事件的使用。

接下来，我们看下事件的结构体，事件初始化，事件常用操作的源代码。

1、事件结构体定义和常用宏定义

1.1 事件结构体定义

在文件kernel\include\los_event.h定义的事件控制块结构体为EVENT_CB_S，结构体源代码如下，结构体成员的解释见注释部分。

 
 
 
 
    
  
  
  
  
  1. typedef struct tagEvent { 
    2. 
  
  
  
  
  2.     UINT32 uwEventID;        /**< 事件ID，每一位标识一种事件类型 */ 
    3. 
  
  
  
  
  3.     LOS_DL_LIST stEventList; /**< 读取事件的任务链表 */ 
    4. 
  
  
  
  
  4. } EVENT_CB_S, *PEVENT_CB_S; 
    5.

 1.2 事件常用宏定义

在读事件时，可以选择读取模式。读取模式由如下几个宏定义：

所有事件(LOS_WAITMODE_AND)：

逻辑与，基于接口传入的事件类型掩码eventMask，只有这些事件都已经发生才能读取成功，否则该任务将阻塞等待或者返回错误码。

任一事件(LOS_WAITMODE_OR)：

逻辑或，基于接口传入的事件类型掩码eventMask，只要这些事件中有任一种事件发生就可以读取成功，否则该任务将阻塞等待或者返回错误码。

清除事件(LOS_WAITMODE_CLR)：

这是一种附加读取模式，需要与所有事件模式或任一事件模式结合使用(LOS_WAITMODE_AND | LOS_WAITMODE_CLR或 LOS_WAITMODE_OR | LOS_WAITMODE_CLR)。在这种模式下，当设置的所有事件模式或任一事件模式读取成功后，会自动清除事件控制块中对应的事件类型位。

 
 
 
 
    
  
  
  
  
  1. #define LOS_WAITMODE_AND                   (4) 
    2. 
  
  
  
  
  2.  
    3. 
  
  
  
  
  3.   #define LOS_WAITMODE_OR                    (2) 
    4. 
  
  
  
  
  4.  
    5. 
  
  
  
  
  5.   #define LOS_WAITMODE_CLR                   (1) 
    6.

 2、事件常用操作

2.1 初始化事件

在使用事件前，必须使用函数UINT32 LOS_EventInit(PEVENT_CB_S eventCB)来初始化事件，需要的参数是结构体指针变量PEVENT_CB_S eventCB。分析下代码，⑴处表示传入的参数不能为空，否则返回错误码。⑵处把事件编码.uwEventID初始化为0，然后初始化双向循环链表.stEventList，用于挂载读取事件的任务。

 
 
 
 
    
  
  
  
  
  1. LITE_OS_SEC_TEXT_INIT UINT32 LOS_EventInit(PEVENT_CB_S eventCB) 
    2. 
  
  
  
  
  2. { 
    3. 
  
  
  
  
  3. ⑴  if (eventCB == NULL) { 
    4. 
  
  
  
  
  4.         return LOS_ERRNO_EVENT_PTR_NULL; 
    5. 
  
  
  
  
  5.     } 
    6. 
  
  
  
  
  6. ⑵  eventCB->uwEventID = 0; 
    7. 
  
  
  
  
  7.     LOS_ListInit(&eventCB->stEventList); 
    8. 
  
  
  
  
  8.     OsHookCall(LOS_HOOK_TYPE_EVENT_INIT); 
    9. 
  
  
  
  
  9.     return LOS_OK; 
    10. 
  
  
  
  
  10. } 
    11.

 2.2 校验事件掩码

我们可以使用函数UINT32 LOS_EventPoll(UINT32 *eventId, UINT32 eventMask, UINT32 mode)来校验事件掩码，需要的参数为事件结构体的事件编码eventId、用户传入的待校验的事件掩码eventMask及读取模式mode，返回用户传入的事件是否发生: 返回值为0时，表示用户预期的事件没有发生，否则表示用户期望的事件发生。

我们看下源码，⑴处先检查传入参数的合法性，事件编码不能为空。然后执行⑵处的代码进行校验。如果是任一事件读取模式，接下来的判断不等于表示至少有一个事件发生了，返回值ret就表示哪些事件发生了。⑶如果是所有事情读取模式，当逻辑与运算*eventId & eventMask还等于eventMask时，表示期望的事件全部发生了，返回值ret就表示哪些事件发生了。⑷处当ret不为0，期望的事件发生，并且是清除事件读取模式时，需要把已经发生的事情进行清除。看来，这个函数不仅仅是查询事件有没有发生，还会有更新事件编码的动作。

 
 
 
 
    
  
  
  
  
  1. LITE_OS_SEC_TEXT UINT32 LOS_EventPoll(UINT32 *eventID, UINT32 eventMask, UINT32 mode) 
    2. 
  
  
  
  
  2. { 
    3. 
  
  
  
  
  3.     UINT32 ret = 0; 
    4. 
  
  
  
  
  4.     UINT32 intSave; 
    5. 
  
  
  
  
  5.  
    6. 
  
  
  
  
  6. ⑴  if (eventID == NULL) { 
    7. 
  
  
  
  
  7.         return LOS_ERRNO_EVENT_PTR_NULL; 
    8. 
  
  
  
  
  8.     } 
    9. 
  
  
  
  
  9.     intSave = LOS_IntLock(); 
    10. 
  
  
  
  
  10. ⑵  if (mode & LOS_WAITMODE_OR) { 
    11. 
  
  
  
  
  11.         if ((*eventID & eventMask) != 0) { 
    12. 
  
  
  
  
  12.             ret = *eventID & eventMask; 
    13. 
  
  
  
  
  13.         } 
    14. 
  
  
  
  
  14.     } else { 
    15. 
  
  
  
  
  15. ⑶      if ((eventMask != 0) && (eventMask == (*eventID & eventMask))) { 
    16. 
  
  
  
  
  16.             ret = *eventID & eventMask; 
    17. 
  
  
  
  
  17.         } 
    18. 
  
  
  
  
  18.     } 
    19. 
  
  
  
  
  19. ⑷  if (ret && (mode & LOS_WAITMODE_CLR)) { 
    20. 
  
  
  
  
  20.         *eventID = *eventID & ~(ret); 
    21. 
  
  
  
  
  21.     } 
    22. 
  
  
  
  
  22.     LOS_IntRestore(intSave); 
    23. 
  
  
  
  
  23.     return ret; 
    24. 
  
  
  
  
  24. } 
    25.

2.3 读/写事件

2.3.1 读取指定事件类型

我们可以使用函数LOS_EventRead()来读取事件，需要4个参数。eventCB是初始化好的事件结构体，eventMask表示需要读取的事件掩码，mode是上文说明过的读取模式，timeout是读取超时，单位是Tick。函数返回0时，表示期望的事件没有发生，读取事件失败，进入阻塞。返回非0时表示期望的事件发生了，成功读取事件。下面我们分析下函数的源码来看看如何读取事件的。

⑴处调用函数OsEventReadParamCheck()进行基础的校验，比如第25位保留不能使用，事件掩码eventMask不能为零，读取模式组合是否合法。⑵处表示不能中断中读取事件。⑶处调用校验函数OsEventPoll()检查事件eventMask是否发生。如果事件发生ret不为0，成功读取直接返回。ret为0，事件没有发生时，执行⑷，如果超时时间timeout为0，调用者不能等待时，直接返回。⑸如果锁任务调度时，不能读取事件，返回错误码。

⑹更新当前任务的阻塞的事件掩码.eventMask和事件读取模式.eventMode。执行⑺调用函数OsSchedTaskWait更改当前任务的状态为阻塞状态，挂载到事件的任务阻塞链表上。如果timeout不是永久等待，还会把任务设置为OS_TASK_STATUS_PEND_TIME状态并设置等待时间。⑻处触发任务调度，后续程序需要等到读取到事件才会继续执行。

⑼如果等待时间超时，事件还不可读，本任务读取不到指定的事件时，返回错误码。如果可以读取到指定的事件时，执行⑽，检查事件eventMask是否发生，然后返回结果值。

 
 
 
 
    
  
  
  
  
  1. LITE_OS_SEC_TEXT UINT32 LOS_EventRead(PEVENT_CB_S eventCB, UINT32 eventMask, UINT32 mode, UINT32 timeOut) 
    2. 
  
  
  
  
  2. { 
    3. 
  
  
  
  
  3.     UINT32 ret; 
    4. 
  
  
  
  
  4.     UINT32 intSave; 
    5. 
  
  
  
  
  5.     LosTaskCB *runTsk = NULL; 
    6. 
  
  
  
  
  6.  
    7. 
  
  
  
  
  7. ⑴  ret = OsEventReadParamCheck(eventCB, eventMask, mode); 
    8. 
  
  
  
  
  8.     if (ret != LOS_OK) { 
    9. 
  
  
  
  
  9.         return ret; 
    10. 
  
  
  
  
  10.     } 
    11. 
  
  
  
  
  11.  
    12. 
  
  
  
  
  12. ⑵  if (OS_INT_ACTIVE) { 
    13. 
  
  
  
  
  13.         return LOS_ERRNO_EVENT_READ_IN_INTERRUPT; 
    14. 
  
  
  
  
  14.     } 
    15. 
  
  
  
  
  15.     intSave = LOS_IntLock(); 
    16. 
  
  
  
  
  16. ⑶  ret = LOS_EventPoll(&(eventCB->uwEventID), eventMask, mode); 
    17. 
  
  
  
  
  17.     OsHookCall(LOS_HOOK_TYPE_EVENT_READ, eventCB, eventMask, mode); 
    18. 
  
  
  
  
  18.     if (ret == 0) { 
    19. 
  
  
  
  
  19. ⑷      if (timeOut == 0) { 
    20. 
  
  
  
  
  20.             LOS_IntRestore(intSave); 
    21. 
  
  
  
  
  21.             return ret; 
    22. 
  
  
  
  
  22.         } 
    23. 
  
  
  
  
  23.  
    24. 
  
  
  
  
  24. ⑸      if (g_losTaskLock) { 
    25. 
  
  
  
  
  25.             LOS_IntRestore(intSave); 
    26. 
  
  
  
  
  26.             return LOS_ERRNO_EVENT_READ_IN_LOCK; 
    27. 
  
  
  
  
  27.         } 
    28. 
  
  
  
  
  28.         runTsk = g_losTask.runTask; 
    29. 
  
  
  
  
  29. ⑹      runTsk->eventMask = eventMask; 
    30. 
  
  
  
  
  30.         runTsk->eventMode = mode; 
    31. 
  
  
  
  
  31. ⑺      OsSchedTaskWait(&eventCB->stEventList, timeOut); 
    32. 
  
  
  
  
  32.         LOS_IntRestore(intSave); 
    33. 
  
  
  
  
  33. ⑻      LOS_Schedule(); 
    34. 
  
  
  
  
  34.  
    35. 
  
  
  
  
  35. ⑼      intSave = LOS_IntLock(); 
    36. 
  
  
  
  
  36.         if (runTsk->taskStatus & OS_TASK_STATUS_TIMEOUT) { 
    37. 
  
  
  
  
  37.             runTsk->taskStatus &= ~OS_TASK_STATUS_TIMEOUT; 
    38. 
  
  
  
  
  38.             LOS_IntRestore(intSave); 
    39. 
  
  
  
  
  39.             return LOS_ERRNO_EVENT_READ_TIMEOUT; 
    40. 
  
  
  
  
  40.         } 
    41. 
  
  
  
  
  41.  
    42. 
  
  
  
  
  42. ⑽      ret = LOS_EventPoll(&eventCB->uwEventID, eventMask, mode); 
    43. 
  
  
  
  
  43.     } 
    44. 
  
  
  
  
  44.  
    45. 
  
  
  
  
  45.     LOS_IntRestore(intSave); 
    46. 
  
  
  
  
  46.     return ret; 
    47. 
  
  
  
  
  47. } 
    48.

 2.3.2 写入指定的事件类型

我们可以使用函数UINT32 LOS_EventWrite(PEVENT_CB_S eventCB, UINT32 events)来写入指定的事件类型。代码如下所示：

下面通过分析源码来看看如何写入事件类型的。⑴处代码把事件结构体的事件掩码和要写入的事件类型events进行逻辑或计算，来完成事件的写入。⑵如果等待事件的任务链表不为空，需要处理写入事件后是否有任务能读取到相应的事件。⑶处for循环依次遍历事件阻塞链表上的任务，⑷获取下一个任务nextTask。⑸处

分不同的读取模式判断事件是否符合任务resumedTask读取事件的要求，如果满足读取事件，执行⑹设置退出标记exitFlag，然后调用函数OsSchedTaskWake()把读取事件的任务更改状态并放入就绪队列，继续执行⑺，遍历事件的阻塞任务链表中的每一个任务。⑻如果有任务读取到事件，需要触发任务调度。

 
 
 
 
    
  
  
  
  
  1. LITE_OS_SEC_TEXT UINT32 LOS_EventWrite(PEVENT_CB_S eventCB, UINT32 events) 
    2. 
  
  
  
  
  2. { 
    3. 
  
  
  
  
  3.     LosTaskCB *resumedTask = NULL; 
    4. 
  
  
  
  
  4.     LosTaskCB *nextTask = (LosTaskCB *)NULL; 
    5. 
  
  
  
  
  5.     UINT32 intSave; 
    6. 
  
  
  
  
  6.     UINT8 exitFlag = 0; 
    7. 
  
  
  
  
  7.     if (eventCB == NULL) { 
    8. 
  
  
  
  
  8.         return LOS_ERRNO_EVENT_PTR_NULL; 
    9. 
  
  
  
  
  9.     } 
    10. 
  
  
  
  
  10.     if ((eventCB->stEventList.pstNext == NULL) || (eventCB->stEventList.pstPrev == NULL)) { 
    11. 
  
  
  
  
  11.         return LOS_ERRNO_EVENT_NOT_INITIALIZED; 
    12. 
  
  
  
  
  12.     } 
    13. 
  
  
  
  
  13.     if (events & LOS_ERRTYPE_ERROR) { 
    14. 
  
  
  
  
  14.         return LOS_ERRNO_EVENT_SETBIT_INVALID; 
    15. 
  
  
  
  
  15.     } 
    16. 
  
  
  
  
  16.     intSave = LOS_IntLock(); 
    17. 
  
  
  
  
  17. ⑴  eventCB->uwEventID |= events; 
    18. 
  
  
  
  
  18.     OsHookCall(LOS_HOOK_TYPE_EVENT_WRITE, eventCB); 
    19. 
  
  
  
  
  19. ⑵  if (!LOS_ListEmpty(&eventCB->stEventList)) { 
    20. 
  
  
  
  
  20. ⑶      for (resumedTask = LOS_DL_LIST_ENTRY((&eventCB->stEventList)->pstNext, LosTaskCB, pendList); 
    21. 
  
  
  
  
  21.              &resumedTask->pendList != (&eventCB->stEventList);) { 
    22. 
  
  
  
  
  22. ⑷          nextTask = LOS_DL_LIST_ENTRY(resumedTask->pendList.pstNext, LosTaskCB, pendList); 
    23. 
  
  
  
  
  23.  
    24. 
  
  
  
  
  24. ⑸          if (((resumedTask->eventMode & LOS_WAITMODE_OR) && (resumedTask->eventMask & events) != 0) || 
    25. 
  
  
  
  
  25.                 ((resumedTask->eventMode & LOS_WAITMODE_AND) && 
    26. 
  
  
  
  
  26.                  ((resumedTask->eventMask & eventCB->uwEventID) == resumedTask->eventMask))) { 
    27. 
  
  
  
  
  27. ⑹              exitFlag = 1; 
    28. 
  
  
  
  
  28.  
    29. 
  
  
  
  
  29.                 OsSchedTaskWake(resumedTask); 
    30. 
  
  
  
  
  30.             } 
    31. 
  
  
  
  
  31. ⑺          resumedTask = nextTask; 
    32. 
  
  
  
  
  32.         } 
    33. 
  
  
  
  
  33.  
    34. 
  
  
  
  
  34.         if (exitFlag == 1) { 
    35. 
  
  
  
  
  35.             LOS_IntRestore(intSave); 
    36. 
  
  
  
  
  36. ⑻          LOS_Schedule(); 
    37. 
  
  
  
  
  37.             return LOS_OK; 
    38. 
  
  
  
  
  38.         } 
    39. 
  
  
  
  
  39.     } 
    40. 
  
  
  
  
  40.  
    41. 
  
  
  
  
  41.     LOS_IntRestore(intSave); 
    42. 
  
  
  
  
  42.     return LOS_OK; 
    43. 
  
  
  
  
  43. } 
    44.

2.4 清除事件

我们可以使用函数UINT32 LOS_EventClear(PEVENT_CB_S eventCB, UINT32 eventMask)来清除指定的事件类型，下面通过分析源码看看如何清除事件类型的。

函数参数为事件结构体eventCB和要清除的事件类型eventMask。清除事件时首先会进行结构体参数是否为空的校验，这些比较简单。⑴处把事件结构体的事件掩码和要清除的事件类型eventMask进行逻辑与计算，来完成事件的清理。

 
 
 
 
    
  
  
  
  
  1. LITE_OS_SEC_TEXT_MINOR UINT32 LOS_EventClear(PEVENT_CB_S eventCB, UINT32 eventMask) 
    2. 
  
  
  
  
  2. { 
    3. 
  
  
  
  
  3.     UINT32 intSave; 
    4. 
  
  
  
  
  4.     if (eventCB == NULL) { 
    5. 
  
  
  
  
  5.         return LOS_ERRNO_EVENT_PTR_NULL; 
    6. 
  
  
  
  
  6.     } 
    7. 
  
  
  
  
  7.     intSave = LOS_IntLock(); 
    8. 
  
  
  
  
  8. ⑴  eventCB->uwEventID &= eventMask; 
    9. 
  
  
  
  
  9.     LOS_IntRestore(intSave); 
    10. 
  
  
  
  
  10.     OsHookCall(LOS_HOOK_TYPE_EVENT_CLEAR, eventCB); 
    11. 
  
  
  
  
  11.     return LOS_OK; 
    12. 
  
  
  
  
  12. } 
    13.

 2.5 销毁事件

我们可以使用函数UINT32 LOS_EventDestroy(PEVENT_CB_S eventCB)来销毁指定的事件控制块，下面通过分析源码看看如何销毁事件的。

函数参数为事件结构体，销毁事件时首先会进行结构体参数是否为空的校验，这些比较简单。⑴处如果事件的任务阻塞链表不为空，则不能销毁事件。⑵把事件结构体的读取事件的任务链表stEventList设置为空，完成事件的销毁。

 
 
 
 
    
  
  
  
  
  1. LITE_OS_SEC_TEXT_INIT UINT32 LOS_EventDestroy(PEVENT_CB_S eventCB) 
    2. 
  
  
  
  
  2. { 
    3. 
  
  
  
  
  3.     UINT32 intSave; 
    4. 
  
  
  
  
  4.     if (eventCB == NULL) { 
    5. 
  
  
  
  
  5.         return LOS_ERRNO_EVENT_PTR_NULL; 
    6. 
  
  
  
  
  6.     } 
    7. 
  
  
  
  
  7.     intSave = LOS_IntLock(); 
    8. 
  
  
  
  
  8.  
    9. 
  
  
  
  
  9. ⑴  if (!LOS_ListEmpty(&eventCB->stEventList)) { 
    10. 
  
  
  
  
  10.         LOS_IntRestore(intSave); 
    11. 
  
  
  
  
  11.         return LOS_ERRNO_EVENT_SHOULD_NOT_DESTORY; 
    12. 
  
  
  
  
  12.     } 
    13. 
  
  
  
  
  13. ⑵  eventCB->stEventList.pstNext = (LOS_DL_LIST *)NULL; 
    14. 
  
  
  
  
  14.     eventCB->stEventList.pstPrev = (LOS_DL_LIST *)NULL; 
    15. 
  
  
  
  
  15.     LOS_IntRestore(intSave); 
    16. 
  
  
  
  
  16.     OsHookCall(LOS_HOOK_TYPE_EVENT_DESTROY); 
    17. 
  
  
  
  
  17.     return LOS_OK; 
    18. 
  
  
  
  
  18. } 
    19.

 小结

本文带领大家一起剖析了鸿蒙轻内核的事件模块的源代码，包含事件的结构体、事件初始化、事件创建删除、申请释放等。

想了解更多内容，请访问：

和华为官方合作共建的鸿蒙技术社区

https://harmonyos.

当前文章：鸿蒙轻内核M核源码分析系列十二事件Event
本文路径：http://www.shufengxianlan.com/qtweb/news33/217233.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联

猜你还喜欢下面的内容

手机网站建设知识

分类信息网

成都路面机械设备　　 　视频运营　　 　成都装饰装修　　 　犀浦封阳台　　 　蜀锦在线　　 　电商网站建设　　 　普特斯腐植酸　　 　江油网站建设　　 　重庆网站设计　　 　橡塑保温管　　 　软文推广　　 　成都名片印刷　　 　雅安服务器托管　　 　成都画册设计　　 　云服务器　　 　和县翔豪网站　　 　无边发光字厂家　　 　香港虚拟主机空间　　 　发电机组维修保养　　 　成都搬家公司