LVGL9 定时器模块

---

前言

在嵌入式图形开发中，定时任务是一个非常常见的需求，通常用于实现周期性操作或延迟功能。LVGL 提供了内置的定时器（Timer）系统，允许开发者注册回调函数，并在指定的时间间隔内调用这些函数。本文将详细介绍 LVGL 定时器系统的功能、使用方法以及相关的 API。

---

定时器系统概述

LVGL 的定时器系统允许用户注册函数并在指定的时间间隔内周期性调用。所有定时器的回调函数由 lv_timer_handler() 函数统一调度，因此需要在程序中定期调用 lv_timer_handler()（通常在主循环中）。

特点

1. 非抢占式：定时器无法中断其他定时器或任务，因此可以在定时器中安全调用任何 LVGL 函数。
2. 灵活性：支持动态设置定时器周期、回调函数、重复次数等参数。

---

定时器的创建

函数：lv_timer_create

作用
创建一个新的定时器并指定其回调函数和调用周期。

原型

lv_timer_t * lv_timer_create(lv_timer_cb_t timer_cb, uint32_t period_ms, void * user_data);

参数

• timer_cb：回调函数指针，格式为 void (*lv_timer_cb_t)(lv_timer_t *)。
• period_ms：定时器的调用周期（毫秒）。
• user_data：用户自定义数据，可在回调函数中通过 timer->user_data 访问。

返回值
返回一个 lv_timer_t * 指针，用于管理创建的定时器。

示例代码

void my_timer_callback(lv_timer_t * timer) {uint32_t * user_data = timer->user_data;printf("Timer called, user data: %d\n", *user_data);
}static uint32_t my_data = 42;
lv_timer_t * timer = lv_timer_create(my_timer_callback, 1000, &my_data);

函数：lv_timer_create_basic

作用
创建一个基本定时器，不需要指定初始参数。

原型

lv_timer_t * lv_timer_create_basic(void);

返回值
返回一个未初始化的 lv_timer_t * 指针。可以稍后设置其参数。

示例代码

lv_timer_t * timer = lv_timer_create_basic();
lv_timer_set_cb(timer, my_timer_callback);
lv_timer_set_period(timer, 500);

---

定时器的控制

函数：lv_timer_ready

作用
使定时器在下次调用 lv_timer_handler() 时立即执行。

原型

void lv_timer_ready(lv_timer_t * timer);

参数

• timer：目标定时器。

示例代码

lv_timer_ready(timer);

---

函数：lv_timer_reset

作用
重置定时器的周期，使其在指定的时间间隔后再次执行。

原型

void lv_timer_reset(lv_timer_t * timer);

参数

• timer：目标定时器。

示例代码

lv_timer_reset(timer);

---

定时器的参数设置

函数：lv_timer_set_cb

作用
更改定时器的回调函数。

原型

void lv_timer_set_cb(lv_timer_t * timer, lv_timer_cb_t new_cb);

示例代码

lv_timer_set_cb(timer, new_timer_callback);

---

函数：lv_timer_set_period

作用
修改定时器的调用周期。

原型

void lv_timer_set_period(lv_timer_t * timer, uint32_t new_period);

示例代码

lv_timer_set_period(timer, 2000); // 修改周期为 2 秒

---

函数：lv_timer_set_repeat_count

作用
设置定时器的重复次数，自动删除达到次数的定时器。

原型

void lv_timer_set_repeat_count(lv_timer_t * timer, int32_t count);

参数

• count：重复次数，-1 表示无限循环，0 表示不重复。

示例代码

lv_timer_set_repeat_count(timer, 5); // 定时器运行 5 次后自动删除

---

定时器的启用与暂停

函数：lv_timer_enable

作用
启用或禁用定时器。

原型

void lv_timer_enable(lv_timer_t * timer, bool en);

示例代码

lv_timer_enable(timer, true); // 启用定时器
lv_timer_enable(timer, false); // 禁用定时器

---

函数：lv_timer_pause 和 lv_timer_resume

作用
暂停或恢复指定的定时器。

原型

void lv_timer_pause(lv_timer_t * timer);
void lv_timer_resume(lv_timer_t * timer);

示例代码

lv_timer_pause(timer);  // 暂停定时器
lv_timer_resume(timer); // 恢复定时器

---

异步调用

函数：lv_async_call

作用
延迟调用一个函数，在下次调用 lv_timer_handler() 时执行。

原型

void lv_async_call(lv_async_cb_t async_cb, void * user_data);

示例代码

void cleanup_function(void * data) {lv_obj_delete((lv_obj_t *)data);
}lv_async_call(cleanup_function, lv_screen_active());

---

测量空闲时间

函数：lv_timer_get_idle

作用
获取 lv_timer_handler() 的空闲时间百分比。

原型

uint8_t lv_timer_get_idle(void);

返回值
一个 0-100 的值，表示空闲时间百分比。

示例代码

uint8_t idle = lv_timer_get_idle();
printf("Idle time: %d%%\n", idle);

---

总结

LVGL 的定时器系统提供了强大的功能，支持各种灵活的定时任务管理方式，从基本的周期调用到复杂的异步操作，都可以通过简单的接口实现。掌握这些 API，可以帮助开发者更高效地设计和实现图形界面的动态行为。