1. 项目概述：2.7英寸电子纸HAT，一个被低估的显示利器

如果你玩过树莓派、Arduino或者STM32，大概率接触过各种屏幕——LCD、OLED、TFT，它们色彩鲜艳，刷新率高，是交互显示的主力。但今天我想聊的，是另一个赛道的选手：电子墨水屏，或者更具体点，这块2.7英寸的e-Paper HAT。你可能在电子价签、公交站牌或者Kindle上见过它，那种像印刷纸张一样的显示效果，以及只有在刷新时才耗电的特性，让它天生就适合那些需要长时间静态显示、且对功耗极其敏感的场景。比如，做一个放在门口的天气预报站，一个显示菜谱的厨房计时器，或者一个低功耗的传感器数据看板，电子纸几乎是唯一的选择。

这块2.7英寸的HAT（Hardware Attached on Top），本质上是一个为树莓派等单板计算机设计的扩展板，通过GPIO排针直接插在主板顶部。它分辨率是264x176，黑白两色显示，支持局部刷新和全局刷新。听起来参数平平无奇，对吧？但它的魅力恰恰在于“专一”。它不追求绚丽的动画，而是追求极致的静态显示效果和近乎为零的待机功耗。我最初用它做一个项目：一个联网的室内温湿度计，希望它一周甚至更久才充一次电。试了一圈屏幕，只有这块电子纸能满足要求，屏幕上的数字可以一直显示，而主板和屏幕本身几乎不耗电。这让我开始深入研究它，从驱动原理到优化技巧，踩了不少坑，也总结了一套从硬件连接到软件优化，再到实战项目的完整流程。

2. 硬件连接与核心驱动原理拆解

拿到这块屏幕，第一步不是急着写代码，而是搞清楚它怎么和你的主板“对话”。这块2.7英寸e-Paper HAT通常使用SPI接口进行通信，这是一种高速、全双工、同步的串行通信总线，非常适合驱动这种不需要极高刷新率的显示设备。

2.1 引脚定义与物理连接

虽然叫HAT，意味着它应该能完美兼容树莓派的40针GPIO排针，但为了确保万无一失，我们还是要核对一下关键引脚。通常，板子上会丝印标注，或者供应商会提供引脚图。核心的SPI引脚包括：

• SCLK (Serial Clock): 时钟信号线，由主设备（树莓派）产生，用于同步数据。
• MOSI (Master Out Slave In): 主设备输出，从设备输入，也就是树莓派向屏幕发送命令和数据的数据线。
• CS (Chip Select) / SS (Slave Select): 片选信号，用于在多个SPI设备中选择当前要通信的哪一个。对于单一屏幕，通常固定接低电平或由软件控制。
• DC (Data/Command): 这是一个非常关键的引脚。它用来告诉屏幕，当前通过MOSI发送过去的数据，是“命令”还是“要显示的图像数据”。比如，发送初始化序列是命令，发送一幅264x176像素的位图数据就是显示数据。这个引脚的高低电平决定了数据的解释方式。
• RST (Reset): 复位引脚，用于硬件复位屏幕控制器。
• BUSY: 忙状态引脚。电子纸刷新（尤其是全局刷新）是一个物理过程，需要几十到几百毫秒。在此期间，屏幕控制器会拉高BUSY引脚，告诉主设备“我正在忙，别打扰我”。主程序必须检测这个引脚，等待其变为低电平后才能发送下一条指令。忽略这个信号是导致显示异常的最常见原因之一。

对于树莓派，连接非常简单，直接对准GPIO排针插上去即可，HAT的设计已经完成了引脚映射。但对于Arduino Uno或STM32（如STM32F103C8T6，即“蓝色药丸”），你需要使用杜邦线进行连接。这里提供一个通用连接参考表（以SPI1为例）：

注意：上表中的“任意GPIO”指的是除了用于SPI通信的固定引脚（PA5, PA7）外，其他用于控制信号的引脚可以自由分配，但需要在代码中做相应定义。STM32的SPI引脚是固定的，但CS、DC、RST、BUSY这些可以用软件模拟。

2.2 电子墨水屏的刷新机制：为什么它这么“慢”

