1.54英寸三色电子纸模块驱动指南：从SPI原理到多平台实战

1. 项目概述：从“墨水屏”到“电子纸”，为什么1.54英寸G类模块值得你投入时间？

如果你玩过树莓派或者Arduino，大概率见过那种小小的黑白液晶屏，刷新快、能显示动画，但功耗不低，强光下还看不清。而当你第一次接触电子纸（e-Paper），特别是像1.54英寸G类（三色）模块时，感觉会完全不同：它显示的内容像印刷品一样稳定，只在刷新时才耗电，阳光下越看越清晰，还能显示黑、白、红三种颜色。这不仅仅是换了个显示技术，而是彻底改变了嵌入式设备人机交互的“气质”——从电子产品的闪烁感，转向了纸张般的沉静与持久。

我最初接触这个模块，是想做一个超低功耗的室内温湿度监测器，希望它挂在墙上几个月都不用充电。市面上黑白屏虽然省电，但无法高亮提示异常值（比如高温）。而这个1.54英寸G类三色屏，正好解决了这个问题：常态显示黑白温湿度数据，一旦超过阈值，关键数字瞬间变红，一目了然。这个简单的需求，让我深入研究了它在Raspberry Pi、Arduino、Jetson Nano乃至STM32等多种平台上的驱动方法，踩过不少坑，也积累了一套从选型、接线、驱动到深度优化的完整经验。

这篇教程，就是把这些经验系统化。它不仅仅是一份“点亮屏幕”的说明书，更是一份针对嵌入式开发者的场景化应用指南。无论你是想用树莓派做信息站、用Arduino做智能标签，还是用STM32做低功耗仪表，甚至是尝试在Jetson Nano上结合视觉AI做动态信息展示，你都能在这里找到对应的思路、可复现的代码，以及那些数据手册里不会写的“避坑指南”。我们会从最基础的原理和硬件接线讲起，逐步深入到刷新优化、局部刷新、功耗控制等高级话题，让你真正掌握这块小而美的屏幕。

2. 核心硬件与驱动原理深度解析

2.1 电子纸（e-Paper）显示原理：不仅仅是“电子墨水”

很多人把电子纸简单理解为“电子墨水”，这其实不准确。以这块1.54英寸G类屏为例，它采用的是微胶囊电泳显示技术。你可以想象屏幕内部有无数个微小的“胶囊”，每个胶囊里充满了透明的液体，并悬浮着带负电的黑色粒子和带正电的白色（或红色）粒子。

当我们在屏幕电极上施加一个电场时，这些带电粒子就会在液体中移动。例如，想让某个像素点显示黑色，就在对应位置施加一个正电场，带负电的黑色粒子被吸引到胶囊顶部（面向观看者），我们就看到了黑色。撤销电场后，粒子由于范德华力和介电泳力被“锁”在原位，图像得以静态保持，无需任何功耗。这就是电子纸“双稳态”特性的核心：只有改变状态（刷新）时需要能量，保持状态时零功耗。

G类（三色）屏的特殊性在于，它除了黑白粒子，还引入了第三种颜色的粒子（通常是红色或黄色）。驱动这类屏幕的波形（Waveform）远比黑白屏复杂。它需要通过更精细的电压序列和时间控制，来精确引导两种或三种粒子到达指定位置，避免刷新时的“鬼影”（上一次图像的残留）。这也是为什么它的驱动IC（如SSD1681）和配套的波形文件（LUT）至关重要的原因。

2.2 1.54英寸G类模块关键参数与接口剖析

拿到模块，第一件事是看背面。通常，这类模块的核心驱动芯片是SSD1681或功能类似的型号。它负责接收主控发来的图像数据，并生成复杂的时序电压去驱动屏幕面板。

关键电气参数：

