1. 项目概述：1.54英寸电子纸模块（B型）是什么？

如果你玩过树莓派、Arduino或者STM32，大概率听说过电子墨水屏，也就是我们常说的e-Paper。它和我们手机、电脑上用的液晶屏（LCD）或者有机发光屏（OLED）完全不同。LCD需要背光持续发光，OLED则是每个像素点自己发光，而电子纸的原理更接近真实的纸张：它利用电场驱动微胶囊里的黑白带电粒子，一旦粒子移动到指定位置形成图像，即使完全断电，画面也能一直保持在那里，纹丝不动。这种“双稳态”特性，让它成了超低功耗显示方案的代名词。

今天要聊的这块1.54英寸电子纸模块（B型），就是电子纸家族里非常经典的一款入门级产品。它的分辨率是200x200像素，黑白两色显示，尺寸小巧，接口简单，特别适合嵌入式开发和物联网项目。你可能会问，市面上屏幕那么多，为什么偏偏要选它？答案就藏在它的特性里：极致的功耗和类纸的观看体验。想象一下，做一个温湿度计放在家里，如果用普通屏幕，要么拖着根电源线，要么隔三差五换电池。而用上这块电子纸，只在数据更新时耗电，刷新完就进入“零功耗”保持状态，一颗纽扣电池可能就能撑上好几个月甚至一年。再比如，做一个电子价签或者信息牌，内容一天只变几次，用它再合适不过，阳光下清晰不反光，还省电。

这块模块之所以在创客和开发者社区这么火，离不开它广泛的平台兼容性。从最简单的8位单片机Arduino Uno，到性能更强的STM32，再到拥有丰富生态的树莓派（Raspberry Pi），甚至是英伟达的边缘计算设备Jetson Nano，你都能找到相应的驱动库和例程。这意味着无论你是嵌入式新手，还是正在做复杂的边缘AI项目，都可以把它轻松集成进去，作为一个低功耗的信息输出窗口。我最初接触它，就是为了给一个户外传感器节点加一个本地显示屏，要求就是省电和强光下可视，找了一圈，发现它就是最完美的答案。

2. 模块核心硬件与接口深度解析

拿到一块1.54英寸e-Paper模块（B型），第一件事不是急着通电，而是要先把它“看透”。了解它的硬件构成和接口定义，是后续一切驱动和调试工作的基础，能帮你避开很多坑。

2.1 屏体与驱动芯片剖析

模块的核心是那块1.54英寸的电子墨水屏体。200x200的分辨率对于显示图标、文字和简单图形来说已经足够。它采用的是微胶囊电泳显示技术，你可以把它想象成无数个微小的“透明乒乓球”，每个“球”里封装着带负电的黑色粒子和带正电的白色粒子。当在屏幕电极上施加特定方向的电场时，黑色或白色粒子就会被吸引到屏幕表面，从而形成我们看到的像素点。

关键点在于驱动芯片。市面上常见的1.54英寸e-Paper模块，大多使用IL3820或功能类似的专用驱动IC。这个芯片的作用至关重要，它相当于屏幕的“大脑”和“手脚”。我们主控（如STM32）通过SPI接口发送过来的只是一串代表图像数据的0和1，IL3820负责将这些数据转换成精确的时序和高压脉冲，去控制屏幕里每一个像素点对应的电极，最终让粒子移动形成图像。它内部还集成了波形查找表（LUT），因为电子纸刷新图像不是简单地“涂色”，而需要一套复杂的电压波形序列来确保粒子移动彻底、避免残影，这个LUT就是用来存储这些波形参数的。

2.2 接口定义与电路连接要点

模块通常通过一个扁平的FPC排线引出一个邮票孔或排针接口。其引脚定义虽然可能因厂家略有差异，但核心信号线是标准的。下面是一个典型的引脚定义表：

注意：电源是第一个大坑！绝大多数1.54英寸e-Paper模块的逻辑电压都是3.3V，并且不兼容5V TTL电平。如果你用5V系统（如Arduino Uno）直接连接，轻则通信不正常，重则永久损坏驱动芯片。稳妥的做法是，无论主控是3.3V还是5V，都使用逻辑电平转换器（如TXS0108E）对SPI信号线（DIN, CLK, CS, DC, RST）进行转换。对于BUSY这根输出线，如果主控是5V系统，也需要确保其能容忍3.3V输入，或者通过电平转换后再读取。

