树莓派Pico驱动1.3寸LCD全攻略：从SPI基础到PIO性能优化-平芜编程栈

1. 项目缘起：为什么是Pico LCD 1.3？

最近在捣鼓一个需要小型显示界面的嵌入式项目，选型时，一块名为“Pico LCD 1.3”的屏幕进入了我的视野。这名字听起来就挺有意思，它通常指的是适配树莓派Pico（RP2040微控制器）的1.3英寸LCD显示屏。市面上这类屏幕很多，但真正上手后你会发现，它远不止是“一块小屏幕”那么简单。对于很多刚接触嵌入式开发，或者想给Pico项目增加一个直观交互界面的朋友来说，这块屏幕是一个性价比和易用性都相当不错的起点。它能显示文字、图形甚至简单的动画，足以胜任大多数需要状态显示、参数设置或简易菜单的项目，比如便携式气象站、迷你游戏机、智能家居控制器等等。

然而，从拿到这块裸屏到让它稳定、高效地显示你想要的内容，中间有不少门道。驱动方式的选择、显存的管理、刷新率的优化，每一个环节都可能成为新手路上的“拦路虎”。我花了不少时间折腾，从最基础的SPI驱动到利用Pico的PIO（可编程IO）来加速，踩过一些坑，也总结出一些能让开发更顺畅的经验。这篇文章，我就来详细拆解一下“Pico LCD 1.3”这个项目，从硬件连接到软件驱动，再到性能优化和实际应用，希望能帮你少走弯路。

2. 硬件拆解与连接：认识你的屏幕

首先，我们得搞清楚手里这块“Pico LCD 1.3”到底是什么。市面上常见的版本，其核心驱动芯片通常是ST7789或ST7735，屏幕分辨率多为240x240或240x135。我手头这块是240x240的ST7789驱动款，这也是目前最主流、资料最全的一种。

注意：在购买或使用前，务必确认你的屏幕具体型号（驱动IC和分辨率），这直接关系到后续的驱动代码和初始化序列。

屏幕的背面通常会有一个小小的FPC（柔性印刷电路）排线接口。为了方便与Pico连接，厂商一般会提供一个转接板，将屏幕的引脚引出成标准的2.54mm间距排母。我们来看一下最关键的几个引脚：

VCC/GND：电源，通常是3.3V。务必确保与Pico的3.3V输出连接，接5V大概率会烧毁屏幕。
SCL/SDA：这是I2C通信引脚，但请注意，对于ST7789这类彩屏，I2C通常仅用于触摸芯片（如果屏幕带触摸功能），主显示驱动并不使用I2C。不带触摸的屏幕，这两个引脚可能悬空。
SCK/MOSI：这是SPI通信的时钟线和数据线。驱动屏幕显示，主要靠SPI。
DC：数据/命令选择引脚。这是一个非常关键的引脚。当DC置为低电平时，通过SPI发送的数据会被屏幕解释为命令（如设置显示区域、睡眠模式）；当DC置为高电平时，发送的数据则是要显示的像素数据（RGB值）。如果这个引脚接错或控制逻辑反了，屏幕要么一片空白，要么显示乱码。
RST：复位引脚，低电平有效。用于硬件复位屏幕，在初始化时是必须的步骤。
CS：片选引脚，低电平有效。当你有多个SPI设备连接到同一组SPI总线时，用这个引脚来选择当前要通信的设备。如果只有屏幕一个设备，可以将其永久接地（始终选中），但在代码中规范地控制它是一个好习惯。
BL：背光控制引脚。接高电平开启背光，接低电平关闭。可以通过PWM来控制背光亮度。

典型的连接方式如下（以树莓派Pico为例）：

Pico LCD 1.3 引脚	树莓派 Pico GPIO	功能说明
VCC	3V3(OUT) (Pin 36)	3.3V电源
GND	GND (任意，如 Pin 38)	地
SCK	GPIO 2	SPI时钟
MOSI	GPIO 3	SPI主设备输出，从设备输入
DC	GPIO 4	数据/命令选择
RST	GPIO 5	复位（也可接固定3.3V，用软件命令复位）
CS	GPIO 1	片选
BL	GPIO 0	背光控制（PWM可选）

连接好后，硬件部分就准备好了。接下来就是让Pico“认识”并“驱动”这块屏幕的软件部分。

3. 软件驱动基础：从SPI初始到点亮第一像素

驱动LCD屏幕，本质上是微控制器按照特定时序，通过SPI接口向屏幕的驱动芯片（ST7789）发送一系列初始化命令和像素数据。我们不需要从零编写这些底层协议，通常可以借助现有的库。在MicroPython环境下，st7789_mpy库是一个优秀的选择；在C/C++环境下，Pico官方SDK的示例中也有相关驱动，或者使用pico_st7789之类的第三方库。