• 工作电压：通常为3.3V。特别注意：逻辑电平是3.3V，切勿接入5V，会永久损坏！
• 通信接口：标准4线SPI（Serial Peripheral Interface）。
  • SCK：时钟线，由主控产生。
  • MOSI：主设备输出，从设备输入，用于发送命令和数据。
  • DC（或有时叫D/C#）：数据/命令选择线。这是SPI屏的关键引脚，高电平时MOSI上传的是要显示的图像数据，低电平时传的是控制命令（如复位、设置窗口等）。
  • CS：片选线，低电平有效，选中该屏幕。
  • BUSY：忙状态指示线。屏幕在刷新内部波形时，此引脚会输出高电平，告诉主控“我正在忙，别打扰”。必须查询此引脚状态，盲目发送数据会导致刷新异常。
  • RST：复位线，低电平有效。用于在初始化或异常时对驱动芯片进行硬件复位。

物理接口：模块通常提供邮票孔或排针两种形式。对于开发，使用排针和杜邦线连接最为方便。但要注意，SPI时钟频率在长飞线情况下不宜过高，建议初始设置在1-4 MHz，稳定后可尝试提升。

注意：不同厂商的模块，引脚顺序可能略有差异。务必以你手中模块的数据手册或卖家提供的资料为准。接错VCC和GND会导致芯片烧毁。

2.3 驱动基础：SPI通信与关键命令集

驱动电子纸的本质，就是通过SPI接口，按照特定时序向SSD1681芯片发送一系列命令和参数。这个过程有严格的顺序。

初始化典型流程：

1. 硬件复位：拉低RST引脚至少10ms，然后拉高，等待芯片就绪（通常通过BUSY引脚判断）。
2. 发送命令序列：设置驱动芯片的工作模式。例如：
   • SWRESET：软件复位。
   • DRIVER_OUTPUT_CONTROL：设置屏幕的扫描方向和分辨率。
   • DATA_ENTRY_MODE：设置数据写入内存的地址增长方向。
   • SET_RAM_X_ADDRESS/SET_RAM_Y_ADDRESS：设置显存（RAM）的窗口区域。
   • WRITE_LUT_REGISTER：这是三色屏的关键！向芯片写入“查找表”（LUT）。LUT定义了不同灰度（或颜色）转换时所需的电压波形序列。厂家会提供针对该屏幕优化好的LUT数据，直接写入即可。使用错误的LUT是导致鬼影、对比度差甚至损坏屏幕的主要原因。
3. 清屏：向显存写入全白或全黑的数据帧。
4. 显示更新：发送DISPLAY_UPDATE_CONTROL_2命令，后跟MASTER_ACTIVATION命令，触发屏幕根据当前显存内容和LUT进行物理刷新。此时BUSY引脚会变高，必须等待其变低后才能进行下一次操作。

图像数据格式：通常为1位深度（1bpp）的位图。对于黑白红三色屏，通常用两位来表示一个像素：例如00=白色，01=黑色，10=红色。你需要将你的图像数据按此格式组织成一个字节数组，然后通过SPI发送。

3. 多平台实战：从接线到“Hello World”

理论讲完，我们来点实际的。下面我将分别演示在四大主流平台上的快速上手步骤。

3.1 Arduino平台驱动实战

Arduino生态完善，有现成的库，是上手最快的方式。

硬件连接（以Arduino Uno为例）：

e-Paper Module -> Arduino Uno VCC -> 3.3V GND -> GND DIN (MOSI) -> Pin 11 (MOSI) CLK (SCK) -> Pin 13 (SCK) CS -> Pin 10 (可自定义，需在代码中对应) DC -> Pin 9 (可自定义) RST -> Pin 8 (可自定义) BUSY -> Pin 7 (可自定义)

实操心得：如果使用3.3V逻辑电平的Arduino板（如ESP32、ESP8266），可以直接连接。但像Uno这样的5V板，虽然IO口可耐受5V，但为安全起见，建议在MOSI、SCK、DC、CS、RST这些从Arduino输出到屏幕的线上，串联一个1kΩ的电阻作为简单限流，或者使用电平转换模块。

