1. 项目概述：为什么选择XIAO ePaper Display Board - EN05？

如果你正在寻找一款既能玩转电子墨水屏，又不想在硬件连接和代码调试上耗费太多精力的开发板，那么Seeed Studio的XIAO ePaper Display Board - EN05绝对是一个值得你花时间研究的“宝藏”项目。它不是一个简单的屏幕模块，而是一个高度集成的解决方案，把一块2.66英寸、三色（黑白红）的电子墨水屏和一颗功能强大的微控制器（ESP32-C3）封装在了一个比名片还小的PCB上。

我第一次拿到这块板子时，最直观的感受就是“省心”。传统玩墨水屏，你需要分别购买屏幕、驱动板、主控板，然后小心翼翼地连接FPC排线，还得处理电平转换、电源管理等一系列问题。而EN05把这些都打包好了，你拿到手的就是一个可以直接编程、直接显示的完整设备。这对于想快速制作一个低功耗信息显示终端、一个桌面天气站，或者一个智能家居状态面板的开发者来说，入门门槛被极大地降低了。

它的核心价值在于“开箱即用”和“超低功耗”。电子墨水屏的特性是只在刷新画面时耗电，静态显示时几乎为零功耗。结合ESP32-C3的深度睡眠功能，你可以轻松做出一个用纽扣电池就能运行数月甚至数年的设备。想象一下，一个贴在冰箱上的购物清单，或者一个放在门口的日程提醒板，不需要频繁充电，信息却能一直清晰可见，这就是墨水屏的魅力所在。

2. 核心硬件与开发环境搭建

2.1 开箱与硬件初识

当你拆开EN05的包装，你会看到一块非常精致的板卡。正面是那块2.66英寸的墨水屏，分辨率是296x152像素。这个分辨率对于显示文字、简单的图标和二维码来说已经足够清晰。屏幕下方印有“XIAO”的Logo。翻到背面，核心是乐鑫的ESP32-C3微控制器，这是一颗基于RISC-V架构的单核芯片，主频160MHz，集成Wi-Fi和蓝牙5.0（LE），性能对于驱动这块屏幕和处理网络请求绰绰有余。

板子上有几个关键接口你需要留意：

1. Type-C接口：用于供电和程序烧录。这是目前最主流的接口，用手机数据线就能连接电脑，非常方便。
2. 用户按键：板载了一个可编程的物理按键，默认连接在GPIO1上。你可以用它来切换显示内容、触发刷新或者进入配置模式。
3. 复位按键：用于重启整个系统。
4. 电池接口：板子预留了连接外部锂电池的焊盘（BAT+和BAT-）。这是实现超长待机的关键。当连接外部电池且USB供电断开时，板子会自动切换到电池供电。板载的电源管理芯片会确保电池电压稳定在3.3V供系统使用。

注意：初次使用前，建议先用USB线连接电脑，让板子通过USB供电启动一次，确保所有电路正常工作。如果计划使用电池供电，请务必确认电池的电压范围（推荐3.7V锂电池），正负极不要接反。

2.2 开发环境配置：Arduino IDE篇

对于大多数初学者，我强烈推荐使用Arduino IDE进行开发。它的库管理机制和丰富的示例代码能让你最快速度看到效果。

第一步：安装Arduino IDE与ESP32开发板支持

1. 从Arduino官网下载并安装最新版的Arduino IDE。
2. 打开IDE，进入“文件” -> “首选项”。在“附加开发板管理器网址”中，填入以下地址：

   https://espressif.github.io/arduino-esp32/package_esp32_index.json

   如果你之前添加过其他地址，用逗号隔开即可。
3. 打开“工具” -> “开发板” -> “开发板管理器”。在搜索框中输入“esp32”，找到由“Espressif Systems”提供的“esp32”开发板包，点击安装。这个过程需要下载一些文件，请保持网络通畅。

第二步：安装必要的库EN05的屏幕驱动依赖于特定的库。最常用的是GxEPD2库，它对多种墨水屏提供了优秀的支持。