这里我以MicroPython为例，因为它交互性强，更适合快速原型验证。首先，你需要将包含st7789.py驱动文件的库上传到Pico的文件系统中。

核心的初始化与显示流程可以分为以下几步：

3.1 导入库与引脚定义

import machine import st7789 import time # 定义引脚 spi_sck = machine.Pin(2, machine.Pin.OUT) spi_mosi = machine.Pin(3, machine.Pin.OUT) spi_miso = machine.Pin(4, machine.Pin.IN) # 屏幕不需要MISO，但SPI对象需要这个参数 reset_pin = machine.Pin(5, machine.Pin.OUT) dc_pin = machine.Pin(4, machine.Pin.OUT) cs_pin = machine.Pin(1, machine.Pin.OUT) bl_pin = machine.Pin(0, machine.Pin.OUT)

3.2 初始化SPI与屏幕对象

# 初始化SPI，设置波特率（影响刷新速度） spi = machine.SPI(0, baudrate=40_000_000, polarity=1, phase=0, sck=spi_sck, mosi=spi_mosi, miso=spi_miso) # 初始化屏幕驱动对象 display = st7789.ST7789( spi, 240, # 宽度 240, # 高度 reset=reset_pin, dc=dc_pin, cs=cs_pin, backlight=bl_pin, rotation=0 # 旋转角度，0/1/2/3 分别对应0°, 90°, 180°, 270° ) # 执行硬件复位并初始化屏幕内部寄存器 display.reset() display.init() # 开启背光 bl_pin.value(1)

3.3 绘制基本图形与文字

库通常提供了基本的绘图函数：

# 1. 填充整个屏幕为某种颜色 (RGB565格式，如红色: 0xF800) display.fill(0xF800) # 红色 time.sleep(1) # 2. 在指定位置画一个矩形 display.fill_rect(50, 50, 100, 100, 0x07E0) # 绿色矩形 time.sleep(1) # 3. 画单个像素 display.pixel(120, 120, 0x001F) # 中心画一个蓝色像素 # 4. 显示文字（需要先有字库，例如内置的bitmap字库） display.text(“Hello Pico!”, 60, 110, 0xFFFF, 0x0000) # 白色字，黑色背景

执行完上述代码，你应该能看到屏幕先变红，然后出现一个绿色方块，最后显示“Hello Pico!”的文字。至此，最基本的驱动就完成了。

实操心得：baudrate（波特率）参数对显示流畅度影响巨大。一开始我用了默认的几MHz，刷屏感觉很慢。逐步提高到40MHz甚至60MHz（取决于屏幕和布线质量），动画效果就流畅多了。但要注意，过高的波特率可能导致数据出错，屏幕出现雪花点或条纹。需要根据实际情况测试一个稳定值。

4. 性能瓶颈与优化：当SPI速度遇到极限

当你尝试绘制更复杂的界面或播放动画时，可能会发现帧率很低，画面刷新缓慢。瓶颈主要出现在两个地方：一是SPI传输大量像素数据的速度，二是MicroPython本身解释执行的效率。

SPI传输优化：对于240x240的屏幕，全屏刷新一次需要传输 240 * 240 * 2 = 115,200 字节（RGB565格式每个像素2字节）。即使在40MHz的SPI时钟下，理论传输时间也要约23ms（不含命令开销），即理论最高帧率约43FPS。但MicroPython的SPI传输有 overhead，实际帧率会低很多。

MicroPython效率优化：

局部刷新：只刷新屏幕上发生变化的部分区域，而不是整个屏幕。使用fill_rect或blit（块传输）函数来更新特定区域。
使用帧缓冲区（Framebuffer）：这是最重要的优化手段。我们可以在Pico的内存中开辟一块和屏幕分辨率对应的缓冲区（bytearray），所有的绘图操作都先在这个内存缓冲区中进行。操作完成后，一次性调用display.blit_buffer()或display.show()将整个缓冲区通过SPI发送到屏幕。这样做有两个巨大好处：一是避免了频繁的小数据SPI传输带来的协议开销；二是可以实现双缓冲，在后台缓冲区绘制下一帧图像时，前台缓冲区保持显示当前帧，绘制完成后再交换，消除屏幕撕裂。
预计算与缓存：对于不变的UI元素（如背景、静态文字），可以预先绘制到缓冲区的一个副本中，需要时直接拷贝，而不是重新绘制。

下面是一个使用帧缓冲区的示例：

import framebuf # 创建一个帧缓冲区，格式为RGB565 buffer = bytearray(240 * 240 * 2) fb = framebuf.FrameBuffer(buffer, 240, 240, framebuf.RGB565) # 在帧缓冲区中绘图（这些操作都在内存中，极快） fb.fill(0x0000) # 黑色背景 fb.text(“Framebuffer Demo”, 30, 100, 0xFFFF) fb.fill_rect(80, 80, 80, 80, 0xF800) # 将整个缓冲区一次性发送到屏幕 display.blit_buffer(buffer, 0, 0, 240, 240)

