大飞的技术博客

·约 4 分钟·

残影不是 bug,是物理:DU 快刷的灰漂账本

上一篇文章把 UC8253 的刷新做成了 DU 差分快刷:未变化的像素不被驱动,菜单移动、签文重掷不再整板闪黑。但「不被驱动」是有账的——这篇讲下半场:残影的治理。它不是显示 bug,是墨水屏的物理性质,驱动设计里必须给它立账本。

残影从哪来

墨水屏的像素是一颗颗带电墨滴,「黑」和「白」靠驱动波形把粒子甩到该在的位置。DU 波形里白→白、黑→黑是直通的:粒子不动,自然不闪。但粒子「没被甩」和「刚被甩准」是两种物理状态——长期不驱动的像素,位置精度会慢慢漂:底色发灰、几页之前的旧画面隐约浮现。这就是残影(ghosting)和灰漂(grey drift)。

唯一的复位手段是 GC 三相波形:整板黑白反复反转,把所有墨滴重新甩到位,顺便清掉残留电荷。GC 又慢又闪——它是清屏的代价,省不掉,只能安排。

所以驱动要记两条账:「玻璃上是什么」和「玻璃有多累」。前者上次交给了控制器的 R10 自动搬运;后者,就是这篇的主角。

账本一:EPD_FAST_MAX,自动清屏计数器

最直觉的方案:在驱动里数快刷次数,每 N 次自动插一次 GC 全刷:

#define EPD_FAST_MAX 10   // GC full refresh on every N-th call; 0 = all-DU

esp_err_t epd_fast_refresh(const uint8_t *fb)
{
    if (++s_fast_count >= EPD_FAST_MAX) {
        ESP_LOGI(TAG, "ghost limit reached, GC refresh");
        return epd_full_refresh(fb);   // 内部把 s_fast_count 归零
    }
    esp_err_t r = lut_write(LUT_DU);
    if (r == ESP_OK) r = epd_cmd(0x13, fb, EPD_FB_SIZE);
    if (r != ESP_OK) return r;
    return refresh_tail();
}

两个设计决定值得说:

残影策略住在驱动里,UI 永远不知道计数器的存在。 UI 只管画图、调 epd_fast_refresh;第 10 次调用悄悄变成全刷,调用方无感。如果让每个页面自己记「我刷了几次」,十几个页面就有十几个记错的地方。

GC 清的是物理漂移,所以清完顺手把计数器归零。 物理复位和账本复位必须同时发生——账本说「刚清过」,玻璃也真的刚清过,这才有下一次十次快刷的额度。

常数怎么定?纸面推不出来。设计稿从 8 起步,原则是:实机上灰雾在额度内提前出现就降(4、2),太宽容就升。现在代码里定在 10——这种常数只有玻璃能投票。

账本二:待机时钟的豁免通道

自动计数器马上撞上一个反例:待机时钟每分钟走针刷一次。10 次一清屏,意味着每 10 分钟整板闪一次——交互页面里用户对偶发闪烁有预期,但一块「静止的脸」随机闪黑,观感是设备坏了。

解法是给驱动开一条豁免通道:

// Differential refresh that never triggers the auto-GC clean — for frequent
// periodic redraws (standby clock) where a flash every EPD_FAST_MAX ticks
// would be unacceptable. Ghost drift accumulates; the caller schedules
// explicit epd_full_refresh() cleans (e.g. hourly).
esp_err_t epd_fast_refresh_keep(const uint8_t *fb);

keep 版本绕过计数器,永不自动 GC;清屏节奏上交给调用方。待机时钟的循环里:

draw_standby_face();
if (ui_now_valid && ui_now.minute == 0)
    ui_refresh_or_sleep(sleep_us);      // 整点:GC 清残影
else
    epd_fast_refresh_keep(ui_fb);       // 其余 59 分钟:快刷走针

同样是「每 10 次闪一下」和「每 60 次闪一下」的选择,本质是把闪烁放进用户的预期里:交互场景不知道下一次操作何时来,自动计数是对的;时钟场景闪烁时机完全可控,那就定在整点——用户对整点闪一下的容忍度,远高于随机第 10 分钟。

代价要写明白:豁免通道意味着灰漂在两次清屏之间单调累积,一小时最多 59 次快刷才等来一次 GC。清屏间隔是设计者自己签的保票,不是免费午餐——想收紧,改一个判断就行。

账本三:唤醒后的第一次快刷会鬼影

第三个坑最隐蔽。每次唤醒,控制器的 R10 旧平面被 epd_controller_init 种成全白基线;但玻璃是双稳态的——断电前的画面还实实在在留在上面。于是第一次 DU 差分时:

  • 控制器以为「玻璃是全白的」,只驱动「新图 vs 全白」的差异;
  • 玻璃上实际残留的旧画面没人清理,以鬼影的形式叠在新画面里,直到下一次 GC 才被擦掉。

驱动头文件里把它写成了调用约定:

Screen-entry clean (power-on splash, menu entry); epd_fast_refresh also
auto-inserts one per EPD_FAST_MAX differential refreshes. A GC clean
resets physical drift, so it restarts that counter. epd_controller_init
seeds R10 with an all-white old plane, so the very first differential
after a wake ghosts whatever the bistable panel was still showing until
the next GC.

对策是调用侧的纪律:凡是「进屏」路径——开机 splash、唤醒回菜单——一律先 GC 全刷。 这既是视觉上的干净入场,也顺手把差分基线对齐了玻璃实况,保证第一次快刷永远发生在 GC 之后。

往深一层说,这是差分刷新的正确性不变量:账面旧帧必须等于玻璃实况。任何让两者脱钩的事件——唤醒、控制器复位、传输中断——之后都要先用全刷重建不变量,再谈快刷。

小结

墨水屏驱动是帧缓冲算法加一点物理学。除了「玻璃上是什么」(这次可以外包给控制器的 R10 自动搬运),还得记「玻璃有多累」(灰漂计数,外包不了)。两条账,一条都不能赖——赖掉的那条,迟早以鬼影的形式出现在屏幕正中。