1. 在Arduino IDE中，点击“项目” -> “加载库” -> “管理库...”。
2. 在库管理器中搜索“GxEPD2”，找到由“Jean-Marc Zingg”开发的版本并安装。这个库包含了EN05所用屏幕（GDEY029T94）的驱动定义。
3. （可选但推荐）同时搜索并安装“Adafruit GFX Library”。这是一个强大的图形库，提供了绘制点、线、圆、文字和位图的基础函数，GxEPD2库的示例会用到它。

第三步：选择开发板与端口

1. 用USB线将EN05连接至电脑。
2. 在Arduino IDE的“工具”菜单下：
   • 开发板：选择“ESP32C3 Dev Module”。
   • Upload Speed：设置为“921600”以获得更快的上传速度。
   • Flash Mode：选择“DIO”（默认）。
   • Flash Size：选择“4MB (32Mb)”。
   • Partition Scheme：选择“Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS)”。
   • 端口：选择识别出的COM口（Windows）或/dev/cu.usbmodem*（Mac）。

实操心得：有时电脑可能无法自动安装EN05的USB串口驱动。如果端口列表里没有出现设备，你需要手动安装CP210x或CH340等USB转串口芯片的驱动。可以到Seeed的Wiki页面或芯片厂商官网下载对应的驱动程序。

3. 第一个程序：让屏幕动起来

环境配置好后，最激动人心的时刻就是让屏幕显示第一幅画面。我们从一个最简单的示例开始，这个示例会清除屏幕并显示一个Hello World的框框。

3.1 基础显示示例解析

在Arduino IDE中，点击“文件” -> “示例” -> “GxEPD2” -> “GxEPD2_Example”。这会打开一个综合示例。但对于入门，我们从一个更精简的版本开始。新建一个Sketch，粘贴以下代码：

#include <GxEPD2_BW.h> // 我们使用黑白红三色屏，但基础驱动是BW（黑白）类 #include <GxEPD2_3C.h> // 三色屏的驱动类 #include <Fonts/FreeMonoBold9pt7b.h> // 一种内置字体 // 定义屏幕对象，参数是屏幕型号、连接引脚等。对于EN05，型号是GDEY029T94 // 引脚定义通常已在板级支持包中预设好，我们使用默认值即可。 GxEPD2_3C<GxEPD2_290_T94, GxEPD2_290_T94::HEIGHT> display(GxEPD2_290_T94(/*CS=*/10, /*DC=*/9, /*RST=*/8, /*BUSY=*/7)); void setup() { Serial.begin(115200); // 初始化串口，用于调试输出 delay(1000); // 给硬件一点启动时间 Serial.println("Setup start"); display.init(115200, true, 2, false); // 初始化显示屏 // 参数说明：波特率（用于SPI通信，可忽略），重置显示，等待时间，是否使用外部RAM（EN05没有，填false） display.setRotation(1); // 设置显示方向，0-3分别对应0°, 90°, 180°, 270°旋转 display.setFont(&FreeMonoBold9pt7b); // 设置字体 display.setTextColor(GxEPD_BLACK); // 设置文字颜色为黑色 // 第一页：清屏并显示Hello World display.setFullWindow(); // 设置全窗口刷新模式（慢，但彻底） display.firstPage(); // 开始多页刷新循环 do { display.fillScreen(GxEPD_WHITE); // 背景填充白色 display.setCursor(20, 30); // 设置文本起始坐标（x, y） display.print("Hello World!"); // 画一个矩形框 display.drawRect(10, 10, display.width() - 20, display.height() - 20, GxEPD_BLACK); } while (display.nextPage()); // 循环直到绘制完成 Serial.println("Setup done"); } void loop() { // 主循环为空，因为我们只显示一次 // 在实际应用中，你可以在这里添加逻辑，例如定时刷新内容 }

代码关键点解读：