连接时，除了电源和地，BUSY线是最容易被忽略但至关重要的。电子纸在刷新过程中（尤其是全局刷新），驱动芯片正在忙绿地施加高压波形，这个过程可能持续几百毫秒到几秒。在此期间，如果你强行通过SPI发送数据，会导致数据错乱，屏幕刷新异常，出现花屏或残影。正确的做法是，在发送刷新命令后，持续检测BUSY引脚的电平，直到它变为低电平，才进行下一步操作。

2.3 电源设计与功耗实测

电子纸的功耗特性是“脉冲式”的。在静态显示时，电流几乎为0（微安级）。但在刷新瞬间，驱动芯片需要产生较高的电压来驱动粒子，此时会有较大的瞬时电流（峰值可能达到几十毫安）。因此，电源设计需要能提供短暂的峰值电流。

如果你的主控板（如STM32开发板）的3.3V线性稳压器（LDO）输出能力足够（通常>300mA），可以直接取电。但如果使用电池供电，特别是纽扣电池这类内阻较大的电源，就需要在模块的VCC和GND之间并联一个容量较大的储能电容，比如100μF的钽电容或电解电容。这个电容的作用是在刷新瞬间“泵”出电流，避免电源电压被拉低导致系统复位。我在早期项目中就吃过亏，用一颗CR2032纽扣电池直接供电，一刷新就黑屏，后来并上一个220μF电容就稳了。

3. 驱动原理与底层通信协议详解

要让屏幕亮起来，光接好线还不够，必须懂得如何与它“对话”。这块屏幕的驱动，本质上就是通过SPI协议，向IL3820芯片写入一系列命令和对应的数据。

3.1 SPI通信时序与关键命令

模块通常支持标准4线SPI模式（CPOL=0， CPHA=0）。通信速率不建议太高，初期调试可以设在1MHz以下，稳定后可提升至10MHz左右。通信流程遵循一个固定模式：先拉低CS片选信号，然后根据DC引脚的电平决定当前字节是命令还是数据，接着在CLK时钟的同步下，通过MOSI线一位一位地发送出去。

有几个核心命令必须掌握：

• 软件复位（SWRESET， 0x12）：让驱动芯片恢复初始状态。在上电初始化或屏幕出现异常时调用。
• 设置数据入口模式（0x11）：告诉屏幕如何更新显存。例如，设置为“X地址递增，Y地址递增”模式，这样我们按顺序发送的像素数据就会从左到右、从上到下填充。
• 写显存数据（0x24）：这是最常用的命令。在发送此命令后，DC线置为高电平（数据模式），然后连续发送200 * 200 / 8 = 5000字节的数据。因为它是单色屏，1个bit代表1个像素（1黑0白或反之），所以一屏图像需要5000字节。
• 显示更新控制（0x22）：这个命令后面需要跟一个参数，来指定更新模式。例如，参数0xC7表示进行全局刷新，这会清除残影，但过程较慢（约2秒）且有明显的闪烁。参数0xC4表示进行局部刷新，速度很快（约300ms），无闪烁，但长时间使用可能产生残影，需要定期进行一次全局刷新来清理。
• 主控进入睡眠模式（0x10）：在屏幕显示稳定后，可以发送此命令让驱动芯片进入深度睡眠，进一步降低功耗。唤醒时需要先进行硬件或软件复位。

3.2 显存结构与图像数据格式

驱动芯片内部有一块对应的显示缓存（RAM）。我们的图像数据就是写入这里。理解其数据结构是关键。对于200x200的单色屏，显存通常被组织为一个位图（Bitmap）。

数据排列方式通常是纵向8个像素为一个字节（LSB或MSB优先需根据数据手册确定）。假设我们定义1代表黑色，0代表白色。那么，要显示一个全黑的屏幕，就需要发送5000个0xFF（二进制11111111）。如果要显示一个全白的屏幕，就发送5000个0x00。

在编程时，我们通常在MCU的内存中先创建一个同样大小的缓冲区（一个5000字节的数组），在这个缓冲区里进行所有的绘图操作（画点、画线、写字）。等所有图形都“画”好了，再一次性通过SPI将整个缓冲区数据发送给屏幕。这样做效率最高，也避免了频繁操作屏幕带来的闪烁。

3.3 刷新波形与残影处理机制

为什么电子纸刷新慢且有闪烁？根源在于其物理刷新过程。它不是瞬间切换，而是需要驱动芯片施加一个特定序列的电压波形（Waveform），这个波形存储在驱动芯片的LUT中。全局刷新时，波形会先施加全屏的反向电压（比如全白变全黑），然后再施加目标图像的电压，这个过程导致了全屏的“闪烁”，但能确保新旧图像更替干净，无残影。

