夜雨聆风学习资料网

ARTICLE · 1392661

十六、软件定时器实战:超时提示、自动息屏和定期上报

十六、软件定时器实战:超时提示、自动息屏和定期上报

软件定时器实战:超时提示、自动息屏和定期上报

桌面终端一直亮着,用户离开后也没人操作。我们希望它过一会儿给出闲置提示,再自动关闭显示。与此同时,设备还要每隔几秒输出一次状态。

这些功能都与时间有关,但触发方式不同。

本篇使用三个FreeRTOS 软件定时器,分别实现一次性超时和周期触发。

一、这次实现什么?

继续使用ESP32-S3 N16R8+ESP-IDF v5.5.5。

功能
时间规则
效果
闲置提示
5 秒没有收到按键事件
OLED 底部出现提示线
自动息屏
10 秒没有收到按键事件
关闭 OLED 显示
定期上报
每隔 3 秒
串口打印进度和屏幕状态
按键操作
短按任意键
清除提示、恢复显示、重新计时

KEY1 增加进度,KEY2 减少进度,KEY3 清零。

本篇的“上报”先输出到串口。后面接入上位机,再把同类状态通过通信协议发送出去。

二、一次性定时器和周期定时器

创建软件定时器时,可以选择到期后是否自动重装。

类型
创建参数
本篇用途
一次性定时器
pdFALSE
闲置提示、自动息屏
周期定时器
pdTRUE
每隔 3 秒输出状态

一次性定时器到期后停止,下一次按键操作调用 xTimerReset(),它就重新开始计时。

周期定时器到期后继续安排下一次触发。

这些回调由 FreeRTOS 的定时器服务任务执行。回调应尽快返回,避免在里面等待或执行耗时操作。ESP-IDF v5.5.5 软件定时器说明

三、定时器只发通知,显示任务处理画面

本篇采用下面的流程。

按键任务 ── 按键通知 ──┐                      │定时器回调 ─ 到期通知 ─┼── 显示任务 ── 更新 OLED 与串口日志                      │

定时器回调只发送通知位。OLED 亮灭、进度更新和日志输出,都由显示任务完成。

这样,显示缓冲区仍然只有一个任务修改。

四、接线与工程准备

功能
GPIO
KEY1
GPIO40
KEY2
GPIO39
KEY3
GPIO0
OLED SDA
GPIO41
OLED SCL(模块若标 SCK,即时钟线)
GPIO42

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_REQUIRES        board_button        esp_driver_i2c        esp_lcd        esp_common        freertos        log)

本篇的定时器回调运行在任务上下文,所以使用普通 xTaskNotify()。第十四篇的 GPIO ISR 则使用 FromISR 接口。

五、为什么收到超时通知后,还检查闲置时间?

可能出现这样的顺序:

  1. 旧定时器到期,超时通知已经发出。
  2. 用户按键,按键通知也到达显示任务。
  3. 显示任务一次取到了两种通知。

如果直接根据超时位息屏,刚刚操作过的设备就可能马上变黑。

代码先处理按键,更新 last_activity,再核对闲置时间。刚发生操作时,旧超时通知就会被忽略。

xTimerReset() 会重新安排定时器到期时间,但它通过定时器命令队列提交操作,因此仍要检查返回值。这里的 100 毫秒是等待命令入队的最长时间,实际定时周期仍是创建时的 5 秒或 10 秒。乐鑫 xTimerReset() 说明

六、烧录后按顺序验证

Set-Location D:\esp_projects\desktop_terminalidf.py -p COM4 build flash monitor

将 COM4 换成实际端口。

操作
预期结果
启动后不操作
每约 3 秒输出状态日志
闲置约 5 秒
底部出现双横线,并输出 Idle warning
继续闲置到约 10 秒
OLED 关闭,输出 OLED off
短按 KEY1 后松开
OLED 恢复,进度增加,提示线消失
再等待约 5 秒
从这次操作重新计时,提示线再次出现

空闲时可能看到:

Report: progress=0%, screen=ON, warning=NOIdle warningReport: progress=0%, screen=ON, warning=YESOLED offReport: progress=0%, screen=OFF, warning=YES

息屏后出现上报日志,说明应用仍在运行。这里调用的是 OLED 显示开关,开发板和任务仍然工作。

本例使用通知位,显示任务尚未处理时,同一类通知可能合并。演示时按普通节奏操作即可。需要逐条保留快速按键事件时,可以继续采用第十二篇的队列。

下一篇:程序为什么卡住或重启?排查死锁、栈溢出和看门狗。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料