1. GxEPD2_3C：这是一个模板类，用于驱动三色（黑、白、红）墨水屏。GDEY029T94是屏幕的具体型号。
2. display.init()：初始化屏幕。第二个参数true表示在初始化前先硬件复位屏幕，这是一个好习惯。
3. setFullWindow()与firstPage()/nextPage()：这是GxEPD2库的核心刷新机制。墨水屏刷新较慢，为了优化体验和避免残影，库采用了“分页刷新”模式。setFullWindow()声明我们要刷新整个屏幕。firstPage()和do...while(display.nextPage())结构会库内部将全屏刷新分解为多个局部刷新步骤，你只需要在循环体内描述最终画面即可。
4. 颜色常量：GxEPD_BLACK,GxEPD_WHITE,GxEPD_RED。注意，红色只能在与黑色、白色组合显示时使用，不能单独渐变。

将代码上传到EN05后，你会看到屏幕先闪烁几次（这是墨水屏在清屏和刷新），然后稳定地显示出“Hello World!”和一个边框。恭喜你，第一步成功了！

3.2 深入理解刷新模式与功耗

墨水屏的刷新是门学问，不同的刷新模式直接影响显示效果和功耗。

• 全刷 (setFullWindow)：如上例所示，完整擦除并重绘整个屏幕。效果最干净，无残影，但耗时最长（约2-3秒），功耗也最高。适用于内容完全改变的场景，如从天气界面切换到日历界面。
• 局部刷 (setPartialWindow)：只刷新屏幕上指定区域的内容。速度很快（几百毫秒），功耗低，但多次局部刷后可能产生轻微残影。适用于更新部分数据，如更新温度数字、时间等。
• 灰度刷新：一些高级驱动支持灰度模拟。EN05的屏幕本身是1-bit（黑白）和1-bit红色，但通过时间抖动算法可以在视觉上模拟灰度效果。GxEPD2库内置了对dithering（抖动）算法的支持，可以用来显示图片。

如何选择刷新模式？我的经验是：初始化后第一次显示用全刷，后续的周期性小更新用局部刷。例如，一个时钟项目，启动时用全刷显示完整的表盘和数字，之后每秒只用局部刷更新一下秒针或数字区域。同时，要规划好刷新频率。非必要不刷新，比如温度每分钟更新一次足矣，没必要每秒刷新。

避坑指南：频繁调用display.init()会导致屏幕反复硬件复位，增加不必要的功耗和磨损。正确的做法是，在setup()中初始化一次，之后在整个设备运行周期内，除非进入深度睡眠后唤醒，否则不要重新初始化。深度睡眠唤醒后，通常需要重新init()。

4. 进阶应用：打造一个低功耗网络天气站

掌握了基础显示后，我们来做一个更实用的项目：一个通过Wi-Fi获取天气信息并显示的桌面站。这个项目会综合运用网络连接、JSON解析、定时唤醒和局部刷新等技术。

4.1 项目架构与网络连接

我们的目标是：EN05每30分钟从公共天气API（例如Open-Meteo）获取一次数据，解析后更新到屏幕上，其余时间进入深度睡眠以节省电量。

第一步：获取并解析天气数据我们选择一个无需API密钥的免费服务。以下代码演示如何获取并解析JSON格式的天气数据。

