
本文来源:https://www.hqwc.cn/a/1441657.html
若有版权问题,请来信告知:13951431913#139.com 或在右方提交评论。
一个很常见的需求:UI 上要显示一张图,图片放在板载的外部 Flash 里,MCU 上电后用 LTDC 控制器把它刷到 LCD 屏幕上。STM32H7S78-DK 这块板子的硬件路径其实非常典型——外部 QSPI Flash 存资源、SDRAM 做帧缓冲、LTDC 驱动 LCD。很多朋友卡在“Flash 里明明有图,屏上就是不显示”这个环节,问题往往不是单点,而是整条链路里某个细节没对齐。
这篇文章我就按自己实际做过的流程走一遍:从为什么要把图放外部 Flash、CubeMX 里怎么配置 QSPI 和 LTDC、图片怎么转成 bin 烧进去,到最终代码里怎么把图送到帧缓冲,一次讲透。适合刚接触 STM32H7 系列图形开发的工程师,也适合已经在用 TouchGFX 但想自己手动实现一次底层显示的玩家。
1. 先理清楚数据流:图片从 Flash 到屏幕要经过哪几段路
很多人一上来就打开 CubeMX 点 LTDC、配置屏幕参数,然后发现屏幕始终没图。原因很简单:LTDC 本身只是个“扫描器”,它不会主动去 Flash 里读图片,它只知道按固定的时序从某个内存地址连续读像素数据,然后送给 LCD。
STM32H7S78-DK 上典型的分工是这样的:
外部 Flash(QSPI/OctoSPI NOR Flash) :存图片、字库、音频等静态资源,掉电不丢,容量从几 MB 到几十 MB 不等。
SDRAM(外部内存) :作为帧缓冲,也就是 LTDC 实际扫描读取的内存区域。
LTDC 控制器 :按时序从 SDRAM 地址读取像素,转换成 RGB 信号,配上 HSYNC/VSYNC/CLK/DE 送给屏幕。
所以图片从 Flash 到屏幕不是一个直接动作,而是分成两步:
第二步是硬件自动完成的,LTDC 使能后就会一直刷。第一步才是我们要写代码控制的:把图片从 Flash 搬进 SDRAM。
STM32H7S78-DK 这颗芯片的内部 Flash 并不大,存完固件、协议栈之后剩余空间很紧张。而 UI 的图片资源动辄几百 KB,1920x1080 的 RGB565 原始图一帧就要 4MB 左右,内部 Flash 根本装不下。即便装得下,NOR Flash 在内存映射模式下读速度远不如 SDRAM,LTDC 在 60Hz 刷新率下对帧缓冲带宽要求按 MB 算,让 LTDC 直接读外置 Flash 做帧缓冲基本不现实(少数高性能 OctoSPI 在低分辨率场景可以试,但别拿来当通用方案)。
正确的思路就是: Flash 负责“存”,SDRAM 负责“跑”,LTDC 负责“刷” 。理解了这个数据流,后面每一步配置你都会知道自己在做什么。
2. CubeMX 初始化:QSPI 和 LTDC 这两个外设怎么配才不出幺蛾子
STM32H7S78-DK 的板载 QSPI Flash 和 LCD 接口在 CubeMX 里都是现成的,但有几个参数需要手动确认,不是默认值就能直接用。
在 STM32CubeMX 里选中芯片后,先打开 QUADSPI (如果是新版系列也可能是 OCTOSPI,要看具体型号,H7S78 上以实际 CubeMX 显示为准)。以最常见的四线 QSPI NOR Flash 为例,需要关注这几个参数:
Clock prescaler :这个决定了 QSPI 的时钟频率。假设 QSPI 外设时钟来自 AHB 总线,CubeMX 默认分频值可能偏保守,但对首次调通来说,先按 2 分频(即 100MHz 左右)跑,稳定性优先,别一上来就超频。
Fifo threshold :一般保持默认 4 或 8,不用动。
Clock mode :Mode 0 在大多数 Flash 上都支持,如果 Flash 手册要求 Mode 3,再切换。
Memory size :换算关系是 2^(N+1) 字节,16MB Flash 对应 N=23,这个是常见失误点,配错会导致读取地址空间不对。
Flash ID / 指令长度 :需要根据你板子上具体 Flash 型号的手册配置读命令,常见的是 0x03(常规读)、0x0B(快速读)、0xEB(四线快速读)。如果选错指令,读出来全 FF 或者全 00。
时钟树方面,建议在 CubeMX 的 Clock Configuration 里确认 QSPI 时钟源不是来自一个被关闭的 PLL,否则运行时 QSPI 初始化会直接卡死。这个坑很隐蔽,因为编译下载都不报错,调试器单步走到 HAL_QSPI_Init 就超时。
LTDC 配置界面看起来参数很多,实际核心就三部分: 时序参数 、 颜色格式 、 背景色 。
时序参数完全来自你的屏幕数据手册,不能凭感觉填。一个 800x480 的 RGB 屏幕常见参数大概是:
不同屏的数据手册会给出 HSync/VBackPorch/VFrontPorch 这些值,直接把表格里的参数搬进去,然后把同步信号的 polarity(极性)也按手册设置。很多屏是 HSYNC 低有效、VSYNC 低有效 ,如果弄反了,屏幕能亮但画面会随机偏移或者滚动。
这里有个经验技巧:一旦屏幕能亮但画面位置不对,比如整体向右偏移一截、上半屏黑边,基本都是 porch 参数或者极性反了。先别怀疑代码逻辑,回头查屏幕手册的时序图,一行行核对。
色深一般选 RGB888 或者 RGB565。如果屏幕是 24bit RGB 接口,建议 LTDC 输出格式选 RGB888,这样颜色还原准。如果板子的 FPC 线只接了 16bit,那就选 RGB565。STM32H7S78-DK 板载屏用哪种,看原理图里 LCD_R0-R7、LCD_G0-G7、LCD_B0-B7 有没有全部接上。
如果把显示相关的外设都配置完了,再额外检查一下 DMA2D 外设时钟有没有打开。虽然 DMA2D 不是 LTDC 的组成部分,但后面把图片从 Flash 拷贝到帧缓冲时会用到它,这是最高效的搬运方式。CubeMX 里把 DMA2D 勾上,这样 HAL 库函数就能正常调用。
另外,如果你的工程使用了 Cache(STM32H7 系列 Cortex-M7 默认开 D-Cache 很常见),先记着“这里有坑”,具体处理我在第 7 节专门讲。
3. 图片资源准备:不是直接塞一张 JPG 就能用的
很多朋友从 PC 上拿一张 JPG 就往 Flash 里放,然后 LTDC 显示不出来,就以为代码有问题。其实问题出在格式上:LTDC 不认识 JPEG,它只认识原始像素数据(RGB565、RGB888、ARGB8888 这类)。所以图片必须要先预处理成裸像素格式的 bin 文件,再烧进 Flash。
选哪个取决于两个因素:一是屏幕接口的实际色深,二是你是否需要透明度。
如果屏幕是 16bit 接口,直接用 RGB565,省一半带宽,适合显示照片类素材。
如果需要做图标叠加、圆角、阴影、半透明效果,优先 ARGB8888,因为 LTDC 的 alpha 混合功能需要这个格式。
RGB888 格式最尴尬,它没有 alpha 通道,且占用 3 字节/像素,LTDC 虽然支持,但带宽利用率不高。除非屏幕要求 24bit 且你不需要透明,否则通常不如 RGB565 或 ARGB8888。
从带宽角度算一笔账:800x480 的 RGB565 一帧数据量是 800×480×2 = 768,000 字节,约 750KB;60Hz 刷新需要约 45MB/s 的带宽。SDRAM 完全扛得住,但如果是 ARGB8888,一帧就是 1.5MB,带宽翻倍。所以显示照片时选 RGB565 是更务实的做法。
这段脚本生成的是大端序 RGB565 数据。注意:STM32 是小端 CPU,但 LTDC 的字节序约定是按颜色分量在 16bit 中的位置,RGB565 的位域是固定的 RRRRRGGGGGGBBBBB ,直接用上面的脚本生成没问题。不过如果你用的是 CubeMX 生成的工程、LL 库驱动,还要确认你读 Flash 时设置的地址和读取长度是字节对齐的,别用 uint8_t 数组去拼 16bit 像素,效率太低。
方案二:STM32 官方工具或 TouchGFX Image 转换器
TouchGFX Designer 自带图像转换功能,可以把图片直接输出为 Raw RGB565 bin,并且支持自动生成 C 数组格式。用这个工具的好处是它处理了色序、对齐问题,缺点是它默认给 TouchGFX 框架用,如果你想自己写裸驱动,反而要剥离框架代码。
方案三:在线工具或者 PC 端 Image2Lcd

