ESP32驱动SES电子价签墨水屏：从拆机到中文显示实战

简介：面向物联网开发者的 ESP32 驱动 SES 价签墨水屏完整工程包，解决电子纸标签的 SPI 通信、初始化刷新及蓝牙远程改价等实际问题。资源共 13 个文件，以 C 语言源码、JSON 配置、sdkconfig 构建配置和 Markdown/txt 说明文档为主，另有可直接安装的 app-release.apk，整体压缩后仅 1.15 MB。已有 2078 人学习下载。核心代码覆盖 SPI 引脚接线、命令/数据切换、忙信号处理与全屏刷新流程；bt_spp_acceptor 示例实现蓝牙串口服务端，可接收手机指令并驱动墨水屏更新。配套文档解释了 24 针接口定义和 ESP32 软件初始化步骤，适合想快速上手电子价签方案或深入理解低功耗显示驱动的开发者。工程结构清晰，便于直接移植到自己的项目中进行二次开发。 玩硬件最开心的事情，往往就是把手头吃灰的二手件盘活。我桌上那几块SES价签墨水屏就是典型代表——SES是全球商超铺货量很大的电子价签供应商，价签内部的墨水屏素质不错，但当它脱离门店基站体系后，就只是一块没有主控协议的“裸屏”。放到ESP32玩家手里情况就完全不同了：墨水屏静态显示零功耗，接口又是标准SPI，用ESP32做驱动端，把价签变成桌面信息牌、温湿度计或者电子日历，比单独买一块全新墨水屏模组省钱得多，折腾乐趣也足。

这篇文章是我完整驱动过程的复盘，从拆机件辨识、FPC引脚确认、SPI接线，到Arduino生态下用GxEPD2点亮屏幕、显示点阵中文、调整刷新与低功耗策略，最后把我踩过的高频坑一并列出来。适合手里有SES拆机屏、想用ESP32把它变成实用小终端的玩家参考。

1. 拆机件先别急着焊：把SES价签屏的底细摸清楚

SES价签拆开之后，里面通常是一块墨水屏、一块FPC排线、一张带MCU和2.4G私有协议芯片的控制板、以及一颗纽扣电池或小锂电。我们真正要用的其实只有屏幕和FPC，控制板基本可以拆掉。但很多人上来就想直接飞线连ESP32，往往在第一步就翻车，因为屏的引脚定义不搞清楚，后面所有代码都是白写。

1.1 常见尺寸与驱动IC

二手市场里SES价签拆出的屏，常见尺寸有这么几类：

我手上这批2.13寸屏，背面能隐约看到“DEPG0213A1”的字样，这是屏模组的原始型号，对应驱动IC是SSD1680。这个型号在GxEPD2库里有直接支持，类名是GxEPD2_213_B74，直接用就行。所以别一上来就慌，先花十分钟把屏的“出身”搞清楚，后面能省大量调试时间。

1.2 FPC引脚辨识的方法论

二手价签屏最恼人的就是FPC上经常没有完整丝印，或者丝印小到肉眼根本看不清。我建议按下面这个优先级来识别：

1. 用手机微距拍照，放大看FPC上的丝印文字，很多屏其实印了VCC GND DIN CLK CS DC RST BUSY，只是字太小。
2. 如果丝印不完整，就沿着FPC走线找到屏幕边缘的驱动IC，把IC型号抄下来，直接查IC数据手册里的引脚定义，反推FPC上每一根线是什么。
3. 在GxEPD2等开源库的源码里按屏体型号搜索，比如搜DEPG0213A1、SSD1680，经常能直接命中现成的引脚配置。
4. 用万用表二极管档找地，GND通常和屏蔽铜箔或大片焊盘是通的，找到了地，再找VCC就顺了。

有一个最常见的错误是把所有引脚一次性全接到ESP32上去猜，这样很容易烧GPIO甚至烧屏。我的原则是：先定位电源和地，再确认SPI信号，最后才上电测试。

1.3 为什么先确认IC型号再写代码

墨水屏驱动IC决定了命令集、波形表和分辨率。SSD1680和IL0398虽然都能驱动2.13寸黑白屏，但命令集完全不同，初始化代码对不上，屏幕就会出现整屏乱跳、只闪不显示的现象。

所以识别IC型号这步不能省。你甚至可以先把屏接到一个标准墨水屏模组驱动板上，如果显示正常，说明屏体和接线都没问题；如果花屏，再回头查IC型号和波形表，这样能把问题范围快速缩小到“硬件还是软件”。

2. ESP32与价签屏的物理连接：SPI电路里的几个关键细节

接线本身不复杂，但有几个细节会影响稳定性。墨水屏的SPI接口和SD卡的SPI类似，但多出DC、RST、BUSY三个控制脚。

2.1 一份可以直接抄的接线表

以ESP32 DevKitC V4为例，我的标准接法如下：

如果你的ESP32型号不同，引脚编号会变，但映射逻辑一样。接好后先用万用表确认每个GPIO和FPC之间是导通的，省得后面因为虚焊排查半天。

2.2 3.3V逻辑与电平安全