#include <GxEPD2_3C.h> #include <WiFi.h> #include <HTTPClient.h> #include <ArduinoJson.h> // ... 屏幕对象定义同上 ... const char* ssid = "你的Wi-Fi名称"; const char* password = "你的Wi-Fi密码"; // 使用Open-Meteo API（示例，请查看其最新文档） String url = "https://api.open-meteo.com/v1/forecast?latitude=39.90&longitude=116.41&current_weather=true&timezone=auto"; void setup() { Serial.begin(115200); display.init(115200, true, 2, false); display.setRotation(1); display.setFont(&FreeMonoBold9pt7b); // 连接Wi-Fi WiFi.begin(ssid, password); Serial.print("Connecting to WiFi"); while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } Serial.println("\nConnected!"); // 获取天气数据 if (WiFi.status() == WL_CONNECTED) { HTTPClient http; http.begin(url); int httpCode = http.GET(); if (httpCode == HTTP_CODE_OK) { String payload = http.getString(); Serial.println(payload); // 解析JSON DynamicJsonDocument doc(1024); // 根据返回的JSON大小调整缓冲区 DeserializationError error = deserializeJson(doc, payload); if (!error) { float temperature = doc["current_weather"]["temperature"]; // 温度 float windspeed = doc["current_weather"]["windspeed"]; // 风速 int weathercode = doc["current_weather"]["weathercode"]; // 天气代码 // 在屏幕上显示 display.setFullWindow(); display.firstPage(); do { display.fillScreen(GxEPD_WHITE); display.setCursor(20, 30); display.print("Weather Station"); display.setCursor(20, 60); display.print("Temp: "); display.print(temperature, 1); // 显示一位小数 display.print(" C"); display.setCursor(20, 90); display.print("Wind: "); display.print(windspeed, 1); display.print(" km/h"); // 可以根据weathercode显示简单的天气图标，如☀️、☁️、🌧️的字符或图形 } while (display.nextPage()); } else { Serial.print("JSON parse failed: "); Serial.println(error.c_str()); } } else { Serial.printf("HTTP GET failed, error: %s\n", http.errorToString(httpCode).c_str()); } http.end(); } else { Serial.println("WiFi not connected!"); } // 显示完成后，准备进入深度睡眠 Serial.println("Entering deep sleep for 30 minutes..."); // 对于ESP32-C3，深度睡眠的API略有不同 esp_deep_sleep(30 * 60 * 1000000ULL); // 微秒为单位，30分钟 * 60秒 * 1,000,000微秒 } void loop() { // 由于setup末尾进入了深度睡眠，loop永远不会执行 // 设备唤醒后，会重新从setup开始执行 }

关键点说明：

1. Wi-Fi连接：使用标准的WiFi.begin()。注意，Wi-Fi连接是功耗大户，连接成功后应尽快完成数据获取并断开。
2. HTTP请求：使用HTTPClient库发起GET请求。确保URL正确且返回格式是JSON。
3. JSON解析：使用强大的ArduinoJson库。DynamicJsonDocument doc(1024)中的大小需要根据实际返回的JSON数据大小进行调整，过小会导致解析失败。你可以先打印出payload，估算其大小。
4. 深度睡眠：esp_deep_sleep()函数使ESP32-C3进入深度睡眠模式。在此模式下，CPU、RAM和大部分外设都会断电，仅保留RTC（实时时钟）和少数唤醒源在工作，功耗可低至10μA左右。参数是睡眠时间（微秒）。唤醒后，芯片会经历一次硬件重启，从头执行setup()函数。

4.2 优化显示与电源管理

上面的基础版本每次唤醒都会全刷屏幕并重新连接Wi-Fi，这还不够优化。我们可以做以下改进：

1. 显示优化：使用局部刷新首次显示（或内容大变时）用全刷，后续只更新变化的数字部分（如温度、风速）。

// 假设这是全局变量，用于保存上一次的温度值，以便比较是否需要更新 float lastTemperature = -100; void updateTemperatureDisplay(float newTemp) { if (abs(newTemp - lastTemperature) > 0.1) { // 温度变化超过0.1度才更新 // 计算温度数字显示的区域坐标和大小 int16_t x = 100, y = 60, w = 60, h = 20; // 根据你的布局调整 display.setPartialWindow(x, y, w, h); display.firstPage(); do { display.fillRect(x, y, w, h, GxEPD_WHITE); // 先清空旧内容区域 display.setCursor(x, y + 16); // 调整光标位置 display.print(newTemp, 1); } while (display.nextPage()); lastTemperature = newTemp; } }

2. 电源管理优化：RTC内存与唤醒缘由深度睡眠重启后，所有全局变量都会丢失。为了判断是冷启动还是从睡眠中唤醒，以及保存一些状态（比如是否需要全刷），我们可以使用ESP32的RTC（实时时钟）内存。这部分内存在深度睡眠下仍然保持。