软件准备与库安装：

1. 打开Arduino IDE，点击“项目” -> “加载库” -> “管理库”。
2. 在搜索框中输入“GxEPD2”（这是一个非常强大且维护积极的电子纸库）。
3. 找到并安装“GxEPD2 by Jean-Marc Zingg”。

编写第一个程序：

#include <GxEPD2_BW.h> // 对于三色屏，我们需要GxEPD2_3C #include <GxEPD2_3C.h> #include <Fonts/FreeMonoBold9pt7b.h> // 内置字体 // 定义屏幕型号和引脚连接 // GxEPD2_3C<GxEPD2_154_Z90c, GxEPD2_154_Z90c::HEIGHT> display; // 154_Z90c 是一种常见的1.54英寸三色屏型号，请根据你的具体型号修改 // 如果库中未直接列出你的型号，可以尝试用尺寸和颜色类似的驱动类 // 更通用的方式，使用基类并手动指定分辨率（200x200是常见1.54寸分辨率） #define EPD_CS 10 #define EPD_DC 9 #define EPD_RST 8 #define EPD_BUSY 7 GxEPD2_3C<GxEPD2_154_Z90c, GxEPD2_154_Z90c::HEIGHT> display(GxEPD2_154_Z90c(EPD_CS, EPD_DC, EPD_RST, EPD_BUSY)); void setup() { Serial.begin(115200); display.init(115200); // 初始化串口调试和屏幕 display.setRotation(1); // 根据需要设置旋转（0-3） display.setFont(&FreeMonoBold9pt7b); display.setTextColor(GxEPD_RED); // 设置文本颜色为红色 display.firstPage(); do { display.fillScreen(GxEPD_WHITE); // 背景白色 display.setCursor(10, 30); display.print("Hello, World!"); display.setCursor(10, 60); display.print("Temperature: 25C"); } while (display.nextPage()); // 分页渲染，适用于大内存消耗 display.hibernate(); // 让屏幕进入深度睡眠，功耗降至极低 // 注意：hibernate后必须重新调用init()才能再次使用 } void loop() { // 空循环，显示一次后保持 }

关键点解析：

• firstPage()/nextPage()：这是GxEPD2库处理大内存图像的一种高效方式，它分块渲染和传输数据，避免一次性占用过多Arduino内存。
• hibernate()：这是极其重要的一步。刷新完成后调用，驱动芯片会关闭大部分电路，电流消耗可降至几个微安（μA）级别。如果你需要定时更新，记得在下次更新前调用init()唤醒屏幕。

3.2 Raspberry Pi (Python) 平台驱动实战

树莓派使用Python驱动，灵活性高，适合复杂图形应用。

硬件连接：

e-Paper Module -> Raspberry Pi GPIO VCC -> 3.3V (Pin 1) GND -> GND (Pin 6) DIN (MOSI) -> GPIO 10 (MOSI, Pin 19) CLK (SCK) -> GPIO 11 (SCLK, Pin 23) CS -> GPIO 8 (CE0, Pin 24) # 使用SPI0的CE0 DC -> GPIO 24 (可自定义， Pin 18) RST -> GPIO 17 (可自定义， Pin 11) BUSY -> GPIO 25 (可自定义， Pin 22)

软件环境配置：

1. 启用SPI接口：运行sudo raspi-config->Interface Options->SPI->Yes。
2. 安装必要的Python库：

   sudo apt update sudo apt install python3-pip python3-pil python3-numpy sudo pip3 install RPi.GPIO spidev

3. 获取驱动库。通常厂家会提供Python示例，或者可以使用waveshare_e-Paper这个比较通用的库。

   git clone https://github.com/waveshare/e-Paper.git cd e-Paper/RaspberryPi_JetsonNano/python sudo python3 setup.py install

Python示例代码：

