大飞的技术博客

·约 5 分钟·

每分钟刷一次屏的待机时钟:轻睡走针与两个中断坑

用 LCD 或段码屏做时钟是躺赢:RTC 加定时器,屏幕自己会走。换成墨水屏,每过一分钟都要真实地驱动一次玻璃——PocketOracle(电子抽签器)偏偏就要一块默认常开的待机时钟:大字 HH:MM、日期、倒数日或节气、天气,右上角一格 wifi 加电量。这篇讲它的完整方案:轻睡走针,RTC 秒边界对齐,每分钟快刷,整点清残影,以及路上踩到的两个中断坑。

为什么是轻睡,不是深睡

这板子有个先天限制(深睡唤醒的来龙去脉见旧文):ESP32-C3 只有 GPIO0-5 能做深睡唤醒源,而按键 SW2=GPIO20、KEY1=GPIO21、加速度计 INT1=GPIO19 全部不在名单里——深睡只能靠定时器醒。待机时钟要是进了深睡,就是单程票:用户按任何键都没有回应,时钟页面变成不可达。

所以待机时钟用轻睡:静态电流约 130µA,所有引脚的中断都活着,任何按键或摇晃都能瞬时唤醒回菜单。功耗账也说得过去:待机的大头是轻睡的静态电流,面板驱动只在每分钟的半秒里发生——墨水屏「不刷新不耗电、断电保持画面」的属性,在这里兑现成「两次刷新之间,显示是免费的」。

节拍:睡到下一个分钟边界

核心循环的骨架:

for (;;) {
    gpio_wakeup_enable(PIN_KEY1, GPIO_INTR_LOW_LEVEL);
    gpio_wakeup_enable(PIN_BTN_REDRAW, GPIO_INTR_LOW_LEVEL);
    gpio_wakeup_enable(PIN_WAKE_INT1, GPIO_INTR_HIGH_LEVEL);
    esp_sleep_enable_gpio_wakeup();

    rx8010_time_t t;
    uint32_t secs = 60;
    if (rx8010_get_time(&t) == ESP_OK) secs = 60 - t.second;
    if (secs == 0) secs = 60;
    esp_sleep_enable_timer_wakeup((uint64_t)secs * 1000000ULL);
    esp_light_sleep_start();

    esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
    // ... 分诊:GPIO 唤醒回菜单 / 定时器唤醒重画
    draw_standby_face();
    if (ui_now_valid && ui_now.minute == 0)
        ui_refresh_or_sleep(sleep_us);      // 整点:GC 清残影
    else if (epd_fast_refresh_keep(ui_fb) != ESP_OK) {
        epd_sleep();
        enter_deep_sleep(sleep_us);         // 快刷失败:深睡兜底
    }
}

三个小设计:

对齐真实时钟的秒边界,而不是睡满 60 秒。 每次醒来读硬件 RTC 的当前秒,睡 60 - second——睡眠和刷新本身的耗时不会累积成分钟漂移,分针永远踩在真实的分钟边界上。RTC 失效(RX8010 的 VL 位)时退化为固定 60 秒,并且脸上直接显示「RTC 无效」,而不是一个煞有介事的错误时间。

唤醒分诊。 GPIO 唤醒 = 用户碰了设备,回菜单;定时器唤醒 = 走针,重画待机脸。

失败兜底。 快刷超时或 SPI 出错,说明屏或线可疑:立即 epd_sleep 断屏、进深睡等定时唤醒,别让一块坏屏把电池拖死。

刷新节奏的分工(灰漂账本详见前文):每分钟 epd_fast_refresh_keep 走针——DU 快刷,不触发驱动的自动清屏计数;整点 minute == 0 换成一次 GC 全刷。让闪烁发生在用户预期里(整点),而不是随机第 10 分钟。

还有一条静态媒介的自觉:待机脸的时间是进页快照,电子纸不做分钟内的局部重绘,右上角的状态簇也是唤醒时采一次样。屏幕是什么媒介,就按什么媒介的规矩设计信息密度。

坑一:gpio_wakeup_enable 会静默改写中断类型

症状:从待机时钟回菜单后,菜单里 SW2 五连按进配网页的快捷手势,时灵时不灵。

根因藏在 API 的副作用里。为了能被按键唤醒,循环里对 SW2 调了 gpio_wakeup_enable(pin, GPIO_INTR_LOW_LEVEL)——这个函数会把引脚的中断类型从 NEGEDGE 静默改写成 LOW_LEVEL。而 SW2 停在 UART0 的 RX 脚上,五连按计数器靠的是这个脚的下降沿中断;睡眠唤醒配置一写,边沿中断悄悄变成了共享串口脚上的电平中断,串口线上每个低电平字节都会触发它。

对策是「进门前停车,出门后恢复」:

// SW2 is a light-sleep wake source below, and gpio_wakeup_enable()
// silently rewrites its int type (NEGEDGE -> LOW_LEVEL), leaving a
// level-triggered interrupt on the shared RX pin. Park the five-tap
// tracker's interrupt for the whole face and restore it on the way out.
gpio_intr_disable(PIN_BTN_REDRAW);
for (;;) { ... }
// 退出路径:
gpio_set_intr_type(PIN_BTN_REDRAW, GPIO_INTR_NEGEDGE);
gpio_intr_enable(PIN_BTN_REDRAW);

教训:「配置睡眠唤醒」和「配置 GPIO 中断」在 ESP-IDF 里写的是同一个硬件字段,后写的赢,而且不吭声。跨功能复用一个引脚时,每一次模式切换都要显式交接,不能假设前一个功能的中断配置还活着。

坑二:睡在用户手里——INT1 洪泛

症状:待机时钟被按键唤醒回菜单,菜单还没等操作,先自己「摇」了一下——直接跳进了求签页。

根因:唤醒发生在用户手里,而手不是静止的。手抖 = 运动 = 加速度计持续把 INT1 锁存置位;菜单的轮询循环每次 poll 都读到高电平,SHAKE 事件形成洪流,把 SW2/KEY1 的轮询全部饿死——于是设备看起来「自己摇了」。

对策在回菜单之前排空:

if (cause == ESP_SLEEP_WAKEUP_GPIO) {
    sc7a20_clear_irq_int1();         // drop shake latch -> clean menu return
    // A wake in the user's hand keeps re-latching INT1; drain it so
    // the menu's poll isn't SHAKE-flooded (starving SW2/KEY1).
    for (int i = 0; i < 15 && gpio_get_level(PIN_WAKE_INT1) == 1; i++) {
        sc7a20_clear_irq_int1();
        vTaskDelay(pdMS_TO_TICKS(POLL_MS));
    }
    gpio_set_intr_type(PIN_BTN_REDRAW, GPIO_INTR_NEGEDGE);
    gpio_intr_enable(PIN_BTN_REDRAW);
    ui_input_reset();                // no stale combo/repeat into the menu
    return;
}

两个要点:锁存的清理语义是「清到它不再置位」,不是「清一次」——手还在抖,清完马上又置位,所以要循环到电平落下为止。顺带 ui_input_reset() 把轻睡前的组合键、长按重复状态全部作废,睡眠边界就是输入状态机的事务边界。

小结

墨水屏待机时钟的公式:轻睡 + RTC 秒边界对齐 + DU 快刷走针 + 整点 GC 清屏 + 输入排空交接。做完回头看,真正难的从来不是省电——130µA 是选对睡眠模式就有的——而是睡眠、中断、输入三方在几根共享引脚上的交接礼仪:谁的配置会被谁静默覆盖,谁的锁存要在什么时机排空。把这些交接写显式,时钟就稳了。