PocketOracle(电子抽签器)换上 UC8253 玻璃之后(点屏实录见前作),全刷流程很快稳定了。但全刷有个改不掉的脾气:OTP 里的全刷波形要先把整板黑白反转几个来回清残影,再落新画面——菜单每移动一格、签文每摇一次,200×200 全板闪一遍。观感割裂,而且反转波形是面板最耗电的动作。
需求很朴素:菜单移动只改两行,重掷只改文字区,能不能只动这些像素?这篇记录两次半失败和最终方案——三次尝试,分别死于三个「权威」:datasheet、开源驱动、以及最后的厂商 demo。
为什么全刷一定要闪
UC8253 的刷新输入是两张平面:DTM1(0x10)放旧帧,DTM2(0x13)放新帧,控制器逐像素比对,为每个像素选择驱动波形——白变黑、黑变白、保持不变各有一套脉冲序列。全刷波形里的「保持不变」也不省事:GC 波形会先整板反转几个相位,把所有墨滴甩到位、清掉残留电荷,然后才落新图。闪不是 bug,是清残影的代价。
所以「不闪」的唯一出路,是让未变化的像素不被驱动。接下来三次尝试,都是围绕这一句话。
第一败:PTL 窗口——datasheet 说了不算
规格书 p22 有一组看起来正中下怀的命令:
- PTL(0x90):五个字节设刷新窗口,HRST/HRED 是字节列地址(x/8),VRST/VRED 是行地址;
- PTIN(0x91):进入局部模式;PTOUT(0x92):退出。
照着实现:开窗 → 双平面写入窗内切片 → DRF → PTOUT 退出(错误路径也发 PTOUT,控制器不能留在局部模式,否则残留窗口会污染下一次全刷)。然后上机探针:全刷一帧菜单,等 2 秒,移动选中项,刷新一条 200×52 的横带。
两个现象,两个都是坏消息:
- 窗口切片数据全落在屏幕顶部。 PTL 只限定 DTM 的写入寻址;局部模式下 DTM 数据照样从显存第 0 行开始流,切片内容被写到了错误的位置。
- 改发整平面数据 + PTL 窗口,内容终于对了——但 DRF 依然驱动整面板,整板照闪不误。OTP 里根本没有窗口化的波形,窗口命令限定的是寻址,不是波形的作用范围。
结论:在这颗控制器上,控制器侧开窗是死路。datasheet 的命令表是真的——命令、参数一字不差都收;但「命令组合出什么效果」,它没承诺。
第二败:CDI 浮空——开源驱动不能跨家族抄
在 GxEPD2 里找到了理论优雅的答案:同家族驱动做免闪刷新完全不写 LUT,全靠 CDI 寄存器(0x50)的 VBD 位——0x37 让未变化像素驱白,0x97 让未变化像素浮空不受驱动。我们的规格书 p21 定义着同一个位域,连默认值 0xD7 都对得上。方案写好了,连失败备选梯子(0x9F → 0x90 → 0x98)都排好了队。
动手之前认真核对来源,发现两件事:
- GxEPD2 这段代码属于 JD79660 家族(四色屏)的实现,我们的黑白 UC8253 只是「家族相似」。魔法值没有在这块玻璃上验证过;更要命的是 CDI 是只写寄存器,写错了连读回来诊断的机会都没有。
- GxEPD2 用的开窗命令 0x83 在我们这颗控制器上根本不存在——第一败已经证明这不是同一颗芯片的镜像。
第二版方案没有上屏就被否了。教训:开源驱动的寄存器魔法值,移植前先核对控制器家族;「datasheet 位域对得上」只说明寄存器叫同一个名字,不保证语义相同。更深一层的判断是:手里没有面板厂的一手资料时,任何寄存器组合都只是猜想——猜想是要用烧录次数付费的。
终局:厂商 demo 里的 GC/DU 双波形
转机是随屏附带的参考程序——同尺寸(200×200)、同控制器的官方 demo 源码,里面躺着两套现成的刷新模式:
lut_find(GC):"full-screen refresh, but it is slow ... will flicker"——全刷清残影,等价于我们原来的 OTP 路径;lut_find(DU):"performs partial refreshing and is fast"——单相位、单帧的差分波形,快而不闪。
机制一句话:每次刷新前,把五张 42 字节的波形表(VCOM / WW / BW / WB / BB,共 210 字节)写进 R20~R24,再用 PSR 的 REG_EN=1 让控制器改用寄存器 LUT 而非 OTP。DU 的 WW/BB 行(白→白、黑→黑)是直通的——未变化的像素不被驱动,自然不闪。所谓「局部刷新」从头到尾不需要开窗:控制器逐像素比对两张平面,只有变化的像素出波形,视觉上就是局部的。
代码里三处值得抄笔记的细节。
其一,初始化序列逐字照抄。 解锁密码(0x4D←0x55、0xF3←0x0A)、PSR=0xFF,0x68、电源时序、TRES=0xC8,0xC8……demo 注释原话:"The initial settings cannot be modified at will"。我们一个字节没改,注释也一起抄进了驱动。
其二,LUT 写入顺序是个暗坑。 demo 先用整张表的最后 42 字节写 R24(BB),再写 R20/R21/R22/R23——顺序错了波形就串台:
// Vendor lut_find(): the demo writes 0x24 (BB) FIRST with the LAST
// 42 bytes, then 0x20/0x21/0x22/0x23 with the other blocks. Order matters.
static esp_err_t lut_write(const uint8_t *lut)
{
esp_err_t r = epd_cmd(0x20, lut, 42); // VCOM (block 0)
if (r == ESP_OK) r = epd_cmd(0x24, lut + 168, 42); // BB (block 4) 先写!
if (r == ESP_OK) r = epd_cmd(0x21, lut + 42, 42); // WW (block 1)
if (r == ESP_OK) r = epd_cmd(0x22, lut + 84, 42); // BW (block 2)
if (r == ESP_OK) r = epd_cmd(0x23, lut + 126, 42); // WB (block 3)
return r;
}其三,R13→R10 自动搬运删掉了主机端一半的状态管理。 demo 注释:"After the image of R13h register is updated, it will be automatically stored in the R10h register"——控制器自己跟踪玻璃状态,刷新只需要写新图。前两版设计里最重的心智负担(主机端维护「玻璃上现在是什么」的旧平面镜像 s_old_plane),被厂商一行注释解决了:
esp_err_t epd_fast_refresh(const uint8_t *fb)
{
esp_err_t r = lut_write(LUT_DU);
if (r == ESP_OK) r = epd_cmd(0x13, fb, EPD_FB_SIZE); // R13: 新图
if (r != ESP_OK) return r;
return refresh_tail(); // PON → DRF → POF,每步等 BUSY
}保留的偏离只有两处,都是刻意的:传输层用 10 MHz 硬件 SPI + DMA(demo 是约 5µs/bit 的 GPIO 位拍),复位时序沿用已验证的 10/10 ms。
上机结果:菜单移动只更新高亮的两行,签文重掷只更新文字区,其余像素纹丝不动;DU 单帧波形落定肉眼可见地快。PTL 那套 epd_partial_refresh(fb, x, y, w, h) 整个删除,新 API 叫 epd_fast_refresh(fb)——连坐标参数都不要了,因为「局部」是波形的性质,不是命令的参数。
复盘:三个权威的可信度排序
| 权威 | 承诺了什么 | 实机检验 |
|---|---|---|
| datasheet | 命令表 + 位域,暗示可开窗局部刷新 | 命令真,效果假 |
| 开源驱动(GxEPD2) | CDI 魔法值,不写 LUT 就能不闪 | 跨家族移植,未验证即弃 |
| 厂商 demo | 两套 LUT 波形 + 逐字节初始化 | 一次通过 |
几条带走的经验:
- datasheet 的命令表是接口契约,组合效果不是。 窗口命令限定寻址,不限定波形的物理作用范围。
- 开源驱动是某个家族的实现细节,不是标准。 魔法值跨家族移植等于猜,猜错的价格是一次次烧录。
- 厂商参考代码是这块玻璃的唯一真相。 照抄不丢人;demo 的注释里全是金子,连写入顺序这种暗坑都写在里面。
- 实验方法论:一次只动一个变量,决策表先行。 第一败前就列好了失败模式对照(内容错位 = 寻址单位错;整板闪 = 无窗口波形;显示旧内容 = DTM 顺序错),每个现象都有对应的下一步,不至于烧一次屏猜三天。
不闪只是上半场——未驱动的像素会在物理上悄悄积累漂移,这是下一篇文章的主题:残影的账本。