LVGL9 定时器模块

文章目录


前言

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


定时器系统概述

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

特点

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

定时器的创建

函数:lv_timer_create

作用

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

原型

c 复制代码
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 * 指针,用于管理创建的定时器。

示例代码

c 复制代码
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

作用

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

原型

c 复制代码
lv_timer_t * lv_timer_create_basic(void);

返回值

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

示例代码

c 复制代码
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() 时立即执行。

原型

c 复制代码
void lv_timer_ready(lv_timer_t * timer);

参数

  • timer:目标定时器。

示例代码

c 复制代码
lv_timer_ready(timer);

函数:lv_timer_reset

作用

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

原型

c 复制代码
void lv_timer_reset(lv_timer_t * timer);

参数

  • timer:目标定时器。

示例代码

c 复制代码
lv_timer_reset(timer);

定时器的参数设置

函数:lv_timer_set_cb

作用

更改定时器的回调函数。

原型

c 复制代码
void lv_timer_set_cb(lv_timer_t * timer, lv_timer_cb_t new_cb);

示例代码

c 复制代码
lv_timer_set_cb(timer, new_timer_callback);

函数:lv_timer_set_period

作用

修改定时器的调用周期。

原型

c 复制代码
void lv_timer_set_period(lv_timer_t * timer, uint32_t new_period);

示例代码

c 复制代码
lv_timer_set_period(timer, 2000); // 修改周期为 2 秒

函数:lv_timer_set_repeat_count

作用

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

原型

c 复制代码
void lv_timer_set_repeat_count(lv_timer_t * timer, int32_t count);

参数

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

示例代码

c 复制代码
lv_timer_set_repeat_count(timer, 5); // 定时器运行 5 次后自动删除

定时器的启用与暂停

函数:lv_timer_enable

作用

启用或禁用定时器。

原型

c 复制代码
void lv_timer_enable(lv_timer_t * timer, bool en);

示例代码

c 复制代码
lv_timer_enable(timer, true); // 启用定时器
lv_timer_enable(timer, false); // 禁用定时器

函数:lv_timer_pauselv_timer_resume

作用

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

原型

c 复制代码
void lv_timer_pause(lv_timer_t * timer);
void lv_timer_resume(lv_timer_t * timer);

示例代码

c 复制代码
lv_timer_pause(timer);  // 暂停定时器
lv_timer_resume(timer); // 恢复定时器

异步调用

函数:lv_async_call

作用

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

原型

c 复制代码
void lv_async_call(lv_async_cb_t async_cb, void * user_data);

示例代码

c 复制代码
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() 的空闲时间百分比。

原型

c 复制代码
uint8_t lv_timer_get_idle(void);

返回值

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

示例代码

c 复制代码
uint8_t idle = lv_timer_get_idle();
printf("Idle time: %d%%\n", idle);

总结

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

相关推荐
十年编程老舅24 分钟前
跨越十年的C++演进:C++20新特性全解析
c++·c++11·c++20·c++14·c++23·c++17·c++新特性
小眼睛FPGA2 小时前
【RK3568+PG2L50H开发板实验例程】FPGA部分/紫光同创 IP core 的使用及添加
科技·嵌入式硬件·ai·fpga开发·gpu算力
小刘同学3212 小时前
C++11 特性
c++·c11新特性
真的想上岸啊2 小时前
学习C++、QT---18(C++ 记事本项目的stylesheet)
开发语言·c++·学习
m0_552200822 小时前
《UE5_C++多人TPS完整教程》学习笔记40 ——《P41 装备(武器)姿势(Equipped Pose)》
c++·游戏·ue5
竹照煜_ysn2 小时前
STM32
stm32·单片机·嵌入式硬件
丁劲犇3 小时前
用 Turbo Vision 2 为 Qt 6 控制台应用创建 TUI 字符 MainFrame
开发语言·c++·qt·tui·字符界面·curse
蓬荜生灰4 小时前
永磁无刷电机旋转原理
单片机·嵌入式硬件
charlie1145141914 小时前
深入理解Qt的SetWindowsFlags函数
开发语言·c++·qt·原理分析