1. 这个冰箱贴到底解决了什么问题家里冰箱门上贴一张购物清单这件事听起来简单到不值一提但真正过日子的人都知道它其实是个高频刚需。纸质便签写完就扔、白板笔擦来擦去一手墨、手机备忘录记了但进厨房又懒得掏手机——这些场景我都经历过。PaperMono 这个项目的切入点就在这里用一块电子墨水屏做成冰箱磁贴显示购物清单手机浏览器打开网页就能同步修改固件跑在设备端负责刷新和联网。核心关键词是PaperMono、电子墨水、固件、手机网页同步。说白了它是一套软硬件结合的小系统硬件是一块带电池的电子墨水屏加磁贴背板固件负责驱动屏幕、连接网络、拉取清单数据手机端不需要装 App打开一个网页就能编辑清单改完自动推到冰箱贴上。适合谁来参考如果你玩过 ESP32、树莓派 Pico 这类开发板想做一个真正每天都会用的小物件这个项目非常合适如果你只是想找个现成的购物清单工具那它也能给你一套自建方案的完整思路。我之所以对这个项目感兴趣是因为它踩中了几个很实际的设计取舍为什么用电子墨水而不是 LCD为什么固件要自己做而不是买个成品为什么手机端用网页而不是 App这些选择背后都有明确的理由后面我会逐个拆开讲。2. 整体设计思路与方案选型拆解2.1 为什么是电子墨水屏而不是普通屏幕电子墨水屏最大的特点是双稳态——断电之后画面还在不刷新就不耗电。冰箱贴这个东西一天可能只看两三次改清单也就几分钟一次如果用 LCD屏幕得一直亮着或者频繁唤醒电池撑不了几天。电子墨水屏在静态显示时功耗几乎为零只有刷新那一瞬间才吃电这直接决定了整机可以用小电池跑几个月。另一个原因是可视角度和观感。冰箱贴是贴在金属门上的人站着、弯腰、侧着看都有可能电子墨水屏的可视角度接近纸张不像 LCD 那样偏一点就发白。而且它不发光厨房灯光下看着不刺眼这点在真实使用里比参数表上写的更重要。当然代价也有刷新慢通常全刷要一两秒局刷快一些但会有残影。所以固件设计上必须考虑刷新策略——不是每次改一个字就全屏刷而是攒一批改动再刷或者用局刷加定期全刷清残影。这个取舍我在第 4 部分会详细讲。2.2 固件为什么要自己写市面上有现成的电子价签、电子备忘录但它们的固件是封闭的你没法改刷新逻辑、没法接自己的同步服务、没法控制功耗策略。PaperMono 选择自己写固件核心目的是把控制权拿回来。固件要干的事其实就几件驱动墨水屏、连 Wi-Fi、跟服务端同步清单、管理电池和休眠。听起来不多但每一件都有坑。比如墨水屏驱动不同型号的波形表不一样直接抄别人的代码可能显示发灰或者残影严重比如 Wi-Fi 连接如果每次唤醒都重新握手功耗会飙升得做连接复用或者快速重连。自己写固件的另一个好处是可以针对场景做极致优化。购物清单这个场景数据量极小几十个字符更新频率极低一天几次完全可以把固件做成“深度休眠 定时唤醒 事件唤醒”的模式把平均功耗压到微安级。2.3 手机网页同步而不是 App这是我觉得最聪明的一个选择。做一个 App 要处理 iOS 和 Android 两套、要上架、要更新成本高且没必要。购物清单就是个文本列表用网页做编辑器手机浏览器打开就能用改完点保存服务端存下来设备下次唤醒时拉取。网页同步的技术栈可以很轻一个简单的后端接口比如 REST 或者 WebSocket前端就是一个带输入框和列表的页面。设备端固件用 HTTP 轮询或者长连接接收更新通知。这里的关键是冲突处理——如果两个人同时改清单怎么办常见做法是服务端以最后一次写入为准或者给每条记录加时间戳做合并。对于家庭购物清单这种场景最后写入为准基本够用但固件端要处理好“本地未提交的改动”和“远端新改动”的关系避免把刚输入的内容覆盖掉。3. 核心细节解析与实操要点3.1 硬件选型与接线要点电子墨水屏模块常见的有微雪Waveshare系列、Good Display 系列尺寸从 1.54 寸到 7.5 寸都有。冰箱贴这个场景我建议选2.9 寸到 4.2 寸之间太小显示不了几行太大贴冰箱上显得笨重。分辨率方面2.9 寸通常是 296x1284.2 寸是 400x300显示十几行购物清单完全够用。主控方面ESP32 是最稳妥的选择自带 Wi-Fi、功耗管理成熟、社区资料多。如果追求更低功耗可以用 ESP32-C3 或者带 ULP 协处理器的型号。电池用 3.7V 锂聚合物电池容量 1000mAh 到 2000mAh 就够跑很久具体算一下假设深度休眠电流 20uA每天唤醒 10 次、每次工作 5 秒、工作电流 80mA那么日均耗电大约是 20uA×24h 80mA×50s/3600 ≈ 0.48mAh 1.11mAh ≈ 1.6mAh2000mAh 电池理论上能跑三年以上实际考虑自放电和刷新功耗半年到一年充一次电是合理预期。接线方面墨水屏模块一般用 SPI 接口需要接 CS、DC、RST、BUSY、CLK、DIN 这几根线具体引脚定义看模块手册。注意BUSY 引脚一定要接固件靠它判断屏幕是否忙不接的话刷新会出错。另外建议加一个物理按键用于手动刷新或配网不然设备休眠后你没法主动触发操作。3.2 固件架构与关键模块固件我建议分成几个清晰的模块别全塞在一个文件里显示驱动层封装墨水屏的初始化、全刷、局刷、休眠。不同屏幕型号的波形表要单独适配。网络层Wi-Fi 连接管理、HTTP 客户端、可能的 WebSocket 客户端。要处理断线重连和超时。同步逻辑层拉取清单、对比本地版本、决定是否刷新、提交本地改动。电源管理层休眠唤醒、外设供电控制、电池电压监测。配网与配置首次使用时怎么让设备连上你家 Wi-Fi常见做法是设备开一个热点手机连上去填 Wi-Fi 信息或者用 SmartConfig 这类一键配网。这里重点说同步逻辑。一个可靠的流程是设备唤醒后先连 Wi-Fi向服务端请求清单的版本号或哈希值如果跟本地一致就跳过刷新直接睡如果不一致就拉取完整清单渲染到屏幕更新本地版本号然后睡。本地改动如果设备支持输入则反过来先提交到服务端成功后再刷新屏幕。注意墨水屏刷新期间绝对不能断电否则可能损坏屏幕或者留下永久残影。固件里要在刷新前确保电池电压足够低于阈值就拒绝刷新并提示充电。3.3 手机网页端的设计要点网页端不需要花哨核心功能就三个显示当前清单、添加/删除条目、保存同步。但有几个细节直接影响体验第一输入框要支持回车快速添加买菜的场景是一边看冰箱一边记操作越少越好。第二已购条目要能一键清除或者折叠不然清单越用越长。第三页面要适配手机竖屏字体别太小按钮别太密。技术上前端可以用原生 HTMLJS也可以用轻量框架。后端如果只是家庭自用一个简单的服务加上 SQLite 或者 JSON 文件存储就够了。接口设计上GET /list返回清单POST /list提交更新GET /version返回版本号供设备轮询。如果想做得更实时可以用 WebSocket 让设备保持长连接但那样功耗会高一些需要权衡。3.4 刷新策略与残影处理电子墨水屏的残影是个绕不开的问题。局刷速度快但会累积残影全刷干净但闪屏明显、速度慢。我的经验是采用混合策略日常小改动用局刷每刷 5 到 10 次局刷后做一次全刷清残影或者每天固定时间做一次全刷。具体实现上固件里维护一个局刷计数器每次局刷后加一达到阈值就触发全刷并清零。全刷的时机可以选在深夜或者设备长时间休眠后第一次唤醒时这样闪屏对用户影响最小。另外刷新前要先清屏再写新内容直接覆盖写容易留鬼影。有些驱动库提供了clear()和display()两个步骤别偷懒只调一个。4. 实操过程与核心环节实现4.1 开发环境搭建以 ESP32 为例我习惯用 ESP-IDF 或者 PlatformIO。PlatformIO 对新手更友好库管理方便。装好之后新建项目选对开发板型号然后把墨水屏驱动库加进依赖。# PlatformIO 项目初始化示例 pio project init --board esp32dev # 在 platformio.ini 中添加依赖 # lib_deps # waveshare/gxepd2 # bblanchon/ArduinoJson如果你用 Arduino 框架那就装 ESP32 板支持包再装 GxEPD2 或者类似驱动库。注意不同库对屏幕型号的支持不一样买屏幕时看清楚驱动芯片型号比如 SSD1680、UC8176 等选对应的库。4.2 屏幕驱动跑通第一步永远是让屏幕能显示东西。写一个最小程序初始化屏幕显示一行文字确认接线和驱动没问题。// 伪代码示意具体API看所用库 display.init(); display.setRotation(1); display.setFont(FreeMonoBold9pt7b); display.setTextColor(GxEPD_BLACK); display.setFullWindow(); display.firstPage(); do { display.fillScreen(GxEPD_WHITE); display.setCursor(10, 30); display.print(Shopping List); } while (display.nextPage());这一步常见的坑是接线错误导致 BUSY 一直忙或者波形表不匹配导致显示发灰。如果屏幕全白或者全黑先查接线再查驱动型号。如果显示内容但对比度差多半是波形表问题换库或者手动调 LUT。4.3 Wi-Fi 连接与配网配网我推荐用ESP32 的 WiFiManager 库它会在连不上已知 Wi-Fi 时自动开热点手机连上去弹出配置页面填完保存重启。这样你不需要在代码里硬编码 Wi-Fi 密码也方便换环境。// WiFiManager 配网示意 WiFiManager wm; bool res wm.autoConnect(PaperMono-AP); if (!res) { // 配网失败进入休眠或重试 }连上之后固件要能处理断线重连。我的做法是设置一个连接超时比如 10 秒连不上就放弃本次同步直接睡下次唤醒再试。不要无限重试那样电池很快耗光。4.4 清单同步的完整流程设备端的同步流程我整理成下面这张表方便对照实现步骤操作失败处理1唤醒初始化外设检查电池电压过低则提示并休眠2连接 Wi-Fi超时 10 秒则休眠下次重试3请求服务端版本号超时或错误则休眠4对比本地版本一致则跳过刷新直接休眠5拉取清单数据解析失败则保留旧画面休眠6渲染到屏幕按局刷/全刷策略执行7更新本地版本号写入非易失存储8断开 Wi-Fi进入深度休眠设置定时唤醒或等待按键服务端这边版本号可以用清单内容的哈希或者一个自增整数。每次网页端保存时版本号加一设备拉取时带上本地版本号服务端返回 304 或者新数据。这样能最大程度减少数据传输和刷新次数。4.5 电源管理与休眠调优ESP32 的深度休眠电流可以做到 10uA 左右但前提是关掉所有不必要的外设电源。墨水屏模块在休眠时也要断电否则它自己会耗电。具体做法是用一个 MOS 管控制屏幕的 VCC休眠时拉低。唤醒源可以配多个定时器唤醒比如每 30 分钟检查一次更新、按键唤醒手动刷新、外部中断唤醒如果有传感器。购物清单场景定时 30 分钟到 1 小时检查一次足够了太频繁没必要。实操心得调试功耗时先用万用表测休眠电流如果超过 100uA检查是不是有 LED 没关、稳压器静态电流太大、或者某个引脚悬空导致漏电。我踩过的一个坑是串口芯片没断电白白多耗了几百微安。5. 常见问题与排查技巧实录5.1 屏幕显示异常排查现象可能原因解决办法全白无显示接线错误、驱动型号不对检查 SPI 接线确认驱动芯片型号全黑波形表错误、电压不足换驱动库检查电池电压显示发灰局刷残影累积执行全刷清屏局部花屏BUSY 引脚未接或接触不良确保 BUSY 正确连接刷新后内容偏移分辨率设置错误核对屏幕分辨率参数5.2 同步失败排查同步失败最常见的原因是Wi-Fi 连不上和服务端地址写错。我的排查顺序是先用串口打印 Wi-Fi 连接状态确认能拿到 IP再用浏览器或者 curl 测试服务端接口是否可达最后检查固件里的 URL 和端口。另一个坑是HTTPS 证书。如果服务端用了自签名证书ESP32 默认会拒绝连接。解决办法是要么用 HTTP内网自用可以接受要么把证书指纹写进固件做校验。5.3 电池续航不达预期如果发现电池掉得比预期快按这个顺序查先测休眠电流再测工作电流和单次工作时长最后算日均耗电。常见问题包括Wi-Fi 没真正断开、屏幕没断电、定时唤醒间隔太短、某个传感器一直在采样。我遇到过一次续航只有几天的情况最后发现是固件里有个delay()在循环里导致设备根本没进休眠。所以休眠前一定要确认所有任务都挂起或者删除别留后台任务偷偷跑。5.4 网页端同步冲突两个人同时改清单时可能出现一方改动被覆盖。简单做法是服务端记录最后修改时间设备拉取时如果发现远端版本比本地新就覆盖本地。如果要做更细的合并可以给每个条目加唯一 ID 和删除标记合并时按 ID 对齐。家庭场景下最后写入为准基本不会出问题但如果经常多人同时编辑建议加一个“正在编辑”的提示或者乐观锁。6. 一些实际使用后的体会这个项目我从打样到日常使用大概折腾了一个多月最大的感受是电子墨水屏的刷新体验决定了整个产品的成败。刚开始我每次改动都全刷闪得人眼晕后来改成局刷为主、全刷为辅体验立刻上了一个台阶。另一个体会是配网一定要做简单我第一版硬编码 Wi-Fi 密码换路由器后设备直接变砖后来换成 WiFiManager 才省心。还有一点别低估手机网页的便利性。我一开始想做个 App后来发现网页完全够用而且改起来快、不用审核、家人也能直接用。如果你也在做类似的东西我建议先把最小可用版本跑通屏幕能显示、网页能改、设备能同步这三件事通了剩下的都是优化。后续如果想扩展可以加语音输入手机网页调麦克风、加到期提醒清单条目带日期、加多设备同步厨房一个、玄关一个。但核心逻辑不变还是那套“网页编辑、服务端存储、设备拉取刷新”的架构。
1. 这个冰箱贴到底解决了什么问题家里冰箱门上贴一张购物清单这件事听起来简单到不值一提但真正过日子的人都知道它其实是个高频刚需。纸质便签写完就扔、白板笔擦来擦去一手墨、手机备忘录记了但进厨房又懒得掏手机——这些场景我都经历过。PaperMono 这个项目的切入点就在这里用一块电子墨水屏做成冰箱磁贴显示购物清单手机浏览器打开网页就能同步修改固件跑在设备端负责刷新和联网。核心关键词是PaperMono、电子墨水、固件、手机网页同步。说白了它是一套软硬件结合的小系统硬件是一块带电池的电子墨水屏加磁贴背板固件负责驱动屏幕、连接网络、拉取清单数据手机端不需要装 App打开一个网页就能编辑清单改完自动推到冰箱贴上。适合谁来参考如果你玩过 ESP32、树莓派 Pico 这类开发板想做一个真正每天都会用的小物件这个项目非常合适如果你只是想找个现成的购物清单工具那它也能给你一套自建方案的完整思路。我之所以对这个项目感兴趣是因为它踩中了几个很实际的设计取舍为什么用电子墨水而不是 LCD为什么固件要自己做而不是买个成品为什么手机端用网页而不是 App这些选择背后都有明确的理由后面我会逐个拆开讲。2. 整体设计思路与方案选型拆解2.1 为什么是电子墨水屏而不是普通屏幕电子墨水屏最大的特点是双稳态——断电之后画面还在不刷新就不耗电。冰箱贴这个东西一天可能只看两三次改清单也就几分钟一次如果用 LCD屏幕得一直亮着或者频繁唤醒电池撑不了几天。电子墨水屏在静态显示时功耗几乎为零只有刷新那一瞬间才吃电这直接决定了整机可以用小电池跑几个月。另一个原因是可视角度和观感。冰箱贴是贴在金属门上的人站着、弯腰、侧着看都有可能电子墨水屏的可视角度接近纸张不像 LCD 那样偏一点就发白。而且它不发光厨房灯光下看着不刺眼这点在真实使用里比参数表上写的更重要。当然代价也有刷新慢通常全刷要一两秒局刷快一些但会有残影。所以固件设计上必须考虑刷新策略——不是每次改一个字就全屏刷而是攒一批改动再刷或者用局刷加定期全刷清残影。这个取舍我在第 4 部分会详细讲。2.2 固件为什么要自己写市面上有现成的电子价签、电子备忘录但它们的固件是封闭的你没法改刷新逻辑、没法接自己的同步服务、没法控制功耗策略。PaperMono 选择自己写固件核心目的是把控制权拿回来。固件要干的事其实就几件驱动墨水屏、连 Wi-Fi、跟服务端同步清单、管理电池和休眠。听起来不多但每一件都有坑。比如墨水屏驱动不同型号的波形表不一样直接抄别人的代码可能显示发灰或者残影严重比如 Wi-Fi 连接如果每次唤醒都重新握手功耗会飙升得做连接复用或者快速重连。自己写固件的另一个好处是可以针对场景做极致优化。购物清单这个场景数据量极小几十个字符更新频率极低一天几次完全可以把固件做成“深度休眠 定时唤醒 事件唤醒”的模式把平均功耗压到微安级。2.3 手机网页同步而不是 App这是我觉得最聪明的一个选择。做一个 App 要处理 iOS 和 Android 两套、要上架、要更新成本高且没必要。购物清单就是个文本列表用网页做编辑器手机浏览器打开就能用改完点保存服务端存下来设备下次唤醒时拉取。网页同步的技术栈可以很轻一个简单的后端接口比如 REST 或者 WebSocket前端就是一个带输入框和列表的页面。设备端固件用 HTTP 轮询或者长连接接收更新通知。这里的关键是冲突处理——如果两个人同时改清单怎么办常见做法是服务端以最后一次写入为准或者给每条记录加时间戳做合并。对于家庭购物清单这种场景最后写入为准基本够用但固件端要处理好“本地未提交的改动”和“远端新改动”的关系避免把刚输入的内容覆盖掉。3. 核心细节解析与实操要点3.1 硬件选型与接线要点电子墨水屏模块常见的有微雪Waveshare系列、Good Display 系列尺寸从 1.54 寸到 7.5 寸都有。冰箱贴这个场景我建议选2.9 寸到 4.2 寸之间太小显示不了几行太大贴冰箱上显得笨重。分辨率方面2.9 寸通常是 296x1284.2 寸是 400x300显示十几行购物清单完全够用。主控方面ESP32 是最稳妥的选择自带 Wi-Fi、功耗管理成熟、社区资料多。如果追求更低功耗可以用 ESP32-C3 或者带 ULP 协处理器的型号。电池用 3.7V 锂聚合物电池容量 1000mAh 到 2000mAh 就够跑很久具体算一下假设深度休眠电流 20uA每天唤醒 10 次、每次工作 5 秒、工作电流 80mA那么日均耗电大约是 20uA×24h 80mA×50s/3600 ≈ 0.48mAh 1.11mAh ≈ 1.6mAh2000mAh 电池理论上能跑三年以上实际考虑自放电和刷新功耗半年到一年充一次电是合理预期。接线方面墨水屏模块一般用 SPI 接口需要接 CS、DC、RST、BUSY、CLK、DIN 这几根线具体引脚定义看模块手册。注意BUSY 引脚一定要接固件靠它判断屏幕是否忙不接的话刷新会出错。另外建议加一个物理按键用于手动刷新或配网不然设备休眠后你没法主动触发操作。3.2 固件架构与关键模块固件我建议分成几个清晰的模块别全塞在一个文件里显示驱动层封装墨水屏的初始化、全刷、局刷、休眠。不同屏幕型号的波形表要单独适配。网络层Wi-Fi 连接管理、HTTP 客户端、可能的 WebSocket 客户端。要处理断线重连和超时。同步逻辑层拉取清单、对比本地版本、决定是否刷新、提交本地改动。电源管理层休眠唤醒、外设供电控制、电池电压监测。配网与配置首次使用时怎么让设备连上你家 Wi-Fi常见做法是设备开一个热点手机连上去填 Wi-Fi 信息或者用 SmartConfig 这类一键配网。这里重点说同步逻辑。一个可靠的流程是设备唤醒后先连 Wi-Fi向服务端请求清单的版本号或哈希值如果跟本地一致就跳过刷新直接睡如果不一致就拉取完整清单渲染到屏幕更新本地版本号然后睡。本地改动如果设备支持输入则反过来先提交到服务端成功后再刷新屏幕。注意墨水屏刷新期间绝对不能断电否则可能损坏屏幕或者留下永久残影。固件里要在刷新前确保电池电压足够低于阈值就拒绝刷新并提示充电。3.3 手机网页端的设计要点网页端不需要花哨核心功能就三个显示当前清单、添加/删除条目、保存同步。但有几个细节直接影响体验第一输入框要支持回车快速添加买菜的场景是一边看冰箱一边记操作越少越好。第二已购条目要能一键清除或者折叠不然清单越用越长。第三页面要适配手机竖屏字体别太小按钮别太密。技术上前端可以用原生 HTMLJS也可以用轻量框架。后端如果只是家庭自用一个简单的服务加上 SQLite 或者 JSON 文件存储就够了。接口设计上GET /list返回清单POST /list提交更新GET /version返回版本号供设备轮询。如果想做得更实时可以用 WebSocket 让设备保持长连接但那样功耗会高一些需要权衡。3.4 刷新策略与残影处理电子墨水屏的残影是个绕不开的问题。局刷速度快但会累积残影全刷干净但闪屏明显、速度慢。我的经验是采用混合策略日常小改动用局刷每刷 5 到 10 次局刷后做一次全刷清残影或者每天固定时间做一次全刷。具体实现上固件里维护一个局刷计数器每次局刷后加一达到阈值就触发全刷并清零。全刷的时机可以选在深夜或者设备长时间休眠后第一次唤醒时这样闪屏对用户影响最小。另外刷新前要先清屏再写新内容直接覆盖写容易留鬼影。有些驱动库提供了clear()和display()两个步骤别偷懒只调一个。4. 实操过程与核心环节实现4.1 开发环境搭建以 ESP32 为例我习惯用 ESP-IDF 或者 PlatformIO。PlatformIO 对新手更友好库管理方便。装好之后新建项目选对开发板型号然后把墨水屏驱动库加进依赖。# PlatformIO 项目初始化示例 pio project init --board esp32dev # 在 platformio.ini 中添加依赖 # lib_deps # waveshare/gxepd2 # bblanchon/ArduinoJson如果你用 Arduino 框架那就装 ESP32 板支持包再装 GxEPD2 或者类似驱动库。注意不同库对屏幕型号的支持不一样买屏幕时看清楚驱动芯片型号比如 SSD1680、UC8176 等选对应的库。4.2 屏幕驱动跑通第一步永远是让屏幕能显示东西。写一个最小程序初始化屏幕显示一行文字确认接线和驱动没问题。// 伪代码示意具体API看所用库 display.init(); display.setRotation(1); display.setFont(FreeMonoBold9pt7b); display.setTextColor(GxEPD_BLACK); display.setFullWindow(); display.firstPage(); do { display.fillScreen(GxEPD_WHITE); display.setCursor(10, 30); display.print(Shopping List); } while (display.nextPage());这一步常见的坑是接线错误导致 BUSY 一直忙或者波形表不匹配导致显示发灰。如果屏幕全白或者全黑先查接线再查驱动型号。如果显示内容但对比度差多半是波形表问题换库或者手动调 LUT。4.3 Wi-Fi 连接与配网配网我推荐用ESP32 的 WiFiManager 库它会在连不上已知 Wi-Fi 时自动开热点手机连上去弹出配置页面填完保存重启。这样你不需要在代码里硬编码 Wi-Fi 密码也方便换环境。// WiFiManager 配网示意 WiFiManager wm; bool res wm.autoConnect(PaperMono-AP); if (!res) { // 配网失败进入休眠或重试 }连上之后固件要能处理断线重连。我的做法是设置一个连接超时比如 10 秒连不上就放弃本次同步直接睡下次唤醒再试。不要无限重试那样电池很快耗光。4.4 清单同步的完整流程设备端的同步流程我整理成下面这张表方便对照实现步骤操作失败处理1唤醒初始化外设检查电池电压过低则提示并休眠2连接 Wi-Fi超时 10 秒则休眠下次重试3请求服务端版本号超时或错误则休眠4对比本地版本一致则跳过刷新直接休眠5拉取清单数据解析失败则保留旧画面休眠6渲染到屏幕按局刷/全刷策略执行7更新本地版本号写入非易失存储8断开 Wi-Fi进入深度休眠设置定时唤醒或等待按键服务端这边版本号可以用清单内容的哈希或者一个自增整数。每次网页端保存时版本号加一设备拉取时带上本地版本号服务端返回 304 或者新数据。这样能最大程度减少数据传输和刷新次数。4.5 电源管理与休眠调优ESP32 的深度休眠电流可以做到 10uA 左右但前提是关掉所有不必要的外设电源。墨水屏模块在休眠时也要断电否则它自己会耗电。具体做法是用一个 MOS 管控制屏幕的 VCC休眠时拉低。唤醒源可以配多个定时器唤醒比如每 30 分钟检查一次更新、按键唤醒手动刷新、外部中断唤醒如果有传感器。购物清单场景定时 30 分钟到 1 小时检查一次足够了太频繁没必要。实操心得调试功耗时先用万用表测休眠电流如果超过 100uA检查是不是有 LED 没关、稳压器静态电流太大、或者某个引脚悬空导致漏电。我踩过的一个坑是串口芯片没断电白白多耗了几百微安。5. 常见问题与排查技巧实录5.1 屏幕显示异常排查现象可能原因解决办法全白无显示接线错误、驱动型号不对检查 SPI 接线确认驱动芯片型号全黑波形表错误、电压不足换驱动库检查电池电压显示发灰局刷残影累积执行全刷清屏局部花屏BUSY 引脚未接或接触不良确保 BUSY 正确连接刷新后内容偏移分辨率设置错误核对屏幕分辨率参数5.2 同步失败排查同步失败最常见的原因是Wi-Fi 连不上和服务端地址写错。我的排查顺序是先用串口打印 Wi-Fi 连接状态确认能拿到 IP再用浏览器或者 curl 测试服务端接口是否可达最后检查固件里的 URL 和端口。另一个坑是HTTPS 证书。如果服务端用了自签名证书ESP32 默认会拒绝连接。解决办法是要么用 HTTP内网自用可以接受要么把证书指纹写进固件做校验。5.3 电池续航不达预期如果发现电池掉得比预期快按这个顺序查先测休眠电流再测工作电流和单次工作时长最后算日均耗电。常见问题包括Wi-Fi 没真正断开、屏幕没断电、定时唤醒间隔太短、某个传感器一直在采样。我遇到过一次续航只有几天的情况最后发现是固件里有个delay()在循环里导致设备根本没进休眠。所以休眠前一定要确认所有任务都挂起或者删除别留后台任务偷偷跑。5.4 网页端同步冲突两个人同时改清单时可能出现一方改动被覆盖。简单做法是服务端记录最后修改时间设备拉取时如果发现远端版本比本地新就覆盖本地。如果要做更细的合并可以给每个条目加唯一 ID 和删除标记合并时按 ID 对齐。家庭场景下最后写入为准基本不会出问题但如果经常多人同时编辑建议加一个“正在编辑”的提示或者乐观锁。6. 一些实际使用后的体会这个项目我从打样到日常使用大概折腾了一个多月最大的感受是电子墨水屏的刷新体验决定了整个产品的成败。刚开始我每次改动都全刷闪得人眼晕后来改成局刷为主、全刷为辅体验立刻上了一个台阶。另一个体会是配网一定要做简单我第一版硬编码 Wi-Fi 密码换路由器后设备直接变砖后来换成 WiFiManager 才省心。还有一点别低估手机网页的便利性。我一开始想做个 App后来发现网页完全够用而且改起来快、不用审核、家人也能直接用。如果你也在做类似的东西我建议先把最小可用版本跑通屏幕能显示、网页能改、设备能同步这三件事通了剩下的都是优化。后续如果想扩展可以加语音输入手机网页调麦克风、加到期提醒清单条目带日期、加多设备同步厨房一个、玄关一个。但核心逻辑不变还是那套“网页编辑、服务端存储、设备拉取刷新”的架构。
)
)
)