import epaper1in54g # 假设库中对应模块名为这个，具体需根据实际库调整 from PIL import Image, ImageDraw, ImageFont import time # 初始化屏幕 epd = epaper1in54g.EPD() epd.init() epd.Clear(0xFF) # 清屏为白色 # 创建一张画布 image = Image.new('1', (epd.width, epd.height), 255) # 模式‘1’为1位黑白，255为白色 draw = ImageDraw.Draw(image) # 加载字体（树莓派自带一些字体） font = ImageFont.truetype('/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf', 20) # 绘制文字 draw.text((10, 10), 'Raspberry Pi', font=font, fill=0) # fill=0 黑色 draw.text((10, 40), 'e-Paper Demo', font=font, fill=0) # 绘制一个红色矩形（对于三色屏，需要特殊处理红色） # 通常方法：创建另一张单色图像作为“红色层”，黑色部分代表显示红色 red_image = Image.new('1', (epd.width, epd.height), 0) # 默认全黑（不显示红） red_draw = ImageDraw.Draw(red_image) red_draw.rectangle([(50, 70), (100, 120)], fill=1) # fill=1 表示这个区域显示红色 # 显示图像 epd.display(epd.getbuffer(image), epd.getbuffer(red_image)) # 传入黑白缓冲和红色缓冲 time.sleep(2) # 进入休眠 epd.sleep()

避坑指南：树莓派GPIO的驱动能力有限，如果同时连接多个外设，可能导致屏幕刷新不稳定。如果遇到问题，尝试单独给屏幕供电（仍共地），并检查BUSY引脚读取是否正常。另外，Pillow库绘制文字时，确保字体路径正确，否则会静默失败。

3.3 STM32 (HAL库) 平台驱动实战

在STM32上驱动，能让你对底层SPI和GPIO控制有最深的理解，也是产品化必经之路。

开发环境：以STM32CubeIDE为例，使用HAL库。

步骤一：CubeMX配置

1. 创建工程，选择你的STM32型号。
2. 配置一个SPI外设（如SPI1）为全双工主模式。
   • 数据大小：8位。
   • 时钟极性（CPOL）和相位（CPHA）：通常设置为Low和1 Edge（即模式0）。但务必以屏幕数据手册为准！SSD1681常用模式0。
   • 预分频器：设置波特率，初始可设为PCLK / 64或更低（约1MHz），稳定后可提高。
3. 配置DC、RST、CS、BUSY为GPIO输出（CS、RST、DC）和输入（BUSY）。
   • CS引脚也可以使用SPI的硬件NSS，但软件控制更灵活，这里我们配置为普通GPIO输出。
4. 生成代码。

步骤二：编写驱动层代码首先，创建一个e_paper.h和e_paper.c文件。

关键函数示例：

