STM32 RGB屏LTDC黑屏排查：SDRAM刷新与时序协同

800×480 的 RGB 屏挂到 STM32 上LTDC 时钟使能了、图层开了、显存地址也填了程序下载进去之后屏幕一片纯黑——背光明明亮着就是不出图。这个现象我前后遇到过四五次每次的根因都不一样有一次是 SDRAM 刷新计数器沿用了模板里的默认值有一次是 D-Cache 没配 MPU 导致写进缓存的像素根本没落到 SDRAM还有一次纯粹是显存首地址没按字对齐。黑屏只是表象真正要拆的是 LTDC 取数链路和 SDRAM 刷新、时序之间的协同关系这两者任何一头没对齐屏幕就是黑的或者花得没法看。下面我把这套排查逻辑完整摊开讲从带宽账本算起一直到寄存器级别的参数落地适合刚上手 RGB 屏驱动、也适合调过一阵但一直没彻底搞明白的同行对照着看。1. 黑屏先别急着改代码把现象拆成三层1.1 三种“黑”对应三条完全不同的链路同样是黑屏示波器一夹就能分出三类。第一类是像素时钟 PCLK 根本没有输出这属于 LTDC 的时钟域问题源头在 PLL 配置或者 LTDC 使能位没置起来跟 SDRAM 一点关系都没有。第二类是 PCLK 有、HSYNC/VSYNC/DE 都有波形但屏幕全黑这时候 LTDC 已经在正常扫屏了问题出在它读到的像素数据上——要么显存里全是 0要么读回来的数据是错的这一类才是 SDRAM 出问题的典型表现。第三类是屏幕能亮但只有背光或者偶尔闪一下白一般是屏本身的复位、背光使能、部分带 SPI 初始化序列的屏没走完上电流程。我一般的做法是先用示波器或者逻辑分析仪夹住 PCLK 和 DE 两根线确认时序信号是否真的在跑。这一步花不了五分钟但能直接砍掉一半的排查范围。很多人一上来就怀疑 SDRAM结果折腾半天发现是 PLLSAI 的分频系数算错了PCLK 压根没出来。分清楚这三类之后“SDRAM 刷新与时序协同”这个话题才有意义——它只对第二类黑屏负责。1.2 为什么嫌疑名单里 SDRAM 排第一在没有外部 SRAM、也没有内部显存足够大的情况下RGB 屏的帧缓冲基本只能放在外部 SDRAM 里。这就意味着 LTDC 每一行有效像素期间都要从 SDRAM 连续搬运数据而 SDRAM 同时又得定期做刷新、还要应付 CPU 和 DMA2D 的写入请求。三方抢同一个存储控制器任何一方的参数没配好表现到屏幕上就是黑屏、花屏或者撕裂。更麻烦的是 SDRAM 的问题有很强的隐蔽性。写进去的数据读出来不对不一定是颗粒坏了很可能是刷新计数设得太离谱、时序参数比手册要求还紧、或者 SDCLK 相位没调对导致采样点落在数据跳变沿上。这些问题的共同点是代码能编译、能下载、不报错但屏幕就是不给你面子。所以我习惯把 SDRAM 单独拎出来先做裸读写验证验证通过了再往上叠 LTDC这样出了问题能立刻定位到是哪一层。2. LTDC 与 SDRAM 的账本带宽与时序到底谁卡谁2.1 像素时钟不是拍脑袋定的像素时钟由屏幕的时序参数反推出来公式很直白PCLK (HSW HBP Width HFP) × (VSW VBP Height VFP) × 刷新率。以一块 800×480 的屏为例手册给的典型值是 HSW48、HBP88、HFP40、VSW3、VBP32、VFP13那么一行的总像素数是 488880040976一帧的总行数是 33248013528按 60Hz 算就是 976×528×60≈30.9MHz。实际工程里更常用 33MHz 这个整数因为它能被 PLL 更容易地分频出来代价是刷新率略高于 60Hz屏幕一般都能吃下。这里有个容易忽略的点PCLK 的上限不只受屏幕限制还受 LTDC 外设本身和 SDRAM 带宽限制。PCLK 越高单位时间从 SDRAM 拉的数据越多如果 SDRAM 那边供不上就会出现 FIFO 欠载表现为行内突然出现一段黑或者整帧闪。计算的时候还要注意别把 HSW 和 HBP 搞混。HSW 是同步脉冲宽度HBP 是同步脉冲结束到有效像素开始之间的后沿HFP 是有效像素结束到下一个同步脉冲之间的前沿。有些屏手册把 HBP 和 HFP 标成“Back Porch”和“Front Porch”也有标成“BP”和“FP”的看的时候要对着时序图确认一遍别拿错数字。2.2 显存带宽的粗算与留余量带宽这块我习惯算两个数平均值和峰值。平均值决定 SDRAM 长期负载峰值决定会不会瞬间欠载。800×480、RGB565、60Hz 的平均带宽是 800×480×2×60≈46.08MB/s峰值则是 PCLK × 每像素字节数也就是 33MHz×266MB/s。再看 SDRAM 这一侧。假设用的是一颗 16 位数据宽度、SDCLK 跑 90MHz 的颗粒理论峰值带宽是 90M×2180MB/s。但理论值不能直接用SDRAM 每次读写都要经历激活、行地址选通、列地址选通、预充电这一套流程加上定期刷新要占时间实际有效带宽通常只有峰值的六到七成。按 65% 折算可用带宽大概 117MB/s。这样一对比单层 RGB565 的 46MB/s 平均负载看起来绰绰有余。但如果再加一层 UI、再叠一个 DMA2D 做局部刷新、CPU 还要往显存里写文字负载很容易冲到 80MB/s 以上余量就变薄了。我的经验是平均负载不要超过 SDRAM 可用带宽的 50%超过这个线屏幕在某些极端画面下就会开始出现偶发黑条。真压不住就得往上加 SDCLK、换 32 位位宽或者干脆降低分辨率。2.3 刷新命令是怎么“偷走”带宽的SDRAM 靠电容存数据电容会漏电所以必须周期性刷新。刷新是一个占用总线时间的操作在刷新期间 SDRAM 不能响应正常的读写请求。FMC 外设内部会把刷新请求和读写请求做仲裁读写优先但刷新请求积压到一定程度就必须插进去执行。以 13 位行地址、8192 行、tREF64ms 的颗粒为例平均每个刷新周期是 64ms/81927.8125μs。每次刷新大约占用 7 个 SDCLK 周期90MHz 下就是 78ns 左右。算下来刷新占用总时间的比例是 78ns/7.8125μs≈1%。这个比例很低正常情况下不会成为瓶颈。真正的问题出在配置错误上。如果刷新计数器被人改成了默认的 0 或者接近 0刷新频率会高得离谱总线被刷新命令占满LTDC 取数严重不足屏幕直接黑掉或者大面积花屏。反过来如果计数设得太大刷新不足电容漏电导致数据翻转读回来的像素是乱码屏幕上是雪花点。这两种错误方向相反但最终都指向黑屏所以光看现象是分不出方向的必须回到寄存器里核对数值。3. 参数落地从屏手册到寄存器3.1 屏幕时序六件套的读取与换算拿到一块屏第一件事是翻手册里的时序表把 HSW、HBP、HFP、VSW、VBP、VFP 这六个数抄下来。抄的时候要特别注意单位有的手册给的是像素数有的给的是时间ns 或者 μs如果是时间还得用 PCLK 换算回像素数。换算公式是像素数 时间 × PCLK然后向上取整。抄完之后立刻做一次自检把这六个数代进总行数、总列数公式算出来的刷新率应该在 55Hz 到 75Hz 之间。如果算出来是 200Hz 或者 20Hz说明某个参数抄错了单位或者看错了列。这一步能挡住很大一部分低级错误我在新手代码里见过太多次因为 HBP 抄成了 HSW 导致的图像左移。LTDC 寄存器这边有个细节必须记住所有累积值都要减一。硬件内部是从 0 开始计数的而手册给的是个数所以写寄存器的时候要统一减 1。具体对应关系是HorizontalSync 写 HSW-1AccumulatedHBP 写 HSWHBP-1AccumulatedActiveW 写 HSWHBPWidth-1TotalWidth 写 HSWHBPWidthHFP-1。垂直方向同理。这个减一如果漏掉图像会整体偏移一个像素边界上会出现一条细黑线看起来像黑屏的一部分很容易误判。3.2 LTDC 侧配置代码与易错点配置代码本身不复杂难点在于每个字段的含义要和上面的公式一一对应hltdc.Init.HorizontalSync 48 - 1; // HSW hltdc.Init.VerticalSync 3 - 1; // VSW hltdc.Init.AccumulatedHBP 48 88 - 1; // HSW HBP hltdc.Init.AccumulatedVBP 3 32 - 1; // VSW VBP hltdc.Init.AccumulatedActiveW 48 88 800 - 1; // 有效区右边界 hltdc.Init.AccumulatedActiveH 3 32 480 - 1; // 有效区下边界 hltdc.Init.TotalWidth 48 88 800 40 - 1; // 一行总长 hltdc.Init.TotalHeigh 3 32 480 13 - 1; // 一帧总长 hltdc.Init.HSPolarity LTDC_HSPOLARITY_AL; hltdc.Init.VSPolarity LTDC_VSPOLARITY_AL; hltdc.Init.DEPolarity LTDC_DEPOLARITY_AL; hltdc.Init.PCPolarity LTDC_PCPOLARITY_IPC;极性这四项是最容易被忽略的黑屏元凶。HSPolarity、VSPolarity、DEPolarity 决定同步信号和有效区标志是高有效还是低有效PCPolarity 决定像素数据在时钟上升沿还是下降沿采样。不同屏厂的要求不一样配反了轻则图像偏移重则整屏黑掉。我的做法是手册上写“Active Low”就选_AL写“Active High”就选_AH不确定的时候两个都试一遍出图的那个留下五分钟的事比翻手册猜语义快得多。图层配置里还有一个坑是ImageWidth和ImageHeight这两个值必须等于实际分辨率不能填成整个屏幕加消隐区的大小也不能填成显存里分配的更大尺寸。填错了 LTDC 会按错误的步长取数画面会斜切。显存首地址FBStartAdress必须是 4 字节对齐最好直接按 32 字节对齐配合 Cache 行大小用起来更省心。3.3 SDRAM 侧初始化、时序与刷新计数SDRAM 的初始化序列是有固定顺序的顺序错了颗粒根本不上电。大致流程是先开时钟使能命令延时一小段时间然后发预充电所有 Bank 命令接着连续发 8 次自动刷新命令再发加载模式寄存器命令把突发长度、CAS 延迟、写突发模式配进去最后单独配一次刷新率。这几步的间隔和参数在颗粒手册的“Initialization”章节都写得很清楚照抄就行但最后那次刷新率计算要自己动手。刷新计数的公式是COUNT (tREF / 行数) × SDCLK频率 - 20。以前面说的 8192 行、tREF64ms、SDCLK90MHz 为例64ms/81927.8125μs乘以 90MHz 得 703减 20 得 683。所以HAL_SDRAM_ProgramRefreshRate(hsdram1, 683);减 20 是 FMC 内部预留的余量让刷新命令不至于卡在读写中间。这个值很多模板里写成 1386 或者 924那是因为对应的是不同行数和不同时钟的颗粒直接照抄模板必踩坑。刷新计数必须按自己板子上的颗粒手册和实际 SDCLK 重新算。时序参数这块FMC 要求按 SDCLK 周期数填写所以要把颗粒手册里的纳秒值除以时钟周期再向上取整参数含义手册典型值90MHz 下取值TMRD模式寄存器设置到命令2 tCK2TXSR退出自刷新时间67ns7TRAS行激活到预充电42ns4TRC行周期60ns6TWR写恢复时间15ns2TRP预充电时间18ns2TRCD行到列延迟18ns2取整一律向上宁可给多一个周期也不能少少了就是时序违规读出来的数据会随机错位。另外ReadPipeDelay和ReadBurst这两项要跟着硬件设计走走线短、信号质量好的板子可以把读管道延迟设成 0走线长或者有转接板的建议设成 1 甚至 2用相位补偿换稳定性。SDCLK 相位那一项在 FMC 里是SDClockPeriod取值 2 或 3 对应不同的时钟输出相位读数据异常时这是第一个要调的地方。3.4 显存布局、对齐与 Cache/MPU显存地址建议直接放在 SDRAM 的起始段并且和 LTDC 的其他缓冲区比如双层时的第二层保持足够的间距避免越界覆盖。如果用的是带 D-Cache 的核这里有个必须处理的问题CPU 往显存写像素时数据可能只落在 Cache 里没写回 SDRAMLTDC 从 SDRAM 读到的还是旧值表现就是屏幕一直黑着或者显示的是上一帧内容。解决办法有两条。第一条是把显存区域配置成 Write-through 或者 Non-cacheable 的 MPU 区域让写操作直接穿透到 SDRAMMPU_InitStruct.BaseAddress 0xC0000000; MPU_InitStruct.Size MPU_REGION_SIZE_32MB; MPU_InitStruct.IsCacheable MPU_ACCESS_NOT_CACHEABLE; MPU_InitStruct.IsBufferable MPU_ACCESS_NOT_BUFFERABLE; MPU_InitStruct.IsShareable MPU_ACCESS_SHAREABLE; MPU_InitStruct.TypeExtField MPU_TEX_LEVEL1; MPU_InitStruct.DisableExec MPU_INSTRUCTION_ACCESS_DISABLE;第二条是在每次改完显存内容后手动做一次SCB_CleanDCache_by_Addr只清显存那一段。第一条更省心代价是 CPU 写显存的速度会慢一点但对 LTDC 这种实时取数的场景来说稳定性远比那点写入速度重要。我现在的习惯是显存区域一律走 Non-cacheable其他地方照常开 Cache这样既不影响运算性能也不会出现“程序里明明画了图、屏幕上啥也没有”的诡异现象。4. 分阶段点亮把黑屏逼到某个确定环节4.1 第一阶段SDRAM 裸读写验证在碰 LTDC 之前先写一段最朴素的 SDRAM 测试往整个显存区域按 32 位字写入递增模式再读回来逐个比对统计错误个数和首个错误地址。这一步能一次性排除掉颗粒焊接、地址线错位、时序参数错误、刷新计数错误这几类问题。我一般会测三遍第一遍写 0xAA55AA55、第二遍写 0x55555555、第三遍写地址本身。三遍都过说明数据线和地址线都没问题。如果只在某些地址段出错多半是行地址或者 Bank 地址线的问题如果错误是随机的、每次位置都不一样基本可以确定是刷新不足或者时序太紧。这时候把刷新计数调小一点、把 TRCD 和 TRP 各加一个周期通常就能收敛。这一步还有一个容易被跳过的地方上电后要等 SDRAM 稳定再访问。有些板子的电源爬升比较慢初始化序列发太早会导致模式寄存器没写进去后面所有读写都是错的。加个几毫秒的延时成本几乎为零。4.2 第二阶段屏幕信号线验证SDRAM 过了之后先别急着开 LTDC 出图。把 LTDC 配好但先往显存里填一个纯色然后用示波器确认 PCLK、HSYNC、VSYNC、DE 四根线的波形都正常频率和计算值对得上。这一步是分水岭波形对了说明 LTDC 的时钟和时序没问题接下来黑屏只可能是数据通路或者显存内容的问题波形不对就回去查 PLL 和极性配置。有些屏还带一根独立的复位脚和背光使能脚这两根线如果没拉对LTDC 输出再标准屏幕也不会亮。带 SPI 初始化序列的 IPS 屏更麻烦得先通过 SPI 把上电序列、伽马参数、像素格式发完屏才会接受 RGB 信号。这类屏黑屏时先量一下 SPI 有没有真的发出去别一头扎进 LTDC 里。4.3 第三阶段LTDC 纯色输出纯色测试是判断“黑屏到底是不是 SDRAM 数据问题”的最快手段。往显存首地址开始填满 0xF800红色RGB565如果屏幕变成整屏红色说明 LTDC 取数链路、显存地址、像素格式全部正确剩下的问题只可能出在“你写的数据没到显存里”或者“写进去的数据被覆盖了”。如果填了红色还是黑的那就往前查显存地址对不对、图层使能位有没有置、LTDC 全局使能位LTDCEN有没有置、SRCR寄存器里的立即重载位有没有触发。这里有个细节改完 LTDC 寄存器后要等一个垂直消隐期新配置才生效改完立刻读状态寄存器可能还是旧值。性子急的可以直接置LTDC_SRCR的VBR位强制重载或者置IMR位立即生效但立即生效在某些情况下会造成画面瞬闪调试阶段用没问题量产代码里还是老老实实等垂直消隐。4.4 第四阶段加图、加压、加并发纯色过了之后开始往显存里写真实图像。这一步最容易暴露带宽问题静态图正常、一动起来就撕裂或者画面切换时出现横向黑条基本可以判定是 SDRAM 带宽余量不够或者刷新和读请求打架。我的验证方法是写一个简单的压力测试CPU 持续往显存的另一半区域写数据同时 LTDC 正常扫屏观察屏幕有没有异常。如果只在 CPU 写入时出现花屏说明总线仲裁偏向 CPU可以考虑把 CPU 写显存的操作改成 DMA2D 搬运让 DMA 控制器以更规整的突发方式访问减少对 LTDC 读请求的打断。另一个要盯的点是 SDRAM 的写操作效率。FMC 的写是单次写不像读那样能组突发所以频繁的小块写会明显拖低带宽。用 DMA2D 做矩形填充和图像拷贝能把写操作聚合成连续访问实测下来比 CPU 逐像素写快不少对屏幕稳定性的帮助也很直接。5. 踩过的坑与排障速查表5.1 八个高频坑位第一个坑刷新计数照抄模板。模板里的值对应的是另一颗颗粒、另一个时钟频率直接抄过来要么刷新过密拖垮带宽要么刷新不足数据翻转。必须按自己的颗粒手册重算。第二个坑显存没做 Cache 处理。CPU 写进去了LTDC 读不到屏幕黑着但调试器看显存内容是对的。配 MPU 或者手动清 Cache二选一。第三个坑显存地址没对齐。有些编译器把数组放在奇数地址上LTDC 取数直接错位画面斜切甚至全黑。加__attribute__((aligned(32)))或者用链接脚本固定段地址。第四个坑SDRAM 时序取整方向错了。手册给 18ns90MHz 下是 1.62 个周期必须向上取 2取 1 就是违规。所有时序参数一律向上取整。第五个坑SDCLK 相位没调。波形看着有但数据采样点落在跳变沿上读回来的像素是乱的。表现为花屏而非纯黑调相位或者加读管道延迟。第六个坑LTDC 极性配反。同步信号极性错了屏幕识别不到有效区整屏黑。四个极性挨个试最快。第七个坑图层混合系数配错。单层显示时如果混合系数配成了需要背景层参与的模式而背景层又没配置输出可能是全黑。单层场景直接把 Alpha 设 255、混合系数设成 PAxCA 就行。第八个坑背光和复位没处理。屏的背光使能脚悬空或者极性反了LTDC 输出再标准也看不见。硬件上电第一件事就是量这两根线的电平。5.2 排障速查表现象优先怀疑验证手段处理方向全黑PCLK 无输出PLL 分频或 LTDC 未使能示波器测 PCLK 脚检查 PLLSAI 分频与 LTDCEN全黑PCLK 正常显存有数据Cache 未回写清 DCache 后观察配 MPU 为 Non-cacheable全黑显存内容全 0应用层没写显存调试器读显存首地址检查写显存代码路径全黑显存地址异常地址未对齐打印指针值强制 32 字节对齐花屏、雪花点刷新不足或时序太紧裸读写测试统计错误率重算 COUNT放宽 TRCD/TRP图像整体偏移HBP/VBP 算错或漏减一对照手册重算累积值修正寄存器值图像上下翻滚VSW 太小或极性反改 VSPOL 试加大 VSW 或翻转极性颜色错乱像素格式或 PCPOL 反填纯红纯绿对比改 RGB/BGR 或翻转 PCPOL偶发横向黑条带宽不足或 FIFO 欠载降帧率看是否消失提 SDCLK、降分辨率、减层数画面撕裂显存被边写边读双缓冲切换测试上双缓冲或加垂直同步等待5.3 一个我自己常用的定位顺序遇到黑屏我现在的固定动作是先测 PCLK 有没有有就填纯色看屏幕变不变变了说明通路 OK 去查应用层不变就翻寄存器看LTDC_GCR的使能位和图层使能位如果使能位都对但画面还是黑的把显存首地址往前挪 32 字节再试一次很多时候就是对齐问题最后才去怀疑 SDRAM 刷新和时序。这个顺序的好处是每一步都能给出明确的“是/否”结论不会在几个可能的根因之间来回打转。SDRAM 那边我还有一个习惯把刷新计数和几个关键时序参数做成宏定义调试的时候可以现场改、现场烧不用每次翻数据手册重算。等你把一块板子调通之后这些值就是这块板子的“指纹”换个颗粒、换个 SDCLK 就必须重新来过千万别觉得调通一次就一劳永逸。最后分享一个小技巧如果手头没有逻辑分析仪可以用一个空闲 GPIO 在 LTDC 的行中断里翻转配合示波器看翻转频率是不是等于刷新率。这个方法虽然粗糙但判断 LTDC 有没有真的在扫屏足够用了比盯着黑屏瞎猜强得多。