做 BSP 的人看到“MIPI DSI”这几个字血压一般都会高一点。前面几期把网口、USB、eMMC 都调顺了这次轮到全志 T527 的显示链路而且偏偏是 DSI。DSI 跟 I2C、SPI 这类慢速接口不一样它既是协议又是物理层软件配错一个字节、硬件上有一根线序不对结果都是“黑屏”区别只在坑的深浅。这篇把这次 T527 的 MIPI DSI 调试过程完整留个底从设备树怎么填、初始化序列怎么搬到黑白花屏三类症状怎么一步步定位都是实际踩过之后的总结。后面有人再在这颗 SoC 上调屏看完至少能少走一半弯路。1. 先把显示链路看清楚从 DE 到 DSI PHY1.1 MIPI DSI 本质上是一条高速差分串行链路很多第一次调 DSI 的人会把它理解成“给屏幕发 SPI 命令”这么想就踩坑了。屏幕上每一个像素以 RGB888 为例要编成 24bit 的字节流再由 DSI 控制器打包成 packets通过 1 到 4 对差分数据线Data Lane加一对差分时钟线Clock Lane送给面板。差分线上并不是一个持续平稳的信号而是分成两种工作模式高速模式HS只管猛传像素数据低功耗模式LP才用来发命令、切状态。两种模式之间切换的时序、线上的共模电压、以及信号完整性都会直接影响屏能不能认住。这也是 DSI 调试让人头疼的根本原因——你没法像 I2C 那样用逻辑分析仪直接“听”命令是否送达。绝大多数时候屏幕对外表现就是三个结果黑屏、白屏、花屏然后靠软件和示波器去猜中间发生了什么。1.2 全志 T527 的显示链路分三段走T527 内部已经把“显示控制器DE 时序控制器TCON MIPI DSI 控制器 D-PHY”集成到一颗 SoC 里从软件角度看到的只是dsi节点、panel/lcd0节点但硬件上这条链路是分段的DE 负责从内存搬帧、做图层合成TCON 负责产生面板需要的行场时序DSI 控制器把并行 RGB 数据编码成 DSI 协议包D-PHY 再把协议包变成差分信号推上线。在 T527 的 BSP 里设备树搜索dsi大概率能看到三类节点一是 SoC 的 DSI 控制器节点描述 lane、时钟、PHY二是面板节点或lcd0节点描述分辨率、时序、初始化序列、供电 GPIO三是背光节点描述 PWM、背光使能脚、亮度范围。全志 BSP 的显示驱动会把这些节点组合成一个显示输出初始化顺序一般是固定的先供电、再复位、再初始化面板命令最后才开背光。这个顺序在调试时非常重要后面我会反复提。1.3 带宽核算为什么 1080P 60 必须走 4 laneMIPI DSI 和 LVDS 类似带宽永远是账面上的第一道坎。像素时钟的基础公式很简单pixclk x_res × htotal × y_res × vtotal × fpshtotal hactive hfront_porch hback_porch hsync_lenvtotal 同理。比如一块 1080x1920 的 60fps 屏典型 htotal 在 1200 左右、vtotal 在 1980 左右pixclk 就是 148.5MHz 附近。RGB888 一个像素要 24bit所以裸数据率大约是 148.5MHz × 24 3.56Gbps。DSI 的 D-PHY 在高速模式下用差分时钟上下沿采样一个 lane 的吞吐率取决于你配的每 lane 比特率。4 lane 的情况下假设每 lane 800Mbps总带宽 3.2Gbps加上 DSI 包头的开销已经非常紧张这就是为什么 1080P 的 MIPI 屏普遍要求 4 lane面板规格书里也一定会写明每 lane 的比特率上限。如果只配 2 lane或者 lane 速率配低了画面就会出现噪点、丢色严重时直接花屏甚至不亮。所以拿到一块新屏先别急着改分辨率先按面板规格书把 lane 数和每 lane bit rate 算清楚这一步错了一切免谈。2. BSP 设备树实战lcd0/panel/dsi 节点怎么填2.1 先把面板规格书变成时序数字这次手上是一块 1080x1920 的 MIPI DSI 屏驱动 IC 是市面上非常常见的一款。拿到规格书后先找“Timing Diagram”那几页把 hsync/vsync 脉宽、前后肩、blank 时间抄出来。全志老 BSP 的lcd0节点写法大致长这样lcd0 { lcd_used 1; lcd_if 4; /* 4: MIPI DSI */ lcd_dbi_if 4; /* DSI 命令接口编号 */ lcd_x 1080; lcd_y 1920; lcd_pixel_freq 150000000; /* 像素时钟单位 Hz */ lcd_hspw 4; lcd_hbp 54; /* 按 SDK 具体含义填写 */ lcd_ht 1200; lcd_vspw 2; lcd_vbp 20; lcd_vt 1980; lcd_dsi_lane 4; /* 4 lane */ lcd_dsi_format 0; /* RGB888 */ };这里有个容易搞混的点不同版本的全志 SDK 对lcd_hbp的定义不完全一致有的把 hsync 脉宽也算进去有的只算 back porch。保险的做法是拿公式去反推lcd_x lcd_hspw lcd_hbp front porch lcd_ht填完之后用分辨率、htotal、vtotal 去验证lcd_pixel_freq是否和 60fps 匹配别只改分辨率、不改时钟。我曾见过一整版 dts 里 x/y 改成了 1080p但lcd_pixel_freq还留着上一个 720p 屏的 70 多 MHz出来的画面自带各种诡异条纹。2.2 初始化序列从驱动 IC 手册到 dtsMIPI DSI 屏和 LVDS 屏最大的区别在于面板里有一颗带寄存器的驱动 IC上电后默认状态往往不是正常显示状态必须先给它发一串初始化命令比如退出睡眠、设置电源、设置 gamma、开启显示。这些命令一般由面板厂商提供经常是一份几十上百行的寄存器序列。全志老 BSP 里初始化序列会被翻译成 dts 中lcd0节点下的数组新版 DRM 驱动则更倾向使用标准 panel 节点里的panel-init-sequence。例如panel-init-sequence [ 05 78 01 11 /* Sleep Out延时 120ms */ 39 00 04 FF 98 81 03 /* 厂商私有命令使能扩展寄存器 */ 15 00 02 35 00 /* Tearing Effect Line ON */ 15 00 02 36 00 /* 扫描方向 */ 05 00 01 29 /* Display On */ ];翻译时注意三点一是命令里的延时不要省略尤其 Sleep Out 之后的 120ms少了它面板可能还没准备好就开始刷图二是厂商文档里的某些私有使能命令比如上面 0xFF 开头的扩展命令不能漏漏了后续所有命令都不生效三是最后一条通常必须有 0x29Display On漏掉这条的表现就是背光亮、屏也初始化了但一直白屏。2.3 背光与供电时序最容易翻车DSI 屏的供电树比 RGB 屏复杂常见有 VCI、VDDIO、AVDD、VSP/VSN甚至还有单独的触摸供电。全志 BSP 允许在 dts 里定义多个 GPIO 作为供电/复位/背光脚这些脚的触发顺序直接决定了屏能不能正常起来。我调屏的习惯是严格按照面板规格书的 Power Sequence 去排 GPIO 动作先打开模拟电源和 IO 电源等电压稳定再把复位脚拉低保持几十毫秒然后拉高释放复位释放后发送初始化命令等命令执行完最后才开背光。如果把背光使能和复位搞反了或者 VSP/VSN 没上电就发命令最常见的现象就是屏幕亮一下又黑、或者背光一亮整屏惨白。提示调试初期不要在 dts 里把所有 GPIO 的default-on都打开宁可一版配一个 GPIO逐项确认电压再组合起来。BSP 驱动 probe 失败时第一嫌疑就是 GPIO 被别的模块复用这一条在 T527 上尤其常见。3. 三阶段点亮uboot、内核、用户空间3.1 uboot 阶段先把它点亮BSP 调试里我习惯让屏幕先在 uboot 阶段亮起来。全志 uboot 显示驱动会解析同一份lcd0节点只要能打到 splash logo就说明面板初始化、DSI 链路、背光时序这三条最基本的问题已经过了。操作上很简单uboot 起来后看串口打印重点过滤lcd、panel、dsi这几个关键字。如果日志显示lcd_open_flow、panel_init没有报错但屏幕不亮先用万用表量背光使能脚有没有电平如果背光使能正常但仍黑屏就要回头查初始化序列是不是漏了0x11/0x29这种关键命令。uboot 阶段的显示驱动一般比较精简错误响应没有内核那么全必要时直接在驱动里加打印把初始化序列从头到尾打一遍能省很多猜的时间。uboot 能亮、内核起完变黑这种情况也见过不少问题通常不在屏而在内核的显示驱动没有正确 probe。接下来就要进内核阶段看。3.2 内核起来后确认 display 设备已经注册内核起来后第一步不是急着刷图而是确认显示设备有没有注册成功。全志 BSP 内核里通常可以看这几处dmesg | grep -iE display|disp|dsi|lcd0|panel如果驱动 probe 失败日志里往往会直接给probe fail或者timeout。再看 sysfsls /sys/class/disp/disp/ # 老 BSP 显示子系统 cat /sys/class/disp/disp/attr/sys如果是 DRM/KMS 分支会用modetest更直接modetest -M sun4i-drm能看到 connector/modes 列表说明内核里链路基本通了如果列表为空优先检查 dts 里dsi0和 panel 节点的status是不是okay以及compatible是否和驱动匹配。这一步解决的问题是“内核到底认不认这块屏”而不是“怎么调画面”。3.3 用一段小代码把画面打出来显示设备注册成功之后就该确认实际画面通路了。全志老 BSP 通常暴露/dev/fb0写一个简单的小程序往 framebuffer 里刷三段颜色就能快速判断是整链黑屏还是部分图层问题/* fb_fill.c —— 编译gcc -o fb_fill fb_fill.c */ #include stdio.h #include stdlib.h #include fcntl.h #include unistd.h #include sys/mman.h #include sys/ioctl.h #include linux/fb.h int main(void) { int fd open(/dev/fb0, O_RDWR); struct fb_var_screeninfo vi; if (fd 0) return 1; ioctl(fd, FBIOGET_VSCREENINFO, vi); unsigned int *fb mmap(NULL, vi.xres * vi.yres * 4, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0); for (unsigned int y 0; y vi.yres; y) for (unsigned int x 0; x vi.xres; x) { if (x vi.xres / 3) fb[y * vi.xres x] 0x00ff0000; else if (x vi.xres * 2 / 3) fb[y * vi.xres x] 0x0000ff00; else fb[y * vi.xres x] 0x000000ff; } munmap(fb, vi.xres * vi.yres * 4); close(fd); return 0; }跑完后屏幕上如果能看到红绿蓝三块说明 DE、DSI、面板整条显示通路是通的剩下的就是细调亮度和画面参数。如果三块颜色错位、颜色混杂别急着查用户空间先回到时序和 lane 配置上。4. 黑白花屏三类故障的定位思路4.1 黑屏、背光不亮先查电和 GPIO“黑屏”分两种背光不亮的真黑和背光亮但没画面的假黑。背光不亮最优先查背光使能脚和 PWM 配置用万用表量 LCD 接口处的背光供电再量使能脚电压。全志 BSP 里背光节点常见配置有enable-gpios、pwm-gpios如果节点明明写了 GPIO示波器却看不到电平翻转基本就是 pinctrl 复用冲突——同一个引脚被其他外设驱动占了DSI 屏自然不可能亮。还有一种情况是屏幕上电时序里某个供电轨没起来特别是 VSP/VSN 这类负压供电。测量时注意负压轨的地不要接反很多万用表笔误触一下屏的驱动 IC 就挂了。4.2 背光亮、整屏白色九成是初始化序列没走完白屏是我这次调 T527 时遇到最常见的现象。背光亮了说明供电和背光正常屏幕全白说明面板 IC 要么没收到初始化命令要么初始化没走到 Display On。处理思路是按顺序排查初始化序列先确认复位引脚真的释放了再确认为什么 DSI 命令没进去。全志驱动里如果命令发送失败有时不会主动报错只是默默跳过。这种情况我会在驱动里临时加一个对初始化每条命令的返回值打印如果驱动不打印返回码就用示波器抓 DSI 的 LP 命令波形看有没有命令包在线上。另外很多 DSI 驱动 IC 的初始化序列有一个共性必须以0x11退睡眠、以0x29开显示漏了任何一条屏都会停在出厂默认的白屏状态。拿到厂商初始化表后先扫一眼头尾这两条命令在不在能省掉一大半时间。4.3 花屏、色斑、滚动先怀疑时序和 lane 配置花屏的排查优先级比较高的是这几个点lcd_dsi_lane是否和面板实际接法一致4 lane 屏配成 2 lane 几乎必花lcd_ht、lcd_vt是否和规格书一致尤其 htotal 算错会造成画面左右错位或滚动lcd_pixel_freq是否准确太高或太低都会出现雪花般噪点DSI 工作在 Video Mode 还是 Command Mode配错模式会出现刷新率异常、局部残影。花屏不像黑白屏那么绝对它更像是“链路已经通了但参数没对齐”。建议一次只改一个变量先固定时序验证 lane 数再固定 lane调 htotal像素时钟最后动因为牵一发动全身。全志 BSP 里修改lcd0节点后如果内核和 uboot 共用 dtb记得两边都要重新编很多人只更新了内核 dtbuboot 里还是旧参数上电瞬间屏幕各种闪。4.4 用二分法把问题范围切开DSI 调试最怕的就是同时怀疑“供电、时序、初始化、驱动”四个环节。实操中我的做法永远是纵向三分uboot 亮不亮、内核日志有没有报错、fb/DRM 能不能刷色块。三步走完问题一定可以被归到其中一个环节。如果 uboot 亮、内核黑那问题几乎只在内核驱动和设备树如果 uboot 就黑再去量电、抓波形。这个顺序别看简单能防住一半以上的无效操作。另外还有一招非常实用找一块已知正常的板子把自己的 dtb 换过去如果能亮说明屏和线没问题问题在板级配置如果不能亮就要回到硬件和屏本身。这种替换法比加一百句打印都高效。5. 常见问题速查与避坑清单5.1 故障速查表现象优先排查方向常见根因背光不亮、屏完全黑背光供电、使能 GPIO、PWM 配置GPIO 复用冲突、背光节点 status 不对背光亮、整屏白初始化序列、复位时序缺少 0x11/0x29 命令复位未释放背光亮、雪花噪点像素时钟、lane 速率pixclk 配错每 lane bit rate 不足画面左右错位、滚动htotal、hbp、hspw行同步时序参数和规格书不一致画面局部残影、刷新慢Video/Command Mode、TE 信号DSI 工作模式配错TE 相关配置缺失上下电瞬间闪屏背光时序、电源时序背光开得太早供电未稳定5.2 每次调屏前过一遍的检查清单调多了之后我会在开工前把下面这张清单过一遍别看它啰嗦很多白屏问题都是被这张清单当场拦下来的。第一确认电源轨量一下屏端的主供电、IO 电压、VSP/VSN 是否都在规格书范围内负压轨特别容易漏。第二确认复位时序复位脚释放前供电要已经稳定复位低电平保持时间要够。第三确认 lane 数量和排列屏端和板端的 DSI 数据线不能内部交叉。第四确认像素时钟与 htotal/vtotal 匹配拿公式算一遍别凭感觉填。第五确认初始化序列有头有尾头是 Sleep Out尾是 Display On。第六确认背光开启晚于初始化背光亮起来那一刻面板必须已经准备好显示内容。这些看起来都是常识但 BSP 调试里恰恰是常识最容易翻车。全志 T527 这颗 SoC 的功能复用很密一个引脚经常同时出现在三四个外设的 pinctrl 选项里光“GPIO 被复用”这个问题我在不同板子上就遇到过四五回。5.3 改 dts 之前先给自己留后路这是我个人吃过亏之后养成的习惯任何改动之前把当前能正常工作的 dts 完整备份一份并且在文本里注明“此刻现象是什么”。同一块屏有时候它闪一下你以为是驱动问题改了几个参数改完发现还是一样但你已经不知道最开始是什么状态了。所以调屏时不要“一次改多个参数”。BSP 调试最怕并行验证同时动了时序、lane、初始化命令结果反而从白屏变成了花屏你根本不知道是哪一步造成的。只改一个参数验证一次记一次现象。慢但一定能把问题找出来。我就是用这个笨办法把这次 T527 的 DSI 从全白调到了正常出图。6. 这次调试的小体会最后再说一个我觉得对后来人最有用的习惯在本地维护一份“面板参数速查本”每次调完一块屏就把 dts 关键差异记下来。同样是 1080P 分辨率不同驱动 IC 的初始化命令完全不同寄存器的魔法数字更是加密一样过两个月连你自己都不一定能读懂更别说下一任接手的人。就我个人经验来说DSI 屏的很多问题并不是难在某个高深原理上而是难在“症状”和“根因”之间隔了好几层。一次黑屏可能是背光 GPIO 没起来可能是 MIPI 信号根本没发出也可能是面板命令卡在中间。只要把调试顺序固定成“先电、再时序、后信号”把每次改动记录清楚黑白花屏都是纸老虎。这次 T527 的 MIPI DSI 算是在第 11 篇连载里收尾了。后面如果同系列里再遇到更刁钻的屏参问题比如多颗并接、双 DSI、或者是带触摸干扰的显示链路我再单独开一篇写。