本文来源:https://www.hqwc.cn/a/1441657.html
若有版权问题,请来信告知:13951431913#139.com 或在右方提交评论。
A common requirement is showing an image stored in onboard external QSPI Flash on an LCD after power-up. The STM32H7S78-DK board has a representative hardware path — external QSPI Flash for assets, SDRAM for the framebuffer, LTDC driving the panel — and 'the image is in Flash but nothing appears' usually means one detail in that chain is misaligned rather than a single broken driver.
The guide walks the full flow: why images belong in external Flash, how to configure QSPI and LTDC in CubeMX, how to convert images to .bin and flash them, and how code moves the data into the framebuffer. It targets engineers new to STM32H7 graphics as well as TouchGFX users who want to implement the underlying display path once by hand.
Several pitfalls get specific treatment. Add timeout protection around HAL_QSPI_Command and HAL_QSPI_Receive loops to avoid hangs, and note that the H7's QSPI has only one chip select — if Flash is on QSPI_CS0, do not use CS1 in code. For optimisation, the H7's hardware JPEG codec decodes an 800×480 JPEG in tens of milliseconds, at the cost of an RGB888 intermediate buffer and a conversion to RGB565.
Further directions: local refresh via LTDC layer windows and window-sized DMA2D transfers; double or triple buffering with framebuffer swaps during vertical blanking to avoid tearing; handing the framebuffer and layer config to TouchGFX for widgets, animation and touch; and measuring real-time LTDC bandwidth for complex UI, animation or video. The author recommends understanding the whole chain first, since TouchGFX issues such as missing external-Flash images, cache coherency and LTDC timing all trace back to the same bare-metal principles.