RTC_DATA_ATTR int bootCount = 0; // 这个变量会保存在RTC内存中 RTC_DATA_ATTR bool firstBootAfterFlash = true; // 标记是否是烧录后的第一次启动 void setup() { Serial.begin(115200); delay(1000); // 等待串口稳定 bootCount++; Serial.printf("Boot count: %d\n", bootCount); // 初始化屏幕 display.init(115200, true, 2, false); display.setRotation(1); // 判断启动原因 esp_sleep_wakeup_cause_t wakeup_reason = esp_sleep_get_wakeup_cause(); bool isFullRefreshNeeded = false; switch(wakeup_reason) { case ESP_SLEEP_WAKEUP_TIMER: // 定时器唤醒 Serial.println("Woke up from timer"); isFullRefreshNeeded = (bootCount % 10 == 0); // 每唤醒10次做一次全刷，防止残影累积 break; case ESP_SLEEP_WAKEUP_UNDEFINED: // 上电复位或硬件复位 default: Serial.println("Woke up from initial power-on or reset"); isFullRefreshNeeded = true; // 首次启动或复位，必须全刷 firstBootAfterFlash = false; break; } // ... 后续的Wi-Fi连接、数据获取逻辑 ... if (isFullRefreshNeeded) { // 全刷显示完整界面 drawFullScreenWeather(temperature, windspeed, weathercode); } else { // 局部刷新只更新数据 updateTemperatureDisplay(temperature); updateWindDisplay(windspeed); } // 进入下一次深度睡眠前，可以断开Wi-Fi以节省最后一点功耗 WiFi.disconnect(true); WiFi.mode(WIFI_OFF); delay(100); // 等待Wi-Fi完全关闭 esp_deep_sleep(30 * 60 * 1000000ULL); }

3. 使用外部电池的注意事项当使用外部锂电池时，EN05板载的电源管理芯片会优先使用USB电源，当USB断开时无缝切换至电池。为了最大化电池寿命：

• 确保代码中已启用深度睡眠。
• 如果项目不需要Wi-Fi，在setup()中不要调用WiFi.begin()，甚至可以通过WiFi.mode(WIFI_OFF)彻底关闭Wi-Fi射频，能进一步降低睡眠功耗。
• 测量实际功耗：使用万用表的电流档串联在电池回路中，分别测量工作状态和深度睡眠状态的电流。一个优化良好的ESP32-C3 + 墨水屏项目，睡眠电流应在20μA以下。如果睡眠电流过高（如达到mA级别），检查是否有GPIO引脚悬空（应设置为输入上拉或下拉），或者是否有其他外设未断电。

5. 常见问题与深度排查指南

在实际操作中，你肯定会遇到各种各样的问题。这里我整理了几个最典型的问题和我的排查思路。

5.1 屏幕显示异常（花屏、残影、不刷新）

这是新手最常遇到的问题。

• 症状：上传程序后屏幕全黑、全白、有杂乱条纹，或者刷新后留下严重残影。
• 排查步骤：
  1. 检查电源：首先确认供电是否充足。EN05在刷新屏幕时峰值电流可能超过200mA，劣质USB线或电脑USB口供电不足会导致刷新失败。尝试换一根短的、质量好的USB线，或者使用手机充电器供电。
  2. 检查初始化代码：确认display.init()的参数是否正确。特别是对于EN05，busy引脚（默认为7）的连接至关重要，它用于告诉主控屏幕是否忙。如果这个引脚定义错误，主控会在屏幕还没准备好时发送数据，导致乱码。最稳妥的方法是使用GxEPD2库中为XIAO ePaper Board预定义的板型。在“工具” -> “开发板”处，如果你安装了Seeed的板支持包，可能会直接看到“Seeed XIAO ESP32C3”选项，选择它。库可能会自动匹配正确的引脚。如果没有，你需要查看官方Wiki或示例，确认CS,DC,RST,BUSY这四个引脚在EN05上的具体GPIO编号。
  3. 检查刷新模式：如果残影严重，可能是局部刷新使用太频繁。按照前面所述，定期（比如每10次）做一次全刷来彻底清除残影。
  4. 检查SPI频率：display.init()的第一个参数是SPI时钟频率。过高的频率可能导致通信不稳定。EN05的默认115200是经过测试的稳定值，不建议随意修改。

