树莓派Pico驱动2.66英寸电子墨水屏：SPI通信与MicroPython实战

1. 项目概述：Pico e-Paper 2.66 是什么？

如果你手头有一块树莓派 Pico 或者类似的 RP2040 开发板，又恰好对低功耗、类纸显示效果感兴趣，那么“Pico e-Paper 2.66”这个项目绝对值得你花时间折腾一下。简单来说，这就是一个驱动 2.66 英寸电子墨水屏（e-Paper）的完整方案。电子墨水屏大家应该不陌生，像 Kindle、电子价签用的就是这种技术，它的最大特点就是只在刷新画面时才耗电，显示内容时完全零功耗，而且视觉上非常接近真实纸张，不伤眼。

这个项目的核心，就是利用 Pico 的硬件资源，通过 SPI 通信协议，去驱动一块分辨率通常为 296x152 的黑白（或黑/白/红三色）电子墨水屏。为什么是 SPI？因为对于微控制器来说，SPI 是驱动这类外设最常用、最高效的接口之一，它速度快、协议相对简单，而且 Pico 有多个硬件 SPI 接口，用起来非常方便。网络上搜索热度这么高，也恰恰说明了大家对如何在嵌入式设备上玩转 e-Paper 有强烈的实践需求，从基础的 SPI 通信调试，到具体的驱动编写、性能优化，都是大家关心的点。

这个项目适合谁呢？首先是嵌入式爱好者，你想给自己的物联网小设备加一个超低功耗的显示屏来显示状态信息。其次是创客和学生，想做一个无需频繁充电的天气站、日程提醒器或者简易阅读器。最后，哪怕你只是想深入学习一下 SPI 通信协议和微控制器驱动外设的完整流程，这个项目也是一个绝佳的、有可视成果的练手案例。接下来，我会把我从硬件连接到软件驱动，再到实际应用和问题排查的全过程经验，毫无保留地分享给你。

2. 核心硬件解析与连接方案

2.1 电子墨水屏（e-Paper）工作原理浅析

在动手接线之前，我们有必要简单了解一下电子墨水屏是怎么工作的。这能帮你理解后续驱动代码里那些“神秘”的指令序列。e-Paper 内部有数百万个微胶囊，每个胶囊里包含带正电的白色粒子和带负电的黑色粒子，悬浮在透明液体中。通过在不同位置的上下电极施加电压，可以控制黑白粒子上下移动，从而形成图像。

关键点来了：一旦粒子移动到目标位置，即使撤掉电压，由于介电泳力和范德华力的作用，它们也能保持住，这就是“双稳态”特性，也是零功耗显示的物理基础。但是，刷新过程（即粒子移动）本身是耗电的，而且为了确保显示效果，刷新时需要一套复杂的电压波形来驱动，这个波形序列通常由屏幕控制器（比如我们常用的 SSD1680）管理，我们通过 SPI 发送指令和数据来指挥控制器。

所以，我们的驱动代码核心任务有两个：一是通过 SPI 发送正确的初始化序列和波形数据（LUT）到控制器；二是在需要更新屏幕时，发送新的图像数据。屏幕的“慢”（刷新需要几百毫秒到几秒）和“闪”（全屏刷新时会有一次黑白反相的过程）是物理特性，无法改变，但我们可以通过优化刷新策略（如局部刷新）来改善体验。

2.2 硬件清单与接口定义

要完成这个项目，你需要准备以下硬件：

1. 主控板：树莓派 Pico（或其他基于 RP2040 的开发板）。这是核心大脑。
2. 显示屏：2.66 英寸 e-Paper 模块。常见型号如 GDEY0266T90，支持黑白红三色。务必确认你的屏幕驱动芯片型号，最常见的是 SSD1680，但也有其他型号，驱动代码会有差异。
3. 连接线：杜邦线（母对母）若干，用于连接 Pico 和屏幕。
4. 电源：Pico 可通过 USB 供电，但要注意，e-Paper 在刷新瞬间需要较大的电流（可能高达几十毫安），USB 供电通常足够，但为了稳定，建议使用质量较好的 USB 电源或电池。

屏幕模块通常会引出以下几个关键引脚：

• VCC：电源正极，接 3.3V。绝对不要接5V！大部分 e-Paper 模块是 3.3V 逻辑电平。
• GND：电源地，与 Pico 共地。
• DIN (MOSI)：SPI 数据输入线，主设备输出，从设备输入。
• CLK (SCK)：SPI 时钟线。
• CS (CS)：片选信号，低电平有效。
• DC (D/C)：数据/命令选择线。用于告诉屏幕控制器，接下来发送的是命令（低电平）还是数据（高电平）。这是 SPI 驱动外设时非常关键的一根线。
• RST (RESET)：复位引脚，低电平复位。通常用于初始化或唤醒屏幕。
• BUSY：忙状态引脚。屏幕在执行刷新等操作时，此引脚会输出高电平（或低电平，具体看屏幕规格），告诉主控“我正在忙，别打扰”。这个引脚必须接，并且代码里必须检测它，否则会导致发送数据时序错误。

