1. 项目概述：一块能“省电”的屏幕
如果你玩过树莓派或者Arduino，肯定对各种各样的显示屏不陌生。从炫彩的OLED到常见的LCD，选择很多。但今天我想聊的这块屏，有点不一样——Grove接口的2.13英寸三色电子墨水屏。它不发光，只在刷新内容时才耗电，刷新完哪怕你把电源拔了，画面依然能保持好几天甚至几周。这个特性，让它天生就适合那些需要长期显示固定信息，但又对功耗极其敏感的场景，比如智能家居的温湿度标签、超市的电子价签，或者一个放在桌面上显示日程和天气的“永远在线”的桌面摆件。
我第一次接触这种屏，就是想做一个不用天天充电的天气预报站。当时被OLED屏的烧屏和续航问题折腾得够呛，直到用了电子墨水屏，才真正体会到“省心”是什么感觉。Grove接口更是让连接变得傻瓜化，不用再纠结于杜邦线接错正负极或者SPI引脚冲突。这块2.13英寸的屏，尺寸适中，分辨率是212x104像素，虽然不高，但显示文字和简单图标绰绰有余，最关键的是它支持黑、白、红三色显示，这让信息层级可以分得更清楚，比如用黑色显示主体内容，红色突出警告信息或关键数据。
2. 核心思路与方案选型：为什么是“Grove”+“电子墨水”？
2.1 电子墨水技术原理浅析
电子墨水屏，学名叫做“电泳显示”（EPD）。你可以把它想象成无数个微小的“胶囊”，每个胶囊里装着带负电的黑色粒子和带正电的白色粒子，它们悬浮在透明的液体里。当我们在胶囊两侧施加一个电场时，这些带电粒子就会根据电场的极性移动到胶囊的顶部或底部。比如，顶部电极带负电，就会排斥黑色粒子（负电）使其下沉，吸引白色粒子（正电）使其上浮，这样我们从顶部看过去，这个像素点就显示为白色。电场撤销后，粒子由于物理作用会保持位置，从而实现静态显示不耗电。
三色屏（黑白红）的实现，通常是在黑白粒子的基础上，增加了红色颜料层或另一种颜色的带电粒子。通过更复杂的电场序列控制，可以决定让红色层显示还是让底层的黑白电泳层显示，从而混合出红、白、黑三种颜色。这种物理特性决定了它的几个核心特点：超低功耗（仅刷新时耗电）、视觉舒适（类纸质、无背光不刺眼）、强光下可视（依靠环境光反射，阳光越强越清晰），以及刷新速度慢（全屏刷新通常需要几秒）和有残影风险。
2.2 Grove生态的优势与考量
Grove是Seeed Studio推出的一套模块化电子接口标准。它的核心是提供了一个四针的标准化连接器（VCC， GND， 信号1， 信号2），并配套了丰富的传感器、执行器模块。选择Grove接口的电子墨水屏，主要基于以下几点考量：
- 连接可靠性：对于新手或需要快速原型开发的场景，Grove接口杜绝了接错线的可能。你只需要一根Grove线，对准主板（如Seeed的XIAO系列、树莓派的Grove扩展板）的接口插上即可，VCC和GND自动对应，大大降低了硬件入门的门槛和调试时间。
- 简化电路设计：这块屏的驱动电路（包括波形生成、电源管理、存储等）已经集成在了模块背面。你不需要自己设计升压电路来产生电子墨水屏所需的高压（通常需要±15V左右），也不需要关心复杂的刷新波形时序，模块通过SPI或I2C接口接收你的显示数据，内部驱动芯片会处理好一切。
- 快速集成与兼容性：得益于Grove庞大的生态系统，这块屏可以轻松地与数百种其他Grove模块（如温湿度传感器、光线传感器、按钮）组合，快速搭建一个完整的低功耗信息显示终端。主控方面，它兼容Arduino、树莓派、MicroPython设备等多种平台，只要你的主控板有Grove接口或能引出SPI引脚。
当然，Grove接口也有其局限，比如引脚定义固定，对于需要大量GPIO的高级应用可能不够灵活。但对于我们做桌面摆件、信息牌这类专注于显示和简单交互的项目，它的便利性远大于局限性。
3. 硬件连接与驱动准备
3.1 所需材料清单
要玩转这块屏，你需要准备以下核心部件：
- 主控板：这里我以目前非常流行且性价比极高的Seeed Studio XIAO ESP32C3为例。它体积小巧，自带Wi-Fi/蓝牙，性能足够，且板载了一个Grove接口，完美匹配。当然，你也可以使用Arduino Uno（需搭配Grove扩展板）或树莓派。
- 显示屏：Grove - 2.13英寸三色电子墨水显示屏 (分辨率212x104)。
- 连接线：一根Grove四芯电缆（通常模块会附带）。
- USB数据线：用于给XIAO ESP32C3供电和编程。
3.2 物理连接与引脚对应
连接简单到只需一步：将Grove线的一端插入显示屏模块的Grove接口，另一端插入XIAO ESP32C3上唯一的那个Grove接口（标有“D6”）。这就完成了所有物理连接。
背后的引脚对应关系是：
- Grove接口 (屏): VCC ->3.3V, GND ->GND, SDA ->D6(SPI MOSI), SCL ->D7(SPI SCK)。
- 模块内部还使用了D5作为SPI片选（CS），D4作为数据/命令选择（DC），D8作为忙状态检测（BUSY）。这些引脚连接已在模块内部固化，我们无需操心。
注意：务必确认你的主控板Grove接口供电是3.3V。XIAO ESP32C3的Grove口是3.3V，完全匹配。如果使用5V系统（如Arduino Uno），需要确认该屏模块是否支持5V输入（查看产品手册），否则可能损坏屏幕。
3.3 驱动库安装与环境搭建
我们使用Arduino IDE进行开发。首先需要安装两个库：
- 安装ESP32板支持包：在Arduino IDE的“文件->首选项->附加开发板管理器网址”中，添加
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json。然后在“工具->开发板->开发板管理器”中搜索“ESP32”，安装“Espressif Systems”的版本。 - 安装Grove EPD驱动库：在“项目->加载库->管理库”中，搜索“Grove EPD”。我使用的是“Grove - EPD” by Seeed Studio。这个库封装了与屏幕驱动芯片（可能是SSD1680或类似）的通信，提供了高级的绘图函数。
安装完成后，在“工具”菜单中选择正确的开发板（“Seeed XIAO ESP32C3”），选择正确的端口，就可以开始编程了。
4. 基础显示功能实现与解析
4.1 初试啼声：清屏与显示文本
让我们从一个最简单的例子开始，让屏幕显示“Hello, E-Paper!”。理解电子墨水屏的编程，核心在于掌握其“刷新”概念。
#include <Grove_EPD.h> // 包含驱动库 // 根据你的屏幕型号初始化驱动对象，2.13英寸三色屏通常对应 EPD_213_T GroveEPD_213_T epd; // 创建屏幕对象 void setup() { Serial.begin(115200); epd.begin(); // 初始化屏幕，包括SPI通信、硬件复位等 Serial.println("EPD init OK!"); // 1. 清屏为白色（避免残影） epd.clear(EPD_WHITE); // 2. 设置字体和颜色（在内存帧缓冲中操作） epd.setFont(&FreeMonoBold12pt7b); // 使用Adafruit GFX内置字体 epd.setTextColor(EPD_BLACK, EPD_WHITE); // 前景黑色，背景白色 // 3. 设置光标位置并打印文本 epd.setCursor(10, 30); // (x, y)坐标，原点在左上角 epd.print("Hello, E-Paper!"); // 4. 将内存帧缓冲的内容更新到物理屏幕（耗时操作） epd.display(); Serial.println("Display updated."); // 5. 进入深度睡眠以省电 epd.sleep(); } void loop() { // 空循环，显示内容将一直保持 delay(1000); }关键点解析：
epd.begin(): 这个函数至关重要，它完成了屏幕的上电序列、硬件复位和初始化命令。如果此步骤失败，后续所有操作都无效。epd.clear(EPD_WHITE): 在绘制新内容前，先清空帧缓冲为白色。这能确保旧内容被覆盖，是避免“鬼影”（上一次显示内容的残留）的良好习惯。epd.display(): 这是最耗时的操作（可能需要2-3秒）。此函数会将我们在内存（帧缓冲）中绘制好的所有图形、文字，通过复杂的波形序列，一次性更新到电子墨水颗粒上。在此期间，屏幕会闪烁数次（这是正常的刷新波形），且BUSY引脚会保持高电平。epd.sleep(): 刷新完成后，立即让屏幕进入睡眠模式。此时驱动芯片大部分电路关闭，功耗可降至微安级。下次刷新前，必须再次调用epd.begin()唤醒屏幕。
4.2 图形绘制与多色运用
除了文字，绘制图形能让界面更生动。库继承了Adafruit GFX库的强大图形功能。
void displayGraphics() { epd.begin(); epd.clear(EPD_WHITE); // 绘制一个黑色矩形边框 epd.drawRect(10, 10, 100, 50, EPD_BLACK); // 填充一个红色矩形 epd.fillRect(120, 10, 80, 40, EPD_RED); // 画一条黑线 epd.drawLine(10, 70, 200, 70, EPD_BLACK); // 画一个黑色圆圈 epd.drawCircle(50, 120, 20, EPD_BLACK); // 在红色区域上写白色字（注意设置正确的背景色） epd.setTextColor(EPD_WHITE, EPD_RED); // 白字红底 epd.setCursor(125, 35); epd.print("Alert"); // 更新显示 epd.display(); epd.sleep(); }三色使用心得：
- 黑白是基础：黑色和白色的对比度最高，适合显示主要内容和背景。
- 红色用于强调：红色非常醒目，但不宜大面积使用。适合标记警告、重要数字（如高温）、状态异常（如“错误”）或关键标题。
- 颜色覆盖逻辑：电子墨水屏的颜色是“覆盖”关系。后绘制的图形会覆盖先绘制的。如果你在黑色区域上想写白字，必须使用
setTextColor(EPD_WHITE, EPD_BLACK)，原理是先在那个矩形区域用背景色“填充”，再画上前景文字。
5. 实战项目：打造低功耗桌面信息站
现在，我们将结合Wi-Fi功能，制作一个能自动从网络获取天气和日期时间，并定时刷新的桌面信息站。这是电子墨水屏的典型应用。
5.1 系统架构设计
项目目标是每30分钟更新一次天气和時間，其余时间主控和屏幕均深度睡眠以节省电能。整体流程如下：
- 上电/唤醒：ESP32从深度睡眠中定时唤醒。
- 网络连接：连接预设的Wi-Fi。
- 数据获取：通过HTTP请求从公开的天气API（如心知天气、和风天气）和NTP服务器获取数据。
- 数据处理与绘制：解析JSON数据，在内存帧缓冲中设计并绘制显示界面。
- 屏幕刷新：调用
display()将画面更新到屏幕。 - 再次休眠：让屏幕进入睡眠，然后配置ESP32的定时器，进入深度睡眠，等待下一个周期。
5.2 关键代码实现
这里展示核心逻辑片段，你需要自行替换Wi-Fi信息和API密钥。
#include <Grove_EPD.h> #include <WiFi.h> #include <HTTPClient.h> #include <ArduinoJson.h> #include <time.h> GroveEPD_213_T epd; // 配置你的网络和API const char* ssid = “Your_SSID”; const char* password = “Your_PASSWORD”; const char* weatherAPI = “http://api.seniverse.com/v3/weather/now.json?key=YOUR_KEY&location=beijing&language=zh-Hans&unit=c”; const char* ntpServer = “pool.ntp.org”; void setup() { Serial.begin(115200); connectToWiFi(); configTime(8 * 3600, 0, ntpServer); // 设置东八区时区 // 获取并显示数据 displayWeatherAndTime(); // 准备深度睡眠 Serial.println(“Entering deep sleep for 30 minutes...”); // 注意：ESP32C3的深度睡眠需要用到GPIO0的RTC唤醒 esp_sleep_enable_timer_wakeup(30 * 60 * 1000000ULL); // 30分钟，单位微秒 delay(100); // 等待串口输出完成 esp_deep_sleep_start(); // 进入深度睡眠 } void loop() { // 不会执行到这里 } void connectToWiFi() { WiFi.begin(ssid, password); Serial.print(“Connecting to WiFi...”); while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print(“.”); } Serial.println(“\nConnected!”); } void displayWeatherAndTime() { epd.begin(); epd.clear(EPD_WHITE); // 1. 获取并绘制时间 struct tm timeinfo; if (!getLocalTime(&timeinfo)) { Serial.println(“Failed to obtain time”); epd.setCursor(10, 20); epd.print(“Time Error”); } else { char timeStr[20]; strftime(timeStr, sizeof(timeStr), “%H:%M”, &timeinfo); epd.setFont(&FreeMonoBold18pt7b); epd.setTextColor(EPD_BLACK); epd.setCursor(10, 30); epd.print(timeStr); strftime(timeStr, sizeof(timeStr), “%Y-%m-%d”, &timeinfo); epd.setFont(&FreeMono9pt7b); epd.setCursor(10, 55); epd.print(timeStr); } // 2. 获取并绘制天气 String weatherText = “N/A”; String tempText = “–°C”; if (WiFi.status() == WL_CONNECTED) { HTTPClient http; http.begin(weatherAPI); int httpCode = http.GET(); if (httpCode == HTTP_CODE_OK) { String payload = http.getString(); DynamicJsonDocument doc(1024); deserializeJson(doc, payload); weatherText = doc[“results”][0][“now”][“text”].as<String>(); tempText = doc[“results”][0][“now”][“temperature”].as<String>() + “°C”; } http.end(); } // 绘制天气信息，温度用红色突出显示 epd.setFont(&FreeMono12pt7b); epd.setTextColor(EPD_BLACK); epd.setCursor(10, 90); epd.print(weatherText); epd.setFont(&FreeMonoBold18pt7b); epd.setTextColor(EPD_RED); // 温度用红色 epd.setCursor(120, 90); epd.print(tempText); // 3. 绘制一个简单的图标框 epd.drawRect(150, 10, 50, 50, EPD_BLACK); epd.setCursor(155, 45); epd.setFont(&FreeMono9pt7b); epd.setTextColor(EPD_BLACK); epd.print(“WTHR”); // 4. 更新屏幕 epd.display(); epd.sleep(); // 屏幕睡眠 }5.3 功耗优化与电源管理
这是项目的精髓所在。实测数据如下：
- 刷新过程：屏幕刷新时（约2-3秒），整个系统（ESP32 + 屏幕）电流峰值可达~80mA。
- 屏幕睡眠后：屏幕自身功耗降至~10uA以下，几乎可忽略。
- ESP32深度睡眠：ESP32C3在深度睡眠模式下，电流可低至~20uA。
假设每30分钟（1800秒）刷新一次，每次刷新活跃时间3秒。
- 平均电流 ≈ [(3s * 80mA) + (1797s * 0.02mA)] / 1800s ≈0.15mA
- 使用一块1000mAh的锂电池，理论续航时间 ≈ 1000mAh / 0.15mA ≈6666小时，约277天。
这仅仅是理论计算，实际还会受到Wi-Fi连接耗电、环境温度等因素影响，但轻松实现数月续航是毫无压力的。你可以使用一个小的太阳能板搭配充电管理电路，实现完全的能量自给自足。
6. 常见问题与深度排坑指南
在实际使用中，你几乎一定会遇到下面这些问题。这里是我踩过坑后的经验总结。
6.1 显示问题排查表
| 问题现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| 屏幕全白/全黑，无内容 | 1. 电源问题 2. 初始化失败 3. 硬件连接错误 | 1. 用万用表测量Grove接口VCC是否为稳定的3.3V。 2. 检查 epd.begin()的返回值或后续display()是否执行。在begin()后添加Serial.println(“EPD Begin OK”)调试。3.最重要：确认使用的是3.3V主控板。5V可能会损坏屏幕。 |
| 显示内容模糊、有重影 | 1. 未正确清屏 2. 刷新模式不对 3. 屏幕物理老化 | 1. 每次更新画面，务必先执行epd.clear(EPD_WHITE)。2. 尝试在 display()前调用epd.setFullWindow()强制全屏刷新（库可能支持）。全屏刷新更彻底，但速度慢且更闪烁。局部刷新快但有累积残影风险。对于长时间静态显示，建议每次都用全刷。3. 电子墨水屏有刷新次数寿命（通常几十万次），但正常使用很难达到。 |
| 刷新后屏幕局部变灰或残留旧图 | 局部刷新（Partial Update）的固有缺陷 | 这是电子墨水屏局部刷新技术的物理限制。电荷清除不彻底导致。解决方案：每进行数次（如5-10次）局部刷新后，必须执行一次全屏刷新（clear+display）来彻底清空残留电荷。许多驱动库的display()函数内部会自动判断和管理这个周期。 |
| 刷新过程异常缓慢或卡住 | 1. BUSY引脚未正确等待 2. SPI时钟速度过快 | 1. 确保驱动库在display()函数内部有正确检测BUSY引脚状态的逻辑，必须等待BUSY变低才能发送下一条命令。可以检查库源码。2. 尝试在 epd.begin()初始化时降低SPI时钟频率，有些屏对高速SPI支持不佳。 |
| 红色显示不正常（如发黑） | 刷新波形或时序不匹配 | 三色屏刷新黑白和红色的波形序列不同。确认你使用的Grove_EPD库是否明确支持你的具体屏幕型号（如EPD_213_T）。型号不对，驱动命令会出错。去Seeed的Wiki页面核对型号和示例代码。 |
6.2 编程与逻辑中的“坑”
- 内存帧缓冲是核心：所有
drawRect,print,setCursor等操作，都只是在MCU内存里的一块“画布”上修改。只有调用display()，才会把整块“画布”推送到屏幕。因此，复杂的UI应该先在内存中组合好，最后一次性display，避免多次刷新。 - 深度睡眠与唤醒的序列：在让ESP32进入深度睡眠前，务必先让屏幕进入睡眠(
epd.sleep())。否则屏幕可能保持在高功耗状态。唤醒后，第一件事就是重新初始化屏幕 (epd.begin())。这个顺序不能乱。 - Wi-Fi连接耗电是大头：在我们的信息站项目中，最耗电的阶段其实是Wi-Fi连接和数据获取。为了进一步省电，可以：
- 使用更快的Wi-Fi连接方式（如保存Wi-Fi凭证到NVS，快速重连）。
- 选择响应更快的天气API，减少HTTP请求等待时间。
- 如果信号稳定，可以尝试降低Wi-Fi发射功率。
- 字体与内存消耗：Adafruit GFX字体是位图字体，较大的字体文件会占用大量程序存储空间（Flash）。如果项目复杂，可能导致编译失败。解决方案是使用较小的字体，或者仅包含需要的字符子集（Adafruit提供了工具）。
7. 进阶玩法与扩展思路
当你掌握了基础显示和定时刷新后，可以尝试更多有趣的应用：
- 制作电子相框（慢速）：将小型黑白漫画或高对比度图片转换为1-bit位图，通过
drawBitmap函数显示。由于刷新慢，适合展示不常更换的艺术画或名言警句。 - 智能家居标签：结合温湿度传感器（如Grove - DHT20），制作一个放在各个房间的温湿度显示器。可以设置阈值，当温度超标时，用红色显示温度值进行报警。
- 交互式菜单：配合Grove - 按键或旋转编码器，实现简单的菜单交互。例如，一个通过按键切换显示天气预报、日历、待办事项的桌面终端。注意交互反馈不能依赖实时动画，而是通过整屏刷新来更新菜单页。
- 利用红色区域做状态栏：将屏幕顶部或底部的一小条区域固定用于显示红色信息，如连接状态、电池电量低警告、未读消息数量等。由于红色醒目且仅在状态变化时才需刷新该局部区域，既实用又省电。
这块小小的Grove三色墨水屏，打开的是一扇通往超低功耗嵌入式显示应用的大门。它的魅力不在于绚丽的色彩或流畅的动画，而在于那份“静默的坚守”——用最小的能量消耗，提供最清晰、最持久的信息呈现。从简单的文字显示到联网的信息终端，每一步实践都会让你对功耗管理、硬件接口和UI设计有更深的理解。
