uCO/OS-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