基于 RT-Thread 的 Raspberry Pi Pico 运行 LVGL 图形界面:ST7789 SPI 屏移植全指南

发布时间:2026/9/25 10:43:02

基于 RT-Thread 的 Raspberry Pi Pico 运行 LVGL 图形界面:ST7789 SPI 屏移植全指南 操作系统嵌入式物联网嵌入式OSRTOS【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址https://gitcode.com/gh_mirrors/rt/rt-thread点击查看免费下载本篇技术指南以 RT-Thread 仓库中bsp/raspberry-pico/RP2040/applications/lvgl目录下的官方文档与配套源码为骨架系统讲解如何在 Raspberry Pi Pico 上通过 RT-Thread Studio 使能并移植 LVGL 图形库驱动 ST7789 SPI 接口 TFT-LCD 屏幕。读完本文你将掌握完整的操作路径在 RT-Thread Settings 中开启 LVGL、配置屏幕分辨率与方向、对接 LVGL 显示刷新接口与按键输入设备并最终在 240×240 屏幕上运行 LVGL 官方音乐播放器演示。一、硬件准备Pico 主板与 ST7789 屏幕1.1 Raspberry Pi Pico 核心参数本项目基于 Raspberry Pi PicoRP2040 芯片其关键硬件参数如下双核 Arm Cortex-M0主频 133MHz芯片内置 264KB SRAM 与 2MB 板载闪存通过专用 QSPI 总线支持最高 16MB 片外闪存内置 DMA 控制器30 个 GPIO 引脚其中 4 个可用作模拟输入2 个 UART、2 个 SPI 控制器、2 个 I2C 控制器16 个 PWM 通道这些资源为 LVGL 运行提供了基础264KB SRAM 足以承载 LVGL 的绘制缓冲区与对象树双核 Cortex-M0 保证界面渲染与 RT-Thread 调度互不阻塞。1.2 ST7789 SPI 屏幕规格本文使用的拓展屏为ST7789 SPI 接口 TFT-LCD这是一颗单芯片 TFT-LCD 控制器/驱动器核心规格如下显示分辨率240 × RGB (H) × 320 (V)帧内存Frame Memory大小240 × 320 × 18-bit 1,382,400 bitsLCD 驱动输出电路Source 输出240 RGB 通道Gate 输出320 通道公共电极输出Common Electrode OutputST7789 支持 SPI 串行接口仅需 4~5 根信号线即可驱动非常适合 Pico 这类引脚资源有限的开发板。1.3 引脚接线对照表从仓库中的 drv_lcd.h 可以提取出本工程实际的接线定义接线时请对照此表信号Pico GPIO 引脚说明LCD_RST_PIN12屏幕硬件复位LCD_DC_PIN8数据/命令选择LCD_CS_PIN9片选LCD_CLK_PIN10SPI 时钟SCLKLCD_MOSI_PIN11SPI 数据输出MOSILCD_BL_PIN13背光PWM 控制同时drv_lcd.h 中还定义了屏幕尺寸与显示方向宏#define LCD_HEIGHT 240 #define LCD_WIDTH 240 #define HORIZONTAL 0 #define VERTICAL 1注意虽然 ST7789 原生分辨率为 240×320但本项目使用的屏幕模组实际可视区域为240×240驱动代码中以LCD_WIDTH/LCD_HEIGHT均为 240 配置这也是后续 LVGL 分辨率设置为 240×240 的原因。二、软件环境搭建运行本示例需要以下软件组件RT-Thread IoT OS本仓库即是 RT-Thread 官方内核源码Pico BSP 位于 bsp/raspberry-pico 目录RT-Thread Studio IDE免费版用于工程创建、配置与编译烧录LVGL开源的嵌入式图形库本工程通过 RT-Thread 软件包管理集成示例中为 LVGL v8.x 版本源码位于packages/LVGL-v8.1.0软件包目录。在 RT-Thread Studio 中导入本 BSP 工程后即可开始以下配置流程。三、使能 LVGL for LCD在 RT-Thread Studio 中打开工程的RT-Thread Settings配置页在「硬件」分类下的配置树中展开Hardware Drivers Config → Onboard Peripheral Drivers找到Enable LVGL for LCD配置项并将其勾选该配置项对应的源码依赖关系体现在 lvgl/SConscript 中group group DefineGroup(LVGL-port, src, depend [BSP_USING_LVGL], CPPPATH CPPPATH)即只有定义了BSP_USING_LVGL由上述配置项生成时lv_conf.h、lv_port_disp.c、lv_port_indev.c等 LVGL 移植文件才会被编译进工程。同时该目录还会递归加载demo/子目录下的演示源码。四、配置屏幕参数使能 LVGL 后需要根据实际屏幕规格配置分辨率与显示方向。本教程使用 ST7789屏幕实际尺寸为 240×240。在 drv_lcd.h 中通过LCD_HEIGHT、LCD_WIDTH两个宏定义选择屏幕尺寸通过HORIZONTAL/VERTICAL选择显示方向与屏幕物理参数相对应LVGL 侧的配置位于 lv_conf.h#define LV_COLOR_DEPTH 16 /* 16 位色深 RGB565 */ #define LV_COLOR_16_SWAP 1 /* 高低字节交换匹配 ST7789 RGB565 时序 */ #define LV_HOR_RES_MAX 240 /* 水平最大分辨率 */ #define LV_VER_RES_MAX 240 /* 垂直最大分辨率 */ #define LV_USE_PERF_MONITOR 1 /* 启用性能监视器可在屏幕角落显示 FPS */这里需要解释两个关键配置的作用LV_COLOR_DEPTH 16LVGL 以 16 位 RGB565 格式绘制与 ST7789 的 16 位 SPI 像素数据格式一一对应一次spi_write_blocking即可写入一个像素LV_COLOR_16_SWAP 1开启字节序交换因为 SPI 总线按大端先发高字节而内存中 RGB565 通常按小端存储此开关保证颜色显示正确LV_HOR_RES_MAX/LV_VER_RES_MAX均为 240与 drv_lcd.h 中LCD_WIDTH/LCD_HEIGHT保持严格一致这两组宏在显示驱动注册时会被交叉引用见下一节务必同步修改。五、LVGL 显示接口对接LVGL 本身不直接操作硬件需要通过显示驱动Display Driver与绘制缓冲Draw Buffer完成对接。本工程的核心移植文件是 lv_port_disp.c。5.1 显示刷新回调lcd_fb_flushLVGL 绘制完成后会通过注册的flush_cb回调把缓冲区内容送到屏幕。本工程的实现如下static void lcd_fb_flush(lv_disp_drv_t *disp_drv, const lv_area_t *area, lv_color_t *color_p) { LCD_DisplayWindows(area-x1, area-y1, area-x2, area-y2, (uint16_t*) color_p); lv_disp_flush_ready(disp_drv); }LCD_DisplayWindows(x1, y1, x2, y2, color_p)只刷新脏矩形区域area指定的窗口底层通过 ST7789 的0x2A/0x2B命令设置窗口坐标后批量写入像素实现局部刷新减少 SPI 传输量lv_disp_flush_ready(disp_drv)通知 LVGL 本次刷新完成可继续绘制下一帧。LCD_DisplayWindows的实现位于 drv_lcd.c其底层使用spi_write_blocking(SPI_PORT, ...)发送数据SPI 控制器选择spi1初始化时钟为 80MHzspi_init(SPI_PORT, 80000 * 1000)。同时该文件还封装了 DMA 通道initDMA/pushPixelsDMA/dmaWait为后续大块像素搬运提供 DMA 加速能力。5.2 绘制缓冲与驱动注册lv_port_disp_init显示驱动的初始化入口为lv_port_disp_init完整流程如下void lv_port_disp_init(void) { SPI_Init(); LCD_Init(HORIZONTAL); lv_disp_draw_buf_init(disp_buf, lv_disp_buf1, RT_NULL, DISP_BUF_SIZE); lv_disp_drv_init(disp_drv); disp_drv.hor_res LV_VER_RES_MAX; disp_drv.ver_res LV_HOR_RES_MAX; disp_drv.draw_buf disp_buf; disp_drv.flush_cb lcd_fb_flush; lv_disp_drv_register(disp_drv); g_disp_drv disp_drv; }关键点说明硬件初始化SPI_Init()与LCD_Init(HORIZONTAL)完成 SPI 外设、GPIO、PWM 背光与 ST7789 寄存器初始化drv_lcd.c 中的LCD_InitReg包含了 Gamma、电源、帧率等完整寄存器序列缓冲区绑定lv_disp_draw_buf_init将静态数组lv_disp_buf1[DISP_BUF_SIZE]绑定为 LVGL 绘制缓冲DISP_BUF_SIZE定义为LV_HOR_RES_MAX * LV_VER_RES_MAX即完整的 240×240 全屏缓冲分辨率交叉映射disp_drv.hor_res LV_VER_RES_MAX、disp_drv.ver_res LV_HOR_RES_MAX这是源码中一个值得注意的细节——由于显示方向为横向HORIZONTAL物理屏的宽高被交换映射到 LVGL 的逻辑分辨率上注册驱动lv_disp_drv_register将配置好的驱动注册进 LVGL 全局驱动表此后 LVGL 的绘制与刷新即与该屏幕绑定。5.3 初始化调用链从 LVGL 软件包侧的lv_rt_thread_port.c可以看出调用关系lv_port_init()中先执行lv_init()初始化 LVGL 核心随后在#ifndef PKG_USING_LVGL_DISP_DEVICE分支内调用lv_port_disp_init()完成显示接口初始化如果启用了 RT-Thread 显示设备框架PKG_USING_LVGL_DISP_DEVICE则改走设备框架路径。本 BSP 的示例采用直接对接方式即上文所述流程。六、输入设备对接按键扩展除了显示输出本工程还提供了按键输入设备移植文件为 lv_port_indev.c将 Pico 板载按键映射为 LVGL 按钮输入设备LV_INDEV_TYPE_BUTTON#define BUTTON0_PIN 2 #define BUTTON1_PIN 18 #define BUTTON2_PIN 16 #define BUTTON_WKUP_PIN 20实现要点lv_port_indev_init()中通过rt_pin_mode(...)将四个按键引脚配置为输入模式并初始化lv_indev_drv_t指定类型为LV_INDEV_TYPE_BUTTON、读取回调为button_readbutton_read调用button_get_pressed_id轮询四个按键按下时引脚为低电平PIN_LOW将按下的按键 ID 与LV_INDEV_STATE_PRESSED/RELEASED状态写入lv_indev_data_t交由 LVGL 处理最终通过lv_indev_drv_register注册输入设备。这为 LVGL 界面提供了交互能力可用于菜单选择、翻页等操作而无需额外的触摸屏硬件。七、运行 LVGL 演示程序7.1 演示入口完成上述配置并编译烧录后工程会运行 LVGL 官方提供的音乐播放器演示。入口代码位于 demo/lv_demo.cvoid lv_user_gui_init(void) { /* display demo; you may replace with your LVGL application at here */ extern void lv_demo_music(void); lv_demo_music(); }这里就是替换为你自己的 LVGL 应用的地方只需在lv_user_gui_init中调用你自定义的界面初始化函数即可。7.2 使能音乐演示音乐演示依赖 LVGL 软件包中的 demo 组件在 lv_conf.h 中通过PKG_USING_LV_MUSIC_DEMO条件编译开关控制#ifdef PKG_USING_LV_MUSIC_DEMO #define LV_USE_DEMO_RTT_MUSIC 1 #define LV_DEMO_RTT_MUSIC_AUTO_PLAY 1 #define LV_FONT_MONTSERRAT_12 1 #define LV_FONT_MONTSERRAT_16 1 #define LV_COLOR_SCREEN_TRANSP 1 #endif即在 RT-Thread 软件包配置中启用LV_MUSIC_DEMO后会同时开启音乐演示、自动播放、所需字体与屏幕透明色支持。7.3 板载外设辅助验证BSP 默认的 main.c 还提供了板载 LEDGPIO 25的闪烁程序与Hello, RT-Thread!串口打印可用于烧录后先验证 RT-Thread 系统本身运行正常再接入 LVGL 界面调试。八、工程结构与二次开发指引本示例的完整工程结构如下bsp/raspberry-pico/RP2040/ ├── applications/ │ ├── lvgl/ │ │ ├── lv_conf.h # LVGL 核心配置色深、分辨率、demo 开关 │ │ ├── lv_port_disp.c # 显示驱动移植刷新回调 缓冲 注册 │ │ ├── lv_port_indev.c # 按键输入设备移植 │ │ ├── demo/lv_demo.c # 用户 GUI 入口演示/自定义应用 │ │ └── SConscript # BSP_USING_LVGL 条件编译 │ └── main.c # 板载 LED 示例 └── board/ports/lcd/ ├── drv_lcd.c # ST7789 底层驱动SPI/PWM/DMA └── drv_lcd.h # 引脚与屏幕尺寸宏定义对开发者而言二次开发通常只需两步在demo/lv_demo.c的lv_user_gui_init中替换为你自己的界面初始化代码如需更换屏幕尺寸或型号同步修改 drv_lcd.h 的LCD_WIDTH/LCD_HEIGHT与 lv_conf.h 的LV_HOR_RES_MAX/LV_VER_RES_MAX并调整lv_port_disp.c中的分辨率映射即可。九、小结本文完整复现了官方文档的四个核心步骤——使能 LVGL for LCD → 配置屏幕参数 → 对接显示接口 → 运行演示并结合 lv_conf.h、lv_port_disp.c、drv_lcd.c 等源码深入剖析了色深/字节序、脏矩形刷新、绘制缓冲、DMA 搬运与按键输入等关键实现。按照上述步骤操作即可在 Pico ST7789 的组合上跑通完整的 LVGL 图形界面并以此为模板快速扩展出自定义的嵌入式 GUI 应用。赞分享操作系统嵌入式物联网嵌入式OSRTOS【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址https://gitcode.com/gh_mirrors/rt/rt-thread点击查看免费下载相关推荐RT-Thread RA6M3-HMI-Board 实战LVGL 图形界面在 RGB 屏与 SPIILI9431屏上的完整配置与移植原理RT Thread RA6M3 HMI Board 实战LVGL 图形界面在 RGB 屏与 SPIILI9431屏上的完整配置与移植原理 本篇围绕 RT操作系统嵌入式物联网嵌入式OSRTOSRT-Thread EK-RA6M3 BSP 下 LVGL 图形界面配置实战RGB 屏与 SPI ILI9341 屏双路径完整指南RT Thread EK RA6M3 BSP 下 LVGL 图形界面配置实战RGB 屏与 SPI ILI9341 屏双路径完整指南 本文基于 RT Threa操作系统嵌入式物联网嵌入式OSRTOSRaspberry Pi Pico SDK图形界面OLED和LCD驱动开发Raspberry Pi Pico SDK图形界面OLED和LCD驱动开发 还在为嵌入式设备的显示界面发愁一文掌握Raspberry Pi Pico SDK嵌入式物联网系统编程上一篇如何3步解锁联想拯救者BIOS隐藏功能终极免费教程下一篇监督对比学习突破传统分类瓶颈的下一代特征表示框架创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/9/25 10:43:02

