RT-Thread学习记录11 事件集的使用

以下为看视频笔记..........

1. 例说事件集

以坐公交车为例说明事件集，在公交站等公交车时可能有以下几种情况:

①P1坐公交车去某地，只有一趟公交车可以到达目的地，等到此公交车即可出发。②P1坐公交车去某地，有3趟公交车都可以到达目的地，等到其中任意一辆即可出发

③P1约另一人P2一起去某地，则P1必须要等到“同伴P2到达公交站”与“公交车到达公交站”两个条件都满足后，才能出发。

这里，可以将P1去某地的这个行为视为线程，将“到达目的地的公交车到达公交站”、“同伴P2到达公交站”视为事件的发生，情况①是特定事件唤醒线程;情况②是任意单个事件唤醒线程;情况③是多个事件同时发生才能唤醒线程。

2. 事件集工作机制

 

信号量主要用于“一对一”的线程同步;当需要“一对多”、“多对一”、“多对多”的同步时，就需要事件集来处理了。

RT-Thread中的事件集用一个32位无符号整型变量来表示，变量中的一个位代表一个事件，线程通过“逻辑与”或“逻辑或”与一个或多个事件建立关联形成一个事件组合。

事件的“逻辑或”也称为是独立型同步，指的是线程与任何事件之一发 生同步，只要有一个事件发生，即满足条件;

事件的“逻辑与”也称为是关联型同步，指的是线程与若干事件都发生同步，只有这些事件全部发生，才满足条件。

3. 事件集控制块

在RT_Thread中，事件集控制块是操作系统用于管理事件的一个数据结构

struct  rt_event
{
    struct  rt_ipc_object parent;  //从IPC对象继承过来
    rt_uint32_t           set;     //set是一个32位无符号数，每一位代表一个事件
                                   //若某位是0代表事件没有发生，1代表发生
}
typedef  struct  rt_ecent  * rt_event_t;

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

4. 事件集的操作API

初始化与脱离

这组API主要用于静态事件集的操作，第一个参数是事件集控制块指针，通过这个API来操作这个事件集event。参数flag可取RT_IPC_FLAG_FIFO,RT_IPC_FLAG_PRIO,表示线程不可用时等待的方式。

rt_err_t  rt_event_init(rt_event_t  event,const char *name,rt_uint8_t  flag)

rt_err_t rt_event_detach(rt_event_t  event)

删除与创建

这组API主要用于动态事件集的操作

rt_event_t  rt_event_create (const char *name,rt_uint8_t  flag)

rt_err_t rt_event_delete(rt_event_t event)

发送事件

第一个参数表示我们向那一个事件集发送事件，第二个参数是我们发送的事件，若发送是0x08代表是第三个事件发生了

我们可以在线程和中断服务中使用API去发送事件

rt_err_t rt_event_send(rt_event_t event,rt_uint32_t set)

接受事件

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)
//第一个参数是事件集线程的指针，即我们要接受那一个事件集的事件，指定事件集
//第二个参数是表示我们对那个事件集哪一个位感兴趣，是某些bit的组合，
//第三个参数是事件的信息标记，有RT_EVENT_FLAG_AND(表示set参数的某几个事件都发生这个函数才能被唤醒),RT_EVENT_FLAG_OR(表示set参数有其中一个事件发生这个函数才能被唤醒),RT_EVENT_FLAG_CLEAR(表示函数唤醒后会清除set参数中的位，即把事件清零).
//函数没收到事件等待时间，等待会挂起线程，

3. 事件集示例代码

在event_sample.c中

/*
 * 程序清单：事件例程
 *
 * 程序会初始化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;
}