1. 项目缘起为什么是电子墨水屏几年前我还在为一个户外数据采集项目头疼。设备需要一块屏幕能实时显示几个关键参数比如温度、湿度和电池电量。当时手头有现成的LCD屏装上后效果却差强人意。在户外强烈的阳光下LCD屏幕几乎成了一面“镜子”想看数据得用手捂着或者找个阴凉地儿用户体验大打折扣。更别提功耗了为了保持画面常亮那块小小的LCD屏竟然成了整个系统的耗电大户让原本计划续航一周的设备两天就得换电池。就是在那时我第一次接触到了电子墨水屏。它那种“类纸”的显示效果在阳光下越亮越清晰的特性以及只在刷新画面时才耗电的“零功耗”特性完美契合了我的需求。自那以后无论是做桌面摆件、便携式信息牌还是低功耗物联网终端电子墨水屏都成了我的首选。今天要聊的这块Grove - 三色电子墨水显示屏 2.13就是Seeed Studio推出的一款非常经典的入门级电子墨水屏模块。它集成了驱动电路通过标准的Grove接口与主控板连接极大地简化了硬件连接和软件驱动的复杂度。对于想体验电子墨水屏魅力或者正在寻找低功耗显示方案的开发者来说它是一个绝佳的起点。2. 核心器件解析Grove接口与三色墨水屏在深入代码之前我们得先搞清楚手里这块屏幕到底是个什么“物件”。知其然更要知其所以然这能帮我们在后续开发中避开很多坑。2.1 Grove接口不仅仅是方便Grove接口是Seeed Studio推广的一套模块化电子原型系统。它的核心价值在于标准化和防呆设计。对于这块2.13英寸墨水屏它采用了一个4针的Grove连接器通常是I2C类型但具体协议需看型号这款常见为SPI。为什么选择Grove对于新手和快速原型开发Grove的优势是压倒性的连接零错误4针接口VCC, GND, SDA, SCL 或 VCC, GND, SCLK, SDI插上就用不用担心接错线烧坏设备。这对于动辄十几二十个引脚的裸屏来说是巨大的体验提升。节省时间省去了焊接排针、杜邦线连接、检查线路的繁琐步骤让你能专注于核心逻辑开发。生态兼容可以轻松与Arduino、Raspberry Pi、Micro:bit等主流平台的Grove扩展板配合使用构建系统非常快捷。但这里有一个关键细节需要特别注意并非所有标着Grove接口的模块都使用I2C协议。这款2.13英寸墨水屏根据其驱动芯片通常是IL3895或类似的特性绝大多数版本使用的是SPI通信协议。虽然接口物理形状一样但内部的信号定义不同。你必须查阅该模块的具体Wiki或数据手册确认其通信协议并将其连接到主控板上对应的SPI Grove端口而不是I2C端口。接错端口会导致通信失败屏幕无任何反应。2.2 电子墨水屏的工作原理与三色实现电子墨水屏或称E-Ink屏其显示原理与我们熟悉的LCD、OLED有本质区别。你可以把它想象成无数个微小的“胶囊”每个胶囊里装着带负电的黑色粒子和带正电的白色粒子悬浮在透明的液体中。刷新过程当在胶囊上下施加一个电场时黑色或白色粒子就会被吸引到顶部从而显示出黑色或白色。一旦粒子位置固定即使撤掉电场图像也会保持不变。这就是它“零功耗”显示的奥秘——只在刷新画面时耗电。三色黑白红/黑白黄的实现我们这块屏是“三色”的通常是黑、白、红也有些版本是黑、白、黄。这并非在单个胶囊里放了三种颜色的粒子。其内部结构更复杂一些可以理解为两层或采用了特殊粒子。以黑白红为例它可能包含能显示黑/白的粒子以及能显示红/白的粒子。通过精细控制不同区域、不同阶段的电场可以决定最终显示黑色、白色还是红色。因此三色屏的刷新波形驱动时序比单色屏要复杂刷新时间通常也更长。一个重要的实操心得电子墨水屏有“全刷”和“局刷”的概念。全刷会清空整个屏幕并重新绘制这个过程较慢可能2-3秒但能彻底避免残影。局刷只更新变化的部分速度很快几百毫秒但连续多次局刷后容易产生难以消除的残影。在编程时需要根据显示内容的变化程度策略性地选择刷新方式。例如更新一个数字可以用局刷而切换一个完全不同的画面则必须用全刷。3. 硬件连接与驱动准备理论清楚了我们开始动手。为了让屏幕亮起来我们需要完成硬件连接和软件环境的搭建。3.1 硬件连接清单与步骤你需要准备以下物品主控板以最流行的Arduino Uno为例。Grove - 三色电子墨水显示屏 2.13模块。Grove扩展板例如Seeed Studio的Base Shield V2它能插在Arduino Uno上提供多个Grove接口。一根Grove连接线通常随屏幕或扩展板附送。连接步骤将Grove扩展板Base Shield牢牢插入Arduino Uno的引脚排母中。找到扩展板上标有“SPI”的Grove接口通常在板子边缘并有明确标注。再次强调务必确认是SPI口不是I2C口。使用Grove连接线一端插入墨水屏模块另一端插入扩展板的SPI Grove口。最后通过USB线将Arduino Uno连接到电脑。这样硬件连接就完成了。整个过程不需要焊接也不需要面对令人眼花缭乱的杜邦线这就是Grove系统的便捷之处。3.2 软件库安装与选择Arduino开发离不开库的支持。对于这款屏幕我们有优秀的开源库可用。打开Arduino IDE点击“工具” - “管理库...”。在库管理器的搜索框中输入“GxEPD2”。这个库是由Jean-Marc Zingg维护的是目前支持Grove这款墨水屏以及众多其他型号最强大、最活跃的库之一。它封装了复杂的底层驱动波形提供了非常友好的API。找到“GxEPD2 by Jean-Marc Zingg”选择最新版本进行安装。为什么是GxEPD2在早期你可能看到过e-Paper或GxEPD等库。GxEPD2是它们的继承者和集大成者。它支持更多的屏幕型号优化了内存占用提供了更清晰的示例代码。使用这个库能确保我们获得最好的兼容性和性能。安装完成后你可以在“文件” - “示例” - “GxEPD2”下找到一大堆示例程序。对于Grove 2.13英寸三色屏我们通常需要找到对应型号的示例。型号名可能类似GxEPD2_213_开头后面跟着颜色标识如B73(黑/白/红) 或B74(黑/白/黄)。你需要根据屏幕实际颜色确认。4. 基础显示功能实战环境就绪我们来写第一个程序让屏幕显示一些基本内容。我们将从最简单的“Hello World”文本开始逐步扩展到图形和局部刷新。4.1 首次驱动显示文本与基础图形我们先创建一个新的Arduino草图并输入以下代码框架。请注意具体的类名需要根据你的屏幕型号微调。// 引入必要的库 #include GxEPD2_BW.h // 对于黑白屏但三色屏也常用这个基础类红色作为“高亮” #include GxEPD2_3C.h // 明确的三色屏类根据库的版本和屏幕选择 #include Fonts/FreeMonoBold9pt7b.h // 内置字体 // *** 关键步骤定义你的屏幕驱动对象 *** // 你需要根据屏幕具体型号从GxEPD2库的示例中找到正确的构造函数。 // 例如对于Grove 2.13英寸黑白红三色屏可能是 // GxEPD2_3CGxEPD2_213_Z98, GxEPD2_213_Z98::HEIGHT display; // 最准确的方法是打开库中 examples GxEPD2 GxEPD2_Example.ino // 查看开头的型号定义列表找到与你屏幕匹配的那一行。 // 这里以常见的“GxEPD2_213_Z98”为例请务必替换为你的实际型号 #define EPD_CS 10 // Chip Select引脚通常由扩展板固定 #define EPD_DC 9 // Data/Command控制引脚通常由扩展板固定 #define EPD_RESET 8 // 复位引脚通常由扩展板固定 #define EPD_BUSY 7 // 忙状态引脚通常由扩展板固定 // 声明显示对象 GxEPD2_3CGxEPD2_213_Z98, GxEPD2_213_Z98::HEIGHT display(EPD_CS, EPD_DC, EPD_RESET, EPD_BUSY); void setup() { Serial.begin(115200); delay(100); Serial.println(Setup Start); display.init(115200); // 初始化显示屏可以传入串口波特率用于调试 display.setRotation(1); // 设置旋转方向0-31通常为横向屏幕宽边水平 // 第一次使用先进行一次全刷清洗屏幕去除残影 display.clearScreen(); // 库可能提供此方法或者用 fillScreen(GxEPD_WHITE) display.setFullWindow(); // 设置为全窗口刷新模式 display.fillScreen(GxEPD_WHITE); // 填充白色背景 display.display(false); // false表示全刷。这是一个耗时操作约2-3秒 delay(1000); // 等待刷新完成 // 准备绘制新内容 display.setFullWindow(); display.fillScreen(GxEPD_WHITE); // 再次填充白色背景 // 设置字体颜色黑色 display.setTextColor(GxEPD_BLACK); // 设置字体使用内置点阵字体 display.setFont(FreeMonoBold9pt7b); // 设置光标位置原点在屏幕左上角 display.setCursor(20, 30); // 打印文本 display.print(Hello E-Ink!); // 再画一个矩形框红色 display.drawRect(10, 50, 100, 40, GxEPD_RED); // (x, y, width, height, color) // 填充一个圆形黑色 display.fillCircle(180, 70, 20, GxEPD_BLACK); // (x, y, radius, color) // 将所有绘制的内容更新到屏幕上全刷 Serial.println(About to update display (full update)...); display.display(false); // false 代表全刷 Serial.println(Display updated!); } void loop() { // loop留空我们只显示一次 delay(10000); }代码关键点解析与避坑指南型号定义重中之重代码中的GxEPD2_213_Z98只是一个示例。你必须根据自己屏幕的准确型号进行修改。错误型号会导致初始化失败、颜色错乱或根本点不亮。查看库示例文件是找到正确型号的最佳途径。引脚定义EPD_CS,EPD_DC等引脚号是由你所使用的Grove扩展板如Base Shield硬件连接决定的通常固定为这几个数字。除非你自定义接线否则不要改动。刷新模式display.display(false)参数false表示全刷Full Update速度慢但彻底。参数true表示局刷Partial Update速度快但需谨慎使用避免残影积累。首次显示或内容大幅变化时务必使用全刷。颜色常量GxEPD_WHITE,GxEPD_BLACK,GxEPD_RED对于三色屏。对于黑白屏红色常量可能无效或显示为黑色。初始化延时display.init()后和刷新前后适当的delay()是必要的确保电源稳定和屏幕完成内部操作。上传这段代码到Arduino你应该能看到屏幕先变白全刷清屏然后显示出“Hello E-Ink!”文字、一个红色矩形框和一个黑色实心圆。恭喜你的电子墨水屏已经成功驱动4.2 局部刷新与低功耗优化全刷虽好但耗时耗电。在显示实时变化的数据如时钟、传感器读数时我们更希望只更新变化的部分。这就是局部刷新的用武之地。假设我们要实现一个每秒更新的计数器。全局刷新每秒一次是不可接受的闪屏严重且慢。我们可以这样做// ...前面的库引入、对象定义与setup初始化部分相同... int counter 0; char counterStr[10]; // 用于存储计数器字符串 void setup() { // ... 初始化屏幕并进行一次全刷清屏 ... display.init(115200); display.setRotation(1); display.setFullWindow(); display.fillScreen(GxEPD_WHITE); display.display(false); // 初始全刷 // 绘制静态的背景和标题只做一次 display.setFullWindow(); display.fillScreen(GxEPD_WHITE); display.setTextColor(GxEPD_BLACK); display.setFont(FreeMonoBold9pt7b); display.setCursor(20, 30); display.print(Counter:); // 注意这里只绘制了静态部分并没有调用 display.display() } void loop() { // 1. 设置局部刷新区域。我们需要更新数字所在的大致区域。 // 假设数字从 (100, 25) 开始区域宽80高30像素。 display.setPartialWindow(100, 25, 80, 30); // 2. 在局部窗口内首先用白色填充以清除旧数字非常重要 display.fillRect(100, 25, 80, 30, GxEPD_WHITE); // 3. 绘制新的数字 display.setTextColor(GxEPD_BLACK); display.setFont(FreeMonoBold9pt7b); display.setCursor(100, 30); // 光标位置相对于全局坐标 sprintf(counterStr, %04d, counter); // 格式化为4位数字如 0025 display.print(counterStr); // 4. 执行局部刷新 display.display(true); // 参数 true 代表局部刷新 counter; if (counter 9999) counter 0; delay(1000); // 每秒更新一次 }局部刷新的核心注意事项setPartialWindow(x, y, w, h)这个函数至关重要。它告诉驱动器接下来所有的绘制操作直到下一次display()调用都只在这个矩形区域内有效并且刷新时也只更新这个区域。这能显著减少数据传输量和刷新时间。先清后画在局部窗口内更新内容尤其是文本时必须先用背景色通常是白色填充该区域以擦除上一次的内容。否则新旧内容会叠加产生“鬼影”。残影管理即使使用局部刷新经过数十上百次更新后屏幕仍可能出现轻微残影。一个好的策略是在固定次数比如每50次的局部刷新后强制进行一次全刷 (display.display(false)) 来彻底清屏。功耗考量局部刷新本身功耗很低。整个系统的功耗大头在于主控如Arduino和刷新瞬间的驱动电流。为了极致省电可以在刷新完成后让Arduino进入深度睡眠Deep Sleep直到下一次需要更新的时间点才唤醒。这需要配合外部RTC或定时中断来实现是构建超低功耗信息牌的关键。5. 高级应用与图像显示掌握了文本和图形的基础绘制后我们可以玩些更酷的——显示自定义图像和创建复杂的用户界面。5.1 显示位图图像电子墨水屏显示图像的效果很有质感尤其适合显示Logo、图标或简笔画。由于屏幕本身是黑白的或三色我们需要将彩色图片处理成1位黑白或2位三色的位图。步骤一图像预处理你不能直接把一张JPG或PNG图片扔给屏幕。需要借助工具将其转换为屏幕可识别的位图数组。常用方法如下使用在线转换工具搜索“image to Arduino bitmap converter”或“LCD image converter”有很多在线工具。你需要设置输出格式为“XBM”或“C Array (Bitmap)”颜色深度选择1位单色或2位三色但需要库支持特定格式。更稳妥的方法是使用库作者推荐的工具或方法。使用Processing脚本GxEPD2库的extras文件夹里通常提供了Processing脚本如GxEPD2_Spiffs_Converter可以将图片转换为适合该库的格式并直接存入SPIFFS如果主控支持或生成代码数组。关键参数转换时分辨率必须设置为目标屏幕的分辨率例如 212x104 像素具体请查屏幕规格。缩放时最好使用“最近邻”等不会产生抗锯齿的算法以保证黑白边缘锐利。步骤二在代码中集成与显示假设我们已经将一张logo.png转换成了一个C语言数组保存在logo_bitmap.h文件中。// 在草图开头引入图像数据头文件 #include logo_bitmap.h // 这个文件里定义了 logo_width, logo_height, logo_data[] void displayImage() { display.setFullWindow(); display.fillScreen(GxEPD_WHITE); // 使用 drawBitmap() 函数显示图像 // 参数x坐标, y坐标, 位图数据指针, 位图宽度, 位图高度, 前景色, 背景色 display.drawBitmap(0, 0, logo_data, logo_width, logo_height, GxEPD_BLACK, GxEPD_WHITE); display.display(false); // 显示图像通常用全刷效果更好 }图像显示避坑点内存限制Arduino Uno的SRAM非常有限2KB。一张212x104的1位位图需要约 (212*104)/8 2756 字节这已经超过了可用内存会导致程序崩溃。解决方法有使用PROGMEM将大的位图数组存储在Flash程序存储器中使用drawBitmap()的重载函数来读取。GxEPD2库支持从PROGMEM直接绘图。使用更大的主控如ESP32、ESP8266它们有更大的内存且支持SPIFFS文件系统可以直接从存储中读取图片文件无需全部加载到内存。降低图像分辨率或使用更小的图标。刷新模式显示复杂图像时使用全刷能获得最佳效果。局刷可能导致图像边缘出现残影或更新不完整。5.2 构建信息界面与UI框架我们可以结合上述所有知识创建一个简单的信息显示界面例如一个环境监测显示器。设计思路静态背景在setup()中使用全刷绘制界面框架包括标题、图标、标签如“温度”、“湿度”等固定元素。这部分一旦绘制除非界面大改否则不再更新。动态数据区为每个变化的数据温度值、湿度值、时间规划一个固定的矩形区域。定时更新在loop()中每隔一段时间如5秒读取一次传感器数据。对于每个变化的数据使用setPartialWindow()限定其区域先清空旧值再绘制新值最后调用display(true)进行局部刷新。定期全刷设置一个计数器每完成一定次数如20次的局部刷新后执行一次全刷清屏然后重新绘制静态背景或利用库的“快照”功能恢复再继续局部刷新循环以消除累积残影。这种“静态背景 动态数据局部刷新”的模式是电子墨水屏应用中最经典、最实用的UI架构。它平衡了刷新速度、显示效果和功耗。6. 项目实战打造一个桌面电子时钟/天气站让我们综合运用所学完成一个更有趣的项目一个基于Grove 2.13英寸墨水屏的桌面电子时钟并可以扩展显示天气信息。6.1 硬件扩展与组件清单除了已有的Arduino Uno、Grove扩展板和墨水屏我们还需要RTC实时时钟模块如DS3231Grove接口版本用于提供精确的时间。这是时钟的核心。温湿度传感器如DHT11或DHT22Grove接口版本用于获取环境数据可选。ESP8266或ESP32模块如果你希望从网络获取天气信息则需要一个Wi-Fi模块。你可以直接用ESP32开发板替代Arduino Uno它集成了Wi-Fi和蓝牙性能更强内存更大。连接方式将所有Grove模块墨水屏、RTC、传感器通过连接线分别连接到Grove扩展板上的对应接口SPI口给屏幕I2C口给RTC数字口给DHT传感器。如果使用ESP32可能需要一个兼容ESP32的Grove扩展板或者使用分线板。6.2 软件设计与代码架构我们将程序分为几个功能模块时间管理模块负责从RTC读取当前日期和时间并处理时间格式如“12:30”、“Wed”。显示驱动模块封装屏幕操作提供如drawStaticBackground(),updateTimeArea(hour, minute),updateDateArea(weekday, date)等函数。网络服务模块可选如果使用ESP32则负责连接Wi-Fi并通过HTTP请求从天气API如OpenWeatherMap获取数据解析后交给显示模块。主循环逻辑协调以上模块决定何时更新屏幕的哪个部分。核心代码逻辑片段伪代码风格// 定义显示区域 #define TIME_AREA_X 10 #define TIME_AREA_Y 20 #define TIME_AREA_W 100 #define TIME_AREA_H 40 #define DATE_AREA_X 10 #define DATE_AREA_Y 65 #define DATE_AREA_W 100 #define DATE_AREA_H 20 // 全局变量 String lastTimeStr ; String lastDateStr ; int partialUpdateCount 0; void setup() { initRTC(); initDisplay(); // 初始化网络如果有时钟 connectToWiFi(); // 首次全刷绘制静态界面时钟框、装饰线等 drawStaticClockFace(); display.display(false); } void loop() { // 1. 获取当前时间 DateTime now rtc.now(); String currentTimeStr formatTime(now.hour(), now.minute()); String currentDateStr formatDate(now.dayOfTheWeek(), now.day(), now.month()); // 2. 检查时间是否需要更新例如每分钟更新一次 if (currentTimeStr ! lastTimeStr) { updateTimeDisplay(currentTimeStr); lastTimeStr currentTimeStr; partialUpdateCount; } // 3. 检查日期是否需要更新例如每天更新一次 if (currentDateStr ! lastDateStr) { updateDateDisplay(currentDateStr); lastDateStr currentDateStr; partialUpdateCount; } // 4. 每隔一段时间如每小时或每N次局部刷新后获取并更新天气网络功能 if (isTimeToUpdateWeather()) { WeatherData weather fetchWeatherData(); updateWeatherDisplay(weather.temp, weather.humidity, weather.iconCode); partialUpdateCount; } // 5. 残影管理每进行50次局部刷新后执行一次全刷清屏 if (partialUpdateCount 50) { display.display(false); // 全刷清屏 drawStaticClockFace(); // 重绘静态背景 partialUpdateCount 0; } delay(10000); // 每10秒检查一次更新时间判断逻辑内部会控制实际刷新频率 } void updateTimeDisplay(String timeStr) { display.setPartialWindow(TIME_AREA_X, TIME_AREA_Y, TIME_AREA_W, TIME_AREA_H); display.fillRect(TIME_AREA_X, TIME_AREA_Y, TIME_AREA_W, TIME_AREA_H, GxEPD_WHITE); display.setTextColor(GxEPD_BLACK); display.setFont(FreeSansBold18pt7b); // 使用大字体显示时间 display.setCursor(TIME_AREA_X, TIME_AREA_Y 30); display.print(timeStr); display.display(true); }6.3 优化与美化字体选择使用更多样、更美观的字体。GxEPD2库支持Adafruit GFX字体你可以从网上下载或自己生成喜欢的点阵字体文件.h格式加入到项目中。图标显示为天气状况晴、雨、云设计小的位图图标让界面更生动。低功耗终极优化如果使用电池供电可以让ESP32在大部分时间进入深度睡眠模式仅由RTC的闹钟功能定时唤醒比如每分钟唤醒一次。唤醒后读取时间判断是否需要更新屏幕更新完成后立刻再次进入深度睡眠。这样可以将整体平均电流降至几十微安级别使设备续航达到数月甚至数年。7. 常见问题排查与进阶思考即使按照步骤操作你也可能会遇到一些问题。这里列出一些常见情况及解决方法。问题一屏幕初始化失败全白或全黑无任何变化。检查电源确保Arduino和扩展板供电充足。墨水屏在刷新瞬间需要较大电流可达100mA以上USB口供电不足可能导致刷新异常。尝试使用外部电源如9V电池适配器为Arduino供电。检查型号定义这是最常见的问题。再次确认代码中的屏幕驱动类型号与你的物理屏幕完全一致。一个字符都不能错。检查Grove连接口确认屏幕连接在了扩展板的SPI接口上而不是I2C接口。检查库版本确保安装的GxEPD2库是最新版本。旧版本可能不支持你的屏幕型号。问题二显示内容有严重残影无法清除。强制全刷编写一个简单的程序循环执行display.fillScreen(GxEPD_WHITE); display.display(false);和display.fillScreen(GxEPD_BLACK); display.display(false);多次10-20次这相当于对屏幕进行“深度清洁”可以去除顽固残影。检查刷新模式确保在切换完全不同画面时使用了display.display(false)全刷。局部刷新 (display.display(true)) 只适用于内容小幅变化。遵循“先清后画”在局部刷新区域绘制新内容前务必用背景色填充整个区域。问题三显示图像时Arduino程序崩溃或无响应。内存溢出这是最可能的原因。检查位图数组是否太大。使用F()宏将字符串常量放入Flash节省RAM。对于大图像必须使用PROGMEM存储并使用支持从PROGMEM绘图的函数。考虑升级主控对于复杂的图形应用强烈建议使用ESP32或Raspberry Pi Pico它们拥有更大的内存和更强的处理能力。问题四局部刷新速度依然不够快有闪烁感。优化刷新区域使用setPartialWindow()精确限定更新区域区域越小刷新越快。组合更新如果多个小区域需要更新且它们位置接近可以考虑将它们合并到一个稍大的局部窗口内一次刷新而不是分别刷新多次。接受特性电子墨水屏的刷新率天生较低通常1-2秒全刷几百毫秒局刷不适合需要快速连续动画的场景。它的优势在于静态显示和低功耗而非刷新速度。通过这个从原理到实战的完整过程相信你已经掌握了Grove三色电子墨水屏的核心玩法。它不仅仅是一个显示模块更是通往低功耗、高可读性嵌入式显示应用的大门。无论是做一个永不充电的行李牌一个优雅的桌面时钟还是一个安静的仓库环境监视器这块小屏幕都能以其独特的魅力为你的项目增添一份实用与美感。
Grove三色电子墨水屏入门指南：从原理到Arduino实战应用
发布时间：2026/8/2 18:48:08
1. 项目缘起为什么是电子墨水屏几年前我还在为一个户外数据采集项目头疼。设备需要一块屏幕能实时显示几个关键参数比如温度、湿度和电池电量。当时手头有现成的LCD屏装上后效果却差强人意。在户外强烈的阳光下LCD屏幕几乎成了一面“镜子”想看数据得用手捂着或者找个阴凉地儿用户体验大打折扣。更别提功耗了为了保持画面常亮那块小小的LCD屏竟然成了整个系统的耗电大户让原本计划续航一周的设备两天就得换电池。就是在那时我第一次接触到了电子墨水屏。它那种“类纸”的显示效果在阳光下越亮越清晰的特性以及只在刷新画面时才耗电的“零功耗”特性完美契合了我的需求。自那以后无论是做桌面摆件、便携式信息牌还是低功耗物联网终端电子墨水屏都成了我的首选。今天要聊的这块Grove - 三色电子墨水显示屏 2.13就是Seeed Studio推出的一款非常经典的入门级电子墨水屏模块。它集成了驱动电路通过标准的Grove接口与主控板连接极大地简化了硬件连接和软件驱动的复杂度。对于想体验电子墨水屏魅力或者正在寻找低功耗显示方案的开发者来说它是一个绝佳的起点。2. 核心器件解析Grove接口与三色墨水屏在深入代码之前我们得先搞清楚手里这块屏幕到底是个什么“物件”。知其然更要知其所以然这能帮我们在后续开发中避开很多坑。2.1 Grove接口不仅仅是方便Grove接口是Seeed Studio推广的一套模块化电子原型系统。它的核心价值在于标准化和防呆设计。对于这块2.13英寸墨水屏它采用了一个4针的Grove连接器通常是I2C类型但具体协议需看型号这款常见为SPI。为什么选择Grove对于新手和快速原型开发Grove的优势是压倒性的连接零错误4针接口VCC, GND, SDA, SCL 或 VCC, GND, SCLK, SDI插上就用不用担心接错线烧坏设备。这对于动辄十几二十个引脚的裸屏来说是巨大的体验提升。节省时间省去了焊接排针、杜邦线连接、检查线路的繁琐步骤让你能专注于核心逻辑开发。生态兼容可以轻松与Arduino、Raspberry Pi、Micro:bit等主流平台的Grove扩展板配合使用构建系统非常快捷。但这里有一个关键细节需要特别注意并非所有标着Grove接口的模块都使用I2C协议。这款2.13英寸墨水屏根据其驱动芯片通常是IL3895或类似的特性绝大多数版本使用的是SPI通信协议。虽然接口物理形状一样但内部的信号定义不同。你必须查阅该模块的具体Wiki或数据手册确认其通信协议并将其连接到主控板上对应的SPI Grove端口而不是I2C端口。接错端口会导致通信失败屏幕无任何反应。2.2 电子墨水屏的工作原理与三色实现电子墨水屏或称E-Ink屏其显示原理与我们熟悉的LCD、OLED有本质区别。你可以把它想象成无数个微小的“胶囊”每个胶囊里装着带负电的黑色粒子和带正电的白色粒子悬浮在透明的液体中。刷新过程当在胶囊上下施加一个电场时黑色或白色粒子就会被吸引到顶部从而显示出黑色或白色。一旦粒子位置固定即使撤掉电场图像也会保持不变。这就是它“零功耗”显示的奥秘——只在刷新画面时耗电。三色黑白红/黑白黄的实现我们这块屏是“三色”的通常是黑、白、红也有些版本是黑、白、黄。这并非在单个胶囊里放了三种颜色的粒子。其内部结构更复杂一些可以理解为两层或采用了特殊粒子。以黑白红为例它可能包含能显示黑/白的粒子以及能显示红/白的粒子。通过精细控制不同区域、不同阶段的电场可以决定最终显示黑色、白色还是红色。因此三色屏的刷新波形驱动时序比单色屏要复杂刷新时间通常也更长。一个重要的实操心得电子墨水屏有“全刷”和“局刷”的概念。全刷会清空整个屏幕并重新绘制这个过程较慢可能2-3秒但能彻底避免残影。局刷只更新变化的部分速度很快几百毫秒但连续多次局刷后容易产生难以消除的残影。在编程时需要根据显示内容的变化程度策略性地选择刷新方式。例如更新一个数字可以用局刷而切换一个完全不同的画面则必须用全刷。3. 硬件连接与驱动准备理论清楚了我们开始动手。为了让屏幕亮起来我们需要完成硬件连接和软件环境的搭建。3.1 硬件连接清单与步骤你需要准备以下物品主控板以最流行的Arduino Uno为例。Grove - 三色电子墨水显示屏 2.13模块。Grove扩展板例如Seeed Studio的Base Shield V2它能插在Arduino Uno上提供多个Grove接口。一根Grove连接线通常随屏幕或扩展板附送。连接步骤将Grove扩展板Base Shield牢牢插入Arduino Uno的引脚排母中。找到扩展板上标有“SPI”的Grove接口通常在板子边缘并有明确标注。再次强调务必确认是SPI口不是I2C口。使用Grove连接线一端插入墨水屏模块另一端插入扩展板的SPI Grove口。最后通过USB线将Arduino Uno连接到电脑。这样硬件连接就完成了。整个过程不需要焊接也不需要面对令人眼花缭乱的杜邦线这就是Grove系统的便捷之处。3.2 软件库安装与选择Arduino开发离不开库的支持。对于这款屏幕我们有优秀的开源库可用。打开Arduino IDE点击“工具” - “管理库...”。在库管理器的搜索框中输入“GxEPD2”。这个库是由Jean-Marc Zingg维护的是目前支持Grove这款墨水屏以及众多其他型号最强大、最活跃的库之一。它封装了复杂的底层驱动波形提供了非常友好的API。找到“GxEPD2 by Jean-Marc Zingg”选择最新版本进行安装。为什么是GxEPD2在早期你可能看到过e-Paper或GxEPD等库。GxEPD2是它们的继承者和集大成者。它支持更多的屏幕型号优化了内存占用提供了更清晰的示例代码。使用这个库能确保我们获得最好的兼容性和性能。安装完成后你可以在“文件” - “示例” - “GxEPD2”下找到一大堆示例程序。对于Grove 2.13英寸三色屏我们通常需要找到对应型号的示例。型号名可能类似GxEPD2_213_开头后面跟着颜色标识如B73(黑/白/红) 或B74(黑/白/黄)。你需要根据屏幕实际颜色确认。4. 基础显示功能实战环境就绪我们来写第一个程序让屏幕显示一些基本内容。我们将从最简单的“Hello World”文本开始逐步扩展到图形和局部刷新。4.1 首次驱动显示文本与基础图形我们先创建一个新的Arduino草图并输入以下代码框架。请注意具体的类名需要根据你的屏幕型号微调。// 引入必要的库 #include GxEPD2_BW.h // 对于黑白屏但三色屏也常用这个基础类红色作为“高亮” #include GxEPD2_3C.h // 明确的三色屏类根据库的版本和屏幕选择 #include Fonts/FreeMonoBold9pt7b.h // 内置字体 // *** 关键步骤定义你的屏幕驱动对象 *** // 你需要根据屏幕具体型号从GxEPD2库的示例中找到正确的构造函数。 // 例如对于Grove 2.13英寸黑白红三色屏可能是 // GxEPD2_3CGxEPD2_213_Z98, GxEPD2_213_Z98::HEIGHT display; // 最准确的方法是打开库中 examples GxEPD2 GxEPD2_Example.ino // 查看开头的型号定义列表找到与你屏幕匹配的那一行。 // 这里以常见的“GxEPD2_213_Z98”为例请务必替换为你的实际型号 #define EPD_CS 10 // Chip Select引脚通常由扩展板固定 #define EPD_DC 9 // Data/Command控制引脚通常由扩展板固定 #define EPD_RESET 8 // 复位引脚通常由扩展板固定 #define EPD_BUSY 7 // 忙状态引脚通常由扩展板固定 // 声明显示对象 GxEPD2_3CGxEPD2_213_Z98, GxEPD2_213_Z98::HEIGHT display(EPD_CS, EPD_DC, EPD_RESET, EPD_BUSY); void setup() { Serial.begin(115200); delay(100); Serial.println(Setup Start); display.init(115200); // 初始化显示屏可以传入串口波特率用于调试 display.setRotation(1); // 设置旋转方向0-31通常为横向屏幕宽边水平 // 第一次使用先进行一次全刷清洗屏幕去除残影 display.clearScreen(); // 库可能提供此方法或者用 fillScreen(GxEPD_WHITE) display.setFullWindow(); // 设置为全窗口刷新模式 display.fillScreen(GxEPD_WHITE); // 填充白色背景 display.display(false); // false表示全刷。这是一个耗时操作约2-3秒 delay(1000); // 等待刷新完成 // 准备绘制新内容 display.setFullWindow(); display.fillScreen(GxEPD_WHITE); // 再次填充白色背景 // 设置字体颜色黑色 display.setTextColor(GxEPD_BLACK); // 设置字体使用内置点阵字体 display.setFont(FreeMonoBold9pt7b); // 设置光标位置原点在屏幕左上角 display.setCursor(20, 30); // 打印文本 display.print(Hello E-Ink!); // 再画一个矩形框红色 display.drawRect(10, 50, 100, 40, GxEPD_RED); // (x, y, width, height, color) // 填充一个圆形黑色 display.fillCircle(180, 70, 20, GxEPD_BLACK); // (x, y, radius, color) // 将所有绘制的内容更新到屏幕上全刷 Serial.println(About to update display (full update)...); display.display(false); // false 代表全刷 Serial.println(Display updated!); } void loop() { // loop留空我们只显示一次 delay(10000); }代码关键点解析与避坑指南型号定义重中之重代码中的GxEPD2_213_Z98只是一个示例。你必须根据自己屏幕的准确型号进行修改。错误型号会导致初始化失败、颜色错乱或根本点不亮。查看库示例文件是找到正确型号的最佳途径。引脚定义EPD_CS,EPD_DC等引脚号是由你所使用的Grove扩展板如Base Shield硬件连接决定的通常固定为这几个数字。除非你自定义接线否则不要改动。刷新模式display.display(false)参数false表示全刷Full Update速度慢但彻底。参数true表示局刷Partial Update速度快但需谨慎使用避免残影积累。首次显示或内容大幅变化时务必使用全刷。颜色常量GxEPD_WHITE,GxEPD_BLACK,GxEPD_RED对于三色屏。对于黑白屏红色常量可能无效或显示为黑色。初始化延时display.init()后和刷新前后适当的delay()是必要的确保电源稳定和屏幕完成内部操作。上传这段代码到Arduino你应该能看到屏幕先变白全刷清屏然后显示出“Hello E-Ink!”文字、一个红色矩形框和一个黑色实心圆。恭喜你的电子墨水屏已经成功驱动4.2 局部刷新与低功耗优化全刷虽好但耗时耗电。在显示实时变化的数据如时钟、传感器读数时我们更希望只更新变化的部分。这就是局部刷新的用武之地。假设我们要实现一个每秒更新的计数器。全局刷新每秒一次是不可接受的闪屏严重且慢。我们可以这样做// ...前面的库引入、对象定义与setup初始化部分相同... int counter 0; char counterStr[10]; // 用于存储计数器字符串 void setup() { // ... 初始化屏幕并进行一次全刷清屏 ... display.init(115200); display.setRotation(1); display.setFullWindow(); display.fillScreen(GxEPD_WHITE); display.display(false); // 初始全刷 // 绘制静态的背景和标题只做一次 display.setFullWindow(); display.fillScreen(GxEPD_WHITE); display.setTextColor(GxEPD_BLACK); display.setFont(FreeMonoBold9pt7b); display.setCursor(20, 30); display.print(Counter:); // 注意这里只绘制了静态部分并没有调用 display.display() } void loop() { // 1. 设置局部刷新区域。我们需要更新数字所在的大致区域。 // 假设数字从 (100, 25) 开始区域宽80高30像素。 display.setPartialWindow(100, 25, 80, 30); // 2. 在局部窗口内首先用白色填充以清除旧数字非常重要 display.fillRect(100, 25, 80, 30, GxEPD_WHITE); // 3. 绘制新的数字 display.setTextColor(GxEPD_BLACK); display.setFont(FreeMonoBold9pt7b); display.setCursor(100, 30); // 光标位置相对于全局坐标 sprintf(counterStr, %04d, counter); // 格式化为4位数字如 0025 display.print(counterStr); // 4. 执行局部刷新 display.display(true); // 参数 true 代表局部刷新 counter; if (counter 9999) counter 0; delay(1000); // 每秒更新一次 }局部刷新的核心注意事项setPartialWindow(x, y, w, h)这个函数至关重要。它告诉驱动器接下来所有的绘制操作直到下一次display()调用都只在这个矩形区域内有效并且刷新时也只更新这个区域。这能显著减少数据传输量和刷新时间。先清后画在局部窗口内更新内容尤其是文本时必须先用背景色通常是白色填充该区域以擦除上一次的内容。否则新旧内容会叠加产生“鬼影”。残影管理即使使用局部刷新经过数十上百次更新后屏幕仍可能出现轻微残影。一个好的策略是在固定次数比如每50次的局部刷新后强制进行一次全刷 (display.display(false)) 来彻底清屏。功耗考量局部刷新本身功耗很低。整个系统的功耗大头在于主控如Arduino和刷新瞬间的驱动电流。为了极致省电可以在刷新完成后让Arduino进入深度睡眠Deep Sleep直到下一次需要更新的时间点才唤醒。这需要配合外部RTC或定时中断来实现是构建超低功耗信息牌的关键。5. 高级应用与图像显示掌握了文本和图形的基础绘制后我们可以玩些更酷的——显示自定义图像和创建复杂的用户界面。5.1 显示位图图像电子墨水屏显示图像的效果很有质感尤其适合显示Logo、图标或简笔画。由于屏幕本身是黑白的或三色我们需要将彩色图片处理成1位黑白或2位三色的位图。步骤一图像预处理你不能直接把一张JPG或PNG图片扔给屏幕。需要借助工具将其转换为屏幕可识别的位图数组。常用方法如下使用在线转换工具搜索“image to Arduino bitmap converter”或“LCD image converter”有很多在线工具。你需要设置输出格式为“XBM”或“C Array (Bitmap)”颜色深度选择1位单色或2位三色但需要库支持特定格式。更稳妥的方法是使用库作者推荐的工具或方法。使用Processing脚本GxEPD2库的extras文件夹里通常提供了Processing脚本如GxEPD2_Spiffs_Converter可以将图片转换为适合该库的格式并直接存入SPIFFS如果主控支持或生成代码数组。关键参数转换时分辨率必须设置为目标屏幕的分辨率例如 212x104 像素具体请查屏幕规格。缩放时最好使用“最近邻”等不会产生抗锯齿的算法以保证黑白边缘锐利。步骤二在代码中集成与显示假设我们已经将一张logo.png转换成了一个C语言数组保存在logo_bitmap.h文件中。// 在草图开头引入图像数据头文件 #include logo_bitmap.h // 这个文件里定义了 logo_width, logo_height, logo_data[] void displayImage() { display.setFullWindow(); display.fillScreen(GxEPD_WHITE); // 使用 drawBitmap() 函数显示图像 // 参数x坐标, y坐标, 位图数据指针, 位图宽度, 位图高度, 前景色, 背景色 display.drawBitmap(0, 0, logo_data, logo_width, logo_height, GxEPD_BLACK, GxEPD_WHITE); display.display(false); // 显示图像通常用全刷效果更好 }图像显示避坑点内存限制Arduino Uno的SRAM非常有限2KB。一张212x104的1位位图需要约 (212*104)/8 2756 字节这已经超过了可用内存会导致程序崩溃。解决方法有使用PROGMEM将大的位图数组存储在Flash程序存储器中使用drawBitmap()的重载函数来读取。GxEPD2库支持从PROGMEM直接绘图。使用更大的主控如ESP32、ESP8266它们有更大的内存且支持SPIFFS文件系统可以直接从存储中读取图片文件无需全部加载到内存。降低图像分辨率或使用更小的图标。刷新模式显示复杂图像时使用全刷能获得最佳效果。局刷可能导致图像边缘出现残影或更新不完整。5.2 构建信息界面与UI框架我们可以结合上述所有知识创建一个简单的信息显示界面例如一个环境监测显示器。设计思路静态背景在setup()中使用全刷绘制界面框架包括标题、图标、标签如“温度”、“湿度”等固定元素。这部分一旦绘制除非界面大改否则不再更新。动态数据区为每个变化的数据温度值、湿度值、时间规划一个固定的矩形区域。定时更新在loop()中每隔一段时间如5秒读取一次传感器数据。对于每个变化的数据使用setPartialWindow()限定其区域先清空旧值再绘制新值最后调用display(true)进行局部刷新。定期全刷设置一个计数器每完成一定次数如20次的局部刷新后执行一次全刷清屏然后重新绘制静态背景或利用库的“快照”功能恢复再继续局部刷新循环以消除累积残影。这种“静态背景 动态数据局部刷新”的模式是电子墨水屏应用中最经典、最实用的UI架构。它平衡了刷新速度、显示效果和功耗。6. 项目实战打造一个桌面电子时钟/天气站让我们综合运用所学完成一个更有趣的项目一个基于Grove 2.13英寸墨水屏的桌面电子时钟并可以扩展显示天气信息。6.1 硬件扩展与组件清单除了已有的Arduino Uno、Grove扩展板和墨水屏我们还需要RTC实时时钟模块如DS3231Grove接口版本用于提供精确的时间。这是时钟的核心。温湿度传感器如DHT11或DHT22Grove接口版本用于获取环境数据可选。ESP8266或ESP32模块如果你希望从网络获取天气信息则需要一个Wi-Fi模块。你可以直接用ESP32开发板替代Arduino Uno它集成了Wi-Fi和蓝牙性能更强内存更大。连接方式将所有Grove模块墨水屏、RTC、传感器通过连接线分别连接到Grove扩展板上的对应接口SPI口给屏幕I2C口给RTC数字口给DHT传感器。如果使用ESP32可能需要一个兼容ESP32的Grove扩展板或者使用分线板。6.2 软件设计与代码架构我们将程序分为几个功能模块时间管理模块负责从RTC读取当前日期和时间并处理时间格式如“12:30”、“Wed”。显示驱动模块封装屏幕操作提供如drawStaticBackground(),updateTimeArea(hour, minute),updateDateArea(weekday, date)等函数。网络服务模块可选如果使用ESP32则负责连接Wi-Fi并通过HTTP请求从天气API如OpenWeatherMap获取数据解析后交给显示模块。主循环逻辑协调以上模块决定何时更新屏幕的哪个部分。核心代码逻辑片段伪代码风格// 定义显示区域 #define TIME_AREA_X 10 #define TIME_AREA_Y 20 #define TIME_AREA_W 100 #define TIME_AREA_H 40 #define DATE_AREA_X 10 #define DATE_AREA_Y 65 #define DATE_AREA_W 100 #define DATE_AREA_H 20 // 全局变量 String lastTimeStr ; String lastDateStr ; int partialUpdateCount 0; void setup() { initRTC(); initDisplay(); // 初始化网络如果有时钟 connectToWiFi(); // 首次全刷绘制静态界面时钟框、装饰线等 drawStaticClockFace(); display.display(false); } void loop() { // 1. 获取当前时间 DateTime now rtc.now(); String currentTimeStr formatTime(now.hour(), now.minute()); String currentDateStr formatDate(now.dayOfTheWeek(), now.day(), now.month()); // 2. 检查时间是否需要更新例如每分钟更新一次 if (currentTimeStr ! lastTimeStr) { updateTimeDisplay(currentTimeStr); lastTimeStr currentTimeStr; partialUpdateCount; } // 3. 检查日期是否需要更新例如每天更新一次 if (currentDateStr ! lastDateStr) { updateDateDisplay(currentDateStr); lastDateStr currentDateStr; partialUpdateCount; } // 4. 每隔一段时间如每小时或每N次局部刷新后获取并更新天气网络功能 if (isTimeToUpdateWeather()) { WeatherData weather fetchWeatherData(); updateWeatherDisplay(weather.temp, weather.humidity, weather.iconCode); partialUpdateCount; } // 5. 残影管理每进行50次局部刷新后执行一次全刷清屏 if (partialUpdateCount 50) { display.display(false); // 全刷清屏 drawStaticClockFace(); // 重绘静态背景 partialUpdateCount 0; } delay(10000); // 每10秒检查一次更新时间判断逻辑内部会控制实际刷新频率 } void updateTimeDisplay(String timeStr) { display.setPartialWindow(TIME_AREA_X, TIME_AREA_Y, TIME_AREA_W, TIME_AREA_H); display.fillRect(TIME_AREA_X, TIME_AREA_Y, TIME_AREA_W, TIME_AREA_H, GxEPD_WHITE); display.setTextColor(GxEPD_BLACK); display.setFont(FreeSansBold18pt7b); // 使用大字体显示时间 display.setCursor(TIME_AREA_X, TIME_AREA_Y 30); display.print(timeStr); display.display(true); }6.3 优化与美化字体选择使用更多样、更美观的字体。GxEPD2库支持Adafruit GFX字体你可以从网上下载或自己生成喜欢的点阵字体文件.h格式加入到项目中。图标显示为天气状况晴、雨、云设计小的位图图标让界面更生动。低功耗终极优化如果使用电池供电可以让ESP32在大部分时间进入深度睡眠模式仅由RTC的闹钟功能定时唤醒比如每分钟唤醒一次。唤醒后读取时间判断是否需要更新屏幕更新完成后立刻再次进入深度睡眠。这样可以将整体平均电流降至几十微安级别使设备续航达到数月甚至数年。7. 常见问题排查与进阶思考即使按照步骤操作你也可能会遇到一些问题。这里列出一些常见情况及解决方法。问题一屏幕初始化失败全白或全黑无任何变化。检查电源确保Arduino和扩展板供电充足。墨水屏在刷新瞬间需要较大电流可达100mA以上USB口供电不足可能导致刷新异常。尝试使用外部电源如9V电池适配器为Arduino供电。检查型号定义这是最常见的问题。再次确认代码中的屏幕驱动类型号与你的物理屏幕完全一致。一个字符都不能错。检查Grove连接口确认屏幕连接在了扩展板的SPI接口上而不是I2C接口。检查库版本确保安装的GxEPD2库是最新版本。旧版本可能不支持你的屏幕型号。问题二显示内容有严重残影无法清除。强制全刷编写一个简单的程序循环执行display.fillScreen(GxEPD_WHITE); display.display(false);和display.fillScreen(GxEPD_BLACK); display.display(false);多次10-20次这相当于对屏幕进行“深度清洁”可以去除顽固残影。检查刷新模式确保在切换完全不同画面时使用了display.display(false)全刷。局部刷新 (display.display(true)) 只适用于内容小幅变化。遵循“先清后画”在局部刷新区域绘制新内容前务必用背景色填充整个区域。问题三显示图像时Arduino程序崩溃或无响应。内存溢出这是最可能的原因。检查位图数组是否太大。使用F()宏将字符串常量放入Flash节省RAM。对于大图像必须使用PROGMEM存储并使用支持从PROGMEM绘图的函数。考虑升级主控对于复杂的图形应用强烈建议使用ESP32或Raspberry Pi Pico它们拥有更大的内存和更强的处理能力。问题四局部刷新速度依然不够快有闪烁感。优化刷新区域使用setPartialWindow()精确限定更新区域区域越小刷新越快。组合更新如果多个小区域需要更新且它们位置接近可以考虑将它们合并到一个稍大的局部窗口内一次刷新而不是分别刷新多次。接受特性电子墨水屏的刷新率天生较低通常1-2秒全刷几百毫秒局刷不适合需要快速连续动画的场景。它的优势在于静态显示和低功耗而非刷新速度。通过这个从原理到实战的完整过程相信你已经掌握了Grove三色电子墨水屏的核心玩法。它不仅仅是一个显示模块更是通往低功耗、高可读性嵌入式显示应用的大门。无论是做一个永不充电的行李牌一个优雅的桌面时钟还是一个安静的仓库环境监视器这块小屏幕都能以其独特的魅力为你的项目增添一份实用与美感。
)
