EVENT事件调度（应用层级）操作注意事项

简要

  最大支持32个事件标志管理，倒计时精度为1毫秒的最大倒计时时间为4294967295毫秒，倒计时精度为1秒的最大倒计时时间为4294967295秒，可产生以下事件：

• 立即触发事件
• 单次超时事件
• 循环周期性事件

注意事项

• 内存访问一致性：主循环中获取事件标志或者调用事件触发和事件设置API都有可能导致读取的数据不一致，由于事件标志是4个字节长度，在事件标志读取和设置途中有可能在定时器中断中也会同时操作，这就导致在主循环中读取到的变量出现误差。所以会在相关函数入口和退出处控制控制所有中断开关。
• __set_PRIMASK(1);关闭所有中断
• __set_PRIMASK(0);打开所有中断

API说明

1、1毫秒计时驱动

void eventDriver(void);

调用setEvent(...)延时自动触发事件的倒计时就是在该API中执行，所以该函数需要放在一个周期为1毫秒的定时器中执行。

2、1秒计时驱动

void eventDriver1s(void);

调用setEvent1s(...)延时自动触发事件的倒计时就是在该API中执行，所以该函数需要放在一个周期为1秒的定时器中执行。
比如一些低功耗运行的场景，该定时器可以选择低功耗定时器

2、设置一个单位时间为1毫秒的周期性事件

void setEvent(uint32_t mask, bool first, bool reload, bool setCover, uint32_t timeOut_ms);

序号	传参	变量类型	说明
1	mask	uint32_t	需要设置的事件标志，一个事件占用一个bit内存
2	first	bool	true表示调用setEvent(...)后立即触发一次事件，false表示等待周期时间到了再触发产生事件
3	reload	bool	true表示周期性触发mask事件，false表示执行完第一次超时触发事件后，该事件就停止运行
4	setCover	bool	true表示重新计时，false表示不重新计时
5	timeOut_ms	uint32_t	0表示立即触发，无周期性事件，非0表示以时间做超时事件

3、设置一个单位时间为1秒的周期性事件

void setEvent1s(uint32_t mask, bool first, bool reload, bool setCover, uint32_t timeOut_s);

序号	传参	变量类型	说明
1	mask	uint32_t	需要设置的事件标志，一个事件占用一个bit内存
2	first	bool	true表示调用setEvent(...)后立即触发一次事件，false表示等待周期时间到了再触发产生事件
3	reload	bool	true表示周期性触发mask事件，false表示执行完第一次超时触发事件后，该事件就停止运行
4	setCover	bool	true表示重新计时，false表示不重新计时
5	timeOut_s	uint32_t	0表示立即触发，无周期性事件，非0表示以时间做超时事件

4、单次触发事件

void event_post(uint32_t mask);

执行后会立即触发该事件。

5、清除停止事件

void event_clear(uint32_t mask);

执行后会立即停止该事件的执行。

5、缓存事件触发标志

uint32_t event_pend(void);

该函数放在主循环中执行，会先把所有的事件标志缓存起来，供后续事件判断处理。

6、获取事件状态

uint32_t getEvent(uint32_t mask);

获取事件状态，返回值0表示该事件未触发，非0表示该事件已触发。

示例

#include <stdarg.h>
#include <string.h>
#include <stdio.h>
#include "eventUnit.h"

#define EVENT_TIME_CYCLE_10ms           0
#define EVENT_TIME_CYCLE_500ms          1

void MAIN_TIM_CALLBACK(uint8_t status, uint32_t param)
{
   
    static uint16_t timeCnt_1ms = 0;
    if(++ timeCnt_1ms == 5)
    {
   
        timeCnt_1ms = 0;
        eventDriver();
    }
}
void MAIN_TIM_1S_CALLBACK(uint8_t status, uint32_t param)
{
   
    eventDriver1s()