1. 课程导入

各位同学，咱们今天正式开讲《LVGL事件响应机制与交互设计》的第一章。说实话，事件驱动模型这个概念，很多嵌入式工程师一开始都觉得有点虚——不就是按个键、点个屏嘛？但等你真正做复杂UI的时候，就会发现这里面门道很深。我当年第一次用LVGL做智能家居面板，就是因为没搞懂事件循环，结果屏幕卡死在那，用户怎么点都没反应。嗯，从那以后，我老老实实把事件模型啃了一遍。

说白了，LVGL的事件驱动模型就是一套「谁发生了什么事，该由谁来处理」的规则。你想想看，一个嵌入式系统里，触摸、按键、定时器、动画完成……各种事情随时可能发生。如果没有一套清晰的机制，代码很快就乱成一锅粥了。

1.1 LVGL事件循环机制

LVGL的主循环，说白了就是一个死循环——while(1) 里不断调用 lv_timer_handler()。这个函数就是整个事件系统的发动机。

// 典型的LVGL主循环
while(1) {
    lv_timer_handler();  // 处理定时器、事件、动画等
    my_delay(5);         // 适当延时，避免CPU跑满
}

我习惯把这个循环叫做「心跳」。每次 lv_timer_handler() 被调用，它会做三件事：

1. 处理定时器——检查哪些定时器到期了，执行回调
2. 处理事件队列——从队列里取出待处理的事件，分发给目标对象
3. 刷新显示——如果有脏区域，触发重绘

这里有个关键点：所有事件处理都在这个主线程里完成。你如果在事件回调里写了个死循环或者长时间阻塞，整个UI就冻住了。我踩过这个坑——有一次在按钮回调里做了个延时100ms的等待，结果触摸滑动变得一卡一卡的。

1.2 事件注册与分发流程

事件注册，就是告诉LVGL：「嘿，这个对象上发生了某某事件，你来调用我这个函数。」

注册方式很简单，用 lv_obj_add_event_cb()：

// 给按钮注册点击事件
lv_obj_add_event_cb(btn, btn_click_cb, LV_EVENT_CLICKED, NULL);

// 回调函数
static void btn_click_cb(lv_event_t * e) {
    lv_obj_t * btn = lv_event_get_target(e);
    LV_LOG_USER("按钮被点击了！");
}

你看，四个参数：对象、回调函数、事件类型、用户数据。事件类型有很多种，我整理了个表格：

事件类型	触发时机	常见用途
LV_EVENT_CLICKED	点击完成（按下+释放）	按钮确认、菜单选择
LV_EVENT_PRESSING	正在按下（持续触发）	长按检测、进度反馈
LV_EVENT_VALUE_CHANGED	值发生变化	滑块拖动、开关切换
LV_EVENT_RELEASED	手指抬起	滑动结束、拖拽完成
LV_EVENT_KEY	物理按键按下	键盘导航、编码器输入

分发流程呢？当事件发生时（比如触摸屏检测到点击），LVGL内部会做这几步：

1. 命中检测——根据触摸坐标，找到最上层的可点击对象
2. 事件生成——创建事件结构体，包含目标对象、事件类型、参数
3. 入队——把事件放入全局事件队列
4. 出队分发——主循环取出事件，调用该对象上注册的所有回调
5. 事件冒泡——如果回调没有处理（或设置了冒泡），事件会传给父对象

1.3 事件队列工作原理

事件队列，说白了就是一个先进先出的缓冲区。LVGL内部维护了一个链表，每个节点就是一个待处理的事件。

我画了一张图，帮你理解整个流程：

事件队列的大小是动态的。LVGL内部用 lv_ll_t（链表）来管理，可以无限增长——当然，实际上受内存限制。如果事件产生速度大于处理速度，队列就会越来越长，最终导致内存耗尽。

我记得有个项目，触摸屏驱动在中断里直接调用了 lv_indev_read()，结果中断频率太高，事件队列瞬间塞了几百个事件，内存直接爆了。后来我改成在中断里只设置标志位，主循环里再读取触摸数据，问题就解决了。

1.4 事件冒泡与事件拦截

LVGL的事件冒泡，跟网页的DOM事件冒泡很像。默认情况下，事件处理完当前对象后，会继续传给父对象。你可以用 lv_event_stop_bubbling() 来阻止冒泡。

// 阻止事件冒泡
static void btn_cb(lv_event_t * e) {
    // 处理事件...
    lv_event_stop_bubbling(e);  // 事件不再传给父对象
}

什么时候需要冒泡？举个例子：你有一个容器，里面放了多个按钮。你想在容器层面统一处理所有按钮的点击事件，而不是给每个按钮单独注册回调。这时候就可以利用事件冒泡——给容器注册事件，子按钮的事件会自动冒泡上来。

1.5 自定义事件

除了系统预定义的事件，你还可以发送自定义事件。这在多组件通信时特别有用。

// 发送自定义事件
lv_event_send(obj, LV_EVENT_USER + 1, some_data);

// 接收自定义事件
lv_obj_add_event_cb(obj, my_custom_cb, LV_EVENT_USER + 1, NULL);

我习惯用自定义事件来做模块间的解耦。比如一个温度传感器模块，检测到温度超标时，发送一个自定义事件给UI模块，UI模块收到后弹出警告框。这样传感器模块不需要知道UI模块的任何细节，代码耦合度大大降低。