使用帧缓冲区后，界面更新的流畅度会有质的提升。对于动画，你可以创建两个缓冲区，交替进行绘制和显示。

5. 进阶玩法：释放PIO的威力

即使优化了MicroPython代码和SPI传输，当需要非常高的刷新率（比如用于游戏）或需要同时驱动屏幕和其他高带宽外设时，标准的SPI外设可能仍然力不从心，或者会占用大量CPU时间。这时，树莓派Pico的秘密武器——PIO（可编程输入/输出）就该登场了。

PIO是RP2040芯片上独立于CPU的微型可编程状态机，它可以被编程来实现几乎任何同步或异步的通信协议，并且几乎不占用CPU资源。我们可以用PIO来编写一个“SPI数据泵”，专门负责以最高效、最稳定的时序将帧缓冲区中的数据“推”到LCD屏幕上。

5.1 PIO驱动SPI的原理

我们不再使用芯片硬件SPI外设，而是用PIO状态机模拟SPI的时序。优势在于：

极致速度：PIO时钟可以与系统时钟同步，达到极高的数据输出速率。
确定性延时：PIO程序的执行周期是确定的，避免了MicroPython垃圾回收或其他中断带来的时序抖动。
解放CPU：一旦启动PIO状态机，它就会自动从缓冲区中读取数据并发送，CPU可以腾出来处理业务逻辑。

5.2 一个简单的PIO SPI实现示例

这里给出一个概念性的PIO汇编程序片段（用于rp2模块）和配套的Python代码，用于并行输出RGB565数据（需要多个引脚，更复杂）。实际上，对于SPI，我们通常用PIO实现一个8位或16位的并转串输出。社区已经有成熟的库，例如pico_st7789的C语言版本就大量使用了PIO。

在MicroPython中，我们也可以利用rp2模块写PIO程序。下面是一个极度简化的思路，实际驱动需要考虑DC引脚控制、命令/数据模式切换等：

import rp2 from machine import Pin import array # 定义PIO程序，模拟SPI发送16位数据（假设DC引脚已提前设置好） @rp2.asm_pio(out_init=(rp2.PIO.OUT_LOW,)*8, out_shiftdir=rp2.PIO.SHIFT_LEFT, autopull=True, pull_thresh=16) def spi_out_16b(): set(pins, 0) # 初始引脚为低 pull(block) # 从FIFO拉取16位数据到OSR out(pins, 16) # 将OSR中的16位数据输出到引脚 nop() .side(1) # 产生一个时钟上升沿（假设SCK由side-set控制） nop() .side(0) # 时钟下降沿 # 初始化状态机 sm = rp2.StateMachine(0, spi_out_16b, freq=100_000_000, out_base=Pin(3)) # out_base是MOSI引脚起始位 # 需要配置多个引脚来并行输出，这里仅为示意 # 将像素数据放入数组 pixel_data = array.array(‘H’, [0xF800, 0x07E0, 0x001F]) # 红，绿，蓝 # 启动状态机并发送数据 sm.active(1) for pixel in pixel_data: sm.put(pixel)

重要提示：以上PIO代码仅为原理演示，一个完整的、驱动240x240 LCD的PIO程序要复杂得多，需要处理屏幕初始化命令序列、定义完整的SPI协议（包括SCK、MOSI、CS、DC）、以及高效地从内存缓冲区搬运数据。强烈建议初学者直接使用社区已经验证过的、集成了PIO驱动的成熟库，例如在C/C++环境下探索pico_st7789或pico_ssd1306等项目的源码来学习。在MicroPython中，可以寻找像micropython-st7789的某些优化分支，它们可能已经集成了PIO支持。

6. 项目实战：打造一个迷你系统状态显示器

理论说了这么多，我们来做一个综合性的小项目：用Pico LCD 1.3制作一个能显示Pico内部温度、ADC读取的电压值以及一个动态进度条的系统状态监视器。

硬件：Pico LCD 1.3，一个电位器（接ADC引脚）， Pico开发板。

软件思路：

初始化：初始化屏幕、帧缓冲区、ADC（用于读取电位器电压）、内部温度传感器。
主循环：
- 读取ADC值和内部温度。
- 在离屏缓冲区中绘制所有元素：清空背景、绘制边框和标题、以文本形式显示温度和电压值、根据电压值绘制一个水平进度条。
- 将离屏缓冲区的内容一次性blit到屏幕上。
- 短暂延时，控制刷新率（如10Hz）。

