RT-thread内核之事件
一、事件控制块：在include/rtdef.h中
#ifdef RT_USING_EVENT /** * flag defintions in event */ #define RT_EVENT_FLAG_AND 0x01 /**< logic and */ #define RT_EVENT_FLAG_OR 0x02 /**< logic or */ #define RT_EVENT_FLAG_CLEAR 0x04 /**< clear flag */ /* * event structure */ struct rt_event { struct rt_ipc_object parent; /**< inherit from ipc_object *///从IPC对象派生 rt_uint32_t set; /**< event set */ //保存接收到的事件集 }; typedef struct rt_event *rt_event_t; #endif
二、事件相关接口：在src/ipc.c中
创建事件： rt_event_t rt_event_create(const char *name, rt_uint8_t flag); 调用该函数接口时，系统会从动态内存堆中分配事件对象，然后进行对象的初始化，IPC对象初始化，并把set设置成0。 删除事件： rt_err_t rt_event_delete(rt_event_t event); 在调用rt_event_delete函数删除一个事件对象时，应该确保该事件不再被使用。在删除前会唤醒所有挂起在该事件上的线程（线程的返回值是-RT_ERROR），然后释放事件对象占用的内存块。
初始化事件： 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); 系统首先唤醒所有挂在该事件等待队列上的线程（线程的返回值是- RT_ERROR ），然后将该事件从内核对象管理器中删除。
发送事件： rt_err_t rt_event_send(rt_event_t event, rt_uint32_t set); 通过发送事件服务，可以发送一个或多个事件。使用该函数接口时，通过参数set指定的事件标志来设定event对象的事件标志值，然后遍历等待在event事件对象上的等待线程链表，判断是否有线程的事件激活要求与当前event对象事件标志值匹配，如果有，则唤醒该线程。
发送事件首先会将事件集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); //指向收到的事件 内核使用32位的无符号整型数来标识事件，它的每一位代表一个事件，因此一个事件对象可同时等待接收32个事件，内核可以通过指定选择参数“逻与”或“逻辑或”来选择如何激活线程，使用“逻辑与”参数表示只有当所有等待的事件都发生时才激活线程，而使用“逻辑或”参数则表示只要有一个等待的事件发生就激活线程。 当用户调用这个接口时，系统首先根据set参数和接收选项来判断它要接收的事件是否发生，如果已经发生，则根据参数option上是否设置有RT_EVENT_FLAG_CLEAR来决定是否重置事件的相应标志位，然后返回（其中recved参数返回收到的事件）； 如果没有发生，则把等待的set和option参数填入线程本身的结构中，然后把线程挂起在此事件对象上，直到其等待的事件满足条件或等待时间超过指定的超时时间。如果超时时间设置为零，则表示当线程要接受的事件没有满足其要求时就不等待，而直接返回-RT_TIMEOUT。
接收事件比较简单，如果接收到事件则判断它是否为它关心的事件，如果是，则保存事件，如果不是，则当没有接收到事件情况一起处理。接下来就是没有事件到达的情况，还是老规矩，先判断时间参数是否为0，如果是则直接返回超时，如果不是，则设置一定时器然后启动它，接着重新调度线程，然后根据当前线程的error值是否为RT_EOK来判断是否有新的并且符合条件的事件到达，如果不是，则返回错误码，如果是，则保存事件，最终返回OK。
控制事件： rt_err_t rt_event_control(rt_event_t event, rt_uint8_t cmd, void *arg); 只支持RT_IPC_CMD_RESET这个命令，表示复位事件，将事件集set清0。
