2、事件源与事件类型：触摸、按键、定时器、自定义事件的分类与定义

事件驱动，说白了就是「谁触发了什么事，然后谁来处理」。在嵌入式GUI里，事件源就是那个「谁」。我做了这么多年嵌入式UI，发现很多新手上来就写回调函数，却搞不清事件到底从哪来的。这就像你接到一个电话，却不知道是谁打的——那你怎么处理？

所以今天咱们先把「事件源」和「事件类型」这两个基础概念掰扯清楚。嗯，这部分虽然基础，但后面所有机制都建立在这上面。

2.1 事件源的本质

事件源，就是产生事件的硬件或软件实体。在嵌入式系统里，常见的就这几类：

• 物理输入设备：触摸屏、按键、旋钮、摇杆
• 系统定时器：周期性触发，用于刷新、动画、超时检测
• 通信接口：串口、SPI、I2C 收到的数据
• 软件内部：状态机跳转、数据更新、任务完成通知

每个事件源都有一个唯一的标识符。我习惯用枚举来定义，清晰又安全。

2.2 触摸事件：最常用的交互方式

触摸事件是现在嵌入式GUI的标配。但你真的了解它的完整生命周期吗？

一个完整的触摸事件，从物理接触开始，到手指抬起结束，中间会经历多个阶段：

事件类型	触发条件	典型应用
TOUCH_DOWN	手指按下触摸屏	按钮按下反馈、开始拖动
TOUCH_MOVE	手指在屏幕上滑动	滑动条、绘图、翻页
TOUCH_UP	手指离开屏幕	按钮释放、确认选择
TOUCH_CLICK	按下后快速抬起（无移动）	按钮点击、菜单选择
TOUCH_LONG_PRESS	按下超过一定时间（如500ms）	右键菜单、删除确认

我在一个智能家居面板项目里遇到过一个问题：用户快速滑动时，系统把 MOVE 事件误判成了多个 CLICK 事件。后来我在事件队列里加了一个「时间戳+坐标变化量」的过滤逻辑，才解决。你想想看，如果连点击和滑动都分不清，用户得多崩溃？

2.3 按键事件：简单但容易踩坑

按键看起来简单，不就是按下和弹起吗？但实际项目中，按键的「抖动」问题能把人逼疯。

按键事件通常分为：

• KEY_DOWN：按键被按下（物理电平变化）
• KEY_UP：按键被释放
• KEY_REPEAT：长按时自动重复（比如调节音量）
• KEY_COMBO：组合键（比如 Ctrl+C）

我曾经在一个工业控制器项目里，因为没做按键消抖，导致一次按下触发了三次事件。操作员按一次「启动」，机器启动了三次……嗯，从那以后我再也不敢省消抖逻辑了。

2.4 定时器事件：系统的脉搏

定时器事件是嵌入式GUI的「隐形引擎」。没有它，动画不会动，界面不会刷新，超时检测也做不了。

定时器事件通常分两类：

类型	行为	典型用途
单次定时器	到达时间后触发一次，自动停止	超时提示、延迟跳转
周期定时器	每隔固定时间触发一次，直到手动停止	帧率刷新、光标闪烁、数据轮询

每个定时器事件必须包含：定时器ID、触发时间、剩余次数（如果是周期定时器）。我个人习惯把定时器ID和事件源ID统一管理，这样调试时一眼就能看出是哪个定时器触发了什么事件。

2.5 自定义事件：让系统活起来

前面说的都是硬件或系统自带的事件源。但实际项目中，你一定会需要自己定义事件。比如：

• 网络连接成功/断开
• 数据下载完成
• 传感器阈值超限
• 页面切换完成
• 用户登录状态变化

自定义事件的定义方式，我推荐用结构体：

typedef struct {
    uint16_t event_id;      // 事件ID（必须唯一）
    uint16_t source_id;     // 事件源ID
    uint32_t timestamp;     // 时间戳
    uint8_t  priority;      // 优先级（0最高）
    void*    data;          // 附加数据指针
    uint16_t data_len;      // 数据长度
} Event_t;

你看，这个结构体里我特意留了一个 void* data 字段。为什么？因为自定义事件往往需要携带额外信息。比如「网络连接成功」事件，你可能需要带上IP地址；「传感器超限」事件，你需要带上当前数值和阈值。

2.6 事件分类与定义的整体架构

说了这么多，咱们用一张图把整个事件源和事件类型的体系串起来：

2.7 事件定义的最佳实践

最后，我总结几条在项目中反复验证过的经验：

1. 枚举优先于宏定义：用 typedef enum 定义事件ID，编译器能帮你检查类型错误。
2. 事件ID分段管理：系统事件、驱动事件、应用事件各占一段区间，互不干扰。
3. 事件结构体统一：所有事件共用同一个结构体，用 data 指针携带附加信息。别为每种事件单独定义结构体，那会让代码变得臃肿。
4. 时间戳必须带：哪怕你现在觉得用不上，以后调试性能问题、分析事件顺序时，时间戳就是救命稻草。
5. 优先级别滥用：优先级字段留给真正紧急的事件（比如看门狗超时、紧急停止）。普通触摸和按键事件，优先级相同就好。