2.3 Pico 与 e-Paper 的 SPI 连接实战

Pico 有两个硬件 SPI 接口：spi0和spi1。我们可以任选一个。这里以使用spi0为例，这也是最常用的选择。

接线示意图如下（请根据你的屏幕实际引脚名称调整）：

注意：上表中 GP5、GP6、GP7 是我随意选择的 GPIO，你可以根据布线方便选择其他未被占用的 GPIO。但 CS、SCK、MOSI 这三个 SPI 核心引脚必须连接到 Pico 指定 SPI 接口的对应引脚上。例如spi0的 MOSI、SCK、CS 固定是 GP0、GP1、GP2（或 GP3、GP4、GP5，取决于 set 函数配置）。

连接时的实操心得：

1. 先断电再接线：这是铁律，防止误接短路烧毁设备。
2. GND 最先接，最后断：确保共地，避免因电势差导致逻辑错误甚至损坏。
3. BUSY 引脚必须接：我见过不少人因为屏幕不显示而头疼，最后发现是忘了接或没正确读取 BUSY 引脚。屏幕刷新很慢，不等待 BUSY 信号就发送后续指令，控制器根本来不及处理。
4. 电源质量：刷新瞬间电流较大，如果使用劣质 USB 线或电源，可能导致电压骤降，引起 Pico 复位或屏幕刷新异常。如果遇到不稳定情况，这是首要排查点。

3. 软件驱动开发与核心代码解析

硬件连接妥当后，就进入了软件部分。我们将使用 MicroPython 进行开发，因为它交互性强，代码易懂，非常适合快速原型开发。

3.1 开发环境搭建与 MicroPython 固件烧录

1. 下载固件：前往树莓派基金会官网，下载最新的 Pico MicroPython 固件（.uf2文件）。
2. 烧录固件：按住 Pico 板上的BOOTSEL按钮不放，然后通过 USB 连接到电脑。松开按钮后，电脑会出现一个名为RPI-RP2的U盘。将下载的.uf2文件拖入该U盘，Pico 会自动重启并运行 MicroPython。
3. 选择开发工具：推荐使用 Thonny IDE。它轻量、免费，并且内置了 MicroPython 支持。安装后，在 Thonny 的右下角选择解释器为 “MicroPython (Raspberry Pi Pico)”，并选择正确的串口。

3.2 SPI 初始化与基础通信函数

在 MicroPython 中，我们需要先初始化 SPI 和相关的 GPIO 引脚。

from machine import Pin, SPI import time # 定义引脚 epd_cs = Pin(2, Pin.OUT) # SPI CS epd_dc = Pin(5, Pin.OUT) # Data/Command epd_rst = Pin(6, Pin.OUT) # Reset epd_busy = Pin(7, Pin.IN) # Busy (输入模式！) # 初始化 SPI， 使用 spi0， 频率设为 1 MHz (e-Paper 通常不高) spi = SPI(0, baudrate=1_000_000, polarity=0, phase=0, bits=8, firstbit=SPI.MSB, sck=Pin(1), mosi=Pin(0), miso=None) # 因为我们不需要读取，miso 设为 None epd_cs.value(1) # 初始时片选置高（不选中） def send_command(cmd): """发送命令""" epd_dc.value(0) # DC 置低，表示命令 epd_cs.value(0) # 片选置低，开始通信 spi.write(bytearray([cmd])) epd_cs.value(1) # 片选置高，结束通信 def send_data(data): """发送数据，可以是单个字节或字节数组""" epd_dc.value(1) # DC 置高，表示数据 epd_cs.value(0) if isinstance(data, int): spi.write(bytearray([data])) else: spi.write(data) epd_cs.value(1) def wait_until_idle(): """等待屏幕忙信号结束""" while epd_busy.value() == 1: # 假设 busy=1 表示忙，具体看屏幕手册 time.sleep_ms(10) # 或者 busy=0 表示忙，则判断条件为 `while epd_busy.value() == 0:` # 务必查阅你的屏幕数据手册确认！

代码解析与注意事项：