// e_paper.c #include "e_paper.h" #include "main.h" // 包含HAL库和GPIO/SPI定义 extern SPI_HandleTypeDef hspi1; // 假设使用SPI1 // 引脚定义宏 #define EPAPER_CS_PIN GPIO_PIN_4 #define EPAPER_CS_PORT GPIOA #define EPAPER_DC_PIN GPIO_PIN_5 #define EPAPER_DC_PORT GPIOA #define EPAPER_RST_PIN GPIO_PIN_6 #define EPAPER_RST_PORT GPIOA #define EPAPER_BUSY_PIN GPIO_PIN_7 #define EPAPER_BUSY_PORT GPIOA // 发送命令 void EPD_SendCommand(uint8_t cmd) { HAL_GPIO_WritePin(EPAPER_DC_PORT, EPAPER_DC_PIN, GPIO_PIN_RESET); // DC=0，命令模式 HAL_GPIO_WritePin(EPAPER_CS_PORT, EPAPER_CS_PIN, GPIO_PIN_RESET); // CS=0，选中 HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(EPAPER_CS_PORT, EPAPER_CS_PIN, GPIO_PIN_SET); // CS=1，取消选中 } // 发送数据 void EPD_SendData(uint8_t data) { HAL_GPIO_WritePin(EPAPER_DC_PORT, EPAPER_DC_PIN, GPIO_PIN_SET); // DC=1，数据模式 HAL_GPIO_WritePin(EPAPER_CS_PORT, EPAPER_CS_PIN, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi1, &data, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(EPAPER_CS_PORT, EPAPER_CS_PIN, GPIO_PIN_SET); } // 等待屏幕空闲 void EPD_WaitUntilIdle(void) { uint32_t timeout = 10000; // 超时计数，防止卡死 while(HAL_GPIO_ReadPin(EPAPER_BUSY_PORT, EPAPER_BUSY_PIN) == GPIO_PIN_SET) { timeout--; if(timeout == 0) { break; // 超时退出 } HAL_Delay(1); } } // 硬件复位 void EPD_Reset(void) { HAL_GPIO_WritePin(EPAPER_RST_PORT, EPAPER_RST_PIN, GPIO_PIN_RESET); HAL_Delay(10); // 至少10ms低电平 HAL_GPIO_WritePin(EPAPER_RST_PORT, EPAPER_RST_PIN, GPIO_PIN_SET); HAL_Delay(10); // 等待复位完成 EPD_WaitUntilIdle(); } // 初始化函数（需要根据具体屏幕型号填充命令序列） void EPD_Init(void) { EPD_Reset(); EPD_SendCommand(0x12); // 软件复位 SWRESET EPD_WaitUntilIdle(); // ... 发送一系列初始化命令和LUT数据 ... // 例如设置分辨率、数据格式、写入LUT等 // LUT数据是一个很长的常量数组，通常由厂家提供 }

步骤三：主程序调用在main.c中，调用初始化函数，然后向显存写入图像数据，最后触发刷新。

// 准备一幅200x200，1位深度的图像数据 // 这里简单创建一个全白背景，中间一个黑色方块，一个红色方块的示例数据 // 实际应用中，你可能需要用一个函数来将位图转换成数组 uint8_t black_buffer[5000]; // 200*200/8 = 5000字节 uint8_t red_buffer[5000]; // 填充缓冲区... // ... EPD_Init(); EPD_Clear(); // 清屏函数 EPD_Display(black_buffer, red_buffer); // 显示函数，需要自己实现 EPD_Sleep(); // 进入睡眠

核心技巧：STM32的SPI传输速度很快，但电子纸的BUSY信号是毫秒甚至秒级的。绝对不要在BUSY为高时发送数据。EPD_WaitUntilIdle()函数中的超时机制是产品稳定性的重要保障。另外，将LUT等常量数据存放在Flash（使用const）而非RAM中，可以节省宝贵的内存空间。

3.4 Jetson Nano (Python/C++) 平台驱动实战

Jetson Nano驱动电子纸，通常用于更复杂的应用，比如结合摄像头做AI识别后显示结果。

硬件连接：与树莓派GPIO连接方式几乎完全相同，因为Jetson Nano的40针GPIO排针与树莓派兼容。

软件准备： Jetson Nano默认的Ubuntu系统已经启用了SPI。我们需要安装Python库或使用C++库。

# 安装Python库 sudo apt update sudo apt install python3-pip python3-pil sudo pip3 install Jetson.GPIO # Jetson专用的GPIO库

Python驱动示例： 其代码结构与树莓派版本非常相似，主要区别在于GPIO库的引入和引脚编号方式（可能使用BCM或BOARD模式）。

import Jetson.GPIO as GPIO import spidev import time from PIL import Image, ImageDraw, ImageFont # 引脚定义（使用BOARD编号） RST_PIN = 11 DC_PIN = 13 CS_PIN = 15 BUSY_PIN = 16 # 初始化GPIO和SPI GPIO.setmode(GPIO.BOARD) GPIO.setup(RST_PIN, GPIO.OUT) GPIO.setup(DC_PIN, GPIO.OUT) GPIO.setup(CS_PIN, GPIO.OUT) GPIO.setup(BUSY_PIN, GPIO.IN) spi = spidev.SpiDev() spi.open(0, 0) # 打开SPI总线0，设备0 spi.max_speed_hz = 4000000 # 4MHz spi.mode = 0b00 # 后续的发送命令、数据、初始化的函数与树莓派逻辑一致 # ...