理解了硬件连接，我们再来看看它的核心——电子墨水屏的显示原理。这解释了它所有特性的来源。

电子墨水屏内部有数百万个微胶囊，每个胶囊里包含带负电的黑色粒子和带正电的白色粒子，悬浮在透明液体中。屏幕底板是一层带有电极的电路。当我们给电极施加一个电压时，根据电场的极性，黑色或白色粒子就会被吸引到胶囊顶部，从而在屏幕上形成一个黑点或白点。

全局刷新 (Full Update)：这是最彻底的刷新方式。为了得到最清晰的对比度，消除残影，控制器会先给整个屏幕施加一个反向电压（例如，全屏闪一下黑色或白色），然后再施加正向电压，将目标图像“画”上去。这个过程物理上需要时间让粒子移动到位，所以通常需要200-300毫秒，期间你会看到屏幕先全黑再全白，最后显示图像。全局刷新后图像最干净，但速度慢、功耗相对高（因为粒子做了长距离移动）。

局部刷新 (Partial Update)：这是优化体验和功耗的关键。如果只是改变屏幕上的一小部分内容（比如更新一个数字），控制器可以只刷新对应的区域，其他区域的粒子保持不动。这大大加快了刷新速度（可能只需几十毫秒），并且功耗极低。但是，局部刷新多次后，由于粒子没有经过全局的“复位”，可能会产生轻微的残影。因此，好的驱动策略是：多次局部刷新后，主动进行一次全局刷新来清屏。

在代码驱动中，你必须根据要显示的内容，明智地选择刷新模式。显示静态图片、首次开机画面用全局刷新；频繁更新的数据（如时间、温度）用局部刷新。

3. 软件驱动与库函数深度解析

硬件通了，原理懂了，接下来就是让屏幕动起来的软件部分。我们将分别针对树莓派（Python）、Arduino (C++) 和 STM32 (HAL库/C) 三个平台，解析驱动库的核心函数和避坑要点。

3.1 树莓派平台：使用waveshare_epdPython库

对于树莓派，最常用的是 Waveshare（微雪）提供的waveshare_epd库，它封装了底层SPI操作，提供了非常友好的API。

首先安装库：

sudo apt-get update sudo apt-get install python3-pip python3-pil python3-numpy sudo pip3 install waveshare-epd

一个最基础的显示流程代码如下：

import epd2in7b # 导入2.7英寸屏幕的驱动模块 from PIL import Image, ImageDraw, ImageFont import time # 初始化屏幕 epd = epd2in7b.EPD() epd.init() # 初始化，内部会执行硬件复位和发送初始化命令序列 print(“Clearing screen...”) epd.Clear(0xFF) # 清屏为白色，0xFF代表白色（1），0x00代表黑色（0） # 创建一个与屏幕分辨率相同的图像缓冲区 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’, 24) draw.text((10, 10), ‘Hello, e-Paper!’, font=font, fill=0) # fill=0 表示黑色 # 将图像缓冲区数据发送到屏幕并显示 # 关键参数：`epd.display(epd.getbuffer(image))` 默认使用全局刷新 epd.display(epd.getbuffer(image)) time.sleep(2) # 等待显示完成 # 进入休眠模式以省电 epd.sleep()

核心函数与避坑指南：

1. init()与Clear()：init()必须调用，它配置了屏幕的SPI模式、电压等参数。Clear()通常用于首次使用或需要完全清屏时，它内部也是调用了一次全局刷新。
2. display()的刷新模式：查看库源码，你会发现display()函数可能有一个partial_update参数。强烈建议在频繁更新时使用局部刷新。例如，如果你自己修改或封装库，可以这样调用：epd.display(epd.getbuffer(image), partial_update=True)。这能极大提升刷新速度和降低功耗。
3. 图像缓冲区 (Image) 的模式：创建Image对象时，模式必须是‘1’（1位像素，黑白）。如果你错误地使用了‘L’（8位灰度）或‘RGB’，库函数getbuffer()可能会报错或显示乱码。
4. sleep()的重要性：显示完成后，务必调用epd.sleep()。这个命令会让屏幕控制器进入深度睡眠模式，电流消耗可以从几mA降到几uA级别。如果不调用，屏幕可能会持续消耗可观的电量。
5. 处理BUSY引脚：好的驱动库会在display()和Clear()函数内部自动检测BUSY引脚并等待。但如果你是自己编写底层驱动，或者使用一些简化的库，必须在发送刷新命令后，循环读取BUSY引脚状态，直到其为低电平。