局部刷新则使用了更优化的波形，只对发生变化的像素区域进行电压驱动，因此速度快、无闪烁。但长期局部刷新后，部分粒子可能因驱动不彻底而停留在错误位置，形成“残影”。因此，一个健壮的显示策略是：在连续多次（比如10次）局部刷新后，强制进行一次全局刷新。很多开源驱动库已经内置了这个逻辑。

4. 多平台实战：从Arduino到Jetson Nano

理论说得再多，不如动手一试。下面我将分别针对Arduino、STM32、树莓派和Jetson Nano，讲解快速上手的核心步骤和避坑指南。

4.1 Arduino平台快速上手

Arduino生态完善，是上手最快的方式。这里以Arduino Uno（5V系统）为例。

1. 硬件连接：务必使用电平转换模块！连接如下：Arduino 5V -> 电平转换器HV侧；Arduino 3.3V -> 电平转换器LV侧，同时接模块VCC；GND共地。信号线（SCK, MOSI, SS, DC, RST）通过电平转换器连接。BUSY线直接接Arduino的某个数字引脚（如D2）。

2. 库安装与基础例程：最常用的是GxEPD2库。在Arduino IDE的库管理中搜索并安装。安装后，在示例中找到GxEPD2_Example。你需要根据屏幕型号修改代码开头的定义。对于1.54英寸B型V2模块，通常是：

#include <GxEPD2_BW.h> GxEPD2_BW<GxEPD2_154_D67, GxEPD2_154_D67::HEIGHT> display(GxEPD2_154_D67(/*CS=*/ 10, /*DC=*/ 9, /*RST=*/ 8, /*BUSY=*/ 7));

这里需要将GxEPD2_154_D67换成你屏幕的实际驱动芯片型号，并正确填写你连接的引脚编号。

3. 首次驱动与常见问题：上传例程后，屏幕应该会执行一次全刷，显示测试图案。如果白屏，请检查：

• 电源：用万用表测量模块VCC脚电压是否为稳定的3.3V？
• 电平转换：是否所有信号线都正确通过了转换器？可以尝试用逻辑分析仪抓取SPI波形。
• BUSY引脚：代码中是否正确定义并读取了BUSY引脚？尝试在while (digitalRead(BUSY_PIN) == HIGH);语句前后加串口打印，看是否卡死在这里。
• 型号定义：GxEPD2库支持很多型号，确认GxEPD2_154_D67是否与你的模块匹配。不对的型号定义会导致初始化命令序列错误。

4.2 STM32开发环境配置与HAL库驱动

在STM32上驱动，能让你更深入地理解底层时序。我们以STM32CubeMX和HAL库为例。

1. 工程配置：

• 在CubeMX中配置一个SPI外设（如SPI1）为全双工主模式。
• 将连接CS、DC、RST、BUSY的GPIO引脚配置为输出（推挽输出）或输入（上拉输入）。
• 注意配置SPI的时钟极性（CPOL）和相位（CPHA）为0。
• 生成代码。

2. 底层驱动函数编写：你需要编写几个最基本的函数：

// 写命令 void EPD_WriteCommand(uint8_t cmd) { HAL_GPIO_WritePin(EPD_DC_GPIO_Port, EPD_DC_Pin, GPIO_PIN_RESET); // DC拉低，命令模式 HAL_GPIO_WritePin(EPD_CS_GPIO_Port, EPD_CS_Pin, GPIO_PIN_RESET); // CS拉低 HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(EPD_CS_GPIO_Port, EPD_CS_Pin, GPIO_PIN_SET); // CS拉高 } // 写数据 void EPD_WriteData(uint8_t data) { HAL_GPIO_WritePin(EPD_DC_GPIO_Port, EPD_DC_Pin, GPIO_PIN_SET); // DC拉高，数据模式 HAL_GPIO_WritePin(EPD_CS_GPIO_Port, EPD_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, &data, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(EPD_CS_GPIO_Port, EPD_CS_Pin, GPIO_PIN_SET); } // 等待忙结束 void EPD_WaitUntilIdle(void) { while(HAL_GPIO_ReadPin(EPD_BUSY_GPIO_Port, EPD_BUSY_Pin) == GPIO_PIN_SET) { HAL_Delay(10); } }

3. 初始化与显示流程：根据数据手册的时序图，组合调用上述函数，完成复位、设置LUT、清屏、发送显存数据、触发刷新、等待忙、进入睡眠等一系列操作。建议将官方Arduino库的底层驱动部分移植过来，重点是Init、Clear、Display、Sleep这几个函数。