• polarity=0, phase=0：这是 SPI 的模式 0，是大多数 SPI 设备（包括 SSD1680）最常用的模式。这是最容易出错的地方之一，如果模式不对，通信完全无法进行。如果你不确定，模式 0 是首选的尝试。
• baudrate=1_000_000：1MHz 的速率对于 e-Paper 足够了。一开始可以设低一些（比如 100kHz）以确保通信稳定，后续再提高。
• wait_until_idle()函数至关重要。在发送任何可能触发长时间操作（如刷新）的命令后，都必须调用此函数等待屏幕准备好。

3.3 e-Paper 驱动库核心实现

下面我们构建一个简化的驱动类，包含初始化、清屏、显示图像和休眠等基本功能。

class EPD_2in66: def __init__(self): self.width = 296 self.height = 152 self.reset_pin = epd_rst self.dc_pin = epd_dc self.busy_pin = epd_busy self.cs_pin = epd_cs self.spi = spi self.init() def reset(self): """硬件复位""" self.reset_pin.value(1) time.sleep_ms(20) self.reset_pin.value(0) time.sleep_ms(2) self.reset_pin.value(1) time.sleep_ms(20) def init(self): """初始化屏幕""" self.reset() # 硬件复位 self.wait_until_idle() # 以下指令序列需要根据你的具体屏幕型号（SSD1680）的数据手册来编写 # 这里是一个示例序列，可能不适用于你的屏幕，请务必替换！ send_command(0x12) # 软件复位 self.wait_until_idle() send_command(0x01) # 驱动器输出控制 send_data(0x27) send_data(0x01) send_data(0x00) send_command(0x11) # 数据入口模式 send_data(0x03) # 地址自增，Y方向更新 # ... 更多初始化命令，如设置LUT（查找表）、边框控制等 # 通常厂家会提供完整的初始化代码片段 print("EPD init finished.") def wait_until_idle(self): """等待屏幕空闲""" while self.busy_pin.value() == 1: # 再次确认你的屏幕忙信号极性 time.sleep_ms(10) time.sleep_ms(200) # 额外等待一小段时间确保稳定 def clear(self, color=0): """清屏，color=0白色，1黑色""" buf = [color] * (self.width * self.height // 8) # 创建缓冲区 self.display(buf) def display(self, image_buffer): """显示图像数据""" # 1. 发送命令，准备接收图像数据 send_command(0x24) # 写入黑白位图数据 for i in range(0, len(image_buffer)): send_data(image_buffer[i]) # 2. 触发显示刷新 send_command(0x22) send_data(0xC7) # 刷新显示 send_command(0x20) self.wait_until_idle() # 必须等待刷新完成！ print("Display update complete.") def sleep(self): """进入深度睡眠模式以省电""" send_command(0x10) send_data(0x01) time.sleep_ms(100)

关键点解析：

1. 初始化序列：这是驱动屏幕最核心也是最“黑盒”的部分。你必须找到对应屏幕型号（如 GDEY0266T90 搭配 SSD1680）的官方数据手册或厂家提供的示例代码。序列里的每一个命令（0x12， 0x01等）和数据都有特定含义，设置着驱动电压、扫描方式、LUT 等参数。切勿随意使用其他屏幕的初始化代码，否则可能导致显示异常甚至损坏屏幕。
2. 图像缓冲区：image_buffer是一个字节数组（bytearray）。对于单色屏幕，每个比特（bit）代表一个像素（1为黑，0为白）。因为屏幕宽 296 像素，高 152 像素，总像素为 296*152=44992。每个字节有8位，所以缓冲区大小是 44992 / 8 = 5624 字节。在clear函数中，我们创建了一个全是 0x00（白色）或 0xFF（黑色）的缓冲区。
3. 刷新流程：先发送0x24命令，接着发送整个图像缓冲区数据，然后发送0x22和0xC7来触发刷新，最后发送0x20并等待BUSY信号结束。这个流程是标准操作。

3.4 创建与转换显示图像

我们如何在电脑上准备一张图片，并转换成屏幕能识别的字节数组呢？这里提供一个实用的方法。

1. 使用 Python PIL 库进行预处理（在电脑上运行）：

from PIL import Image import numpy as np def convert_image_for_epd(image_path, output_width=296, output_height=152): # 1. 打开图片并转换为灰度图 img = Image.open(image_path).convert('L') # 2. 调整尺寸（注意保持宽高比，可能需要裁剪） img = img.resize((output_width, output_height), Image.Resampling.LANCZOS) # 3. 二值化（阈值可根据图片调整） threshold = 128 img = img.point(lambda p: 0 if p > threshold else 1, mode='1') # 4. 转换为字节数组（按行，MSB在前） img_data = np.array(img, dtype=np.uint8) # 将二维数组（152行，296列）转换为一维字节数组 # 每行296个像素 -> 37个字节 (296/8=37) bytes_per_row = output_width // 8 buffer = bytearray() for y in range(output_height): for x_byte in range(bytes_per_row): byte_val = 0 for bit in range(8): pixel_x = x_byte * 8 + bit if pixel_x < output_width and img_data[y, pixel_x]: byte_val |= (0x80 >> bit) # 设置对应的位为1（黑色） buffer.append(byte_val) return buffer # 示例：转换一张图片 buf = convert_image_for_epd("your_logo.png") # 将 buf 保存为二进制文件，或者直接嵌入到 MicroPython 代码中 with open("image.bin", "wb") as f: f.write(buf)

