开发指导
使用场景
事件可应用于多种任务同步场景，在某些同步场景下可替代信号量。
功能
Huawei LiteOS 的事件模块为用户提供下面几种功能，接口详细信息可以查看API参考。
功能分类 | 接口名 | 描述 |
|---|---|---|
初始化事件 | LOS_EventInit | 初始化一个事件控制块 |
读/写事件 | LOS_EventRead | 读取指定事件类型，超时时间为相对时间：单位为Tick |
LOS_EventWrite | 写指定的事件类型 | |
清除事件 | LOS_EventClear | 清除指定的事件类型 |
校验事件掩码 | LOS_EventPoll | 根据用户传入的事件ID、事件掩码及读取模式，返回用户传入的事件是否符合预期 |
销毁事件 | LOS_EventDestroy | 销毁指定的事件控制块 |
Event错误码
对存在失败可能性的操作返回对应的错误码，以便快速定位错误原因。
序号 | 定义 | 实际值 | 描述 | 参考解决方案 |
|---|---|---|---|---|
1 | LOS_ERRNO_EVENT_SETBIT_INVALID | 0x02001c00 | 写事件时，将事件ID的第25个bit设置为1。这个比特位OS内部保留，不允许设置为1 | 事件ID的第25bit置为0 |
2 | LOS_ERRNO_EVENT_READ_TIMEOUT | 0x02001c01 | 读事件超时 | 增加等待时间或者重新读取 |
3 | LOS_ERRNO_EVENT_EVENTMASK_INVALID | 0x02001c02 | 入参的事件ID是无效的 | 传入有效的事件ID参数 |
4 | LOS_ERRNO_EVENT_READ_IN_INTERRUPT | 0x02001c03 | 在中断中读取事件 | 启动新的任务来获取事件 |
5 | LOS_ERRNO_EVENT_FLAGS_INVALID | 0x02001c04 | 读取事件的mode无效 | 传入有效的mode参数 |
6 | LOS_ERRNO_EVENT_READ_IN_LOCK | 0x02001c05 | 任务锁住，不能读取事件 | 解锁任务，再读取事件 |
7 | LOS_ERRNO_EVENT_PTR_NULL | 0x02001c06 | 传入的参数为空指针 | 传入非空入参 |
8 | LOS_ERRNO_EVENT_READ_IN_SYSTEM_TASK | 0x02001c07 | 在系统任务中读取事件，如idle和软件定时器 | 启动新的任务来获取事件 |
9 | LOS_ERRNO_EVENT_SHOULD_NOT_DESTORY | 0x02001c08 | 事件链表上仍有任务，无法被销毁 | 先检查事件链表是否为空 |
错误码定义见错误码简介。8~15位的所属模块为事件模块，值为0x1c。
开发流程
使用事件模块的典型流程如下：
- 执行make menuconfig命令，进入Kernel ---> Enable Event菜单，完成事件模块的配置。
配置项
含义
取值范围
默认值
依赖
LOSCFG_BASE_IPC_EVENT
事件功能的裁剪开关
YES/NO
YES
无
LOSCFG_BASE_IPC_EVENT_LIMIT
最大支持的事件控制块数量
无
1024
LOSCFG_BASE_IPC_EVENT
- 调用事件初始化LOS_EventInit接口，初始化事件等待队列。
- 写事件LOS_EventWrite，写入指定的事件类型。
- 读事件LOS_EventRead，可以选择读取模式。
- 清除事件LOS_EventClear，清除指定的事件类型。
平台差异性
无。