网络安全设备硬件加速选型:CPU+DPDK、FPGA与NP的演进与边界

做网络安全设备硬件选型这些年,被问得最多的问题不是“CLI怎么配”,而是“你这盒子为什么敢标40G线速”以及“硬件加速到底加的什么”。拆开友商设备,板卡上主处理器基本就三类:一颗或几颗x86 CPU跑DPDK,一块FPGA协处理…

2026/9/25 10:43:02

昇腾 Atlas 300V 推理卡部署 YOLO 全流程指南

最近在技术社区里被反复问到两个问题:atlas 300v 24g 是运算加速卡吗,以及 atlas 部署 yolo 到底怎么弄。这两个问题放在一起,其实正好构成了一张完整的图景:一块昇腾推理卡,在真实业务里最常见的归宿,就是…

2026/9/25 10:43:02

CLI Agent工程化实战:OpenRouter与MCP协议构建终端工具链

1. 从"treg"这个标题说起:一个被低估的Agent工程化入口第一次看到"treg"这个词,很多人会以为是某个拼写错误,或者某个小众库的缩写。但如果你最近在折腾AI Agent、CLI工具链、MCP协议这些东西,就会发现"…

2026/9/25 11:43:04

智谱唐杰清华开课:大模型全链路实操从数据到部署