2. 在 MicroPython 中加载图像数据： 你可以将生成的image.bin文件拖入到 Pico 的文件系统中（在 Thonny 中可以看到 Pico 的文件视图）。然后在主程序中读取并显示。

def display_from_file(filename): with open(filename, 'rb') as f: img_data = f.read() epd = EPD_2in66() epd.display(img_data) epd.sleep() # 显示完后让屏幕休眠

4. 典型问题排查与性能优化技巧

即使按照步骤操作，你也可能会遇到一些问题。这里我总结了一些常见坑点和解决方案。

4.1 通信失败与无显示问题排查表

4.2 性能优化与省电策略

1. 局部刷新：如果只更新屏幕的一小部分（如数字时钟的秒位），全屏刷新既慢又耗电（且会全屏闪烁）。部分 e-Paper 控制器支持局部刷新。你需要查阅数据手册，使用特定的命令序列设置局部刷新区域，然后只发送该区域的数据。这能极大提升刷新速度和用户体验。
2. 优化图像数据发送：MicroPython 的spi.write()在发送大块数据时效率尚可。但如果你需要极致的速度，可以考虑使用memoryview来避免数据复制，或者研究 Pico 的 PIO（可编程 IO）来模拟 SPI，实现更底层的控制（但对于 1MHz 的 e-Paper，通常没必要）。
3. 深度睡眠与唤醒：在电池供电的场景下，让 Pico 在两次显示更新间隔也进入睡眠模式（machine.lightsleep()或machine.deepsleep()）可以大幅延长续航。注意配置一个外部中断（如按键或 RTC 定时）来唤醒 Pico，然后 Pico 再去唤醒和驱动 e-Paper。
4. 帧缓冲区管理：对于复杂 UI，可以在 Pico 的内存中维护一个完整的“帧缓冲区”（framebuffer）。所有绘图操作（画线、写字、图片）都先在这个缓冲区进行，最后一次性调用display()将整个缓冲区发送到屏幕。MicroPython 有framebuf库可以方便地实现这一点。

4.3 进阶功能：显示文本与图形

直接操作字节缓冲区来画图非常麻烦。我们可以利用 MicroPython 自带的framebuf模块。

import framebuf # 创建一个与屏幕大小匹配的帧缓冲区 buf = bytearray(296 * 152 // 8) # 5624 bytes fb = framebuf.FrameBuffer(buf, 296, 152, framebuf.MONO_HLSB) # 注意格式：MONO_HLSB 表示水平扫描，字节内 LSB 在前。可能需要根据屏幕调整。 # 现在可以在 fb 上作画了 fb.fill(0) # 填充白色 fb.text('Hello Pico!', 10, 10, 1) # 在 (10,10) 位置用黑色(1)写文字 fb.hline(0, 30, 296, 1) # 画一条黑线 fb.rect(50, 50, 100, 60, 1) # 画一个矩形框 # 将帧缓冲区内容发送到屏幕显示 epd = EPD_2in66() epd.display(buf) # 注意：这里直接传 buf，而不是 fb 对象 epd.sleep()

使用framebuf可以极大地简化图形和文本的绘制。关键是理解framebuf.FrameBuffer的格式参数（MONO_HLSB,MONO_HMSB等），它定义了字节中比特与像素的映射关系，这必须与你的 e-Paper 驱动期望的格式匹配，否则显示会旋转或镜像。

驱动一块 e-Paper 屏幕就像是在和一位慢性子的艺术家合作。你需要耐心地按照它的“工作手册”（数据手册）发出精确的指令，并耐心等待它完成每一笔绘画。整个过程融合了硬件接口知识、通信协议理解和软件时序控制，当最终看到清晰的图案在纸一般的屏幕上缓缓呈现时，那种成就感是对所有调试工作最好的回报。希望这份详细的指南能帮你绕过我踩过的那些坑，顺利点亮你的 Pico e-Paper 项目。如果在实践中遇到新的问题，不妨回头仔细看看 BUSY 引脚和初始化序列，这两个地方是绝大多数问题的根源。