ARTICLE · 1392661
十六、软件定时器实战:超时提示、自动息屏和定期上报
软件定时器实战:超时提示、自动息屏和定期上报
桌面终端一直亮着,用户离开后也没人操作。我们希望它过一会儿给出闲置提示,再自动关闭显示。与此同时,设备还要每隔几秒输出一次状态。
这些功能都与时间有关,但触发方式不同。
本篇使用三个FreeRTOS 软件定时器,分别实现一次性超时和周期触发。
一、这次实现什么?
继续使用ESP32-S3 N16R8+ESP-IDF v5.5.5。
KEY1 增加进度,KEY2 减少进度,KEY3 清零。
本篇的“上报”先输出到串口。后面接入上位机,再把同类状态通过通信协议发送出去。
二、一次性定时器和周期定时器
创建软件定时器时,可以选择到期后是否自动重装。
pdFALSE | ||
pdTRUE |
一次性定时器到期后停止,下一次按键操作调用 xTimerReset(),它就重新开始计时。
周期定时器到期后继续安排下一次触发。
这些回调由 FreeRTOS 的定时器服务任务执行。回调应尽快返回,避免在里面等待或执行耗时操作。ESP-IDF v5.5.5 软件定时器说明
三、定时器只发通知,显示任务处理画面
本篇采用下面的流程。
按键任务 ── 按键通知 ──┐│定时器回调 ─ 到期通知 ─┼── 显示任务 ── 更新 OLED 与串口日志│
定时器回调只发送通知位。OLED 亮灭、进度更新和日志输出,都由显示任务完成。
这样,显示缓冲区仍然只有一个任务修改。
四、接线与工程准备
OLED 地址使用前面实测值。正常上电或复位时松开 KEY3。
本篇重新使用 board_button 组件扫描按键,确认其引脚表和输入掩码均已更新。
打开:
D:\esp_projects\desktop_terminal\main\hello_world_main.c保留 OLED 基础绘图函数和 oled_init()。
删除上一章事件组的状态定义、全局变量,以及 oled_init() 后面的事件组实验代码。头文件中加入:
#include"freertos/timers.h"#include"board_button.h"
然后在 oled_init() 后添加以下代码。
#define EVENT_KEY1 (1U << 0)#define EVENT_KEY2 (1U << 1)#define EVENT_KEY3 (1U << 2)#define EVENT_WARNING (1U << 3)#define EVENT_SLEEP (1U << 4)#define EVENT_REPORT (1U << 5)#define EVENT_KEYS (EVENT_KEY1 | EVENT_KEY2 | EVENT_KEY3)static const char *TIMER_TAG = "timer_demo";static TaskHandle_t display_task_handle;static TimerHandle_t warning_timer;static TimerHandle_t sleep_timer;static TimerHandle_t report_timer;staticvoidwarning_callback(TimerHandle_t timer){(void)timer;xTaskNotify(display_task_handle, EVENT_WARNING, eSetBits);}staticvoidsleep_callback(TimerHandle_t timer){(void)timer;xTaskNotify(display_task_handle, EVENT_SLEEP, eSetBits);}staticvoidreport_callback(TimerHandle_t timer){(void)timer;xTaskNotify(display_task_handle, EVENT_REPORT, eSetBits);}staticvoidreset_idle_timers(void){if (xTimerReset(warning_timer, pdMS_TO_TICKS(100)) != pdPASS) {ESP_LOGE(TIMER_TAG, "Failed to reset warning timer");abort();}if (xTimerReset(sleep_timer, pdMS_TO_TICKS(100)) != pdPASS) {ESP_LOGE(TIMER_TAG, "Failed to reset sleep timer");abort();}}staticvoiddraw_timer_screen(esp_lcd_panel_handle_t panel,int progress, bool warning){memset(frame, 0, sizeof(frame));draw_rect(0, 0, OLED_WIDTH, OLED_HEIGHT);draw_text(12, 12, "HELLO ESP32");draw_hline(12, 25, 104);draw_rect(12, 36, 102, 12);for (int row = 38; row < 46; ++row) {draw_hline(13, row, progress);}if (warning) {draw_hline(12, 55, 104);draw_hline(12, 56, 104);}ESP_ERROR_CHECK(esp_lcd_panel_draw_bitmap(panel, 0, 0, OLED_WIDTH, OLED_HEIGHT, frame));}staticvoiddisplay_task(void *arg){esp_lcd_panel_handle_t panel = arg;int progress = 0;bool warning = false;bool screen_on = true;draw_timer_screen(panel, progress, warning);TickType_t last_activity = xTaskGetTickCount();reset_idle_timers();if (xTimerStart(report_timer, pdMS_TO_TICKS(100)) != pdPASS) {ESP_LOGE(TIMER_TAG, "Failed to start report timer");abort();}while (1) {uint32_t events = 0;if (xTaskNotifyWait(0, UINT32_MAX, &events,portMAX_DELAY) != pdTRUE) {continue;}if (events & EVENT_KEYS) {last_activity = xTaskGetTickCount();warning = false;if (events & EVENT_KEY1) {progress += 10;if (progress > 100) {progress = 100;}}if (events & EVENT_KEY2) {progress -= 10;if (progress < 0) {progress = 0;}}if (events & EVENT_KEY3) {progress = 0;}reset_idle_timers();draw_timer_screen(panel, progress, warning);if (!screen_on) {ESP_ERROR_CHECK(esp_lcd_panel_disp_on_off(panel, true));screen_on = true;}ESP_LOGI(TIMER_TAG, "Activity, progress=%d%%", progress);}TickType_t idle_ticks = xTaskGetTickCount() - last_activity;if ((events & EVENT_WARNING)&& idle_ticks >= pdMS_TO_TICKS(5000)&& screen_on&& !warning) {warning = true;draw_timer_screen(panel, progress, warning);ESP_LOGI(TIMER_TAG, "Idle warning");}if ((events & EVENT_SLEEP)&& idle_ticks >= pdMS_TO_TICKS(10000)&& screen_on) {ESP_ERROR_CHECK(esp_lcd_panel_disp_on_off(panel, false));screen_on = false;ESP_LOGI(TIMER_TAG, "OLED off");}if (events & EVENT_REPORT) {ESP_LOGI(TIMER_TAG,"Report: progress=%d%%, screen=%s, warning=%s",progress,screen_on ? "ON" : "OFF",warning ? "YES" : "NO");}}}staticvoidbutton_task(void *arg){(void)arg;ESP_ERROR_CHECK(board_button_init());TickType_t scan_delay = pdMS_TO_TICKS(10);if (scan_delay == 0) {scan_delay = 1;}while (1) {board_button_events_t buttons = board_button_scan();uint32_t events = 0;if (buttons.short_press & (1U << 0)) {events |= EVENT_KEY1;}if (buttons.short_press & (1U << 1)) {events |= EVENT_KEY2;}if (buttons.short_press & (1U << 2)) {events |= EVENT_KEY3;}if (events != 0) {xTaskNotify(display_task_handle, events, eSetBits);}vTaskDelay(scan_delay);}}voidapp_main(void){esp_lcd_panel_handle_t panel = oled_init();if (panel == NULL) {return;}warning_timer = xTimerCreate("idle_warning", pdMS_TO_TICKS(5000),pdFALSE, NULL, warning_callback);sleep_timer = xTimerCreate("idle_sleep", pdMS_TO_TICKS(10000),pdFALSE, NULL, sleep_callback);report_timer = xTimerCreate("report", pdMS_TO_TICKS(3000),pdTRUE, NULL, report_callback);if (warning_timer == NULL|| sleep_timer == NULL|| report_timer == NULL) {ESP_LOGE(TIMER_TAG, "Failed to create timers");abort();}if (xTaskCreate(display_task, "display", 4096,panel, 2, &display_task_handle) != pdPASS) {ESP_LOGE(TIMER_TAG, "Failed to create display task");abort();}if (xTaskCreate(button_task, "button", 4096,NULL, 2, NULL) != pdPASS) {ESP_LOGE(TIMER_TAG, "Failed to create button task");abort();}}
对应的 main/CMakeLists.txt 使用:
idf_component_register(SRCS "hello_world_main.c"INCLUDE_DIRS "."PRIV_REQUIRESboard_buttonesp_driver_i2cesp_lcdesp_commonfreertoslog)
本篇的定时器回调运行在任务上下文,所以使用普通 xTaskNotify()。第十四篇的 GPIO ISR 则使用 FromISR 接口。
五、为什么收到超时通知后,还检查闲置时间?
可能出现这样的顺序:
旧定时器到期,超时通知已经发出。 用户按键,按键通知也到达显示任务。 显示任务一次取到了两种通知。
如果直接根据超时位息屏,刚刚操作过的设备就可能马上变黑。
代码先处理按键,更新 last_activity,再核对闲置时间。刚发生操作时,旧超时通知就会被忽略。
xTimerReset() 会重新安排定时器到期时间,但它通过定时器命令队列提交操作,因此仍要检查返回值。这里的 100 毫秒是等待命令入队的最长时间,实际定时周期仍是创建时的 5 秒或 10 秒。乐鑫 xTimerReset() 说明
六、烧录后按顺序验证
Set-Location D:\esp_projects\desktop_terminalidf.py -p COM4 build flash monitor
将 COM4 换成实际端口。
Idle warning | |
OLED off | |
空闲时可能看到:
Report: progress=0%, screen=ON, warning=NOIdle warningReport: progress=0%, screen=ON, warning=YESOLED offReport: progress=0%, screen=OFF, warning=YES
息屏后出现上报日志,说明应用仍在运行。这里调用的是 OLED 显示开关,开发板和任务仍然工作。

本例使用通知位,显示任务尚未处理时,同一类通知可能合并。演示时按普通节奏操作即可。需要逐条保留快速按键事件时,可以继续采用第十二篇的队列。
下一篇:程序为什么卡住或重启?排查死锁、栈溢出和看门狗。















































































