1. 项目概述与核心思路最近在做一个工业HMI的项目客户指定要用LVDS接口的屏幕分辨率是1024x600。手头正好有飞凌嵌入式的OK113i-S开发板它的核心板FET113i-S是全志T113-i平台显示接口很全LVDS自然也在支持之列。从拿到新屏幕到让它正常点亮显示整个过程其实就是给开发板“换眼睛”的过程核心工作就是修改设备树DTS和U-Boot里的显示参数让软件驱动和硬件屏体对上“暗号”。听起来好像就是改几个数字但实际做起来如果没摸清门道很容易卡在诸如黑屏、花屏、显示偏移或者压根不亮这些问题上。这篇文章我就结合这次适配1024x600 LVDS屏的实际经历把从原理到实操再到踩坑排雷的完整过程拆解清楚。无论你是刚接触嵌入式显示的工程师还是正在为特定屏幕适配发愁的朋友这套方法都能提供一个清晰的参考路径。不同平台的具体文件路径和参数名称会有差异但“修改设备树和引导程序显示参数”这个核心思路是相通的。2. LVDS显示原理与关键参数解析在动手改代码之前我们得先搞明白我们要改的到底是什么以及为什么这些参数如此重要。这能帮你避免很多低级错误并且在出问题时能有方向地去排查。2.1 LVDS接口与信号特点LVDS中文叫低电压差分信号。你可以把它想象成两个人说悄悄话一个人说“是”同时另一个人必须说“不是”。接收端不听他们各自说了什么只关心他俩说的“差值”。这种“差分”传输的方式对外部电磁干扰的抵抗能力极强因为干扰往往同时作用于两根信号线而差值保持不变。所以LVDS能在低电压通常350mV左右下实现高速、远距离、低功耗的传输特别适合工业环境这种“电噪声”比较大的场合。一块LVDS屏幕要正常显示主板我们的开发板需要提供以下几组关键信号LVDS数据通道通常是4对或8对差分数据线Data0/-, Data1/-, …用于传输实际的像素数据RGB色彩信息。LVDS时钟通道1对差分时钟线CLK/CLK-为数据传输提供同步基准。屏供电VCC与背光供电给屏幕逻辑板和背光LED供电。控制信号如使能ENABLE、复位RESET等用于控制屏幕的开关和初始化时序。我们的适配工作主要就是精准配置与数据、时钟相关的电气特性和时序。2.2 设备树DTS中的显示参数详解设备树是Linux内核用来描述硬件配置的数据结构。对于显示子系统我们需要在DTS里正确描述显示控制器和屏幕本身。以全志T113-i平台为例在OK113I-C-Linux.dts文件中屏幕的参数通常定义在一个名为lcd0的节点中。这里面的每一个参数都至关重要lcd0 { lcd_used 1; // 1表示使用此LCD配置 lcd_driver_name default_lcd; // 驱动名通常与屏驱动对应 lcd_if 3; // 接口类型3通常代表LVDS lcd_x 1024; // 屏幕水平像素宽度 lcd_y 600; // 屏幕垂直像素高度 lcd_width 154; // 屏幕物理宽度毫米用于计算DPI lcd_height 85; // 屏幕物理高度毫米 lcd_dclk_freq 51; // 像素时钟频率MHz核心参数 /* 时序参数单位通常是像素时钟周期数 */ lcd_ht 1344; // 水平总周期数H Total lcd_hbp 160; // 水平后沿H Back Porch lcd_hspw 20; // 水平同步脉冲宽度H Sync Width lcd_vt 635; // 垂直总行数V Total lcd_vbp 23; // 垂直后沿V Back Porch lcd_vspw 3; // 垂直同步脉冲宽度V Sync Width /* 极性参数 */ lcd_hv_if 0; // HV接口模式LVDS屏通常为0 lcd_hv_clk_phase 0; // 时钟相位 lcd_hv_sync_polarity 0; // 同步信号极性0/1代表低/高有效 lcd_lvds_if 0; // LVDS模式0:JEIDA, 1:VESA lcd_lvds_colordepth 1; // 色彩深度0:18bit, 1:24bit lcd_lvds_mode 0; // LVDS通道模式0:单通道1:双通道 ... };关键参数计算与获取方法lcd_dclk_freq像素时钟这是驱动屏幕的“心跳”。计算公式为像素时钟 (MHz) (水平总像素 * 垂直总行数 * 刷新率) / 1000000。对于1024x60060Hz(1344 * 635 * 60) / 1e6 ≈ 51.2 MHz所以填51。这个值必须非常准确误差太大会导致显示不稳定或黑屏。lcd_ht,lcd_hbp,lcd_hspw,lcd_vt,lcd_vbp,lcd_vspw这些时序参数定义了每一帧图像是如何被“绘制”到屏幕上的。它们共同决定了消隐区Blanking的大小。这些参数的唯一正确来源是你的屏幕规格书Datasheet绝对不要凭感觉猜。规格书的“Input Signal Timing”表格里会明确给出这些值。lcd_lvds_if和lcd_lvds_mode这是LVDS特有的两个易错点。lcd_lvds_if定义数据格式映射是JEIDA标准还是VESA标准。接错了颜色通道会错乱比如红色显示成蓝色。lcd_lvds_mode定义是单通道1个时钟对3个数据对还是双通道1个时钟对5个或更多数据对传输。6位屏常用单通道8位屏或高分辨率屏需要双通道以提高带宽。1024x600的24位色屏单通道带宽勉强够用但为了稳定很多屏会设计为双通道模式。实操心得屏参获取问屏厂要规格书是最直接的方式。如果实在没有可以尝试用已知好用的配置文件如开发板原配屏的配置作为基础然后根据新屏幕的尺寸和分辨率重点调整lcd_x,lcd_y,lcd_dclk_freq和时序参数。也可以使用一些专业的显示测试仪如RTD来捕获屏幕的准确时序。最“土”但有时有效的方法是找一个能点亮该屏幕的其他主板读取其寄存器配置来反推参数。2.3 U-Boot中的显示配置为什么改了内核的设备树还要改U-Boot因为开发板上电后CPU先执行U-BootU-Boot需要初始化显示控制器并输出Logo或命令行。如果U-Boot阶段的显示参数尤其是分辨率与内核不一致可能会导致以下问题U-Boot Logo显示异常拉伸、压缩、偏移。从U-Boot向内核交接显示控制权时发生冲突导致内核启动后黑屏。早期调试信息输出到帧缓冲Framebuffer时错位。在全志平台的U-Boot中显示参数通常在一个独立的C文件里配置例如display_menu.c或disp.c。你需要修改的是一组类似struct disp_video_timings的结构体变量里面包含了与DTS中类似的分辨率、时序、极性等参数。关键点务必保证U-Boot中配置的xres,yres,hor_total_time,ver_total_time等核心时序参数与内核设备树中的lcd_x,lcd_y,lcd_ht,lcd_vt等完全对应。极性设置hsync_polarity,vsync_polarity也必须一致。3. 为OK113i-S适配1024x600 LVDS屏全流程下面进入实战环节。假设你的开发环境已经搭建好SDK源码、交叉编译工具链等我们目标是适配一款型号为“XXX1024x600”的LVDS屏。3.1 准备工作获取屏幕规格书并解读首先向屏幕供应商索要《XXX1024x600 LCD Specification》文档。找到“Interface”和“Input Signal Timing”章节。我们需要从中提取以下信息参数项符号典型值示例对应DTS/U-Boot字段分辨率-1024 x 600lcd_x,lcd_y像素时钟DCLK51.2 MHzlcd_dclk_freq水平显示区H. Display1024(已包含在lcd_x)水平前沿H. Front Porch160lcd_hfp(需计算)水平同步脉宽H. Sync Width20lcd_hspw水平后沿H. Back Porch140lcd_hbp水平总周期H. Total1344lcd_ht垂直显示区V. Display600(已包含在lcd_y)垂直前沿V. Front Porch12lcd_vfp(需计算)垂直同步脉宽V. Sync Width3lcd_vspw垂直后沿V. Back Porch23lcd_vbp垂直总行数V. Total635lcd_vt同步极性H/V Sync PolarityH: Low, V: Lowlcd_hv_sync_polarityLVDS格式LVDS FormatJEIDAlcd_lvds_if 0色彩深度Color Depth24-bit RGBlcd_lvds_colordepth 1通道数ChannelDual (2 ch)lcd_lvds_mode 1注意有些规格书只给H. Total、H. Sync、H. Back Porch、H. Display此时H. Front Porch H. Total - H. Sync - H. Back Porch - H. Display。垂直方向同理。我们的DTS参数里通常直接使用hbp后沿和hfp前沿所以需要根据公式换算或确认。3.2 步骤一修改内核设备树DTS定位并备份原文件cd ~/work/linux/OK113i-linux-sdk/kernel/linux-5.4/arch/arm/boot/dts cp OK113I-C-Linux.dts OK113I-C-Linux.dts.backup编辑DTS文件vi OK113I-C-Linux.dts使用搜索功能在vi中按/输入lcd0找到显示配置节点。将我们根据规格书整理出的参数替换进去。以下是一个修改后的示例片段lcd0 { lcd_used 1; lcd_driver_name lvds_1024x600; lcd_if 3; // LVDS接口 lcd_x 1024; lcd_y 600; lcd_width 154; lcd_height 85; lcd_dclk_freq 51; lcd_ht 1344; lcd_hbp 160; // 注意这里可能对应规格书的H.Back Porch H.Sync需根据平台驱动定义确认 lcd_hspw 20; lcd_vt 635; lcd_vbp 23; // 同上注意定义 lcd_vspw 3; lcd_hv_if 0; lcd_hv_clk_phase 0; lcd_hv_sync_polarity 0; // 根据规格书HSYNC和VSYNC都是低有效所以填0 lcd_lvds_if 0; // JEIDA格式 lcd_lvds_colordepth 1; // 24bit lcd_lvds_mode 1; // 双通道模式 // ... 可能还有其他背光、电源控制参数根据屏幕规格调整 lcd_power_positive_seq ...; // 上电时序 lcd_power_negative_seq ...; // 下电时序 };重要提示lcd_hbp和lcd_vbp在不同平台驱动中的定义可能不同有些驱动将其定义为“后沿同步脉宽”有些则只定义为“后沿”。最可靠的方法是参考SDK中已有屏幕如原配800x480屏的配置看它的参数与规格书是如何对应的然后依葫芦画瓢。这是最容易出错的地方之一。保存并退出。3.3 步骤二修改U-Boot显示配置定位U-Boot显示配置文件cd ~/work/linux/OK113i-linux-sdk/brandy/brandy-2.0/u-boot-2018/drivers/video/sunxi/通常配置文件在bootGUI或disp子目录下。根据原文章提示我们找到bootGUI/display_menu.c。编辑display_menu.cvi bootGUI/display_menu.c在文件中搜索1024、600或timings等关键词找到显示时序结构体数组。修改对应条目或新增一个static struct disp_video_timings lcd_video_timing[] { // ... 可能已有其他配置 { .vic 0; // 自定义ID .tv_mode 0; .pixel_clk 51200000; // 单位可能是Hz51.2MHz .pixel_repeat 0; .x_res 1024, .y_res 600, .hor_total_time 1344, .hor_back_porch 160, // 注意与DTS定义对齐 .hor_front_porch 140, // 计算得出1344 - 1024 - 20 - 160 140 .hor_sync_time 20, .ver_total_time 635, .ver_back_porch 23, .ver_front_porch 12, // 计算得出635 - 600 - 3 - 23 12 .ver_sync_time 3, .hor_sync_polarity 0, // 低有效 .ver_sync_polarity 0, // 低有效 .b_interlace 0, }, // ... };核心检查确保这里的hor_total_time,hor_sync_time,hor_back_porch,x_res之和等于hor_total_time1344。垂直方向同理。极性参数必须与DTS一致。3.4 步骤三编译与烧录编译U-Boot 返回到SDK根目录执行U-Boot的编译命令。这能确保显示配置被编译进去。cd ~/work/linux/OK113i-linux-sdk ./build.sh brandy全编译内核与文件系统 U-Boot编译成功后进行全系统编译。./build.sh这个过程会编译内核包含我们修改的DTS、驱动、文件系统等。打包镜像 编译成功后将所有组件打包成可供烧录的固件镜像。./build.sh pack成功后在out/目录下会生成t113_ok113i-s_uart0.img之类的镜像文件。烧录与上电测试 使用全志的PhoenixSuit或LiveSuit工具将镜像烧录到开发板的存储中。烧录完成后断开USB给开发板上电。第一阶段观察上电瞬间观察U-Boot阶段的Logo或命令行输出是否正常显示在屏幕中央比例是否正确。第二阶段观察Linux内核启动后查看是否出现企鹅Logo如果配置了以及最终的Qt/命令行界面是否正常满屏显示。4. 常见问题排查与调试技巧实录即使参数看起来都对了第一次点亮屏幕也常常会遇到问题。下面是我在多次调屏中总结的排查清单。4.1 问题一上电后屏幕完全黑屏背光也不亮排查思路检查硬件连接这是第一步也是最容易忽略的一步。确认LVDS排线已插紧方向正确防呆口对齐。用万用表测量屏幕供电引脚通常是3.3V或5V、12V是否有电压。测量背光供电LED/-是否有电压可能高达20V。检查使能信号查看DTS中屏幕的电源使能lcd_power和背光使能lcd_blGPIO配置是否正确。可以用示波器或逻辑分析仪抓取该GPIO上电后的波形看是否有从低到高的跳变。检查核心参数确认DTS中lcd_used 1。确认lcd_if设置正确LVDS是3。重点核对lcd_dclk_freq误差过大会导致无输出。4.2 问题二屏幕亮但无图像白屏、灰屏、彩条屏排查思路LVDS格式与通道模式这是白屏/彩条的常见原因。检查lcd_lvds_ifJEIDA/VESA和lcd_lvds_mode单/双通道是否与屏幕规格严格一致。接错格式会导致颜色数据解析全乱可能表现为白屏或固定彩条。时序参数错误虽然有时能亮但时序严重不符可能导致控制器无法同步到有效图像区域。逐字核对lcd_ht,lcd_hbp,lcd_hspw,lcd_vt,lcd_vbp,lcd_vspw与规格书是否一致并注意平台的特殊定义。像素时钟偏差lcd_dclk_freq不准确可能导致图像无法稳定显示。尝试微调这个值±1MHz看是否有变化。4.3 问题三图像显示偏移、滚动、撕裂或闪烁排查思路同步极性错误检查lcd_hv_sync_polarity。如果设反了图像可能偏移或滚动。尝试改为1看看。前后沿Porch设置不当hbp/hfp或vbp/vfp设置太小可能导致图像边缘被切割或显示不稳定。适当增大这些值在规格书允许范围内。时钟相位问题尝试调整lcd_hv_clk_phase0或180这会影响数据采样的中心对准解决图像模糊或闪烁。4.4 问题四U-Boot显示正常但进入Linux后黑屏排查思路帧缓冲Framebuffer冲突这是典型症状。根本原因是U-Boot和内核使用了不同的显示参数或内存区域。确保两者参数完全一致。此外可以尝试在U-Boot命令行中在内核启动命令bootm或booti里添加video参数来指定帧缓冲例如videoHDMI-A-1:1024x60060具体格式需查内核文档强制内核使用指定配置。内核驱动未加载或报错通过串口查看内核启动日志dmesg | grep lcd或dmesg | grep disp检查显示驱动是否成功加载是否有错误信息如“probe failed”。设备树未生效确认编译内核时你的DTS修改被正确编译成DTB文件并打包进镜像。可以检查arch/arm/boot/dts/目录下对应的.dtb文件生成时间。4.5 高级调试手段使用示波器/逻辑分析仪这是最强大的调试工具。可以测量LVDS时钟线是否有信号频率是否为51.2MHz、数据线是否有差分信号活动、同步信号极性是否正确。可以直观地验证硬件链路和基本时序。修改内核日志等级在内核命令行中添加loglevel8或debug让内核输出更详细的驱动信息有助于定位初始化失败的位置。查阅芯片手册对于极其棘手的问题可能需要查阅全志T113-i的用户手册了解显示控制器DE、TCON寄存器的详细定义通过编写小程序或修改驱动直接读写寄存器进行更底层的调试。调屏是个需要耐心和细致的过程参数差一点都可能失败。最好的习惯是每次只修改一个参数修改后立即编译测试这样一旦出现问题能快速定位到是哪个参数的改动引起的。把屏幕规格书、平台参考手册、一份已知可用的配置作为“三件套”放在手边对照着来能解决大部分问题。
嵌入式LVDS屏幕适配实战：从设备树到U-Boot的1024x600工业屏点亮指南
发布时间：2026/5/21 6:27:19
1. 项目概述与核心思路最近在做一个工业HMI的项目客户指定要用LVDS接口的屏幕分辨率是1024x600。手头正好有飞凌嵌入式的OK113i-S开发板它的核心板FET113i-S是全志T113-i平台显示接口很全LVDS自然也在支持之列。从拿到新屏幕到让它正常点亮显示整个过程其实就是给开发板“换眼睛”的过程核心工作就是修改设备树DTS和U-Boot里的显示参数让软件驱动和硬件屏体对上“暗号”。听起来好像就是改几个数字但实际做起来如果没摸清门道很容易卡在诸如黑屏、花屏、显示偏移或者压根不亮这些问题上。这篇文章我就结合这次适配1024x600 LVDS屏的实际经历把从原理到实操再到踩坑排雷的完整过程拆解清楚。无论你是刚接触嵌入式显示的工程师还是正在为特定屏幕适配发愁的朋友这套方法都能提供一个清晰的参考路径。不同平台的具体文件路径和参数名称会有差异但“修改设备树和引导程序显示参数”这个核心思路是相通的。2. LVDS显示原理与关键参数解析在动手改代码之前我们得先搞明白我们要改的到底是什么以及为什么这些参数如此重要。这能帮你避免很多低级错误并且在出问题时能有方向地去排查。2.1 LVDS接口与信号特点LVDS中文叫低电压差分信号。你可以把它想象成两个人说悄悄话一个人说“是”同时另一个人必须说“不是”。接收端不听他们各自说了什么只关心他俩说的“差值”。这种“差分”传输的方式对外部电磁干扰的抵抗能力极强因为干扰往往同时作用于两根信号线而差值保持不变。所以LVDS能在低电压通常350mV左右下实现高速、远距离、低功耗的传输特别适合工业环境这种“电噪声”比较大的场合。一块LVDS屏幕要正常显示主板我们的开发板需要提供以下几组关键信号LVDS数据通道通常是4对或8对差分数据线Data0/-, Data1/-, …用于传输实际的像素数据RGB色彩信息。LVDS时钟通道1对差分时钟线CLK/CLK-为数据传输提供同步基准。屏供电VCC与背光供电给屏幕逻辑板和背光LED供电。控制信号如使能ENABLE、复位RESET等用于控制屏幕的开关和初始化时序。我们的适配工作主要就是精准配置与数据、时钟相关的电气特性和时序。2.2 设备树DTS中的显示参数详解设备树是Linux内核用来描述硬件配置的数据结构。对于显示子系统我们需要在DTS里正确描述显示控制器和屏幕本身。以全志T113-i平台为例在OK113I-C-Linux.dts文件中屏幕的参数通常定义在一个名为lcd0的节点中。这里面的每一个参数都至关重要lcd0 { lcd_used 1; // 1表示使用此LCD配置 lcd_driver_name default_lcd; // 驱动名通常与屏驱动对应 lcd_if 3; // 接口类型3通常代表LVDS lcd_x 1024; // 屏幕水平像素宽度 lcd_y 600; // 屏幕垂直像素高度 lcd_width 154; // 屏幕物理宽度毫米用于计算DPI lcd_height 85; // 屏幕物理高度毫米 lcd_dclk_freq 51; // 像素时钟频率MHz核心参数 /* 时序参数单位通常是像素时钟周期数 */ lcd_ht 1344; // 水平总周期数H Total lcd_hbp 160; // 水平后沿H Back Porch lcd_hspw 20; // 水平同步脉冲宽度H Sync Width lcd_vt 635; // 垂直总行数V Total lcd_vbp 23; // 垂直后沿V Back Porch lcd_vspw 3; // 垂直同步脉冲宽度V Sync Width /* 极性参数 */ lcd_hv_if 0; // HV接口模式LVDS屏通常为0 lcd_hv_clk_phase 0; // 时钟相位 lcd_hv_sync_polarity 0; // 同步信号极性0/1代表低/高有效 lcd_lvds_if 0; // LVDS模式0:JEIDA, 1:VESA lcd_lvds_colordepth 1; // 色彩深度0:18bit, 1:24bit lcd_lvds_mode 0; // LVDS通道模式0:单通道1:双通道 ... };关键参数计算与获取方法lcd_dclk_freq像素时钟这是驱动屏幕的“心跳”。计算公式为像素时钟 (MHz) (水平总像素 * 垂直总行数 * 刷新率) / 1000000。对于1024x60060Hz(1344 * 635 * 60) / 1e6 ≈ 51.2 MHz所以填51。这个值必须非常准确误差太大会导致显示不稳定或黑屏。lcd_ht,lcd_hbp,lcd_hspw,lcd_vt,lcd_vbp,lcd_vspw这些时序参数定义了每一帧图像是如何被“绘制”到屏幕上的。它们共同决定了消隐区Blanking的大小。这些参数的唯一正确来源是你的屏幕规格书Datasheet绝对不要凭感觉猜。规格书的“Input Signal Timing”表格里会明确给出这些值。lcd_lvds_if和lcd_lvds_mode这是LVDS特有的两个易错点。lcd_lvds_if定义数据格式映射是JEIDA标准还是VESA标准。接错了颜色通道会错乱比如红色显示成蓝色。lcd_lvds_mode定义是单通道1个时钟对3个数据对还是双通道1个时钟对5个或更多数据对传输。6位屏常用单通道8位屏或高分辨率屏需要双通道以提高带宽。1024x600的24位色屏单通道带宽勉强够用但为了稳定很多屏会设计为双通道模式。实操心得屏参获取问屏厂要规格书是最直接的方式。如果实在没有可以尝试用已知好用的配置文件如开发板原配屏的配置作为基础然后根据新屏幕的尺寸和分辨率重点调整lcd_x,lcd_y,lcd_dclk_freq和时序参数。也可以使用一些专业的显示测试仪如RTD来捕获屏幕的准确时序。最“土”但有时有效的方法是找一个能点亮该屏幕的其他主板读取其寄存器配置来反推参数。2.3 U-Boot中的显示配置为什么改了内核的设备树还要改U-Boot因为开发板上电后CPU先执行U-BootU-Boot需要初始化显示控制器并输出Logo或命令行。如果U-Boot阶段的显示参数尤其是分辨率与内核不一致可能会导致以下问题U-Boot Logo显示异常拉伸、压缩、偏移。从U-Boot向内核交接显示控制权时发生冲突导致内核启动后黑屏。早期调试信息输出到帧缓冲Framebuffer时错位。在全志平台的U-Boot中显示参数通常在一个独立的C文件里配置例如display_menu.c或disp.c。你需要修改的是一组类似struct disp_video_timings的结构体变量里面包含了与DTS中类似的分辨率、时序、极性等参数。关键点务必保证U-Boot中配置的xres,yres,hor_total_time,ver_total_time等核心时序参数与内核设备树中的lcd_x,lcd_y,lcd_ht,lcd_vt等完全对应。极性设置hsync_polarity,vsync_polarity也必须一致。3. 为OK113i-S适配1024x600 LVDS屏全流程下面进入实战环节。假设你的开发环境已经搭建好SDK源码、交叉编译工具链等我们目标是适配一款型号为“XXX1024x600”的LVDS屏。3.1 准备工作获取屏幕规格书并解读首先向屏幕供应商索要《XXX1024x600 LCD Specification》文档。找到“Interface”和“Input Signal Timing”章节。我们需要从中提取以下信息参数项符号典型值示例对应DTS/U-Boot字段分辨率-1024 x 600lcd_x,lcd_y像素时钟DCLK51.2 MHzlcd_dclk_freq水平显示区H. Display1024(已包含在lcd_x)水平前沿H. Front Porch160lcd_hfp(需计算)水平同步脉宽H. Sync Width20lcd_hspw水平后沿H. Back Porch140lcd_hbp水平总周期H. Total1344lcd_ht垂直显示区V. Display600(已包含在lcd_y)垂直前沿V. Front Porch12lcd_vfp(需计算)垂直同步脉宽V. Sync Width3lcd_vspw垂直后沿V. Back Porch23lcd_vbp垂直总行数V. Total635lcd_vt同步极性H/V Sync PolarityH: Low, V: Lowlcd_hv_sync_polarityLVDS格式LVDS FormatJEIDAlcd_lvds_if 0色彩深度Color Depth24-bit RGBlcd_lvds_colordepth 1通道数ChannelDual (2 ch)lcd_lvds_mode 1注意有些规格书只给H. Total、H. Sync、H. Back Porch、H. Display此时H. Front Porch H. Total - H. Sync - H. Back Porch - H. Display。垂直方向同理。我们的DTS参数里通常直接使用hbp后沿和hfp前沿所以需要根据公式换算或确认。3.2 步骤一修改内核设备树DTS定位并备份原文件cd ~/work/linux/OK113i-linux-sdk/kernel/linux-5.4/arch/arm/boot/dts cp OK113I-C-Linux.dts OK113I-C-Linux.dts.backup编辑DTS文件vi OK113I-C-Linux.dts使用搜索功能在vi中按/输入lcd0找到显示配置节点。将我们根据规格书整理出的参数替换进去。以下是一个修改后的示例片段lcd0 { lcd_used 1; lcd_driver_name lvds_1024x600; lcd_if 3; // LVDS接口 lcd_x 1024; lcd_y 600; lcd_width 154; lcd_height 85; lcd_dclk_freq 51; lcd_ht 1344; lcd_hbp 160; // 注意这里可能对应规格书的H.Back Porch H.Sync需根据平台驱动定义确认 lcd_hspw 20; lcd_vt 635; lcd_vbp 23; // 同上注意定义 lcd_vspw 3; lcd_hv_if 0; lcd_hv_clk_phase 0; lcd_hv_sync_polarity 0; // 根据规格书HSYNC和VSYNC都是低有效所以填0 lcd_lvds_if 0; // JEIDA格式 lcd_lvds_colordepth 1; // 24bit lcd_lvds_mode 1; // 双通道模式 // ... 可能还有其他背光、电源控制参数根据屏幕规格调整 lcd_power_positive_seq ...; // 上电时序 lcd_power_negative_seq ...; // 下电时序 };重要提示lcd_hbp和lcd_vbp在不同平台驱动中的定义可能不同有些驱动将其定义为“后沿同步脉宽”有些则只定义为“后沿”。最可靠的方法是参考SDK中已有屏幕如原配800x480屏的配置看它的参数与规格书是如何对应的然后依葫芦画瓢。这是最容易出错的地方之一。保存并退出。3.3 步骤二修改U-Boot显示配置定位U-Boot显示配置文件cd ~/work/linux/OK113i-linux-sdk/brandy/brandy-2.0/u-boot-2018/drivers/video/sunxi/通常配置文件在bootGUI或disp子目录下。根据原文章提示我们找到bootGUI/display_menu.c。编辑display_menu.cvi bootGUI/display_menu.c在文件中搜索1024、600或timings等关键词找到显示时序结构体数组。修改对应条目或新增一个static struct disp_video_timings lcd_video_timing[] { // ... 可能已有其他配置 { .vic 0; // 自定义ID .tv_mode 0; .pixel_clk 51200000; // 单位可能是Hz51.2MHz .pixel_repeat 0; .x_res 1024, .y_res 600, .hor_total_time 1344, .hor_back_porch 160, // 注意与DTS定义对齐 .hor_front_porch 140, // 计算得出1344 - 1024 - 20 - 160 140 .hor_sync_time 20, .ver_total_time 635, .ver_back_porch 23, .ver_front_porch 12, // 计算得出635 - 600 - 3 - 23 12 .ver_sync_time 3, .hor_sync_polarity 0, // 低有效 .ver_sync_polarity 0, // 低有效 .b_interlace 0, }, // ... };核心检查确保这里的hor_total_time,hor_sync_time,hor_back_porch,x_res之和等于hor_total_time1344。垂直方向同理。极性参数必须与DTS一致。3.4 步骤三编译与烧录编译U-Boot 返回到SDK根目录执行U-Boot的编译命令。这能确保显示配置被编译进去。cd ~/work/linux/OK113i-linux-sdk ./build.sh brandy全编译内核与文件系统 U-Boot编译成功后进行全系统编译。./build.sh这个过程会编译内核包含我们修改的DTS、驱动、文件系统等。打包镜像 编译成功后将所有组件打包成可供烧录的固件镜像。./build.sh pack成功后在out/目录下会生成t113_ok113i-s_uart0.img之类的镜像文件。烧录与上电测试 使用全志的PhoenixSuit或LiveSuit工具将镜像烧录到开发板的存储中。烧录完成后断开USB给开发板上电。第一阶段观察上电瞬间观察U-Boot阶段的Logo或命令行输出是否正常显示在屏幕中央比例是否正确。第二阶段观察Linux内核启动后查看是否出现企鹅Logo如果配置了以及最终的Qt/命令行界面是否正常满屏显示。4. 常见问题排查与调试技巧实录即使参数看起来都对了第一次点亮屏幕也常常会遇到问题。下面是我在多次调屏中总结的排查清单。4.1 问题一上电后屏幕完全黑屏背光也不亮排查思路检查硬件连接这是第一步也是最容易忽略的一步。确认LVDS排线已插紧方向正确防呆口对齐。用万用表测量屏幕供电引脚通常是3.3V或5V、12V是否有电压。测量背光供电LED/-是否有电压可能高达20V。检查使能信号查看DTS中屏幕的电源使能lcd_power和背光使能lcd_blGPIO配置是否正确。可以用示波器或逻辑分析仪抓取该GPIO上电后的波形看是否有从低到高的跳变。检查核心参数确认DTS中lcd_used 1。确认lcd_if设置正确LVDS是3。重点核对lcd_dclk_freq误差过大会导致无输出。4.2 问题二屏幕亮但无图像白屏、灰屏、彩条屏排查思路LVDS格式与通道模式这是白屏/彩条的常见原因。检查lcd_lvds_ifJEIDA/VESA和lcd_lvds_mode单/双通道是否与屏幕规格严格一致。接错格式会导致颜色数据解析全乱可能表现为白屏或固定彩条。时序参数错误虽然有时能亮但时序严重不符可能导致控制器无法同步到有效图像区域。逐字核对lcd_ht,lcd_hbp,lcd_hspw,lcd_vt,lcd_vbp,lcd_vspw与规格书是否一致并注意平台的特殊定义。像素时钟偏差lcd_dclk_freq不准确可能导致图像无法稳定显示。尝试微调这个值±1MHz看是否有变化。4.3 问题三图像显示偏移、滚动、撕裂或闪烁排查思路同步极性错误检查lcd_hv_sync_polarity。如果设反了图像可能偏移或滚动。尝试改为1看看。前后沿Porch设置不当hbp/hfp或vbp/vfp设置太小可能导致图像边缘被切割或显示不稳定。适当增大这些值在规格书允许范围内。时钟相位问题尝试调整lcd_hv_clk_phase0或180这会影响数据采样的中心对准解决图像模糊或闪烁。4.4 问题四U-Boot显示正常但进入Linux后黑屏排查思路帧缓冲Framebuffer冲突这是典型症状。根本原因是U-Boot和内核使用了不同的显示参数或内存区域。确保两者参数完全一致。此外可以尝试在U-Boot命令行中在内核启动命令bootm或booti里添加video参数来指定帧缓冲例如videoHDMI-A-1:1024x60060具体格式需查内核文档强制内核使用指定配置。内核驱动未加载或报错通过串口查看内核启动日志dmesg | grep lcd或dmesg | grep disp检查显示驱动是否成功加载是否有错误信息如“probe failed”。设备树未生效确认编译内核时你的DTS修改被正确编译成DTB文件并打包进镜像。可以检查arch/arm/boot/dts/目录下对应的.dtb文件生成时间。4.5 高级调试手段使用示波器/逻辑分析仪这是最强大的调试工具。可以测量LVDS时钟线是否有信号频率是否为51.2MHz、数据线是否有差分信号活动、同步信号极性是否正确。可以直观地验证硬件链路和基本时序。修改内核日志等级在内核命令行中添加loglevel8或debug让内核输出更详细的驱动信息有助于定位初始化失败的位置。查阅芯片手册对于极其棘手的问题可能需要查阅全志T113-i的用户手册了解显示控制器DE、TCON寄存器的详细定义通过编写小程序或修改驱动直接读写寄存器进行更底层的调试。调屏是个需要耐心和细致的过程参数差一点都可能失败。最好的习惯是每次只修改一个参数修改后立即编译测试这样一旦出现问题能快速定位到是哪个参数的改动引起的。把屏幕规格书、平台参考手册、一份已知可用的配置作为“三件套”放在手边对照着来能解决大部分问题。