实操心得：STM32的SPI速度。初期调试可将SPI波特率预分频设得大一些（如256分频）。待通信稳定后，再逐步提高速度。过高的SPI速度可能导致时序错乱，屏幕无法正常响应。我曾遇到在72MHz系统时钟下，SPI波特率超过18MHz后出现随机花屏，降低到9MHz就完全稳定。

4.3 树莓派（Raspberry Pi）Python驱动

在树莓派上使用Python驱动，非常适合快速原型验证和物联网应用。树莓派的GPIO是3.3V电平，可以直接连接模块，无需电平转换。

1. 安装依赖库：最常用的是waveshare_epd库。通过pip安装：

sudo pip3 install waveshare-epd

如果你的模块正好是微雪（Waveshare）的产品，那么库中很可能有直接对应的型号。

2. 编写Python脚本：

import epaper from PIL import Image, ImageDraw, ImageFont import time # 初始化，根据实际型号修改 epd = epaper.epaper('epd1in54b').EPD() # 假设是1.54英寸B型 epd.init() epd.Clear(0xFF) # 清屏为白色 # 创建图像并绘图 image = Image.new('1', (epd.width, epd.height), 255) # 255: white draw = ImageDraw.Draw(image) font = ImageFont.truetype('/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf', 20) draw.text((10, 10), 'Hello E-Paper!', font=font, fill=0) # 显示图像 epd.display(epd.getbuffer(image)) time.sleep(2) # 局部刷新示例（如果支持） # epd.displayPartial(epd.getbuffer(image)) # 进入睡眠 epd.sleep()

3. 权限与延时问题：运行Python脚本需要GPIO权限，通常需要sudo。另外，树莓派的Linux系统不是实时系统，在刷新等待（EPD_WaitUntilIdle）时，建议用短延时循环查询，而不是完全阻塞。库函数通常已经处理好了。

4.4 Jetson Nano高级应用与性能考量

Jetson Nano作为边缘AI设备，驱动电子纸可以用于显示AI识别结果、系统状态等。其驱动方式与树莓派类似，因为都是ARM Linux平台。你可以直接使用为树莓派编译的Python库，但需要注意硬件引脚映射的差异。

1. 引脚映射：Jetson Nano的40针GPIO排针定义与树莓派不同。你需要根据Jetson Nano的引脚定义（如JETSON_GPIO库的编号方式），修改驱动库中关于CS、DC、RST、BUSY、SPI设备号的初始化代码。不能直接照搬树莓派的BCM编号。

2. 与AI应用结合：一个典型的流程是：使用YOLO等模型进行图像识别 -> 将识别结果（标签、框）绘制到一张200x200的PIL图像上 -> 调用电子纸驱动库刷新屏幕。由于电子纸刷新慢，切忌在AI推理的循环内频繁刷新。正确的做法是，设置一个状态标志，只有当识别结果发生有意义的变化时（如检测到了新物体），才触发一次屏幕更新。

3. 功耗优化：Jetson Nano本身功耗不低，但你可以通过脚本控制其运行状态。当仅需要维持电子纸显示时，可以将Nano置于低功耗模式（如sudo nvpmodel -m 1），甚至结合cron定时任务，让系统大部分时间休眠，只在特定时间唤醒、执行AI推理、更新屏幕，然后再次休眠。这样能构建一个真正长续航的边缘AI信息终端。

5. 高级应用与图像处理技巧

驱动起来只是第一步，要让屏幕好用，还得在图像处理上下功夫。

5.1 自定义字库与文本显示优化

系统自带的点阵字体在200x200的分辨率下可能不够美观。我们可以使用自定义字库。推荐使用FreeType库（在PC或性能较强的MCU上）来渲染矢量字体，或者使用工具（如PCtoLCD2002）提前将需要的汉字和符号转换成点阵数组，嵌入到程序中。

对于嵌入式设备，一种经典方法是使用“取模软件”。将字体文件（如.ttf）导入，设置好大小和抗锯齿，生成对应字体的像素数据数组。在程序里，通过查表的方式获取每个字符的点阵数据，然后将其绘制到图像缓冲区中。为了优化显示效果，在绘制深色文字到浅色背景时，可以开启反锯齿。虽然电子纸只有黑白两色，但可以通过像素抖动算法（Floyd-Steinberg等）来模拟灰度，让文字边缘看起来更平滑。

5.2 图片转换与抖动算法应用

如何将一张彩色或灰度图片显示在黑白电子纸上？直接二值化（设定一个阈值，高于阈值为白，低于为黑）效果通常很差，会丢失大量细节。这时就需要抖动算法。

