基于TI-RTOS的CC2650DK开发（12）---事件模块

最新推荐文章于 2022-03-13 08:31:39 发布

abatei

最新推荐文章于 2022-03-13 08:31:39 发布

阅读量3.4k

点赞数 1

分类专栏： TI-RTOS 文章标签： CC2650 TI-RTOS

TI-RTOS 专栏收录该内容

28 篇文章 28 订阅

订阅专栏

4.2 事件模块

事件为线程间的通信和同步提供了一种手段。它和Semaphores类似，除了它们允许你在等待线程返回之前可以指定必须发生的多个条件（“事件”）。

事件实例和Semaphore一样使用“pend”和“post”调用。然而调用Event_pend()需附加指定等待哪个事件，调用Event_post()需指定提交的事件是哪个。

注意：每次只有单个Task可以等待一个事件对象。

单个事件实例可管理最多32个事件，每个事件都用一个事件ID代表。事件ID是简单的比特掩码，对应着一个由事件对象管理的唯一事件。

事件的行为和二元semaphore类似。

Event_pend()有两个参数"andMask"和"orMask"。andMask由所有必须发生的事件的事件ID组成，orMask由所有事件中的必须发生的那个一个事件的事件ID组成。

和Semaphonres一样，调用Event_pend()时携带一个timeout参数，如果调用超时则返回0。如果调用 Event_pend()成功，则返回"消耗"掉的事件掩码-----也就是满足 Event_pend()的调用所发生的事件。然后该任务处理所有消耗掉的事件。

只有Tasks可以调用 Event_pend()，反之，Hwi、Swi和其它Tasks都可以调用Event_post()。

Event_pend()原型如下：

UInt Event_pend(Event_Handle event,
                UInt andMask,
                UInt orMask,
                UInt timeout);

Event_post()原型如下：

Void Event_post(Event_Handle event,
UInt eventIds);

配置实例：以下配置声明静态地创建了一个事件。事件对象的Event_Handle名称为“myEvent”：

var Event = xdc.useModule( "ti.sysbios.knl.Event");
Program.global.myEvent = Event.create();

运行时实例：以下C代码创建了一个事件对象，Event_Handle名称为“myEvent”：

Event_Handle myEvent;
Error_Block eb;
Error_init(&eb);
/* Default instance configuration params */
myEvent = Event_create( NULL, &eb);
if (myEvent == NULL)
{
System_abort( "Event create failed");
}

运行时实例：以下是一个事件的C代码。它仅在events 0和6都发生时才唤醒task。它设置andMash为Event_Id_00 和Event_Id_06，并设置orMash为Event_Id_NONE。

Event_pend(myEvent, (Event_Id_00 + Event_Id_06), Event_Id_NONE,
BIOS_WAIT_FOREVER);

运行时实例：以下C代码调用Event_post()来表明发生哪个事件。eventMash应包含被提交的事件的IDs。

Event_post(myEvent, Event_Id_00);

运行时实例：以下C代码演示了task如何为三个中断服务程序提供后台运行的需要：

基于TI-RTOS的CC2650DK开发（12）---事件模块 - 阿巴睇 - 阿巴睇的博客

Event_Handle myEvent;
main()
{
    ...
     /* create an Event object. All events are binary */
    myEvent = Event_create( NULL, &eb);
     if (myEvent == NULL)
    {
        System_abort( "Event create failed");
    }
}
isr0()
{
    ...
    Event_post(myEvent, Event_Id_00);
    ...
}
isr1()
{
    ...
    Event_post(myEvent, Event_Id_01);
    ...
}
isr2()
{
    ...
    Event_post(myEvent, Event_Id_02);
    ...
}
task()
{
    UInt events;
     while (TRUE)
    {
         /* Wait for ANY of the ISR events to be posted *
        events = Event_pend(myEvent, Event_Id_NONE,
        Event_Id_00 + Event_Id_01 + Event_Id_02,
        BIOS_WAIT_FOREVER);
        /* Process all the events that have occurred */
         if (events & Event_Id_00)
        {
            processISR0();
        }
         if (events & Event_Id_01)
        {
            processISR1();
        }
         if (events & Event_Id_02)
        {
            processISR2();
        }
    }
}

4.2.1 隐式提交事件

除了支持通过Event_post() API显示提交事件之外，一些SYS/BIOS对象还支持隐式提交它们所关联的事件。例如，Mailbox（邮箱）就可配置为无论何时，只要获得信息（就是调用了Mailbox_post()）都可提交一个关联事件，这使得task可以阻塞以等待Mailbox信息或其它事件的发生。

Mailbox和Semaphore对象现在支持在所关联的资源可用时提交事件。

支持隐式事件提交的SYS/BIOS对象必须在创建时配置一个事件对象和事件ID。你可以决定将指定资源的可用信号关联到如一个事件ID之上（也就是Mailbox中的信息可用，Mailbox的room可用或Semaphore可用）。

注意：之前曾说过，同一时间只有一个Task可以等待一个事件对象。所以可以得出结论，为隐式提交的事件所配置的SYS/BIOS对象同一时间仅可以等待单个Task。

当Event_pend()用于从隐式提交的对象获取资源时，timeout参数BIOS_NO_WAIT将用于随后从对象接收资源。

运行时实例：以下C代码例程演示了一个task将消息提交到Mailbox消息以及执行一个ISR的提交处理需求。

Event_Handle myEvent;
Mailbox_Handle mbox;
typedef struct msg
{
    UInt id;
    Char buf[ 10];
}
main()
{
    Mailbox_Params mboxParams;
    Error_Block eb;
    Error_init(&eb);
    myEvent = Event_create( NULL, &eb);
     if (myEvent == NULL)
    {
        System_abort( "Event create failed");
    }
    Mailbox_Params_init(&mboxParams);
    mboxParams.readerEvent = myEvent;
     /* Assign Event_Id_00 to Mailbox "not empty" event */
    mboxParams.readerEventId = Event_Id_00;
    mbox = Mailbox_create( sizeof(msg), 50, &mboxParams, &eb);
     if (mbox == NULL)
    {
        System_abort( "Mailbox create failed");
    }
     /* Mailbox_create() sets Mailbox's readerEvent to
    * counting mode and initial count = 50 */
}
writerTask()
{
    ...
    Mailbox_post(mbox, &msgA, BIOS_WAIT_FOREVER);
     /* implicitly posts Event_Id_00 to myEvent */
    ...
}
isr()
{
    Event_post(myEvent, Event_Id_01);
}
readerTask()
{
     while (TRUE)   /* Wait for either ISR or Mailbox message */
    {
        events = Event_pend(myEvent,
                            Event_Id_NONE, /* andMask = 0 */
                            Event_Id_00 + Event_Id_01, /* orMask */
                            BIOS_WAIT_FOREVER); /* timeout */
         if (events & Event_Id_00)
        {
             /* Get the posted message.
            * Mailbox_pend() will not block since Event_pend()
            * has guaranteed that a message is available.
            * Notice that the special BIOS_NO_WAIT
            * parameter tells Mailbox that Event_pend()
            * was used to acquire the available message.
            */
            Mailbox_pend(mbox, &msgB, BIOS_NO_WAIT);
            processMsg(&msgB);
        }
         if (events & Event_Id_01)
        {
            processISR();
        }
    }
}