5.2 程序上传失败

• 症状：Arduino IDE上传时卡住，报错“Timed out waiting for packet header”或“Failed to connect to ESP32”。
• 排查步骤：
  1. 进入下载模式：ESP32-C3芯片需要在上传前进入下载模式。对于EN05，通常的步骤是：先按住板上的“BOOT”按钮（如果有的话，EN05可能将用户按键复用为BOOT）或GPIO9下拉到GND，然后按一下“RST”按钮，再释放“BOOT”按钮。这时芯片应进入下载模式。最简方法：在Arduino IDE点击上传按钮后，看到“Connecting...”提示时，迅速按下并松开EN05板上的“RST”按键。多数情况下， bootloader会自动进入下载模式。
  2. 检查驱动和端口：确认设备管理器（Windows）或系统信息（Mac）中能正确识别到USB串口设备（如CP210x或CH340）。如果端口有黄色感叹号，需要安装驱动。
  3. 降低上传速率：在“工具” ->Upload Speed中，尝试将921600改为115200或更低，特别是在使用较长或质量一般的USB线时。

5.3 深度睡眠后无法唤醒或数据丢失

• 症状：设备睡眠后不再醒来，或者醒来后变量重置。
• 排查步骤：
  1. 检查睡眠时间：esp_deep_sleep()的参数单位是微秒（μs），计算时注意不要溢出。30 * 60 * 1000000ULL中的ULL表示无符号长整型，确保计算在64位下进行。
  2. 检查唤醒源：确保你使用的是定时器唤醒（esp_deep_sleep()本身即指定时间）。如果使用了其他唤醒源（如外部引脚唤醒），需要在睡眠前配置好对应的GPIO。
  3. 使用RTC_DATA_ATTR：所有需要在深度睡眠后保持的全局变量，必须用RTC_DATA_ATTR修饰符声明。普通全局变量在睡眠重启后会丢失。
  4. 检查电源：深度睡眠下电流极小。如果使用电池，确保电池电量充足，且连接可靠。可以用万用表测量睡眠时BAT+和GND之间的电压和电流。

5.4 Wi-Fi连接不稳定或耗电过高

• 症状：有时连不上Wi-Fi，或者设备很快没电。
• 排查与优化：
  1. 增加重试机制：在WiFi.begin()后的连接循环中，增加一个最大重试次数限制，避免因网络暂时不佳而无限阻塞。

     int retryCount = 0; while (WiFi.status() != WL_CONNECTED && retryCount < 20) { // 最多重试20次 delay(500); Serial.print("."); retryCount++; } if (retryCount >= 20) { Serial.println("WiFi connect failed, go to sleep anyway."); // 可以考虑在这里显示一个错误信息，然后继续睡眠 }

  2. 缩短连接时间：连接成功后，立即进行HTTP操作，操作完成后立即调用WiFi.disconnect(true)和WiFi.mode(WIFI_OFF)来关闭Wi-Fi射频。务必在进入深度睡眠前完成这些操作。
  3. 优化API请求：使用高效的JSON解析库，只请求必要的数据字段（在API URL中指定），减少数据传输量，从而缩短Wi-Fi活跃时间。

通过以上这些步骤和技巧，你应该能够顺利地从零开始，让XIAO ePaper Display Board - EN05运行起来，并逐步打造出属于自己的、超低功耗的墨水屏应用。这块板子的可玩性很高，除了显示，其ESP32-C3核心还支持蓝牙、GPIO控制等，你可以发挥想象，把它集成到更多的物联网项目中。记住，玩转电子墨水屏的关键在于“耐心”和“规划”——耐心等待每一次刷新，精心规划每一次功耗状态切换。