LCD 时代的输入假设是「永远在线」:事件队列自己在跑,UI 忙不忙都不丢输入。墨水屏打破了这个假设——每次刷新,主循环要全神贯注半秒钟(SPI 搬平面数据、轮询 BUSY 等波形走完),20ms 一次的输入轮询就停摆这么久。PocketOracle(电子抽签器)靠两颗按键加一个摇晃传感器做全部交互,这篇记录四个由「慢显示」直接催生的输入设计,每一个都有真实的翻车现场。
坑一:摇一下,翻三页
摇晃检测用的是 SC7A20 运动中断(中断调教见旧文):INT1 电平锁存,读到高电平就算摇晃,读完立刻清锁存。不做去抖——加速度计的中断脉冲远长于 20ms 的轮询间隔,去抖没有意义。
六爻页把这套检测用到了极致:摇一次出一爻,一步一页,每爻都要刷一次屏。问题来了——刷屏的半秒里,用户的手没停。摇动的动作持续置位 INT1 锁存,刷屏一结束,下一次轮询立刻又读到高电平:一次摇动,连出三爻,直接跳到排盘页。
按键去抖对付的是「一次物理按压产生多个边沿」;这里是另一种病:「多次物理动作挤在一次消费的窗口里」。锁存型输入在慢操作之后必须排空:
void ui_shake_drain(void)
{
for (int t = 0; t < 75; t++) { // 75 x 20ms = 1.5s cap
sc7a20_clear_irq_int1();
if (gpio_get_level(PIN_WAKE_INT1) == 0) return;
vTaskDelay(pdMS_TO_TICKS(20));
}
}每次出手刷屏之后调用:清锁存,等引脚落回低电平再放行。上限 1.5 秒——排空不能变成卡死。掷筊、梅花这些「一摇一结果」的页面,同款处理直接挂上。
坑二:按键长在串口上,边沿检测是玄学
板卡勘误:SW2 在 GPIO20,恰好是 UART0 的 RX;KEY1 在 GPIO21,恰好是 TX。串口线上的电噪声让单次采样的边沿检测时不时出鬼影——明明没按,来一个事件;按了,又丢一个。
对策是把边沿换成电平加计次:
// A press counts only after LEVEL_TICKS consecutive 20ms polls read
// low (~60ms hold), and re-arms only after the pin reads high again,
// so one press still yields exactly one event.
#define LEVEL_TICKS 3
static int level_event(const char *name, int level, int *low, int *armed)
{
if (level == 1) { *low = 0; *armed = 1; return 0; } // released: re-arm
if (!*armed) return 0; // still holding
if (++*low < LEVEL_TICKS) return 0;
*low = 0; *armed = 0; // fire once
return 1;
}连续三次 20ms 轮询读到低电平(约 60ms 按住)才确认按下,释放后才重新武装——串口噪声的毛刺宽不过一个采样周期,凑不齐三次;一次按压恰好产出一个事件。
调试期还挖出更深一层:KEY1 长在 TX 上,对它跑 gpio_config() 会把引脚从 UART 手里抢走,所有串口日志当场静默。留 TX 的调试模式(只开输入路径,不动复用)能让日志活下来,但代价是 KEY1 永远测不到——UART 的推挽驱动牢牢把引脚拉在高电平,压过按键对地的短路(实测:raw KEY1=1 forever)。于是得出了很「墨水屏」的结论:**验证按键要看屏幕,别看串口。**引脚复用的冲突会连环爆:先爆输入可靠性,再爆调试通道本身。
坑三:0.5 秒盲区吞点击——五连按改走中断
「连按五下 SW2 进配网页」是个彩蛋手势,做出来之后怎么数都数不满五下。
根因在轮询的盲区:20ms 电平轮询会丢掉「在两次轮询之间完成按下又抬起」的完整点击——而刷屏阻塞约 0.5 秒,恰好覆盖用户快速连击的整个节奏。事件计数永远少几个,五连按成了玄学。
对策:计数搬进中断,时间戳进环形缓冲:
static volatile uint32_t s_tap_ms[5];
static volatile uint32_t s_tap_seq;
static void IRAM_ATTR sw2_edge_isr(void *arg)
{
uint32_t now = (uint32_t)(esp_timer_get_time() / 1000);
uint32_t seq = s_tap_seq;
if (seq && now - s_tap_ms[(seq - 1) % 5] < 60)
return; // bounce / UART burst
s_tap_ms[seq % 5] = now;
s_tap_seq = seq + 1;
}主循环只做确认:最近五个时间戳都落在 2 秒窗口内,下一次确认的按下就触发快捷。三个细节都是踩出来的:
- **60ms 去抖在 ISR 里做,顺便挡掉 RX 脚上真实的 UART 字节突发。**一个阈值两用:点击比 60ms 慢,字节突发比 60ms 快。
- **五连确认发生在轮询侧,不在边沿侧。**手势最后一击往往还带着按住——在轮询侧确认,这段按住不会泄漏进配网页自己的轮询循环,变成一个莫名的取消键。
- 触发后冷却一个窗口期(窗口 + 去抖),同一组五击不会在下一轮轮询里二次触发。
坑四:长按重复的节奏,不能挂在轮询计数上
菜单快滚靠 SW2 长按重复。最初的实现按「轮询次数 × 20ms」计时,结果滚动中途一次刷屏,重复节奏硬生生拖长半秒——轮询循环不是实时时钟,它的心跳由墨水屏的心情决定。
对策:换 esp_timer 的墙上时钟——按下确认时刻记下 s_sw2_fire_ms,之后每次轮询比较「现在 - 上次触发」:超过 500ms 出第一次重复,之后每 130ms 一次。刷屏停摆期间,节奏照走,因为账挂在不间断的硬件计时器上,不挂在轮询次数上。
配套的一个小决定:释放不触发任何事件。每一步重复都重绘屏幕,手指抬起时屏幕已经是最终位置,释放事件没有信息量,只会多刷一次屏。
收尾:跨页面交接 ui_input_reset()
最后一块拼图最不起眼:轻睡唤醒、进出子页面时,把所有 in-flight 手势状态一次清空——组合键的 pending、长按重复的标志、五连按的窗口计数。上一步操作的最后半个手势,不该成为下一步的第一个事件。引脚电平在下一次轮询自然重新武装,清状态不会丢掉真实输入。
输入状态机是全局资源,页面切换就是它的事务边界。
小结
墨水屏输入设计三原则:
- 慢操作之后排空锁存——排空的语义是「清到不再置位」,不是「清一次」;
- 节奏逻辑挂墙上时钟或中断——轮询循环的实时性由墨水屏的心情决定;
- 页面切换重置输入状态——睡眠边界、页面边界,都是输入状态机的事务边界。
慢的其实不是屏幕,是「屏幕忙」这件事对系统其他部分的可见性。把每次忙等变成显式的交接点,慢设备上的交互就顺了。