抖动算法的核心是将灰度图像的误差扩散到周围的像素。以Floyd-Steinberg算法为例，它按照固定的权重（如7/16, 3/16, 5/16, 1/16）将当前像素二值化后产生的误差，加到右方、左下、正下、右下的像素上。这样处理后的黑白图片，在人眼看来就能保留更多的明暗层次和细节。有很多在线工具和Python脚本（如使用PIL库）可以完成这个转换。将转换好的、尺寸为200x200的1位BMP或二进制数据，直接送入屏幕的显存缓冲区即可显示。

5.3 多级灰度与动画效果实现

部分高级的电子纸驱动芯片支持4级灰度（黑、白、浅灰、深灰）。这通过更复杂的驱动波形实现。在编程上，你需要为每个像素分配2个bit（00, 01, 10, 11），显存大小变为原来的两倍。驱动库通常会有相应的display4Gray函数。显示灰度图像时，效果会比二值化好很多。

至于动画，由于电子纸刷新率极低（全局刷新约2秒一帧），传统动画不现实。但可以实现“翻页式”动画，比如缓慢擦除一个区域再绘制新的内容。更实用的“动画”是局部刷新实现的动态区域更新。例如，一个仪表盘界面，只有中间的数字区域频繁变化，可以只刷新这个数字区域，其他静态部分（表盘、标题）保持不变，这样更新速度很快，视觉上也更流畅。这需要驱动库支持指定刷新区域的功能，并在软件层面精心设计UI元素的布局。

6. 项目实战：构建一个低功耗环境信息站

现在，我们把所有知识串联起来，做一个完整的项目：一个基于STM32和1.54英寸电子纸的室内环境信息站，通过Wi-Fi获取时间和天气，并定时刷新显示。

1. 系统架构设计：

• 主控：STM32F103C8T6（蓝色药丸核心板），性价比高，资源足够。
• 传感器：DHT11（温湿度），可选BMP280（气压）。
• 网络：ESP-01S WiFi模块，通过AT指令与STM32串口通信。
• 显示：1.54英寸e-Paper模块（B型）。
• 电源：3.7V锂电池配合TP4056充电管理电路，经AMS1117-3.3稳压后给整个系统供电。

2. 软件流程与关键实现：

• 初始化：初始化SPI、GPIO、串口、定时器，连接Wi-Fi。
• 数据获取：每5分钟唤醒一次。通过DHT11读取本地温湿度；通过串口AT指令让ESP-01S访问网络API（如心知天气、和风天气）获取天气信息（天气状况、温度、湿度）和网络时间（NTP）。
• 图像渲染：在STM32的内存中开辟5000字节的显示缓冲区。使用移植好的图形库和字库，在缓冲区中绘制UI：顶部显示日期时间，中间大字体显示本地温湿度，底部显示天气图标和描述。
• 屏幕刷新：判断内容是否发生变化。如果变化，则调用EPD_Display函数将缓冲区数据发送到屏幕，并使用局部刷新模式。同时，维护一个局部刷新计数器，每累计10次局部刷新，下一次刷新就强制使用全局刷新以消除残影。
• 低功耗管理：显示完成后，发送睡眠命令（EPD_Sleep）让屏幕进入零功耗状态。然后，将STM32自身设置为停机（Stop）模式，并通过定时器（RTC）设定5分钟后的唤醒中断。整个系统进入微安级的休眠状态。

3. 避坑指南与优化：

• Wi-Fi连接稳定性：AT指令通信需增加超时和重试机制。网络API调用要处理异常，避免因网络问题导致程序卡死。
• 内存管理：STM32F103C8T6只有20KB RAM，显示缓冲区就占了5KB，字库和网络数据缓冲区要精打细算。尽量将字库存放在Flash中，使用时按需读取。
• 电池续航估算：主要耗电发生在Wi-Fi通信和屏幕刷新瞬间。实测中，STM32在Stop模式下电流约20μA，屏幕静态电流<10μA。假设每天刷新24次（每1小时1次），每次刷新和通信持续10秒，平均工作电流20mA。那么日均功耗 ≈ (24 * 10s * 20mA) / 86400s + 休眠电流 ≈ 0.056mAh + 0.72mAh ≈ 0.78mAh。一颗1000mAh的锂电池可以续航超过50天。这个估算展示了电子纸在低频更新应用中的巨大优势。

通过这个项目，你不仅能掌握电子纸的驱动，还能综合运用MCU编程、外设通信、低功耗设计和网络应用，做出一个真正实用、省电的物联网设备。这远比让一个LED灯闪烁要有成就感得多。