1. 这门课到底在教什么:从标题拆解真实意图先把标题拆开看。“智谱唐杰清华开课”,主语是智谱和唐杰,场景是清华的课堂,动作是“开课”。“爆改课程内容”说明这不是照本宣科的老课件,而是把原有课程结构推倒重来。“让…

2026/9/25 11:43:04

DeepSeek MoE架构与长上下文部署实战:从原理到工程踩坑

1. 为什么DeepSeek值得单独拎出来讲第一次把DeepSeek的权重文件拖到本地跑起来的时候,我盯着显存占用曲线看了很久。同样参数规模的稠密模型,显存早就爆了,而它还能留出余量给长上下文。这个反差让我意识到,MoE加长上下文这套组合…

2026/9/25 11:43:04

OpenCode多模型接入:DeepSeek与Muse Spark性价比验证

近期的 AI 编码工具社区里,经常能看到这样的标题:“无限额度?超越 DeepSeek 的性能和性价比!Muse Spark 上线 opencode,gpt5.6sol 半价!”。先说结论:这类说法里有真实的工具趋势,也…

2026/9/25 11:43:04

每日更新ArXiv CV论文:自动化抓取、过滤与推送实战

1. 这个每日更新项目到底在做什么每天早上八点半,我习惯性地打开终端,先跑一遍当天的ArXiv CV板块抓取脚本,把新挂出来的论文标题、摘要、作者和PDF链接拉下来,筛掉那些明显灌水的,再把真正有意思的十几篇整理成一份清…

