RT-Thread-11-事件集

事件集

举例说明事件集：
1、A坐公交车去某地，只有一趟公交车去该地，等此公交车即可出发；
2、A坐公交车去某地，有三趟公交车去该地，等其中任意一辆公交车即可出发；
3、A约B一起去某地，则A必须等到"B到公交站"和"公交车到底公交站"两个条件都满足后，才出发。
此处，可将A去某地的行为看做一个线程，将"到达目的地公交车到达公交站"、"B到公交站"看做事件发生，情况1是特定事件唤醒线程；情况2是任意单个事件唤醒线程；情况3是多个事件同时发生才能唤醒线程。

---

信号量主要用于"一对一"的线程同步；
事件集可用于"一对多"、“多对一”、“多对多"的线程同步；
RT-Thread中的事件集用一个32位无符号整型变量来表示，变量中的一个位代表一个事件，线程通过"逻辑与”、“逻辑或”，与一个或多个事件建立联系，形成一个事件组合。

事件的"逻辑或"（也称独立型同步），指的是线程和任何事件之一发生同步，只要有一个事件发生，即满足条件；
事件的"逻辑与"（也称关联型同步），指的是线程和若干事件都发生同步，只有这些事件都发生，才满足条件；

---

事件集控制块：

/*
 * event structure
 */
struct rt_event
{
    struct rt_ipc_object parent;   /**< inherit from ipc_object */
    rt_uint32_t          set;      /**< event set */
};
typedef struct rt_event *rt_event_t;

定义静态事件集：struct  rt_event  static_evt
定义动态事件集：rt_event_t  dynamic_evt

初始化与脱离

rt_err_t rt_event_init(rt_event_t event, const char *name, rt_uint8_t flag);//RT_IPC_FLAG_FIFO、RT_IPC_FLAG_PRIO
rt_err_t rt_event_detach(rt_event_t event);

创建与删除

rt_event_t rt_event_create(const char *name, rt_uint8_t flag);
rt_err_t rt_event_delete(rt_event_t event);

发送事件

rt_err_t rt_event_send(rt_event_t event, rt_uint32_t set);
set:某位或某几位的与或操作后的值,如0x01|0x08

接收事件

rt_err_t rt_event_recv(rt_event_t   event,
                       rt_uint32_t  set,
                       rt_uint8_t   option,
                       rt_int32_t   timeout,
                       rt_uint32_t *recved);
option:
RT_EVENT_FLAG_AND     0x01       /**< logic and */
RT_EVENT_FLAG_OR      0x02       /**< logic or */
RT_EVENT_FLAG_CLEAR   0x04       /**< clear flag */

官方示例代码：

/* 
 * Copyright (c) 2006-2018, RT-Thread Development Team 
 * 
 * SPDX-License-Identifier: Apache-2.0 
 * 
 * Change Logs: 
 * Date           Author       Notes 
 * 2018-08-24     yangjie      the first version 
 */ 

/*
 * 程序清单：事件例程
 *
 * 程序会初始化2个线程及初始化一个静态事件对象
 * 一个线程等待于事件对象上，以接收事件；
 * 一个线程发送事件 (事件3/事件5)
*/
#include <rtthread.h>

#define THREAD_PRIORITY      9
#define THREAD_TIMESLICE     5

#define EVENT_FLAG3 (1 << 3)
#define EVENT_FLAG5 (1 << 5)

/* 事件控制块 */
static struct rt_event event;

ALIGN(RT_ALIGN_SIZE)
static char thread1_stack[1024];
static struct rt_thread thread1;

/* 线程1入口函数 */
static void thread1_recv_event(void *param)
{
    rt_uint32_t e;

    /* 第一次接收事件，事件3或事件5任意一个可以触发线程1，接收完后清除事件标志 */
    if (rt_event_recv(&event, (EVENT_FLAG3 | EVENT_FLAG5),
                      RT_EVENT_FLAG_OR | RT_EVENT_FLAG_CLEAR,
                      RT_WAITING_FOREVER, &e) == RT_EOK)
    {
        rt_kprintf("thread1: OR recv event 0x%x\n", e);
    }

    rt_kprintf("thread1: delay 1s to prepare the second event\n");
    rt_thread_mdelay(1000);

    /* 第二次接收事件，事件3和事件5均发生时才可以触发线程1，接收完后清除事件标志 */
    if (rt_event_recv(&event, (EVENT_FLAG3 | EVENT_FLAG5),
                      RT_EVENT_FLAG_AND | RT_EVENT_FLAG_CLEAR,
                      RT_WAITING_FOREVER, &e) == RT_EOK)
    {
        rt_kprintf("thread1: AND recv event 0x%x\n", e);
    }
    rt_kprintf("thread1 leave.\n");
}


ALIGN(RT_ALIGN_SIZE)
static char thread2_stack[1024];
static struct rt_thread thread2;

/* 线程2入口 */
static void thread2_send_event(void *param)
{
    rt_kprintf("thread2: send event3\n");
    rt_event_send(&event, EVENT_FLAG3);
    rt_thread_mdelay(200);

    rt_kprintf("thread2: send event5\n");
    rt_event_send(&event, EVENT_FLAG5);
    rt_thread_mdelay(200);

    rt_kprintf("thread2: send event3\n");
    rt_event_send(&event, EVENT_FLAG3);
    rt_kprintf("thread2 leave.\n");
}

int event_sample(void)
{
    rt_err_t result;

    /* 初始化事件对象 */
    result = rt_event_init(&event, "event", RT_IPC_FLAG_FIFO);
    if (result != RT_EOK)
    {
        rt_kprintf("init event failed.\n");
        return -1;
    }

    rt_thread_init(&thread1,
                   "thread1",
                   thread1_recv_event,
                   RT_NULL,
                   &thread1_stack[0],
                   sizeof(thread1_stack),
                   THREAD_PRIORITY - 1, THREAD_TIMESLICE);
    rt_thread_startup(&thread1);

    rt_thread_init(&thread2,
                   "thread2",
                   thread2_send_event,
                   RT_NULL,
                   &thread2_stack[0],
                   sizeof(thread2_stack),
                   THREAD_PRIORITY, THREAD_TIMESLICE);
    rt_thread_startup(&thread2);

    return 0;
}

/* 导出到 msh 命令列表中 */
MSH_CMD_EXPORT(event_sample, event sample);

运行结果：