ESP32的GPIO和墨水屏驱动IC都是3.3V体系，可以直接互联，不需要电平转换。这里要特别强调：绝对不要把VCC接到5V，墨水屏驱动IC的耐压通常就在3.6V左右，5V上去大概率烧FPC上的IC，屏就直接废了。

另外，BUSY脚一定要接。有人为了省IO把BUSY悬空，初始化时靠固定延时代替忙检测，表面看能用，但遇到温度变化、屏体个体差异时，刷新时序容易出现随机花屏。BUSY检测不费什么事，别省。

2.3 电源滤波与飞线长度

墨水屏在刷新瞬间电流尖峰明显，空闲时可能只有几毫安，刷新时可以冲到几十毫安。ESP32开发板板载的3.3V LDO在USB供电下会有点吃力，常见表现是刷屏刷到一半ESP32重启。

我试过的有效解决办法是在屏的VCC和GND之间并一颗10uF陶瓷电容，再并一颗100uF电解电容。如果条件允许，直接用AMS1117-3.3给屏单独供电，效果更好。飞线方面，FPC转接出来的线尽量短，SPI时钟线不要和电源线平行走太长距离。我一开始用15cm杜邦线飞线，刷新时偶尔花屏，后来缩短到3cm以内，问题彻底消失。

3. 点亮屏幕：Arduino + GxEPD2 从初始化到首帧

接线完成、IC型号确认后，就进入软件阶段。我用的是Arduino框架，原因很简单：驱动库成熟、调试方便、社区资料多。

3.1 为什么选GxEPD2而不是裸写寄存器

裸写寄存器不是不行，SSD1680的命令手册也就几十页，但墨水屏驱动有一个麻烦：不同IC、不同温度下的刷新波形表差异很大，这些波形表是厂家在出厂时烧在屏模组里的，或者由驱动库直接提供。自己从零调波形表，投入产出比很低。

GxEPD2库的成熟度很高，支持市面上绝大多数黑白和三色墨水屏IC，封装好了初始化、波形刷新、帧缓冲管理，还在内部做了平台抽象。也就是说，你写一套逻辑，以后换屏只是改一行构造对象的事。

3.2 最小可用代码

下面这段代码可以完成初始化并显示一行英文：

#include <GxEPD2_BW.h> GxEPD2_BW<GxEPD2_213_B74, GxEPD2_213_B74::HEIGHT> display( GxEPD2_213_B74(/*CS=*/5, /*DC=*/17, /*RST=*/16, /*BUSY=*/4) ); void setup() { SPI.begin(/*SCK=*/18, /*MISO=*/19, /*MOSI=*/23, /*SS=*/5); display.init(); display.setRotation(0); display.setFullWindow(); display.firstPage(); do { display.fillScreen(GxEPD_WHITE); display.setCursor(10, 20); display.print("Hello SES E-ink"); } while (display.nextPage()); } void loop() { // 墨水屏内容会保持，不需要持续刷新 }

这个代码的关键在于firstPage()和nextPage()配合的“分页绘制”机制。大尺寸墨水屏的帧缓冲可能占几十KB内存，GxEPD2用分页方式把绘制过程拆成多次回调，缓解单次缓冲区压力。对2.13寸这种小屏来说，完全够用。

3.3 首次点亮后的自查清单

屏幕跑出第一帧后，别急着开心，按这几个点检查一遍：

• 分辨率是否正确。2.13寸是250x122，如果代码里用了别的分辨率，边缘会有一截不刷新。
• 文字方向是否正常。如果画面左右镜像或上下颠倒，调整setRotation()参数，或者检查取模方向。
• 背景是否干净。纯白区域如果有发灰现象，通常是初始化或波形刷新不完全，可以试着重做一次清屏。
• SPI时钟是否过高。先把SPI频率降到1MHz试，稳定后再逐步提到4MHz。

4. 显示中文内容：点阵字体与帧缓冲的配合细节

英文显示没问题后，中文就是下一个需求。墨水屏和手机屏不一样，没有现成的字体渲染层，中文点阵字体的取模方向、编码映射、坐标对齐，每一步都有讲究。

4.1 帧缓冲的本质

墨水屏的驱动IC内部有一块SRAM，对应每一颗像素。刷新过程分两步：先把整帧图像按字节打包，通过SPI写入驱动IC的SRAM；然后发送刷新命令，驱动IC按内部波形表把内容“画”到屏幕上。

以2.13寸250x122单色屏为例，一个像素用1bit表示是黑还是白，整帧数据算下来约3.8KB。这些数据在ESP32端会先组织成一个图像数组，然后由库函数推送到屏。理解这个机制后，你就能明白为什么库函数需要传入位图数组，而不是直接传文字字符串。

4.2 取模参数与方向匹配

中文显示最省事的方法是提前用取模软件生成字模数组。我用的是PCtoLCD2002，设置参数时重点确认三件事：

• 取模方式：推荐“逐行式”，即每一行从左到右、从上到下扫描。
• 字节正序还是倒序：一般选“字节正序”，配合逐行式，扫描方向和SSD1680的刷新方向一致。
• 阳码还是阴码：阳码表示1对应黑点，0对应白点，显示效果是“白底黑字”；如果显示出来黑底白字，把阴码阳码对调即可。

