os_event.h 函数

📚 本节导读

用途: 事件集 API 函数声明

来源: kernel/include/os_event.h:61

一、事件集创建

os_event_create

os_event_id os_event_create(const char *name);

功能: 创建事件集

os_event_delete

os_err_t os_event_delete(os_event_id event);

功能: 删除事件集

---

二、事件集操作

os_event_send

os_err_t os_event_send(os_event_id event, os_uint32_t event_set);

功能: 发送事件（置位）

os_event_recv

os_err_t os_event_recv(os_event_id event, os_uint32_t interest_mask,
                       os_uint8_t option, os_uint32_t timeout,
                       os_uint32_t *received);

功能: 接收事件

参数:

• interest_mask: 感兴趣的事件位
• option: 选项
  • OS_EVENT_OPTION_AND: 等待所有感兴趣的位
  • OS_EVENT_OPTION_OR: 等待任一感兴趣的位
  • OS_EVENT_OPTION_CLEAR: 接收后清除

os_event_set

os_err_t os_event_set(os_event_id event, os_uint32_t event_set);

功能: 设置事件位（置位）

os_event_clear

os_err_t os_event_clear(os_event_id event, os_uint32_t event_set);

功能: 清除事件位

---

三、静态事件集管理

OS_EVENT_DEFINE

#define OS_EVENT_DEFINE(name) os_event_dummy_t name

功能: 静态定义事件集

os_event_init

os_err_t os_event_init(os_event_id event, const char *name);

功能: 初始化静态事件集

os_event_deinit

os_err_t os_event_deinit(os_event_id event);

功能: 反初始化静态事件集

---

四、唤醒类型设置

os_event_set_wake_type

os_err_t os_event_set_wake_type(os_event_id event, os_uint8_t wake_type);

功能: 设置唤醒类型

参数:

• wake_type: 唤醒类型
  • OS_EVENT_WAKE_TYPE_PRIO: 按优先级唤醒
  • OS_EVENT_WAKE_TYPE_FIFO: 按 FIFO 唤醒

---