3.2 Arduino平台：使用GxEPD2库

在Arduino IDE中，GxEPD2库是支持众多电子纸型号的佼佼者，它性能优秀且更新活跃。

通过库管理器搜索安装GxEPD2。同时建议安装Adafruit GFX库，它提供了丰富的图形绘制函数。

一个简单的Arduino示例：

#include <GxEPD2_BW.h> // 我们的是黑白屏，所以用BW版本 #include <Fonts/FreeMonoBold9pt7b.h> // 内置字体 // 定义你的屏幕型号和引脚 // GxEPD2_BW<GxEPD2_270, GxEPD2_270::HEIGHT> display; // 对于常见的2.7英寸屏，可能对应 GxEPD2_270_GDEY027T91 等具体型号，请根据供应商资料确认 // 这里以通用的270类为例，实际需替换 #define EPD_CS SS // CS引脚 #define EPD_DC 9 // DC引脚 #define EPD_RST 8 // RST引脚 #define EPD_BUSY 7 // BUSY引脚 // 初始化显示对象，参数为：型号、CS、DC、RST、BUSY GxEPD2_BW<GxEPD2_270, GxEPD2_270::HEIGHT> display(GxEPD2_270(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_BLACK); // 设置文本颜色 // 清屏 display.setFullWindow(); // 设置为全窗口刷新模式 display.fillScreen(GxEPD_WHITE); display.display(false); // false 表示不使用局部刷新（即全局刷新） // 绘制文本 display.setCursor(10, 30); display.print(“Hello, Arduino!”); display.display(true); // true 表示使用局部刷新（如果支持且区域设置正确） display.hibernate(); // 进入休眠，比sleep更省电 } void loop() { // 空循环 }

Arduino驱动关键点：

1. 型号匹配：GxEPD2库支持众多型号，你必须根据屏幕驱动芯片或供应商提供的型号信息，选择正确的类。例如可能是GxEPD2_270_GDEY027T91或GxEPD2_270。选错会导致初始化失败或显示异常。
2. 刷新模式控制：display.display(bool partial_update)是核心。在调用它之前，需要通过display.setFullWindow()或display.setPartialWindow(x, y, w, h)来设定刷新区域。局部刷新必须与设定局部窗口配合使用。全局刷新后，如果想接着用局部刷新，有时需要先调用一次display.nextPage()相关的流程，具体需参考库的示例。
3. hibernate()vssleep()：hibernate()是比sleep()更深的休眠模式，功耗极低，但唤醒时间可能稍长。对于需要超低功耗的应用，优先使用hibernate()。
4. 内存管理：Arduino Uno内存有限（2KB SRAM）。全屏位图缓冲区可能很大（264*176/8 ≈ 5.8KB），会直接导致内存不足。GxEPD2库使用了分页刷新技术来规避这个问题，但你在自己创建图像缓冲区时仍需小心。

3.3 STM32平台：HAL库驱动与底层时序

在STM32上驱动，更能让你理解底层原理。我们以STM32CubeMX配置和HAL库为例。

步骤一：STM32CubeMX配置

1. 新建工程，选择你的STM32型号。
2. 启用SPI外设（例如SPI1），模式为“Full-Duplex Master”，硬件NSS信号选择“Disable”（我们将用软件控制CS）。
3. 根据你的连接，配置SPI1的SCK和MOSI引脚（如PA5和PA7）。
4. 将连接DC、RST、BUSY的GPIO（如PA3, PA2, PA1）配置为“GPIO_Output”（DC, RST）和“GPIO_Input”（BUSY）。
5. 配置一个定时器（如TIM2）用于基本的延时。
6. 生成代码。

步骤二：编写驱动函数在生成的代码基础上，你需要编写几个底层函数：

