1. 项目概述当Pico遇上1.8寸LCD如果你手头有一块树莓派Pico或者兼容的RP2040开发板又恰好对嵌入式图形显示感兴趣那么“Pico LCD 1.8”这个组合绝对值得你花时间折腾一下。这不仅仅是在一个微小的屏幕上点亮几个像素那么简单它背后涉及的是如何在资源极其有限的微控制器MCU上高效地驱动一块SPI接口的彩色LCD并实现流畅的图形界面。最近在社区里围绕RP2040和LCD的讨论热度不减从“luckfox pico焊上一块lcd”的硬件改造到“stm32h750 dma 驱动 spi lcd 问题”的性能优化再到“基于stm32的lcd信号波形和fft频谱显示”的应用创意都说明了小型LCD在嵌入式项目中的巨大潜力。而“Pico LCD 1.8”正是踏入这个领域一个非常经典且友好的起点。这个项目适合谁呢首先是嵌入式开发的新手想通过一个具体的硬件项目来学习SPI通信、帧缓冲Framebuffer和基本图形绘制。其次是电子爱好者或创客希望为自己的Pico项目增加一个直观的人机交互界面比如显示传感器数据、制作一个迷你游戏机或者简单的状态显示器。最后即使是经验丰富的开发者在面对如何优化RP2040的双核和PIO可编程IO来极致压榨SPI LCD的刷新率时也能找到不少挑战和乐趣。接下来我将从一个完整的项目流程出发拆解从硬件连接到软件驱动再到图形应用开发的每一个环节分享我实际调试中的经验和踩过的坑。2. 硬件选型与连接不只是插上线那么简单2.1 认识你的LCD模块市面上常见的“1.8寸LCD”模块大多指的是对角线为1.8英寸的TFT液晶屏。它们通常以模块的形式出售已经集成了驱动芯片最常见的是ST7735S或ST7789V、背光电路以及一个FPC排线或插针。对于Pico项目选择带有SPI接口的模块是最方便、最主流的选择。核心驱动芯片解析 ST7735S和ST7789V是两款非常相似的控制器都支持262K色18位RGB6位每色。ST7789V通常用于分辨率稍高的屏幕比如240x320而ST7735S则常见于128x160或132x162分辨率的1.8寸屏。两者都通过SPI接口接受命令和数据其内部有一个显存GRAM我们通过SPI写入的数据就存储在这里控制器会自动按帧率将GRAM中的数据转换成LCD的驱动信号。注意购买时一定要确认模块的驱动芯片型号和分辨率。这直接关系到后续驱动库的选择和初始化序列的配置。我最初就曾误将ST7789的初始化代码用于ST7735的屏幕导致花屏排查了半天。2.2. Pico引脚分配与连接方案树莓派Pico的RP2040芯片有丰富的GPIO但并非所有都适合高速SPI。为了获得最佳性能我们应使用硬件SPI外设。Pico有两个硬件SPIspi0和spi1。一个典型的连接方案如下以spi0为例LCD引脚功能Pico GPIO备注VCC电源正极VSYS 或 3V3(OUT)接VSYS可承受5V接3V3则为3.3VGND电源地GNDSCL / SCKSPI时钟线GPIO 2 (SPI0 SCK)硬件SPI时钟必须连接指定引脚SDA / MOSISPI数据线主出从入GPIO 3 (SPI0 TX)硬件SPI数据输出必须连接指定引脚RES / RST复位线GPIO 4任何GPIO均可用于硬件复位DC / RS数据/命令选择线GPIO 5任何GPIO均可关键控制线CS片选线GPIO 1 (SPI0 CSn)硬件SPI片选或任何GPIOBL / LED背光控制GPIO 6接PWM引脚可实现亮度调节为什么这么连接SPI引脚固定RP2040的硬件SPI外设的SCK、TX、RX、CSn引脚是映射到固定GPIO的。对于spi0SCK可以是GPIO 2或18TX可以是GPIO 3或19。为了布线清晰和代码通用我推荐使用GPIO 2和3这一组。CSn虽然硬件上也有限制但在软件中我们可以用任何GPIO模拟片选更灵活。DC线的重要性这是驱动SPI LCD最关键的一根控制线。它告诉LCD控制器接下来从SPI收到的一个字节是命令Command还是数据Data。例如设置屏幕扫描方向是一个命令而填充屏幕颜色的像素值则是数据。必须用一个独立的GPIO来控制它。复位线RST虽然有些驱动库支持软件复位但硬件复位更可靠。特别是在系统上电或程序跑飞后一个硬复位能确保LCD控制器回到已知的初始状态。背光控制BL直接接VCC背光会常亮。接一个GPIO可以通过输出高/低电平来控制开关。如果接在支持PWM的引脚上如GPIO 6还能用代码analogWrite来实现无极调光这对电池供电的设备节省电量很有用。实操心得焊接或使用杜邦线连接前最好用万用表蜂鸣档检查一下LCD模块的引脚定义是否与卖家描述一致。我曾遇到过一个模块其GND和VCC的顺序印反了盲目上电差点烧毁屏幕。3. 软件驱动原理与底层代码解析3.1. SPI通信时序与初始化序列驱动LCD的第一步是与之建立正确的通信。SPI是一种同步、全双工的串行通信协议。对于LCD我们通常只使用主设备Pico发送数据到从设备LCD的模式。关键概念时钟极性CPOL与相位CPHA这决定了数据在时钟信号的哪个边沿被采样。ST7735/ST7789通常工作在CPOL0, CPHA0或CPOL1, CPHA1模式。具体需查阅数据手册但常见驱动库中SPI_MODE0CPOL0 CPHA0是默认且广泛兼容的。如果屏幕显示乱码或完全无反应检查SPI模式是首要的排查点。数据位顺序通常是MSB最高位先行。时钟频率初期调试建议先使用较低频率如10-20 MHz确保通信稳定。后续优化时可逐步提高。RP2040的SPI时钟最高可达系统时钟的一半。初始化序列Init Sequence 这是一系列预先定义好的命令和数据的组合用于配置LCD控制器的内部寄存器比如设置颜色模式、扫描方向、伽马校正等。这个序列因屏幕型号、厂商甚至批次而异。通常屏幕卖家会提供示例代码或者我们可以在开源驱动库如Adafruit_ST7735中找到对应型号的序列。一个典型的初始化流程包括执行硬件或软件复位。发送SLPOUT退出睡眠模式命令。发送COLMOD接口像素格式命令设置为16位RGB565格式这是最常用格式平衡了色彩和传输量。发送MADCTL内存访问控制命令设置扫描方向横屏/竖屏是否镜像。发送INVON/INVOFF颜色反转命令调整显示颜色。发送DISPON打开显示命令。注意事项初始化序列必须在屏幕供电稳定后发送。建议在setup()函数中完成GPIO和SPI初始化后先延时至少100ms再进行复位和发送初始化命令。匆忙的通信是导致初始化失败的主要原因之一。3.2. 核心驱动函数剖析理解了通信基础后我们来看驱动LCD最核心的三个函数写命令、写数据和设置窗口。// 伪代码示例基于常见Arduino风格库 void writeCommand(uint8_t cmd) { digitalWrite(pinDC, LOW); // DC线拉低表示接下来是命令 digitalWrite(pinCS, LOW); // 片选拉低选中设备 spi.transfer(cmd); // 通过SPI发送命令字节 digitalWrite(pinCS, HIGH); // 释放片选 } void writeData(uint8_t data) { digitalWrite(pinDC, HIGH); // DC线拉高表示接下来是数据 digitalWrite(pinCS, LOW); spi.transfer(data); digitalWrite(pinCS, HIGH); } void setAddrWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1) { // 设置将要写入数据的矩形区域 writeCommand(0x2A); // 列地址设置命令 (CASET) writeData(x0 8); writeData(x0 0xFF); // 起始列高8位低8位 writeData(x1 8); writeData(x1 0xFF); // 结束列 writeCommand(0x2B); // 行地址设置命令 (RASET) writeData(y0 8); writeData(y0 0xFF); // 起始行 writeData(y1 8); writeData(y1 0xFF); // 结束行 writeCommand(0x2C); // 内存写命令 (RAMWR)接下来发送的将是像素数据 }setAddrWindow是关键LCD控制器内部GRAM的访问是基于“窗口”的。我们首先通过CASET和RASET命令划定一个矩形区域然后发送RAMWR命令之后所有通过writeData发送的数据都会被填充到这个窗口内并自动更新行和列指针。这避免了为每个像素都重复发送地址信息极大地提高了填充矩形或绘制位图的速度。3.3. 色彩格式RGB565详解为了节省带宽和内存微控制器驱动LCD最常用的色彩格式是RGB565。它用一个16位2字节的无符号整数来表示一个像素的颜色。结构红色R占5位绿色G占6位蓝色B占5位。RRRRRGGG GGGBBBBB。优势相比24位真彩色RGB8883字节它节省了1/3的传输数据和内存占用这对Pico只有264KB的RAM来说至关重要。转换如果你有24位颜色值如#FF8800需要将其转换为RGB565。// 将8位R,G,B值转换为16位RGB565 uint16_t color ((r 0xF8) 8) | ((g 0xFC) 3) | (b 3);在填充颜色时我们需要依次发送这个16位值的高字节和低字节。4. 高级优化利用RP2040的独门绝技4.1. 使用DMA解放CPU“stm32h750 dma 驱动 spi lcd 问题”这个热词点出了驱动LCD的一个高级话题——使用DMA直接内存访问。RP2040同样拥有强大的DMA控制器。其原理是CPU只需要配置好DMA通道的源地址存放像素数据的数组、目标地址SPI发送数据寄存器、传输数据量然后启动DMA。DMA控制器会在后台自动将数据从内存搬运到SPI外设无需CPU干预。在此期间CPU可以执行其他任务比如处理传感器数据、运行游戏逻辑等从而实现“并行”操作。Pico SDK中的DMA-SPI配置思路初始化SPI为DMA模式。准备一个像素数据缓冲区uint16_t buffer[SCREEN_HEIGHT][SCREEN_WIDTH]这就是我们的帧缓冲Framebuffer。当一帧图像准备好后配置DMA源地址指向buffer目标地址指向SPI_DR数据寄存器数据量是width * height * 2字节因为每个像素2字节。启动DMA传输。在DMA传输完成中断中准备下一帧数据或进行其他同步操作。实操心得使用DMA时要确保像素数据缓冲区位于物理连续的内存中并且对齐到合适的边界通常4字节或32字节对齐这能提升DMA效率。Pico SDK的malloc默认分配的内存可能不保证强对齐可以使用aligned_alloc函数。4.2. 探索PIO可编程IO的极限RP2040最革命性的特性是PIO。我们可以用PIO状态机来模拟或增强外设功能。对于驱动LCD一个有趣的想法是用PIO状态机来生成SPI时钟和数据信号甚至实现“位拆裂”Bit Banging协议。为什么用PIO极致时序控制PIO指令的执行周期是确定的系统时钟分频后。你可以编写精确到纳秒级别的波形这对于驱动一些时序苛刻的非标准SPI变种或8080并行接口屏幕非常有用。减轻CPU负担与DMA类似一旦PIO程序启动状态机会自动运行CPU可以去做别的事。甚至可以将PIO与DMA结合让DMA自动喂数据给PIO状态机实现完全硬件加速的图形数据流。灵活性如果你的项目需要驱动多个SPI设备而硬件SPI外设不够用用PIO可以“创造”出额外的软件SPI且性能远高于用CPU循环模拟。一个简单的PIO SPI发送程序可能包含循环从FIFO先入先出队列取出数据字节然后通过一个循环在8个时钟周期内依次将数据的每个位移出到MOSI引脚同时在SCK引脚产生时钟脉冲。注意事项PIO编程需要学习其独特的汇编指令集。对于标准SPI驱动使用硬件SPIDMA通常已经足够高效且简单。PIO更适合作为解决特殊协议需求或性能瓶颈时的进阶工具。不建议初学者一开始就深陷PIO先从标准的Arduino库或Pico SDK的硬件SPI入手更稳妥。5. 图形库与用户界面构建5.1. 选择合适的图形库直接操作帧缓冲来画点、线、矩形和文字是非常底层的。为了高效开发我们应引入图形库。对于Pico有几个主流选择LVGL一个功能极其强大的开源嵌入式图形库支持动画、抗锯齿、多种字体、主题样式、触摸事件等资源消耗相对较大但对于创建复杂的用户界面UI是首选。它需要你提供一个“刷屏”函数flush_cb在这个函数里LVGL会将需要更新的区域像素数据传递给你由你负责通过SPI发送到LCD。这正是前面讲的setAddrWindow和DMA用武之地。U8g2专注于单色显示屏但通过其“全缓冲模式”也能驱动彩色LCD。它更轻量内置了大量字体和绘图函数适合显示文本、简单图标和图表。如果你的项目主要是数据展示U8g2是个好选择。自定义轻量级库如果你只需要画点、线、矩形、圆形和显示位图完全可以自己封装一个。例如实现一个drawPixel(x, y, color)函数它会更新帧缓冲数组再实现一个updateScreen()或refreshArea(x, y, w, h)函数负责将帧缓冲的特定区域或全部数据发送到LCD。选型建议追求丰富UI和交互选择LVGL。需要仔细配置其内存池用于图形对象、样式等、帧缓冲并实现刷屏和触摸如果有驱动。专注数据监控和文本显示选择U8g2。配置简单API直观。学习底层或需求极简自己实现基础绘图函数。这是理解图形显示原理的最佳途径。5.2. 实现帧缓冲与局部刷新无论用哪个库帧缓冲Framebuffer的概念都至关重要。它是一个存储在RAM中的二维数组大小与屏幕分辨率一致每个元素对应屏幕上一个像素的RGB565值。双缓冲Double Buffering 这是实现流畅动画的关键技术。我们创建两个帧缓冲front_buffer前台缓冲和back_buffer后台缓冲。CPU在back_buffer上绘制下一帧图像。绘制完成后启动DMA将back_buffer的数据传输到LCD。在DMA传输期间CPU可以开始准备下一帧到另一个缓冲此时角色互换。 这样可以避免屏幕在绘制过程中出现撕裂一部分是上一帧一部分是下一帧。局部刷新Partial Update 全屏刷新即使只改了一个像素传输数据量是320*240*2 153600字节在10MHz SPI下需要约123ms帧率不到10FPS。如果UI只有一小部分变化如一个按钮高亮我们可以只刷新变化的矩形区域。这就是setAddrWindow的价值所在。LVGL等高级库内部就实现了局部刷新它只将脏区dirty area的像素数据传给刷屏回调函数极大地提升了效率。实操心得在资源紧张的Pico上全尺寸的双帧缓冲对于240x320屏幕约300KB会占用几乎所有RAM导致程序无法运行。此时可以采用折中方案使用单帧缓冲并结合LVGL的局部刷新机制或者降低显示分辨率或者使用“行缓冲”DMA乒乓传输等更复杂的技术。6. 实战项目构建一个系统监视器让我们将以上所有知识融合创建一个实用的项目一个基于Pico和1.8寸LCD的系统监视器实时显示Pico的CPU温度、核心电压以及自定义的模拟信号波形类似“基于stm32的lcd信号波形和fft频谱显示”的简易版。6.1. 硬件与软件架构硬件Pico开发板1.8寸 SPI LCDST7789V240x320一个电位器用于模拟信号输入。软件架构底层驱动层基于Pico SDK或Arduino框架实现SPI初始化、LCD初始化、setAddrWindow、DMA传输函数。图形库层集成LVGL。配置其内存、实现刷屏驱动调用我们的DMA函数、实现触摸驱动本项目暂不需要。应用层任务A核心0负责数据采集。循环读取Pico内部ADC的温度传感器和电压传感器读取连接电位器的ADC引脚值计算波形数据或简单的FFT如果计算量允许。任务B核心1或主循环负责UI渲染。运行LVGL任务处理器lv_timer_handler根据采集到的数据更新UI上的标签、进度条和波形图控件。6.2. 关键代码片段与解析1. 刷屏回调函数LVGL驱动核心static void disp_flush(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p) { // area: 需要更新的区域 // color_p: LVGL已经渲染好的该区域的像素数据数组 uint32_t width lv_area_get_width(area); uint32_t height lv_area_get_height(area); uint32_t num_pixels width * height; // 1. 设置LCD的更新窗口为这个区域 setAddrWindow(area-x1, area-y1, area-x2, area-y2); // 2. 启动DMA将color_p中的数据发送到SPI start_spi_dma_transfer((uint8_t*)color_p, num_pixels * 2); // 每个像素2字节 // 3. 告诉LVGL刷新已完成需要在DMA传输完成中断中调用 // lv_disp_flush_ready(disp_drv); }注意lv_disp_flush_ready必须在像素数据真正被发送完毕后才能调用通常放在DMA传输完成中断服务程序ISR中。如果立即调用LVGL可能会覆盖还在传输中的数据。2. 数据采集与UI更新void data_acquisition_task() { while (1) { // 读取CPU温度 float temp read_onboard_temperature(); // 读取核心电压 float voltage read_core_voltage(); // 读取ADC电位器值 uint16_t adc_val read_potentiometer(); // 将数据存入全局变量或队列 current_temperature temp; current_voltage voltage; adc_buffer[adc_index] adc_val; adc_index (adc_index 1) % ADC_BUFFER_SIZE; // 唤醒UI任务或设置标志位 update_ui_flag true; sleep_ms(50); // 20Hz采样率 } } void ui_task() { lv_init(); // ... 初始化显示驱动和输入设备驱动 ... lv_disp_t * disp lv_disp_drv_register(disp_drv); // 创建UI标签、进度条、图表 lv_obj_t * temp_label lv_label_create(lv_scr_act()); lv_obj_t * volt_label lv_label_create(lv_scr_act()); lv_obj_t * waveform_chart lv_chart_create(lv_scr_act()); lv_chart_set_point_count(waveform_chart, ADC_BUFFER_SIZE); while (1) { lv_timer_handler(); // 处理LVGL定时器和任务 sleep_ms(5); if (update_ui_flag) { update_ui_flag false; // 更新温度标签 lv_label_set_text_fmt(temp_label, Temp: %.1f C, current_temperature); // 更新电压标签 lv_label_set_text_fmt(volt_label, Volt: %.2f V, current_voltage); // 更新波形图 lv_chart_set_next_value(waveform_chart, lv_chart_get_series_next(waveform_chart, NULL), adc_buffer[adc_index]); } } }6.3. 性能优化与调试在这个项目中性能瓶颈可能出现在SPI刷新率使用DMA并尽可能提高SPI时钟在稳定前提下是提升帧率的关键。实测在62.5MHz系统时钟下SPI时钟设为31.25MHz驱动240x320屏幕局部刷新小区域UI可以非常流畅。LVGL刷新策略确保lv_disp_flush_ready在DMA完成后及时调用避免LVGL任务阻塞。可以适当增加LVGL的任务处理周期但不要低于5ms。双核利用正如上面架构所示将数据采集可能涉及ADC和计算放在一个核心UI渲染放在另一个核心或主循环能有效避免任务相互阻塞。内存管理LVGL对象创建和删除要小心避免内存碎片。对于不变的UI部分在初始化时创建好即可。常见问题排查如果屏幕出现花屏、错位或颜色异常按以下顺序检查电源和连接确保VCC和GND稳定所有信号线连接牢固。初始化序列确认使用的序列与你的屏幕型号ST7735S/ST7789V和具体变体如偏移、扫描方向匹配。很多问题源于错误的MADCTL参数。SPI配置检查时钟极性/相位CPOL/CPHA、位顺序MSB/LSB First和时钟频率。色彩格式确认你发送的是RGB565格式16位并且高低字节顺序是否正确。有些屏幕驱动芯片需要先高字节后低字节有些则相反。DMA/PIO配置如果使用了DMA检查缓冲区地址、传输大小是否正确是否发生了内存越界。如果使用了PIO用逻辑分析仪抓取SPI波形是最直接的调试手段。通过这个完整的“Pico LCD 1.8”项目我们从硬件连接到底层驱动再到高级优化和图形应用开发走通了一个嵌入式图形界面项目的全流程。最关键的不是记住每一个命令而是理解其背后的原理SPI通信、帧缓冲、DMA加速、任务拆分。掌握了这些你就能灵活应对不同的屏幕和更复杂的应用需求真正让这块小屏幕在你的项目中焕发光彩。