取模方向错了，最典型的症状是中文笔画左右颠倒或者上下颠倒，很多人误以为是屏坏了，其实只是取模参数的事。

4.3 在GxEPD2上画中文

16x16的中文字模，每个字占32字节。我习惯把常用汉字按GB2312编码顺序做成一个大数组，显示时查表得到字模数据，再调用drawBitmap()画出：

void drawText16(int16_t x, int16_t y, const char* text) { while (*text) { // 这里根据编码查字模数组，得到 glyph // 假设 glyph 是 16x16 的单色位图数据 display.drawBitmap(x, y, glyph, 16, 16, GxEPD_BLACK); x += 16; text++; } }

英文和数字我用8x6点阵，这样中英文混排时按字符判断编码范围，中文按16x16画，英文按8x6画，间距和换行都好控制。如果你不想自己维护字库，也可以用U8g2_for_Adafruit_GFX这类工具库，它内置了多套中文字体，只是RAM占用会高一些。

5. 显示稳定与低功耗：刷新策略才是墨水屏的灵魂

很多第一次玩墨水屏的人，会把它当成LCD来用：每秒刷一次、频繁局部刷新，结果没几天屏幕就花得不成样子。刷新策略直接决定显示质量和硬件寿命。

5.1 全刷与局刷的取舍

墨水屏的完整刷新会经历一次“全黑再全白”的过程，看起来比较闪，但对比度好、残影少。局部刷新速度更快，画面不会闪黑闪白，适合小面积数字变化，但长时间局部刷新会让未变化区域的粒子状态累积，逐渐出现类似“鬼影”的残影。

我的策略是：整点切页、切换主题这类大变化时用全刷，时间分钟数、温度数值这类局部变化用局刷。并且强制约定每做10次局部刷新，就穿插一次全刷，把整个屏幕的底色“洗”一遍。这个习惯沿用下来，屏幕残影几乎可以忽略。

5.2 低功耗刷新与深度睡眠

墨水屏最大的优势是刷新完成后不需要供电也能保持显示。所以做低功耗方案时，完全可以按“唤醒—刷新—睡死”的周期来跑：

1. 使用ESP32的定时器唤醒或外部传感器唤醒。
2. 唤醒后初始化SPI和屏。
3. 刷新需要更新的内容。
4. 刷新完成后关闭SPI、关闭屏供电，然后esp_deep_sleep()。

实测下来，2.13寸屏每天刷新24次、每次刷新大约3秒，整机平均功耗非常低，配合一节18650电池可以跑很久。需要注意的是，深度睡眠前一定要保证刷新已经完成，也就是BUSY已经拉低，否则内容可能只显示一半。

5.3 多屏共总线扩展

如果你手里不止一块SES屏，想让ESP32同时驱动多块屏，可以直接把它们挂在同一条SPI总线上，每块屏用不同的CS引脚做片选，BUSY引脚各接各的GPIO。驱动逻辑上，先选第一块屏的CS、刷新、等BUSY释放，再选第二块屏。不要同时刷新两块屏，因为墨水屏刷新时对电流要求高，同时刷容易把电源拉垮。

6. 两周连续测试后我总结的高频问题与排查经验

最后这部分是我实际跑了两周、踩过不少坑后整理出来的问题速查。我把最常见的几个现象、原因和解决办法放在一起，方便你对照排查。

6.1 常见现象速查表

6.2 关于SPI频率的一个冷知识

很多人拿到屏后习惯把SPI拉到10MHz甚至更高，结果跑起来随机花屏，然后开始怀疑是代码问题。墨水屏驱动IC内部的移位寄存器并不追求多高的时钟频率，而且FPC转接线、面包板都会引入干扰。我把SPI频率锁在1MHz到4MHz之间，传输一帧2.13寸数据也就几十毫秒，完全不影响体验，稳定性却高了一个台阶。

6.3 从demo到实用信息牌还差什么

屏幕显示稳定后，真正让它变成实用设备，还需要补几块拼图：

• 数据来源：接温湿度传感器、NTP校时、MQTT订阅消息，任选其一。
• 供电设计：如果做固定桌面牌，USB供电就行；如果要无线摆放，就按深度睡眠思路设计电池供电。
• 外壳固定：SES原装外壳直接利用，或者3D打印一个底座，排线做好固定，不然长期扭动会让FPC接触不良。

我个人的习惯是先把数据源跑通，再把刷新策略调好，最后才做外壳和供电优化。一步一步来，不容易乱。

最后再分享一个让我少走弯路的小习惯：每确认一个环节，就把“为什么这样做”记在项目笔记里，尤其是IC型号确认、FPC引脚映射、取模方向这三类基础信息。玩拆机屏，最贵的不是硬件，是你排查问题的耐心。把这些基础钉死，后续接LVGL、做OTA远程更新，甚至把屏接入Home Assistant做自动化展示，就都是水到渠成的事了。

本文还有配套的精品资源，点击获取