// spi.c/h #define EPD_SPI_HANDLE hspi1 // 你的SPI句柄 #define EPD_CS_Pin GPIO_PIN_4 #define EPD_CS_Port GPIOA #define EPD_DC_Pin GPIO_PIN_3 #define EPD_DC_Port GPIOA #define EPD_RST_Pin GPIO_PIN_2 #define EPD_RST_Port GPIOA #define EPD_BUSY_Pin GPIO_PIN_1 #define EPD_BUSY_Port GPIOA // 控制引脚宏 #define EPD_CS_Low() HAL_GPIO_WritePin(EPD_CS_Port, EPD_CS_Pin, GPIO_PIN_RESET) #define EPD_CS_High() HAL_GPIO_WritePin(EPD_CS_Port, EPD_CS_Pin, GPIO_PIN_SET) // 类似定义 EPD_DC_Low/High, EPD_RST_Low/High // 读取BUSY引脚状态 #define EPD_IsBusy() (HAL_GPIO_ReadPin(EPD_BUSY_Port, EPD_BUSY_Pin) == GPIO_PIN_SET) // 发送一个字节的命令 void EPD_SendCommand(uint8_t cmd) { EPD_DC_Low(); // DC置低，表示发送的是命令 EPD_CS_Low(); HAL_SPI_Transmit(&EPD_SPI_HANDLE, &cmd, 1, 100); EPD_CS_High(); } // 发送一个字节的数据 void EPD_SendData(uint8_t data) { EPD_DC_High(); // DC置高，表示发送的是数据 EPD_CS_Low(); HAL_SPI_Transmit(&EPD_SPI_HANDLE, &data, 1, 100); EPD_CS_High(); } // 等待屏幕空闲 void EPD_WaitUntilIdle(void) { while(EPD_IsBusy()) { HAL_Delay(10); // 忙等待，也可以结合RTOS的延时任务 } }

步骤三：实现初始化与刷新序列驱动电子纸的核心，是按照其数据手册（Datasheet）的时序图，发送正确的命令序列。这些序列通常包括：上电复位、设置面板参数、启动振荡器、设置温度补偿、设置显示区域等。每个型号的屏幕，其初始化序列可能略有不同，这通常由供应商提供。

一个简化的显示流程框架如下：

