1. 项目缘起为什么是reTerminal E系列电子纸最近在折腾一个需要长时间显示信息但又不想一直插着电的项目比如一个放在门口的天气预报牌或者一个厨房里的定时器。用普通的LCD屏吧功耗是个大问题哪怕用OLED显示静态内容时虽然省电但屏幕本身一直亮着总感觉有点浪费而且有烧屏的风险。这时候电子纸E-Paper的优势就体现出来了它只在刷新画面时才耗电显示静态内容时功耗几乎为零视觉上也更接近真实的纸张在强光下反而更清晰。市面上电子纸的驱动板不少但很多都需要复杂的接线和底层驱动编写对只想快速验证想法的爱好者来说门槛不低。直到我发现了Seeed Studio的reTerminal E系列。它本质上是一个集成了Raspberry Pi RP2040微控制器和一块2.13英寸三色黑、白、红电子纸显示屏的一体化开发板。最关键的是它原生支持Arduino IDE这意味着我们可以用熟悉的Arduino语法和丰富的库来驱动这块电子纸大大降低了上手难度。这就像拿到了一本现成的“菜谱”我们只需要按照步骤“烹饪”就能快速做出想要的“菜品”——各种低功耗显示应用。所以这篇“菜谱”的目的很明确手把手带你从零开始在Arduino环境下玩转reTerminal E系列的这块电子纸屏。我会从最基础的环境搭建、显示第一行“Hello World”开始逐步深入到绘制图形、显示图片、制作动态效果并分享我在实际项目中遇到的坑和解决技巧。无论你是刚接触Arduino的新手还是想寻找低功耗显示方案的开发者这篇内容都能给你提供一条清晰的路径。2. 开箱与准备你的第一份“食材清单”拿到reTerminal E系列开发板以reTerminal DM E为例你会发现它非常紧凑。正面是那块2.13英寸、250x122像素的电子纸屏幕背面则是核心的RP2040芯片、必要的电路以及一个用于供电和编程的USB-C接口。板子上还预留了Grove接口方便你扩展其他传感器但本篇我们聚焦于屏幕本身。要开始“烹饪”你需要准备以下“食材”硬件reTerminal E系列开发板一块。USB-C数据线一根用于供电和程序上传。一台电脑Windows, macOS, Linux均可。软件Arduino IDE这是我们的主厨工具。建议使用较新的1.8.x版本或2.0版本。从Arduino官网下载安装即可。RP2040板支持包reTerminal的核心是RP2040我们需要在Arduino IDE中安装对这块芯片的支持。这就像为你的厨房添置一个专门处理某种食材的厨具。安装RP2040支持包的详细步骤避坑重点很多新手会卡在这一步因为Arduino IDE默认并不认识RP2040。我们需要手动添加板管理器网址。打开Arduino IDE点击文件-首选项。在“附加开发板管理器网址”一栏中填入以下网址如果已有其他网址用逗号隔开https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json注意这是由社区维护者Earle Philhower提供的RP2040支持包是目前最稳定、功能最全的选项之一。不要使用其他来源不明的链接。点击“好”保存。然后点击工具-开发板-开发板管理器...。在搜索框中输入“Raspberry Pi Pico/RP2040”。找到由“Earle Philhower”发布的“Raspberry Pi Pico/RP2040”项目点击“安装”。这个过程需要下载一些文件请保持网络通畅。安装完成后你就可以在工具-开发板列表中找到“Raspberry Pi Pico”相关的选项了。但这里还有一个关键点reTerminal E系列虽然基于RP2040但它是一个特定的产品我们需要安装针对它的专用板定义和库才能正确驱动屏幕等外设。reTerminal专用库再次打开Arduino IDE点击工具-管理库...。在库管理器中搜索“reTerminal”。你应该能找到由Seeed Studio发布的“Seeed reTerminal E系列硬件支持库”或类似名称的库。点击“安装”。这个库至关重要它包含了驱动电子纸屏、处理按键如果板载有等所有硬件功能的封装。安装后相关的示例代码也会一并安装。完成以上三步你的“厨房”就准备就绪了。现在在工具-开发板列表中你应该能看到“Seeed reTerminal DM E (RP2040)”或对应的型号选项。选中它并将开发板通过USB线连接到电脑。在工具-端口中选择识别出的串口在Windows上通常是COMx在macOS/Linux上是/dev/cu.usbmodemxxx。3. 第一道菜点亮屏幕与“Hello World”环境搭好了让我们先做一道最简单的“开胃菜”在屏幕上显示“Hello World”。这能验证整个链路是否通畅。在Arduino IDE中点击文件-示例- 滚动找到“Seeed reTerminal E系列硬件支持库”或类似名称的文件夹在里面你应该能找到诸如“EPD_Example”或“Basic_Display”的示例。我们也可以从头自己写理解每一步。创建一个新的Arduino草图Sketch输入以下代码// 首先包含必要的库。reTerminal库已经帮我们封装好了。 #include Arduino.h #include epd_driver.h // 电子纸驱动库 #include epd_gfx.h // 图形绘制库 // 定义屏幕的宽度和高度对于reTerminal DM E是250x122 #define SCREEN_WIDTH 250 #define SCREEN_HEIGHT 122 // 声明一个全局的图形缓冲区framebuffer。电子纸需要将整个画面数据准备好后一次性刷新。 uint8_t *framebuffer; void setup() { // 初始化串口方便调试输出信息 Serial.begin(115200); while (!Serial); // 等待串口连接实际产品中可去掉 // 初始化电子纸显示屏 epd_init(); Serial.println(EPD Init OK!); // 为图形缓冲区分配内存。每个像素用1位1 bit表示黑白对于三色屏可能有更复杂的结构但库已简化。 // EPD_BUFFER_SIZE是一个库中定义的宏会根据屏幕型号计算所需缓冲区大小。 framebuffer (uint8_t *)ps_calloc(sizeof(uint8_t), EPD_BUFFER_SIZE); if (framebuffer NULL) { Serial.println(Failed to allocate memory for framebuffer!); while (1); // 分配失败停止运行 } // 清空缓冲区填充为白色1表示白色0表示黑色具体取决于库的实现 epd_clear(framebuffer, 0xFF); // 0xFF代表全白 // 现在我们有了一个“干净”的虚拟画布接下来在上面“作画” } void loop() { // 在画布上绘制文本 // 首先需要设置字体、颜色和起始坐标 int cursor_x 10; int cursor_y 30; const char* text Hello World!; // 使用库提供的函数绘制文本。颜色0黑色绘制在白色背景上。 epd_draw_string(cursor_x, cursor_y, text, framebuffer, 0); // 绘制完成后将整个缓冲区的内容刷新到物理屏幕上 epd_draw_frame(framebuffer); Serial.println(Frame drawn!); // 电子纸的特性刷新后内容会一直保留无需持续供电。 // 因此我们让loop空转或者进入深度睡眠。这里为了演示我们延迟很长时间。 delay(30000); // 等待30秒你可以看到屏幕内容一直保持不变即使拔掉USB线。 }上传与运行点击Arduino IDE上的“上传”按钮向右的箭头。观察下方控制台输出。第一次上传可能需要时间因为IDE在编译并准备RP2040的UF2固件。上传成功后开发板会自动复位运行。你应该立刻看到屏幕上显示“Hello World”。最关键的一步拔掉USB线。你会发现“Hello World”依然清晰地显示在屏幕上这就是电子纸的魅力——零静态功耗显示。第一个坑与技巧坑上传失败提示“Timed out waiting for UF2 device”。这是因为RP2040芯片需要进入USB大容量存储设备模式才能上传新程序。对于reTerminal通常在上传前你需要按住板子上可能存在的“BOOT”或“BTL”按钮请查阅具体型号的文档然后按一下“RESET”按钮再释放BOOT按钮。这时电脑会识别出一个名为“RPI-RP2”的U盘Arduino IDE才能成功上传。有些版本的库可能支持自动复位如果不成功就手动操作一下。技巧理解“帧缓冲区”Framebuffer。电子纸的刷新速度较慢通常需要几百毫秒到几秒且全屏刷新对屏幕寿命有轻微影响。因此我们不是在屏幕上直接“画”而是在内存里开辟一块和屏幕像素对应的区域framebuffer所有绘图操作画点、线、文字、图片都先修改这个内存区域。最后调用一个刷新函数如epd_draw_frame将内存中的数据一次性、同步地更新到物理屏幕上。这种“双缓冲”机制是驱动电子纸、乃至很多图形界面的核心思想。4. 进阶烹饪绘制图形与显示图像只会显示文字显然不够。一个实用的信息牌需要图标、进度条、甚至自定义图片。接下来我们看看如何绘制基本图形和显示位图。4.1 绘制基本图形reTerminal的图形库通常提供绘制点、线、矩形、圆形等基本函数。让我们修改loop函数或者创建一个新的演示void loop() { // 清屏为白色 epd_clear(framebuffer, 0xFF); // 1. 画一个矩形边框 (起点x, 起点y, 宽, 高, 颜色, framebuffer) epd_draw_rect(10, 10, 100, 50, 0, framebuffer); // 黑色边框矩形 // 2. 画一个填充矩形 epd_fill_rect(120, 10, 60, 40, 0, framebuffer); // 黑色实心矩形 // 3. 画一条线 (起点x, 起点y, 终点x, 终点y, 颜色, framebuffer) epd_draw_line(10, 70, 200, 70, 0, framebuffer); // 4. 画一个圆 (圆心x, 圆心y, 半径, 颜色, framebuffer) epd_draw_circle(60, 100, 20, 0, framebuffer); // 5. 画一个填充圆 epd_fill_circle(150, 100, 25, 0, framebuffer); // 6. 显示一些文字说明 epd_draw_string(10, 130, Shapes Demo, framebuffer, 0); // 刷新到屏幕 epd_draw_frame(framebuffer); delay(30000); }通过组合这些基本图形你已经可以绘制出简单的图表、电池图标、信号强度标识等UI元素了。4.2 显示自定义图像位图显示图片是电子纸项目中的一个亮点比如显示一个logo、一个二维码或者一幅小画。电子纸显示的是黑白或三色图像所以我们需要将彩色图片处理成1位黑白或2位三色的位图数据。步骤通常如下准备图片找到或制作一张图片尺寸最好等于或小于屏幕分辨率250x122。为了最佳效果建议使用高对比度的黑白或红黑图片。转换图片将图片转换为C语言数组一个巨大的、包含0和1或0/1/2的数组。这是最关键也最容易出错的一步。在线工具搜索“image to C array converter for epd”或“LCD image converter”有很多在线工具如LCD Image Converter、Image2CPP等。你需要设置输出格式为“C array”色深为“Monochrome (1 BPP)”或“2-bit”对应三色。输出会是一个.h头文件。使用Python脚本对于批量或自动化处理用PILPython Imaging Library库写个小脚本更灵活。核心是读取图片将每个像素的RGB值根据阈值转换为0黑、1白或2红。集成到项目将生成的头文件例如my_image.h放到你的Arduino项目文件夹里。头文件中会定义一个数组比如const unsigned char my_image[] PROGMEM { ... };。在代码中显示使用库提供的显示位图函数。不同的库函数名可能不同常见的是epd_draw_bitmap或epd_draw_image你需要指定图像数据数组、起始坐标、宽度、高度。示例代码片段假设我们有一个转换好的、大小为100x50像素的黑白位图数据数组名为my_logo。// 包含你生成的头文件 #include my_logo.h void loop() { epd_clear(framebuffer, 0xFF); // 在坐标(75, 36)处显示logo这样它大致在屏幕中央 // 函数参数可能为(x, y, 图像数据指针, 宽度, 高度, 颜色模式, framebuffer) // 具体参数请查阅你所使用的reTerminal库的文档或示例 epd_draw_bitmap(75, 36, my_logo, 100, 50, 0, framebuffer); // 0代表用黑色绘制 epd_draw_string(10, 110, My Logo, framebuffer, 0); epd_draw_frame(framebuffer); delay(30000); }第二个大坑与技巧坑图片显示乱码、全黑或全白。这几乎100%是图片转换环节出了问题。位深度不匹配确保转换时选择的位深度1 BPP, 2 BPP与库函数期望的格式一致。reTerminal E系列的三色屏可能需要特殊的2位数据格式00白01黑10红务必查看库的文档或示例代码中是如何定义颜色值的。扫描顺序图片数据在数组中的排列顺序可能是“从左到右、从上到下”行优先也可能是“从上到下、从左到右”列优先。转换工具和显示函数必须一致。通常行优先更常见。字节对齐对于1位位图每行像素数可能需要是8的倍数字节对齐如果不是转换工具或显示函数可能会自动填充如果处理不当就会错位。解决方案最稳妥的方法是直接使用库作者提供的示例图片和转换工具。在Seeed的库示例中很可能已经包含了一两张示例图片比如seeed_logo.h。研究这个头文件的内容和示例代码中是如何调用它的然后严格按照这个流程处理你自己的图片。技巧使用PROGMEM存储大图像。图像数组可能很大会占用宝贵的RAMRP2040有264KB RAM。使用PROGMEM关键字将常量数据存储在Flash中需要显示时再读取可以节省RAM。就像上面的例子一样。确保你的显示函数支持从PROGMEM读取数据。5. 动态效果与局部刷新让画面“活”起来电子纸全屏刷新慢且会有短暂的黑白闪烁称为“鬼影”或“残影”。对于需要频繁更新部分内容的场景如秒表、进度条全屏刷新体验很差。这时就需要用到局部刷新Partial Refresh。局部刷新只更新屏幕上指定区域的内容速度更快闪烁感更弱但对驱动芯片和波形要求更高。幸运的是好的电子纸驱动库包括reTerminal的库通常会封装好局部刷新功能。实现一个动态进度条的例子void loop() { epd_clear(framebuffer, 0xFF); epd_draw_string(10, 10, Loading..., framebuffer, 0); // 先画一个空的进度条外框 int bar_x 10; int bar_y 40; int bar_width 220; int bar_height 20; epd_draw_rect(bar_x, bar_y, bar_width, bar_height, 0, framebuffer); // 初始全屏刷新一次建立干净的基线 epd_draw_frame(framebuffer); delay(1000); // 等待一下 for (int progress 0; progress 100; progress 5) { // 每次增加5% // 计算本次填充矩形的宽度 int fill_width (bar_width - 2) * progress / 100; // -2是为了留出边框像素 // **关键步骤局部刷新** // 1. 在framebuffer中将旧的进度条区域恢复为白色擦除 epd_fill_rect(bar_x 1, bar_y 1, bar_width - 2, bar_height - 2, 1, framebuffer); // 1代表白色 // 2. 在framebuffer中绘制新的填充部分 epd_fill_rect(bar_x 1, bar_y 1, fill_width, bar_height - 2, 0, framebuffer); // 0代表黑色 // 3. 调用局部刷新函数只更新进度条所在的矩形区域 // 函数名可能是 epd_partial_refresh参数为区域坐标和大小 // 注意局部刷新的区域坐标和大小可能需要对齐到特定的边界如8像素请查阅库文档 epd_partial_refresh(bar_x, bar_y, bar_width, bar_height, framebuffer); // 4. 在framebuffer中更新进度文本同样需要先擦后写 char progress_text[10]; sprintf(progress_text, %d%%, progress); // 先在一个固定矩形区域写白色背景“覆盖”旧文本比较取巧的做法 epd_fill_rect(100, 15, 40, 15, 1, framebuffer); // 再写新文本 epd_draw_string(100, 15, progress_text, framebuffer, 0); // 局部刷新文本区域 epd_partial_refresh(95, 10, 50, 20, framebuffer); // 区域稍大一些确保覆盖 delay(200); // 模拟加载过程 } epd_draw_string(10, 70, Complete!, framebuffer, 0); // 最后进行一次全屏刷新确保画面干净减少长期局部刷新可能积累的残影 epd_draw_frame(framebuffer); delay(5000); }第三个坑与核心技巧坑局部刷新导致严重残影或屏幕损坏。局部刷新对驱动波形非常敏感。如果滥用或者区域设置不当会导致屏幕部分像素状态混乱产生难以消除的“鬼影”。遵循“刷新间隔”和“全刷周期”通常在多次局部刷新后比如10-20次必须进行一次全屏刷新来“复位”所有像素状态。具体次数请查阅屏幕数据手册或库的说明。区域对齐局部刷新的起始坐标和宽度/高度可能需要满足特定对齐要求例如必须是8的倍数。不满足可能导致刷新异常。避免频繁重叠刷新尽量避免对刚刚局部刷新过的区域立即再次进行局部刷新。技巧使用“双缓冲”策略管理动态内容。对于复杂的动态UI可以维护两个逻辑上的“图层”一个背景层存储不常变的内容如边框、标题一个动态层存储频繁变化的内容如进度条、数值。每次更新时只需在framebuffer中修改动态层对应的区域然后局部刷新这个区域。背景层只在初始化或重大变更时随全屏刷新一起更新。这能最大程度减少刷新面积和残影风险。6. 低功耗实战让设备续航从小时到月电子纸的终极优势是低功耗。结合RP2040的睡眠模式我们可以打造出续航惊人的设备。下面是一个模拟传感器数据定时刷新的例子假设通过Grove接口连接了一个温湿度传感器。#include Arduino.h #include epd_driver.h #include epd_gfx.h #include hardware/sleep.h // RP2040的睡眠库 #include hardware/rtc.h // 实时时钟如果可用 #define SCREEN_WIDTH 250 #define SCREEN_HEIGHT 122 uint8_t *framebuffer; // 模拟读取传感器数据实际项目中替换为真实的传感器库如DHT22 float read_temperature() { // 这里模拟一个随机温度值 return 20.0 (float)(rand() % 100) / 10.0; } float read_humidity() { // 模拟一个随机湿度值 return 40.0 (float)(rand() % 300) / 10.0; } void setup() { Serial.begin(115200); epd_init(); framebuffer (uint8_t *)ps_calloc(sizeof(uint8_t), EPD_BUFFER_SIZE); if (framebuffer NULL) while(1); epd_clear(framebuffer, 0xFF); // 绘制静态UI框架只在首次启动时绘制 epd_draw_rect(5, 5, SCREEN_WIDTH-10, SCREEN_HEIGHT-10, 0, framebuffer); epd_draw_string(20, 25, Environment Monitor, framebuffer, 0); epd_draw_string(20, 55, Temp:, framebuffer, 0); epd_draw_string(20, 85, Humi:, framebuffer, 0); // 首次全屏刷新建立静态背景 epd_draw_frame(framebuffer); Serial.println(Setup complete. Entering sleep loop.); } void loop() { // 1. 唤醒读取传感器数据 float temp read_temperature(); float humi read_humidity(); // 2. 在framebuffer中更新动态数据区域先白底覆盖旧数据 epd_fill_rect(80, 50, 100, 20, 1, framebuffer); // 覆盖温度值区域 epd_fill_rect(80, 80, 100, 20, 1, framebuffer); // 覆盖湿度值区域 char buffer[10]; dtostrf(temp, 5, 1, buffer); // 浮点数转字符串 epd_draw_string(80, 55, buffer, framebuffer, 0); epd_draw_string(130, 55, C, framebuffer, 0); dtostrf(humi, 5, 1, buffer); epd_draw_string(80, 85, buffer, framebuffer, 0); epd_draw_string(130, 85, %, framebuffer, 0); // 3. 局部刷新数据区域 epd_partial_refresh(75, 45, 120, 40, framebuffer); // 刷新一个包含两行数据的稍大区域 Serial.printf(Updated: Temp%.1fC, Humi%.1f%%\n, temp, humi); // 4. 进入深度睡眠 (Dormant Mode) // 首先关闭不需要的外设以省电。电子纸本身不耗电无需操作。 // RP2040的深度睡眠会关闭几乎所有时钟和内存仅保留RTC等极少数功能。 Serial.println(Entering deep sleep for 60 seconds...); delay(100); // 给串口一点时间输出最后的信息 // 设置睡眠时间这里使用简单的delay模拟实际应用应使用RTC或定时器唤醒 // 注意真正的深度睡眠需要配置唤醒源如RTC闹钟、外部引脚中断。 // 以下代码仅为逻辑示意实际深度睡眠代码更复杂。 // sleep_goto_dormant_until(rtc_alarm); // 示例休眠直到RTC闹钟 // 为简化演示我们使用延迟但这并不是低功耗睡眠 // 在实际产品中这里的延迟应替换为真正的睡眠函数调用。 // 深度睡眠下电流可降至几十微安级别。 delay(60000); // 模拟睡眠60秒。 **实际请替换为低功耗睡眠代码** // 5. 唤醒后循环回到第1步 // 当被RTC闹钟或中断唤醒后程序会从loop()的开头重新执行。 }低功耗设计的核心要点分离静态与动态将UI分为几乎不变的“静态层”和频繁变化的“动态层”。静态层只在全屏刷新时更新动态层用局部刷新。最大化睡眠时间设备99%的时间应处于最深度的睡眠模式。RP2040支持DORMANT模式功耗极低。唤醒源可以是内部的RTC定时器也可以是外部传感器的中断信号。关闭所有无关外设在睡眠前通过代码将未使用的GPIO设置为输入下拉防漏电关闭ADC、PWM等模块的时钟。电源管理如果板载有可以通过MCU控制的电源开关例如给传感器模块供电的MOSFET在睡眠时切断传感器电源能进一步省电。测量验证使用万用表或功耗分析仪测量实际工作电流。目标是在睡眠时达到**微安(µA)**级在刷新屏幕的瞬间可能达到几十毫安(mA)级。计算平均电流再根据电池容量如1000mAh估算续航续航时间(小时) ≈ 电池容量(mAh) / 平均电流(mA)。如果平均电流能做到100µA0.1mA那么1000mAh的电池理论上可以工作10000小时超过一年7. 项目构思与扩展你的电子纸能做什么掌握了基础显示、图形绘制、图片显示和低功耗技巧后reTerminal E系列电子纸可以成为许多创意项目的核心。这里提供几个思路智能日历/天气站连接Wi-Fi模块如ESP8266/ESP32但需考虑通信协议和电源定时从网络API获取天气和日历信息每天只刷新几次续航可达数月。电子标签/价格牌用于仓库、商店。通过蓝牙或LoRa无线接收更新指令仅在价格变动时刷新。离线笔记板/待办清单搭配几个物理按键实现简单的菜单操作记录和显示待办事项。传感器数据记录仪连接温湿度、光照传感器定时采集并显示历史曲线通过局部刷新更新曲线末端。二维码展示器动态生成并显示不同的二维码用于门票、支付等场景。最后的经验之谈玩转电子纸耐心比技术更重要。它的刷新速度、残影现象需要你去适应和优化。在设计交互时要避免需要快速连续反馈的操作。把电子纸想象成一块“数字纸张”或“数字黑板”它的优势在于“静”而非“动”。在低功耗、常显、护眼的场景下它无可替代。从我自己的几个项目来看最耗时的部分往往不是编程而是UI设计和功耗调试。在有限的像素和黑白或三色世界里设计出直观好看的界面是一种挑战。而为了抠出那最后几个微安的电流你可能需要反复检查代码、测量波形。但当你的作品能不插电运行好几个月安静地显示着信息时那种成就感是非常实在的。希望这篇“菜谱”能帮你省去一些摸索的时间更快地享受电子纸项目带来的乐趣。
)
