墨水屏这东西,玩过一次就回不去了:断电之后画面照样挂着,静态显示几乎不耗电。手头这块 Waveshare 2.13 寸 e-Paper HAT 是树莓派排座形态的 HAT 板,但它的本质就是一颗 SPI 接口的 EPD 驱动屏,把信号一根根映射过去,接 ESP32 完全可行。这篇把它的工作原理、规格、接线和官方 demo 的全刷/局部刷新用法一次理顺。

先搞懂墨水屏为什么省电
这类屏幕用的是"微胶囊电泳显示"技术:带电的纳米颗粒悬浮在液体里,在电场作用下迁移成像。也就是说,像素状态是物理"双稳态"的——黑粒子和白粒子停在各自位置上就不动了,画面自己保持,不需要背光也不需要持续供电。官方 wiki 的说法是:墨水屏靠反射环境光显示图案,可视角度接近 180°。
功耗数字很能说明问题。官方参数表写的是刷新功耗 26.4mW(typ.),而待机电流小于 0.01uA,基本等于没有。代价是刷新慢:全刷标称约 2s,而且全刷过程会有闪屏现象,官方明确说这是正常的。
另一个关键是局部刷新(partial refresh)。局部刷新不动整屏,只改变化的区域,速度快得多。但它有硬性使用约束:不能一直用局部模式刷,局部刷新几次之后必须做一次全刷,否则显示效果会异常且不可修复。这条官方用红字标了,务必记住。
2.13寸 e-Paper HAT 规格速览
这块屏有几个版本:V4 完全兼容 V3,还提供快速刷新(fast refresh)的 demo;V3 分辨率 250 × 122,硬件结构和接口兼容 V2。驱动板尺寸 65mm × 30.2mm,显示尺寸 48.55mm × 23.71mm,屏体外形 59.2mm × 29.2mm × 1.05mm,点距 0.194mm × 0.194mm。显示颜色黑白两色,灰阶 2 级。工作电压 3.3V / 5V(供电和信号都要 5V),通信接口 SPI,工作温度 0 ~ 50 ℃,存储温度 -25 ~ 70 ℃。刷新时间 2s 是实验结果,实际会有误差,以实际效果为准。
固件层面,官方 epd2in13_V4.h 里把分辨率和三种刷新模式写得很直白:
/*****************************************************************************
* | File : epd2in13_V4.h
* | Author : Waveshare team
* | Function : 2.13inch e-paper V4
* | Info :
*----------------
* | This version: V1.0
* | Date : 2023-6-25
* | Info :
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documnetation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS OR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
#
******************************************************************************/
#ifndef epd2in13_V4
#define epd2in13_V4
#include "epdif.h"
// Display resolution
#define EPD_WIDTH 122
#define EPD_HEIGHT 250
#define FULL 0
#define FAST 1
#define PART 2
class Epd : EpdIf {
FULL 是全刷,FAST 是 V4 新增的快速刷新,PART 是局部刷新。demo 代码里三种模式都有现成示例,不用自己造轮子。
接线:HAT 形态接 ESP32 要做 SPI 信号映射
先说清楚:这是树莓派 HAT,官方 wiki 没有给 2.13 寸 HAT 对 ESP32 的专用引脚表(官方未公布),也没有专门的转接板。接 ESP32 的正确姿势是按 SPI 信号名逐根映射,把屏的信号线接到 ESP32 硬件 SPI 对应的 MOSI、SCK、CS 以及普通 GPIO 上。信号本身一共 8 根:VCC、GND、DIN(SPI 的 MOSI)、CLK(SCLK)、CS、DC、RST、BUSY。
通信时序是 SPI 模式 0(CPHL=0,CPOL=0)。各信号的职责官方写得清楚:CSB(CS)低电平有效选中芯片;SCL 是串行时钟;D/C 是数据/命令控制脚,低电平写命令、高电平写数据;SDA(DIN)是串行数据线。官方给树莓派和 Arduino UNO 的对照表可以直接当信号定义参考——Arduino UNO 那份是:VCC 接 5V、GND 接 GND、DIN 接 D11(MOSI)、CLK 接 D13(SCK)、CS 接 D10、DC 接 D9、RST 接 D8、BUSY 接 D7。ESP32 侧把 DIN/CLK/CS 落到硬件 SPI 的同名信号上,DC/RST/BUSY 随便挑两个能翻能读的 GPIO 即可,注意供电和信号电平要一致。
还有一条官方红字提醒:墨水屏工作电压是 3.3V,裸屏配 5V 控制器需要加电平转换电路;新版的驱动板(V2.1 及之后)加了电平处理电路,3.3V 和 5V 都能支持。PCB 上带 20 pin 芯片的一般是新版。
官方 demo 库跑起来
官方 demo 有两个入口:GitHub 仓库 waveshare/e-Paper,或者 wiki Resources 里的 E-Paper_code.zip 打包下载。Arduino 端的示例在 E-Paper_code/Arduino/epd2in13_V4/ 目录,里面是 epd2in13_V4.cpp/.h、epdif、epdpaint、fonts、imagedata 这一组文件,用 Arduino IDE 直接打开 epd2in13_V4.ino 即可。

在 IDE 的 Tools 里选好板子和端口,点上传就行。烧录成功的样子是 avrdude 写完 flash 报 done:

全刷、快速刷新、局部刷新的实际用法
官方示例主程序把三种刷新都演示了一遍,下面这段是从官方仓库 epd2in13_V4.ino 原样搬来的 setup(),一个字符没动:
#include "SPI.h"
#include "epd2in13_V4.h"
#include "epdpaint.h"
#include "imagedata.h"
#define COLORED 0
#define UNCOLORED 1
/**
* Due to RAM not enough in Arduino UNO, a frame buffer is not allowed.
* In this case, a smaller image buffer is allocated and you have to
* update a partial display several times.
* 1 byte = 8 pixels, therefore you have to set 8*N pixels at a time.
*/
unsigned char image[1050];
Paint paint(image, 0, 0);
Epd epd;
void setup()
{
// put your setup code here, to run once:
Serial.begin(115200);
Serial.println("epd FAST");
epd.Init(FAST);
epd.Display_Fast(IMAGE_DATA);
delay(2000);
#if 1
Serial.println("epd FULL");
epd.Init(FULL);
Paint paint(image, epd.bufwidth*8, epd.bufheight); //width should be the multiple of 8
paint.Clear(UNCOLORED);
paint.DrawStringAt(8, 2, "e-Paper Demo", &Font12, COLORED);
paint.DrawStringAt(8, 20, "Hello world", &Font12, COLORED);
epd.Display1(image);//1
paint.Clear(UNCOLORED);
paint.DrawRectangle(2,2,50,50,COLORED);
paint.DrawLine(2,2,50,50,COLORED);
paint.DrawLine(2,50,50,2,COLORED);
paint.DrawFilledRectangle(52,2,100,50,COLORED);
paint.DrawLine(52,2,100,50,UNCOLORED);
paint.DrawLine(100,2,52,50,UNCOLORED);
epd.Display1(image);//2
paint.Clear(UNCOLORED);
paint.DrawCircle(25,25,20,COLORED);
paint.DrawFilledCircle(75,25,20,COLORED);
epd.Display1(image);//3
paint.Clear(UNCOLORED);
epd.Display1(image);//4
delay(2000);
#else
Serial.println("epd PART");
epd.DisplayPartBaseImage(IMAGE_DATA);
char i = 0;
for (i = 0; i < 10; i++) {
Serial.println("e-Paper PART IMAGE_DATA");
epd.Init(PART);
epd.DisplayPart(IMAGE_DATA);
Serial.println("e-Paper PART Clear");
epd.Init(PART);
epd.ClearPart();
delay(2000);
}
#endif
epd.Init(FULL);
Serial.println("e-Paper clear and sleep");
epd.Clear();
epd.Sleep();
}
void loop()
{
}
读这段代码有几个要点。第一,UNO 的 RAM 不够放整帧缓冲,所以 demo 里只开了一个 1050 字节的小缓冲(1 字节 = 8 像素,一次要设置 8*N 个像素),局部显示得分几次更新——换到 ESP32 上 RAM 宽裕,思路一样但余地大得多。第二,绘图都走 Paint 类:Clear、DrawStringAt、DrawRectangle、DrawCircle 这些接口先在缓冲里画,再一次 Display1 推屏。第三,切换刷新模式就是 epd.Init(FULL / FAST / PART) 换参数:FAST 配 Display_Fast 做快速刷新,PART 配 DisplayPart 做局部刷新,局部刷新前要先 DisplayPartBaseImage 打底。程序结尾官方的做法是 Init(FULL) 后 Clear 清屏、再 Sleep 进休眠——这个收尾动作别省。
如果你觉得 V3 的局部刷新偏慢,官方给了调波形的方法:改 EPD_2in13_V3.c 里的波形参数,把图示框里的参数调小可以提速(比如把 0x14 改成 0x13),但参数太小会让局部刷新的颜色变浅。下图就是官方标注的那个位置:

低功耗显示的正确姿势
墨水屏的功耗模型决定了用法:平时让它保持画面断电休眠,只在内容变化时唤醒刷一次。官方的使用注意有几条必须照做:屏幕不刷新时要进 sleep 模式或断电,长期高压状态会损坏屏且不可修复;进入 sleep 后发过去的图像数据会被忽略,只有重新初始化才能正常刷新;刷新间隔建议至少 180s,且 24 小时内至少完整刷新一次;长期不用要用程序清屏后再存放。低温环境刷新可能偏色,需要先在 25℃ 环境静置 6 小时再刷。
硬件上同样有两处易碎点:FPC 排线脆弱,不要沿屏幕垂直方向折、不要反复过度弯折,调试时建议先固定排线再动手;屏体本身怕摔怕压。图像数据显示不对时,先检查图像宽高设置是否正确再排查别的。
总结一下:双稳态加局部刷新,是墨水屏在电池设备上立足的根本;2.13 寸这个尺寸配 250 × 122 的分辨率,做状态牌、标签、桌面小信息板刚刚好。接 ESP32 这条路官方没有现成引脚表,但信号定义是公开的,SPI 模式 0、8 根线、按名映射就能点亮。记得局部刷新要配全刷,不刷的时候让它睡觉——墨水屏的省电,一半靠硬件,一半靠你会不会让它休息。











HAT接ESP32这段写得很实在,没瞎编个转接板出来,按信号名自己映射就行,DC和BUSY随便挑GPIO这话没毛病
问一下0x14改0x13提速那个,改完局部刷新大概能快多少?手上正好有块V3闲置
局部刷新几次后必须全刷一次这条真的要刻在脑子里,我一块2.9的屏就是偷懒全用局部模式,最后底色发灰救不回来了,官方红字不是吓人的。
avrdude写flash那步我熟,6916字节,跟官方demo对得上