void EPD_Init(void) { // 1. 硬件复位 EPD_RST_Low(); HAL_Delay(10); EPD_RST_High(); HAL_Delay(10); // 2. 发送初始化命令序列 EPD_SendCommand(0x01); // 驱动软件控制 EPD_SendData(0x03); // 具体参数 EPD_SendData(0x00); EPD_SendData(0x2b); EPD_SendData(0x2b); EPD_SendCommand(0x06); // 升压器设置 EPD_SendData(0x17); // ... 更多命令，参考具体屏幕的驱动代码 EPD_WaitUntilIdle(); } void EPD_DisplayFrame(const uint8_t *image_buffer) { // 1. 设置RAM地址 EPD_SendCommand(0x24); // 写入黑/白像素数据 for (uint16_t i = 0; i < (EPD_WIDTH * EPD_HEIGHT / 8); i++) { EPD_SendData(image_buffer[i]); } // 2. 触发显示刷新 EPD_SendCommand(0x22); EPD_SendData(0xC7); EPD_SendCommand(0x20); // 3. 等待刷新完成 EPD_WaitUntilIdle(); }

STM32驱动避坑经验：

1. SPI时钟速度：电子纸控制器速度不快，SPI时钟频率（BaudRate）不要设置得太高，通常1-10MHz即可。太高可能导致时序错误。在CubeMX中配置SPI_BaudRatePrescaler为SPI_BAUDRATEPRESCALER_8或SPI_BAUDRATEPRESCALER_16。
2. 命令序列的准确性：初始化序列和刷新命令序列必须严格对照供应商提供的示例代码或数据手册。一个字节的错误都可能导致屏幕无显示或显示异常。最稳妥的方法是，直接使用供应商提供的针对STM32的示例工程，在其基础上修改。
3. BUSY等待的优化：在EPD_WaitUntilIdle中使用HAL_Delay是阻塞式的，在复杂系统中可能影响其他任务。如果使用RTOS（如FreeRTOS），可以将其改为非阻塞等待，在等待期间让出CPU给其他任务。
4. 图像数据格式：屏幕需要的通常是位图数据，每个bit代表一个像素（1黑0白）。你的图像数组需要是这种格式。并且要注意扫描顺序（水平扫描还是垂直扫描）和字节内比特顺序（MSB还是LSB在前），这需要与屏幕驱动要求匹配。

4. 实战项目：构建一个低功耗无线温湿度站

理解了基础驱动后，我们将其应用于一个完整的项目：一个基于树莓派 Zero W 和 2.7英寸 e-Paper HAT 的无线温湿度显示站。这个项目综合了传感器读取、网络时间同步、图像处理和低功耗显示。

项目目标：设备每小时唤醒一次，从网上获取天气和时间，读取本地传感器温湿度，更新到电子纸上，然后进入深度睡眠，实现长达数周的续航。

硬件清单：

• 树莓派 Zero W
• 2.7英寸 e-Paper HAT
• DHT22 温湿度传感器
• 移动电源或锂电池组

软件架构：

1. 主循环与休眠：使用cron定时任务或systemd timer来定期唤醒执行脚本，而不是让Python脚本一直循环。更极致的做法是使用硬件看门狗或RTC唤醒，但树莓派Zero W的深度睡眠支持有限，我们采用简单的cron+ 脚本结束后关机（halt）的方案，配合带有“通电自启”功能的移动电源来实现周期运行。不过，更实用的方案是让树莓派保持最低功耗运行，使用python脚本配合time.sleep(3600)。
2. 数据获取：
   • 温湿度：使用Adafruit_DHT库读取DHT22。
   • 时间与天气：使用requests库调用公共API。例如，获取时间可以用worldtimeapi.org，获取天气可以用openweathermap.org（需注册API Key）。
3. 图像渲染：使用PIL库绘制界面。为了优化刷新速度和功耗，我们采用分层绘制和局部刷新策略。
4. 显示更新：优先使用局部刷新更新变化的数字部分，每24次更新后强制进行一次全局刷新以消除残影。

核心代码片段与优化技巧：

import epd2in7b from PIL import Image, ImageDraw, ImageFont import Adafruit_DHT import requests import time from datetime import datetime # 初始化 epd = epd2in7b.EPD() epd.init() sensor = Adafruit_DHT.DHT22 pin = 4 # DHT22数据引脚 # 全局变量记录上次显示内容，用于判断是否需要更新 last_temp = None last_humi = None refresh_count = 0 # 局部刷新计数器 def get_sensor_data(): humidity, temperature = Adafruit_DHT.read_retry(sensor, pin) # 注意：DHT22可能返回None，需要处理异常 return (round(temperature, 1) if temperature else ‘–‘, round(humidity, 1) if humidity else ‘–‘) def get_network_time(): try: resp = requests.get(‘http://worldtimeapi.org/api/ip‘, timeout=5) data = resp.json() dt = datetime.fromisoformat(data[‘datetime‘].replace(‘Z‘, ‘+00:00‘)) return dt.strftime(‘%H:%M‘), dt.strftime(‘%m-%d‘) except: return ‘–:–‘, ‘–-–‘ def draw_display(temp, humi, current_time, date): global refresh_count # 创建图像 image = Image.new(‘1‘, (epd.width, epd.height), 255) draw = ImageDraw.Draw(image) font_large = ImageFont.truetype(‘DejaVuSans-Bold.ttf‘, 48) font_medium = ImageFont.truetype(‘DejaVuSans.ttf‘, 24) font_small = ImageFont.truetype(‘DejaVuSans.ttf‘, 18) # 绘制静态框架（只在全局刷新后绘制） if refresh_count == 0: draw.rectangle([5, 5, epd.width-5, epd.height-5], outline=0, width=2) draw.text((20, 70), “Temp:“, font=font_medium, fill=0) draw.text((20, 120), “Humi:“, font=font_medium, fill=0) draw.text((epd.width-100, 20), “Time:“, font=font_small, fill=0) draw.text((epd.width-100, 50), “Date:“, font=font_small, fill=0) # 绘制动态数据（总是绘制，但可能只刷新这部分区域） # 计算文本宽度，用于局部刷新区域定位 temp_str = f“{temp}°C“ humi_str = f“{humi}%“ time_str = current_time date_str = date # 关键优化：判断数据是否变化，只有变化才触发刷新 global last_temp, last_humi need_refresh = (last_temp != temp_str) or (last_humi != humi_str) last_temp, last_humi = temp_str, humi_str if need_refresh or refresh_count == 0: # 清除旧数据区域（用白色矩形覆盖） draw.rectangle([120, 70, 250, 110], fill=255) # 温度区域 draw.rectangle([120, 120, 250, 160], fill=255) # 湿度区域 draw.rectangle([epd.width-80, 20, epd.width-10, 45], fill=255) # 时间区域 draw.rectangle([epd.width-80, 50, epd.width-10, 75], fill=255) # 日期区域 # 绘制新数据 draw.text((120, 70), temp_str, font=font_large, fill=0) draw.text((120, 120), humi_str, font=font_large, fill=0) draw.text((epd.width-80, 20), time_str, font=font_small, fill=0) draw.text((epd.width-80, 50), date_str, font=font_small, fill=0) # 决定刷新模式 if refresh_count >= 24: # 每24次局部刷新后，做一次全局刷新 epd.display(epd.getbuffer(image)) # 全局刷新 refresh_count = 0 print(“Full refresh performed.“) else: # 注意：waveshare库的partial update可能需要特定函数 # 这里假设我们修改了库，或者使用支持局部刷新的函数 # 例如：epd.displayPartial(epd.getbuffer(image)) # 实际中，可能需要自己实现设置局部窗口并刷新的函数 # 作为示例，我们这里用全局刷新替代，但标注思路 epd.display(epd.getbuffer(image)) # 应替换为局部刷新函数 refresh_count += 1 print(f“Partial refresh #{refresh_count}“) else: print(“Data unchanged, skip refresh.“) # 让屏幕进入睡眠 epd.sleep() # 主循环 while True: temp, humi = get_sensor_data() current_time, date = get_network_time() draw_display(temp, humi, current_time, date) time.sleep(3600) # 休眠一小时

项目避坑与进阶优化：

1. 功耗是核心：树莓派 Zero W 在 idle 状态仍有约 100mA 的电流。为了真正实现长续航，可以考虑：
   • 使用树莓派 Pico W替代，其功耗可低至个位数mA。
   • 使用带有“通电自启”功能的USB定时开关，每小时通电几分钟让树莓派完成工作，然后彻底断电。
   • 禁用树莓派上不必要的硬件（如HDMI、LED灯）。
2. 局部刷新的真正实现：上面的代码中局部刷新是概念性的。你需要深入研究waveshare_epd库的源码，找到发送Partial Update命令的函数，或者直接根据屏幕数据手册，在EPD_SendCommand()层面实现局部刷新序列。这通常涉及设置RAM的X/Y地址和窗口大小。
3. 网络请求的稳定性：在get_network_time()和获取天气的函数中，必须添加超时和重试机制。网络不稳定时，应该使用上一次成功获取的数据，而不是显示空白或导致程序崩溃。
4. 图像数据的预处理：如果你要显示复杂的图形或图标，可以预先在电脑上将其转换为1位BMP格式，并生成一个C语言或Python的字节数组，直接嵌入代码中，避免在资源受限的设备上进行复杂的图像解码。
5. 残影管理策略：refresh_count机制是一个简单有效的残影管理策略。你也可以根据时间来判断，例如每24小时强制一次全局刷新。更智能的策略是监测屏幕内容的变化程度，如果大面积内容改变，则直接使用全局刷新。

通过这个项目，你将不仅仅是在驱动一个屏幕，而是在设计一个完整的、以低功耗为核心目标的嵌入式系统。从硬件选型、接口连接，到驱动编写、刷新策略优化，再到系统级的功耗管理，每一个环节都考验着对电子纸特性的理解。当你看到自己制作的设备静静地显示着信息，一周后依然有电，那种成就感是驱动一块普通LCD屏幕无法比拟的。这正是电子墨水屏的魅力所在——它用最朴素的方式，解决了信息持久显示与能耗之间的矛盾。