UCOS-II 事件(event)的使用规则及MUTEX实例整理

原博文网址：http://blog.csdn.net/wavemcu/article/details/27790605

一：μC/OS-II系统事件简介
好久没有弄μC/OS-II系统了，也很久没有更新这个板块的博文了，有工作的原因，也有时间的原因。今天就以Nuvoton的NUC140为例，简单介绍下uCOS-II系统中的事件（Event）的一般使用规则。事件管理函数是μC/OS-II中最多的系统函数， 在μC/OS-II中总共有34个，而且每种事件具有的管理函数数目不同。但是所有的事件都有类似的6个函数，它们是所有事件的基本功能，其函数名类似，使用方法也类似，详细函数见下表。

任何一个事件，必须先创建后使用。创建事件是通过调用函数OS???Create()实现的，其中???为事件的类型。创建事件可以在main()函数中，但更多的是在任务初始化部分。使用方法如下：

在嵌入式系统中，事件是静态使用的，即创建后永远不删除。但有时候需要动态使用，即根据需要创建和删除事件，此时创建事件就是在任务的事件执行代码中，使用方法如下:

要掌握事件函数在中断服务程序中的调用规则，我们必须清楚中断服务有哪些特点。

下面给出事件在中断服务程序中使用方法，假设Task0任务接收ISR发送的消息，任务代码如下：

注意：
1. 中断服务程序一般不会调用建立和删除事件函数，否则要么没有起到事件的作用，要么程序很复杂；
2. 中断服务程序不能调用等待事件的函数，否则可能造成程序崩溃，可以调用无等待获得事件函数获得信号，但事实上，在中断中调用无等待获得事件的情况都很少。
以互斥信号量为例，说明事件如何使用的，在日常生活中，出租车是一种常用的共享资源，当出租车载客时，从外面可以看到标识为载客；当空闲时，标识为空车。这样等车的人就可以根据标识知道出租车的当前状态，判断是否能够座上这辆车。这个标识牌就是一个二值信号量。由于这种二值信号量可以实现对共享资源的独占式处理，所以叫做互斥信号量。
使用互斥信号量有以下3点需要注意：

互斥信号量函数的6个基本函数如下：

二：MUTEX事件实例代码

为了实现资源同步， 我们需要保证OSMutexPost()与OSMutexPend()成对出现在同一个任务函数中。这点请注意哦，下面以Nuvoton的NUC140为例说明如下：

主函数里面只有做一些简单的初始化和OS环境建立。下面是MUTEX的实例代码：

#ifndef _TASK_C  #define _TASK_C  /*-----------------------------------------------------------------------------------------*/  /*                                                                                         */  /* Copyright (c) EasyWave. All rights reserved.                                            */  /*                                                                                         */  /*-----------------------------------------------------------------------------------------*/  //===========================================================================================  //                      INCLUDE FILES                                                          //===========================================================================================  #include "SYS_Header.H"  #include "BSP_Header.H"  #include "DRV_Header.H"  #include "UOS_Header.H"  #include "Task.H"  /* *************************************************************************************** */  /*                               LOCAL VARIABLE                    */  /* *************************************************************************************** */  #define MUTEX_PRIO              1       // MUTEX_PRIO < OS_LOWEST_PRIO  #define TASK1_PRIO              2       // TASK1_PRIO < OS_LOWEST_PRIO  #define TASK2_PRIO              3       // TASK2_PRIO < OS_LOWEST_PRIO  OS_STK  Task1Stack[OS_MAX_STACK];       // for task1 stack size  OS_STK  Task2Stack[OS_MAX_STACK];       // for task2 stack size  OS_EVENT    *Mutex;  UINT32  Critical1,Critical2;  /* *************************************************************************************** */  /*                               DEBUG MARCO                       */  /* *************************************************************************************** */  #ifdef ENABLE_DEBUG      #define TASK_DEBUG(x)     x  #else      #define TASK_DEBUG(x)  #endif  /*-----------------------------------------------------------------------------------------*/  /*                      PUBLIC FUNCTION                                                    */  /*-----------------------------------------------------------------------------------------*/  //===========================================================================================  // Function     : OSTaskInitial  // Purpose      : None  // Input        : None  // Rteurn       : None  // External     : None  // History      : EasyWave 2011-11-16 Create  //  // Modify       : None  //===========================================================================================  VOID OSTaskInitial(VOID)  {      OSTaskCreate( MainTask1, (void*)0, &Task1Stack[OS_MAX_STACK-1], TASK1_PRIO );      OSTaskCreate( MainTask2, (void*)0, &Task2Stack[OS_MAX_STACK-1], TASK2_PRIO );      Critical1 = 0x00;      Critical2 = 0x00;  }  //===========================================================================================  // Function     : MainTask1  // Purpose      : None  // Input        : None  // Rteurn       : None  // External     : None  // History      : EasyWave 2011-11-16 Create  //  // Modify       : None  //===========================================================================================  VOID MainTask1(VOID *pdata)  {      INT8U   err;      (VOID)pdata;       Mutex = OSMutexCreate(MUTEX_PRIO,&err);      if(err == OS_ERR_NONE)      {          TASK_DEBUG(DrvSIO_printf("OSMutexCreate Sucess.\r\n"));           }      while(TRUE)      {          OSMutexPend(Mutex, INFINITE, &err);          TASK_DEBUG(DrvSIO_printf("%s is Running.\r\n",__FUNCTION__));          Critical1 ++;          OSTimeDly(100);          Critical2 ++;          OSMutexPost(Mutex);      }  }  //===========================================================================================  // Function     : MainTask2  // Purpose      : None  // Input        : None  // Rteurn       : None  // External     : None  // History      : EasyWave 2011-11-16 Create  //  // Modify       : None  //===========================================================================================  VOID MainTask2(VOID *pdata)  {      INT8U   err;      (VOID)pdata;       while(TRUE)      {          TASK_DEBUG(DrvSIO_printf("%s is Running.\r\n",__FUNCTION__));          OSMutexPend(Mutex, INFINITE, &err);          if(Critical1 != Critical2)          {              TASK_DEBUG(DrvSIO_printf("Mutex error\n"));              while(TRUE);          }          else          {              TASK_DEBUG(DrvSIO_printf("Mutex Works Well.\r\n"));          }          Critical1 ++;          Critical2 ++;          OSMutexPost(Mutex);      }   }  #endif  //_TASK_C