import machine import st7789 import framebuf import time import math # ... 屏幕初始化代码（同上，使用帧缓冲区） ... # 初始化ADC（假设电位器接GPIO26） adc = machine.ADC(26) # 内部温度传感器 sensor_temp = machine.ADC(4) conversion_factor = 3.3 / (65535) # 创建离屏帧缓冲区 buffer = bytearray(240 * 240 * 2) fb = framebuf.FrameBuffer(buffer, 240, 240, framebuf.RGB565) def draw_background(): """绘制静态背景""" fb.fill(0x0000) # 黑色背景 fb.rect(10, 10, 220, 220, 0xFFFF) # 白色边框 fb.text(“Pico Monitor”, 70, 30, 0x07E0) # 绿色标题 def draw_progress_bar(x, y, width, height, value, max_value): """绘制进度条，value为当前值，max_value为最大值""" # 绘制外框 fb.rect(x, y, width, height, 0xFFFF) # 计算填充长度 fill_width = int((value / max_value) * (width - 2)) # 绘制填充部分（从x+1, y+1开始） if fill_width > 0: fb.fill_rect(x+1, y+1, fill_width, height-2, 0xF800) # 红色填充 while True: # 1. 读取数据 adc_value = adc.read_u16() voltage = adc_value * conversion_factor # 读取温度（需要根据Pico手册进行公式换算） reading = sensor_temp.read_u16() * conversion_factor temperature = 27 - (reading - 0.706)/0.001721 # 2. 在离屏缓冲区绘制 draw_background() # 显示文本 fb.text(“Temp: {:.1f}C”.format(temperature), 20, 80, 0xFFFF) fb.text(“Volt: {:.2f}V”.format(voltage), 20, 110, 0xFFFF) # 绘制进度条，电压映射到0-3.3V draw_progress_bar(20, 140, 200, 20, voltage, 3.3) # 3. 更新屏幕 display.blit_buffer(buffer, 0, 0, 240, 240) # 4. 控制刷新率 time.sleep(0.1) # 约10Hz刷新

这个项目综合运用了SPI驱动、帧缓冲区、ADC读取、数据格式化显示等知识。你可以看到，通过帧缓冲区，我们轻松地组合了静态背景和动态数据，刷新过程平滑无闪烁。

7. 避坑指南与常见问题排查

在折腾Pico LCD 1.3的过程中，我遇到了一些典型问题，这里汇总一下：

屏幕白屏或完全不亮：
- 检查电源：首先确认VCC接的是3.3V，不是5V或VSYS。
- 检查背光：测量BL引脚电压，尝试将其直接接到3.3V看背光是否亮起。
- 检查复位：确保RST引脚有正确的复位序列（先拉低至少10ms，再拉高）。可以尝试在代码中显式调用display.reset()。
- 检查SPI引脚：确认SCK、MOSI、DC、CS的引脚号在代码中和实际连接完全对应。
屏幕花屏、条纹或显示错位：
- 降低SPI波特率：这是最常见的原因。过高的波特率导致时序错误。尝试将baudrate从40_000_000逐步降低到20_000_000或10_000_000。
- 检查初始化序列：不同的ST7789屏幕（尤其是来自不同厂商的）可能需要微调初始化命令。查阅屏幕供应商提供的资料，或者尝试在st7789.py驱动库中查找并替换初始化命令数组。
- 检查DC引脚逻辑：确认在发送命令和发送数据时，DC引脚的电平设置正确。
显示内容上下或左右颠倒：
- 调整旋转参数：在初始化ST7789对象时，修改rotation参数（0, 1, 2, 3）。
- 修改扫描方向：有些驱动库允许通过发送特定的命令（如MADCTL）来设置屏幕的扫描方向、颜色顺序等。这通常在驱动库的初始化方法中完成。
刷新速度慢：
- 启用帧缓冲区：这是最大的性能提升点，务必使用。
- 提高SPI波特率：在保证稳定的前提下，逐步提高。
- 局部刷新：只更新变化的区域。
- 考虑使用PIO或C语言：对于性能要求极高的应用，MicroPython可能成为瓶颈，可以考虑使用C/C++ SDK配合PIO驱动。
MicroPython内存不足：
- 240x240的RGB565帧缓冲区需要115.2KB内存，而Pico的MicroPython默认的堆内存可能不足。如果创建缓冲区失败，可以尝试在编译MicroPython固件时增加堆大小，或者使用分辨率较低的显示模式（如果屏幕支持），或者换用C语言环境。

最后，调试这类硬件问题，一个逻辑分析仪或者示波器是极好的帮手，可以直观地看到SPI总线上的时序和数据是否正确，能快速定位是硬件连接问题还是软件配置问题。从点亮第一个像素到做出流畅的交互界面，这个过程充满挑战也充满乐趣。希望这篇详细的拆解能帮你顺利搞定手中的这块“Pico LCD 1.3”，让它成为你下一个创意项目中最出彩的部分。