1. 项目缘起与整体设计思路1.1 为什么我要做一条数字钥匙链钥匙链这东西几乎每个人兜里都揣着一串但绝大多数就是几片金属加一个塑料挂件功能单一到不能再单一。我一直在琢磨能不能把一块带 Wi-Fi 的微控制器塞进钥匙链的尺寸里让它既能当装饰挂件又能干点实际的事情——比如显示天气、当个迷你信息牌、甚至做个随身的小工具。这就是 eChain 这个项目的出发点一条有趣的数字钥匙链。核心硬件我选了ESP32-S3具体型号是ESP32-S3-N16R8 Mini 开发板16MB Flash 加 8MB PSRAM 的配置。为什么是它因为这块板子体积小、自带 Wi-Fi、算力足够驱动一块电子墨水屏而且 GPIO 数量在迷你板里算相当充裕的。显示部分用ePaper电子墨水屏这是整个项目的灵魂——墨水屏断电后画面不消失功耗极低特别适合钥匙链这种偶尔刷新、长期待机的场景。开发环境用Arduino IDE对个人项目来说上手快、库生态成熟没必要一上来就折腾更重的框架。这个项目适合谁如果你玩过 Arduino、手里有块 ESP32 想找个有意思的练手项目或者你想做一个真正能天天带在身上的小玩意儿那 eChain 就是个很好的切入点。它不需要你懂复杂的电路设计焊接量很小主要工作在软件和结构上。下面我会把整个设计思路、硬件选型、代码实现、踩过的坑全部摊开讲你可以直接照着复现。1.2 整体架构与功能规划eChain 的功能我做了取舍没有贪多。核心功能定在三个一是显示自定义的图案或文字比如你的名字缩写、一个 logo、一句座右铭通过墨水屏呈现二是联网获取信息比如显示当前时间、简单天气靠 ESP32-S3 的 Wi-Fi 实现三是低功耗待机平时屏幕保持画面芯片进入深度睡眠按一下按键才唤醒刷新。架构上分三层硬件层ESP32-S3 墨水屏 锂电池 按键、固件层Arduino 程序负责驱动屏幕、联网、电源管理、结构层3D 打印外壳或亚克力板把电路包成钥匙链形态。这三层里硬件层决定能不能做小固件层决定好不好用结构层决定好不好看。我个人的经验是先把固件跑通再考虑外壳不然外壳做完了发现电路要改前功尽弃。提示墨水屏刷新慢是物理特性别指望它做动画。它的定位是静态信息展示想清楚这一点整个项目的功能边界就清晰了。2. 硬件选型与核心细节解析2.1 ESP32-S3-N16R8 Mini 开发板为什么合适选板子这件事我对比过好几款。ESP32-S3-N16R8 Mini 的优势在于16MB Flash意味着你可以塞下多套字库和图片资源不用为空间发愁8MB PSRAM对驱动墨水屏的帧缓冲特别关键——一块 2.13 寸墨水屏的帧缓冲大概需要几十 KB普通 ESP32 的 SRAM 勉强够用但加上 Wi-Fi 协议栈就紧张了有 PSRAM 就从容很多。Mini 版的尺寸通常在 20mm×50mm 左右塞进钥匙链外壳完全可行。它的 Wi-Fi 是 2.4GHz 频段支持 STA 和 AP 模式做联网取数据绰绰有余。GPIO 方面驱动墨水屏用 SPI 接口占 4 到 6 个引脚再留一两个给按键和电池检测剩下的还够扩展。我实测下来这块板子的稳定性比一些杂牌 ESP32 好不少尤其是长时间待机唤醒后重新联网掉线率低。2.2 电子墨水屏的选型与驱动原理墨水屏我推荐2.13 寸、250×122 分辨率、SPI 接口的型号比如常见的 Waveshare 或微雪兼容款。为什么选这个尺寸因为钥匙链的视觉面积有限2.13 寸刚好能显示三四行文字或一个中等图案再大就笨重了。分辨率 250×122 属于够用不浪费帧缓冲小刷新也快一点。墨水屏的驱动原理值得说清楚它内部是无数个微胶囊里面装着黑白带电粒子靠电场驱动粒子移动来显色。刷新分全刷和局刷——全刷会黑屏闪一下再显示约 2 秒局刷快但残影会累积。我的做法是开机或换大图时全刷一次之后小范围更新用局刷每隔十几次局刷再补一次全刷清残影。这个策略实测下来画面最干净。接线方面SPI 的几根线要接对SCLK、MOSI、CS、DC、RST、BUSY。BUSY 引脚很关键墨水屏刷新期间它是忙状态程序必须等它拉低才能发下一条指令否则画面会乱。我一开始没接 BUSY 用延时硬等结果偶尔花屏后来老老实实接上就再没出过问题。2.3 供电与低功耗设计的关键取舍钥匙链要能随身带供电只能用小容量锂电池我用的是一块 3.7V、300mAh 的软包电池尺寸约 30mm×20mm×4mm塞进外壳刚好。ESP32-S3 在 Wi-Fi 工作时电流能到 100mA 以上300mAh 撑不了太久所以低功耗设计是必须的不是可选项。我的策略是平时芯片进deep sleep电流降到几十微安只有按键中断或定时器到点才唤醒。唤醒后如果只是刷新屏幕几秒内完成再睡回去如果要联网控制在 10 秒内完成。这样算下来一天刷新十几次电池能撑一两周。充电用 TP4056 模块带过充过放保护直接 USB 口充电。注意锂电池千万别接反也别用没有保护板的裸电芯。我见过有人图省事直接焊电芯结果过放把电池鼓包了很危险。带保护板的电池贵几块钱但省心。3. 开发环境搭建与实操过程3.1 Arduino IDE 配置 ESP32-S3 的完整流程先说开发环境。Arduino IDE 我用的 2.x 版本配置 ESP32-S3 的步骤如下。第一步在首选项的附加开发板管理器网址里填入 ESP32 的板支持包地址乐鑫官方那个 JSON 链接。第二步打开开发板管理器搜索 esp32安装最新版。这一步在国内网络下经常卡住建议提前下载离线包或者耐心等它下完别中途关掉。安装完成后开发板选ESP32S3 Dev Module然后重点配置几个参数Flash Size 选 16MBPSRAM 选 OPI PSRAMN16R8 是 Octal PSRAM选错会启动失败Partition Scheme 选 16M Flash 的大分区方案不然装不下字库。USB CDC On Boot 建议开启这样串口打印能正常输出。我踩过的一个坑Arduino IDE 启动时一直等待卡在启动界面进不去。这通常是它在后台扫描网络或加载插件导致的。解决办法是断网启动一次或者在设置里关掉启动时检查更新。Mac 用户如果遇到mac arduino ide打不开、提示来源不明去安全性与隐私里允许一下就行。3.2 墨水屏驱动库的安装与初始化墨水屏驱动我用的是GxEPD2库它对多种型号兼容性好支持局刷和部分刷新。在库管理器里搜 GxEPD2 装上再装一个Adafruit GFX作为图形底层。初始化时根据你的屏幕型号选对应的类比如 2.13 寸的常见型号是GxEPD2_213_B74之类具体看屏幕背面丝印。初始化代码大致是这样#include GxEPD2_BW.h #include SPI.h #define EPD_CS 10 #define EPD_DC 9 #define EPD_RST 8 #define EPD_BUSY 7 GxEPD2_BWGxEPD2_213_B74, GxEPD2_213_B74::HEIGHT display( GxEPD2_213_B74(EPD_CS, EPD_DC, EPD_RST, EPD_BUSY)); void setup() { display.init(115200); display.setRotation(1); display.setTextColor(GxEPD_BLACK); }display.init()里的波特率是给调试用的实际不影响显示。setRotation(1)把屏幕转成横向适合钥匙链的宽扁造型。初始化后第一次刷新建议用display.setFullWindow()全刷把屏幕清干净。3.3 联网取数据与显示的实现联网部分用 ESP32 自带的 WiFi 库。连接流程是唤醒后WiFi.begin(ssid, password)等连接成功然后发 HTTP 请求取数据。我取的是简单的时间接口返回 JSON用 ArduinoJson 库解析出时间字段再画到屏幕上。#include WiFi.h #include HTTPClient.h #include ArduinoJson.h void fetchAndDisplay() { WiFi.begin(你的SSID, 你的密码); unsigned long start millis(); while (WiFi.status() ! WL_CONNECTED millis() - start 8000) { delay(200); } if (WiFi.status() WL_CONNECTED) { HTTPClient http; http.begin(http://你的接口地址); int code http.GET(); if (code 200) { String payload http.getString(); StaticJsonDocument512 doc; deserializeJson(doc, payload); String t doc[time]; display.setFullWindow(); display.firstPage(); do { display.fillScreen(GxEPD_WHITE); display.setCursor(10, 40); display.print(t); } while (display.nextPage()); } http.end(); } WiFi.disconnect(true); }这里有个关键点取完数据立刻WiFi.disconnect(true)关掉 Wi-Fi不然它会一直耗电。我一开始忘了关电池掉得飞快后来加上这句续航直接翻倍。3.4 低功耗与按键唤醒的落地深度睡眠用esp_deep_sleep_start()唤醒源配成按键的 GPIO 中断。按键接在支持 RTC 唤醒的引脚上比如 GPIO 0 到 5 之间选一个配置成低电平触发。#define BUTTON_PIN 3 void setup() { esp_sleep_enable_ext0_wakeup((gpio_num_t)BUTTON_PIN, 0); // ... 其他初始化 } void loop() { // 干活刷新屏幕或联网 // 干完睡觉 esp_deep_sleep_start(); }ext0唤醒只支持一个引脚够用了。注意按键要加下拉电阻不然悬空会误触发。我用的 10kΩ 下拉实测稳定。唤醒后程序从头跑一遍setup()所以状态要存在 RTC 内存里别指望变量能保留。4. 常见问题与排查技巧实录4.1 屏幕不显示或花屏怎么查这是最高频的问题。排查顺序我总结成一张表现象可能原因解决办法完全白屏接线错、CS/DC 接反对照丝印逐根检查花屏、乱码BUSY 没接或没等接上 BUSY 并等待拉低显示一半供电不足换足电电池或加电容残影严重长期局刷定期全刷清屏刷新后不变没调 nextPage检查 firstPage/nextPage 循环我最开始遇到花屏折腾半天以为是库的问题最后发现是 BUSY 引脚接错了位置。墨水屏的 BUSY 一定要接对这是新手最容易忽略的点。4.2 联网失败与耗电异常的排查联网失败先看串口打印确认是连不上路由器还是请求超时。连不上多半是 SSID 或密码写错或者路由器开了 MAC 过滤。请求超时可能是接口地址不对或对方限流。建议把 Wi-Fi 连接超时设成 8 秒以内超时就放弃直接睡别死等。耗电异常的话用万用表串在电池正极测电流。正常待机应该几十微安如果测出来几毫安说明有外设没关——最常见的是 Wi-Fi 没 disconnect或者墨水屏没进休眠。墨水屏有个display.hibernate()方法刷完调一下能进一步省电。4.3 几个我踩过的坑和独家心得第一个坑PSRAM 选错导致启动失败。N16R8 是 Octal PSRAMArduino IDE 里必须选 OPI PSRAM选成 QSPI 会一直重启。这个坑我卡了半小时最后看串口日志才发现。第二个坑字库太大装不下。中文字库动辄几 MB16MB Flash 看着大但分区一划就没多少了。我的做法是只取需要的汉字做成小字库或者干脆用英文和图标省空间。第三个心得外壳留出充电口和按键孔别等打印完才发现插不进 USB。我第一版外壳就是忘了留充电口只能重新打。第四个心得电池和主板之间加个拨动开关长期不用时彻底断电不然 deep sleep 也会慢慢耗电。5. 结构组装与成品打磨5.1 外壳设计与装配要点外壳我用 3D 打印材料选 PLA 就行钥匙链不需要太高强度。设计时留三个开口USB 充电口、按键孔、挂绳孔。屏幕开窗要比屏幕本身大 0.5mm避免装配时压到屏幕边缘。主板和电池用双面胶或热熔胶固定别用螺丝钥匙链空间太小。装配顺序建议先把屏幕和主板用排线连好并测试通过再装进外壳。千万别先封壳再测试不然出问题要拆壳容易损坏排线。我第一版就是先封壳结果屏幕接触不良拆的时候把排线扯断了白干。5.2 成品功能扩展的几种思路eChain 跑通基础功能后可以扩展的方向不少。比如加个温湿度传感器显示环境数据或者做个番茄钟按键启动倒计时再或者显示每日一句联网取一句名言。这些扩展都不难核心是控制好功耗和刷新频率。我个人觉得最有意思的扩展是做成电子名牌开会或活动时挂在胸前显示名字和职位比纸质名牌酷多了。这个场景下墨水屏的静态显示优势发挥得淋漓尽致一整天不用充电。6. 写在最后的一点个人体会这个项目我从画草图到成品挂上钥匙扣前后断断续续花了两三周大部分时间不是在写代码而是在调硬件和改外壳。ESP32-S3 加墨水屏这个组合难点从来不在软件而在电源管理和结构装配。软件有库帮你兜底硬件出问题只能自己一点点排查。如果你也想做我的建议是分阶段来先让屏幕亮起来显示一张图再打通联网最后做低功耗和外壳。每一步都验证通过再往下走别想着一次做完。我见过太多人一上来就买齐所有零件结果卡在第一步就放弃了。最后分享一个小技巧调试阶段先用 USB 供电别接电池等固件稳定了再上电池测续航。这样能避免反复充放电也安全。等你的 eChain 真正挂在钥匙上、掏出来给朋友看的时候那种成就感是纯软件项目给不了的。