2026/9/25 11:43:04

钢板表面缺陷检测数据集:划伤/孔洞/焊缝三类YOLO-ready资源

简介:本资源是一份面向工业视觉检测领域的钢板表面缺陷数据集,专为缺陷检测与目标检测算法研发、模型训练及课程实验设计,适用于计算机视觉初学者与工程实践者。数据集融合铝型材与德国DAGM两大公开数据集,聚焦划伤、孔洞、焊缝三…

2026/9/24 20:24:47

GAMP 5 基于风险的计算机化系统验证:软件分类与审计追踪实践

简介:《A Risk-Based Approach to Compliant GxP Computerized Systems》即业内熟知的GAMP 5指南,面向制药企业质量与IT合规人员、验证工程师及计算机化系统管理者,用于解决GxP法规环境下系统合规性难以科学落地的问题。文档以风险管理为主线…

2026/9/23 12:06:55

安全托管MSSP实战:从静态防御到人机协同的攻防运营与应急响应

简介:这份PPT围绕互联网业务安全托管服务展开,面向企业安全负责人、IT运维人员及关注MSSP/MSS选型的读者,重点回应传统安全过度依赖人工、碎片化静态防御难以对抗产业化攻击等痛点。资源共1个pptx文件,包体约30.63MB,以…

2026/9/25 0:02:35

AI元人文:从工具使用到思维重构的深度探索

最近半年我一直在琢磨一件事:AI元人文到底是什么?说白了,就是“用元视角重新审视人与AI的关系”,也在“探索AI如何反向逼着我们发现自己的思考边界”。标题里的“元探索”,在我看就是一层套一层的追问——当你用AI解决…

2026/9/25 0:02:35

Python+CNN车牌识别实战:从数据预处理到模型训练与部署

简介:基于Python与卷积神经网络的车牌识别项目,面向计算机视觉初学者及智能交通开发者,目标是帮助用户掌握从数据预处理、模型构建到实际部署的完整流程。压缩包共25个文件,包含jpg/png图像样本、py训练脚本、md说明文档、dat数据…

2026/9/25 0:02:35

Vim基础操作全攻略:保存退出、模式切换与高频命令实战

1. 项目概述1.1 核心需求解析今天聊聊Vim。写这个题目的原因是:几乎每个后端开发者、运维人员、数据工程师某天都会遇到一个场景——深夜加班,服务器登录界面只有黑底白字,编辑器只有vi/vim,你必须在五分钟内完成一次配置修改并保…

2026/9/22 16:34:32

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/22 20:01:30

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/22 13:25:41

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