高级应用场景：在Jetson Nano上，你可以运行一个YOLOv5物体检测模型，当检测到特定目标（比如“人”）时，在电子纸上用红色框和文字标注出来，形成一个低功耗的智能识别展示终端。这需要结合OpenCV进行图像处理，并将处理后的结果转换为1位深度的黑白和红色缓冲区，再发送给屏幕刷新。

4. 高级应用与性能优化技巧

让屏幕亮起来只是第一步，用好它才是关键。

4.1 图像处理与缓冲区管理

嵌入式设备内存有限，直接处理200x200的全尺寸图像（5000字节）可能压力不大，但更大的屏幕或更复杂的图形就需要技巧。

• 局部刷新（Partial Refresh）：许多电子纸驱动芯片支持局部刷新，即只更新屏幕上变化的部分。这能显著减少刷新时间和功耗。实现原理是：先发送命令设置一个矩形窗口（SET_RAM_X_ADDRESS_START/END,SET_RAM_Y_ADDRESS_START/END），然后只向这个窗口对应的显存区域写入数据，最后执行局部刷新命令。注意：局部刷新对波形（LUT）有特殊要求，频繁的局部刷新可能导致残影加剧，需要厂家提供对应的局部刷新LUT。
• 双缓冲与差分更新：在内存中维护两个缓冲区：current_buffer和new_buffer。更新时，比较两者差异，只将发生变化的像素块通过局部刷新或智能全局刷新进行更新。这对于显示缓慢变化的数据（如时钟、传感器读数）非常有效。
• 图像抖动算法（Dithering）：如果你想显示灰度图片，但屏幕只支持黑白（1位），就需要抖动算法（如Floyd-Steinberg）将灰度图转换为黑白点阵，模拟灰度效果。对于三色屏，算法更复杂，需要将彩色图分解为黑、白、红三个平面。

4.2 低功耗设计策略

电子纸的终极优势是低功耗，设计不当会浪费这一优势。

1. 刷新后必休眠：每次调用完刷新函数（display()，MASTER_ACTIVATION）后，必须立即发送进入深度睡眠（Deep Sleep或Hibernate）的命令。此时模块电流可从几毫安降至10微安以下。
2. 主控协同休眠：如果整个设备是电池供电，让屏幕休眠后，也应让MCU（如STM32）进入Stop或Standby模式，通过RTC或外部中断定时唤醒，读取传感器、刷新屏幕，然后继续休眠。这样系统平均电流可以做到几十微安级别。
3. 减少不必要的全局刷新：全局刷新（尤其是带清屏的）最耗电。优先使用局部刷新。对于静态界面，刷新一次后即可完全断电（物理断电），仅在有信息更新时上电。
4. 优化刷新波形：有些驱动芯片允许微调LUT中的波形参数，在保证显示质量的前提下，适当缩短刷新阶段的时间，可以降低单次刷新能耗。

4.3 常见问题与故障排查实录

以下是我在实际项目中遇到的一些典型问题及解决方法：

一个深刻的教训：我曾在一个户外项目中使用该屏幕，初期测试正常，但批量部署后部分设备显示异常。最终发现是温度影响。电子纸的刷新波形对温度敏感，厂家提供的LUT通常在25℃下优化。在低温（0℃以下）或高温（40℃以上）环境下，刷新时间会变化，原有代码中的固定延迟可能不足，导致刷新不完全。解决方案是：始终以BUSY引脚为刷新完成的唯一判断标准，并适当延长超时时间。更高级的方案是使用温度传感器，根据环境温度选择不同的LUT或调整刷新参数。