简介面向联发科平台的LT9611驱动源码包聚焦MTK芯片上LT9611型号设备默认输出1080p的驱动实现适合嵌入式驱动工程师、系统集成人员参考。压缩包仅5个文件包含3个C源码文件和2个dws配置文件整体约21KB。C源码分别对应LK引导阶段与kernel内核阶段中DSI转HDMI的驱动逻辑dws文件则用于配置显示相关的引脚复用和参数能够帮助梳理从驱动注册、I2C通信、寄存器初始化到1080p时序输出的完整链路。已有974人学习可配合屏幕规格书和芯片手册进行驱动移植、输出参数调整或显示异常排查。借助这份精简代码开发者可以快速理解LT9611在MTK平台上的挂载方式对比官方驱动校准分辨率与像素时钟并将代码整合到自己的系统镜像中显著缩短显示模块的开发验证周期。对于需要定制视频输出或修复高清显示问题的场景其中关于引脚配置、初始化流程和时序参数的细节均有直接参考价值。1. MTK平台上的LT9611这块DSI转HDMI桥接芯片决定了你开机logo能不能亮mtk平台 lt9611 这个组合最近在我手上至少跟进了三轮 bring-up。LT9611 是龙迅的方案做 DSI 转 HDMI 桥接主控用 MIPI DSI 输出桥接芯片转成 HDMI 给显示器或者电视默认就是 1080p。很多平板、盒子、车载中控的 HDMI 输出都走这条路径。我拿到这份 mtk-lt9611 源码包时第一反应是看 LK 阶段那份 lt9611_dsi2hdmi.c——MTK 的开机 logo 是 LK 画的HDMI 输出能不能在 bootloader 阶段起来直接决定用户按下电源键之后看到的是 logo 还是黑屏。这个包适合正在做 MTK 平台 HDMI 移植的 BSP 工程师也适合刚接手这类项目、想搞明白 DSI 转 HDMI 到底怎么配置的驱动入门者。2. 源码包的结构LK 与 Kernel 两套驱动一条数据链路2.1 五个关键文件谁管初始化谁管时序谁管引脚这份资源的核心文件其实不多但每个都不能少。先说文件职责再讲调用关系。文件所在阶段职责lk/lt9611_dsi2hdmi.cLKbootloader 阶段初始化 LT9611输出开机 logokernel/lt9611_dsi2hdmi.cKernel系统起来后的显示驱动负责正常的 HDMI 输出lt9611_v1_3_MTK658_0628.c参考原厂针对 MTK658 平台的 V1.3 版本参考代码0628 是构建日期标记codegen.dws配置MTK 的引脚复用配置定义 I2C、复位、使能引脚tb8735ap1_lr_ztk.dws配置板级 DWS适配 tb8735ap1_lr_ztk 这块具体硬件的 GPIO 分配项目代号 stomachhcc 应该就是这个方案在你们工程里的内部命名具体含义得问硬件那边但源码包里 dws 文件名对应的就是具体板子。最容易被忽略的是最后一个板级 dws。codegen.dws 是芯片级的通用复用表tb8735ap1_lr_ztk.dws 才是这块板子真正的引脚分配。我之前接过一个项目两个 dws 里的复位引脚不一致代码里用的是 GPIO 28dws 里复用成了 PWM 功能结果 LT9611 一直不复位I2C 完全不通。这种问题光看驱动代码永远查不出来必须逐个引脚对 dws。2.2 LK 阶段开机 logo 能不能亮全靠这段驱动MTK 的 LKLittle Kernel是 bootloader负责初始化内存、显示、触摸这类最小外设。开机 logo 就是在 LK 里画的。LT9611 要在 LK 阶段工作驱动必须被编译进 LK 镜像并且在一个很窄的时序窗口内完成上电、复位、I2C 初始化。为什么 LK 里要单独放一份驱动不能把这事全丢给 kernel因为从按下电源键到内核起来中间大概两三秒的时间完全由 LK 接管这期间电视必须已经检测到 HDMI 信号。如果只靠 kernel 初始化按下电源键到画面出来可能拖到五六秒用户体验会很糟。常见的调用路径是这样的/* LK 显示初始化流程中HDMI 桥接芯片的接入点 */ static int hdmi_bridge_init(void) { /* 1. 拉复位引脚给桥接芯片一个干净的上电时序 */ gpio_set_value(LT9611_RESET_PIN, 0); mdelay(10); gpio_set_value(LT9611_RESET_PIN, 1); mdelay(20); /* 2. 通过 I2C 写初始化序列 */ lt9611_init_registers(); /* 3. 读取芯片状态确认输出就绪 */ if (lt9611_check_link() ! 0) { printf([LT9611] link failed at LK\n); return -1; } return 0; }这里有几个动作是固定的先拉低复位、延时、再拉高复位这是为了保证芯片每次上电都从一个确定的寄存器状态开始。mdelay 的时长不是随便写的10ms 和 20ms 是数据手册里建议的最小值我一般习惯再往上加一点余量因为 LK 阶段时钟刚起来I2C 抖动比较明显。LT9611 的 I2C 地址默认是 0x3B加上写位就是 0x76。这个地址在 LK 驱动里通常是硬编码的如果硬件做了地址偏移比如 A0 引脚被拉高地址会变成 0x3D驱动里就得同步改。我第一次调这个芯片的时候花了半天查 I2C 不通最后发现是原理图上 A0 接了上拉而驱动还在用 0x3B。这个教训我后面会专门展开。2.3 Kernel 阶段驱动从 LK 手里接棒系统进入 kernel 之后显示输出会从 LK 的 framebuffer 切换到真正的 DRM/KMS 驱动。MTK 平台的显示框架会枚举所有显示通路包括 DSI、DPI、HDMI。LT9611 所在的 DSI 转 HDMI 通路在 kernel 里可能注册成一个 i2c client也可能注册成一个 panel bridge取决于平台的驱动模型。kernel 阶段至少要做三件事在设备树里给 LT9611 分配正确的 I2C 总线确保它挂在 main bus 而不是 sensor bus把 dws 里配好的 GPIO 复用关系保存下来复位、使能、HPD 都要对应在显示框架里注册桥接回调让 DRM 在模式设置时把时序参数通过 I2C 写进 LT9611。一个典型的设备树节点长这样i2c0 { status okay; lt9611: lt96113b { compatible lontium,lt9611; reg 0x3b; reset-gpios pio 28 GPIO_ACTIVE_LOW; hpd-gpios pio 29 GPIO_ACTIVE_HIGH; pinctrl-names default; pinctrl-0 lt9611_pins; status okay; }; };reg 地址要和 LK 阶段硬编码的 I2C 地址保持一致。reset-gpios 的 GPIO 编号必须和 dws 里的复用结果一致否则 gpio_request 会直接失败。hpd-gpios 是热插拔检测引脚如果这个引脚没配好HDMI 线插上去之后系统检测不到外接显示器电视屏幕就是无信号。我在 kernel 里调试 LT9611 时有个习惯先用 i2cdetect 扫一遍总线确认芯片在枚举阶段能被发现再去看 DRM 的日志。i2cdetect 是 Linux 下最直接的验证手段能迅速把问题分成 I2C 不通和驱动配置不对两类。3. 移植步骤从复制文件到输出 1080p四步走3.1 把源文件放进工程并加入编译移植的第一步是把驱动文件放进对应的目录。按照 MTK 的源码结构LK 的代码通常在 bootable/bootloader/lk/ 下kernel 的驱动在 drivers/ 下面。拿到这份源码包之后先把 lk/lt9611_dsi2hdmi.c 拷进 LK 的显示驱动目录kernel/lt9611_dsi2hdmi.c 拷进 kernel 的显示驱动目录然后在对应的 makefile 里加一行# bootable/bootloader/lk/target/xxx/display/ 下的 makefile obj-y lt9611_dsi2hdmi.oobj-y 表示这个文件会被编译进 LK 镜像。LK 固定用 obj-y因为 LK 没有模块机制所有驱动都是静态编译的。加完 makefile 之后编译一次 LK确认没有编译错误再用烧录工具把新的 boot 镜像写进去。MTK 的工程编译 LK 和 boot 镜像是两条命令先用 ./mk 之类的方式确认你的 target 名再执行对应分支的编译。忘了 target 名是最常见的低级错误我有一阵子没碰 MTK每次都要回看 README 才能想起来。编译阶段有一个很常见的报错LK 的环境里没有完整的内核头文件如果你直接用了mdelay这类函数编译器会提示 implicit declaration。处理方法是在文件头部显式包含 LK 提供的头文件#include platform/mt_gpio.h #include platform/mt_i2c.h #include printf.h这三个头文件分别对应 GPIO 操作、I2C 控制器访问和串口打印。LK 的头文件路径和 kernel 完全不一样不能直接拿 kernel 的 include 来凑否则编译到链接阶段才会暴露符号缺失的问题排查起来很费时间。3.2 配置 codegen.dws引脚复用错了后面全白搭codegen.dws 是 MTK 的引脚配置工具生成的本质是一个文本文件里面按 GPIO 编号列出每个引脚的复用功能、上下拉、驱动能力。LT9611 会用到这么几组引脚引脚组复用功能配置要点I2C SCL/SDAGPIO/I2C 复用必须选 I2C 功能编号要和设备树一致复位 RESETGPIO 输出设置为输出、默认低电平使能 ENGPIO 输出设置为输出、默认高电平HPD 检测GPIO 输入设置为输入、带上拉用于检测 HDMI 是否插入用文本方式打开 codegen.dws找到对应 GPIO 的配置行按上表修改。如果你用的是图形化工具改完记得重新导出别直接在源码目录里手动编辑——图形工具导出的格式里包含了额外的校验信息手动改动可能导致编译通过但实际配置不生效。这个我踩过导出的 dws 和手写的 dws 在 MTK 的工具链里是两个处理路径手写文件的加载结果经常是复位引脚变成普通输入。我一般会在 dws 里把复位引脚配置成 GPIO 输出且默认拉低。初始为低电平的作用是让 LT9611 在上电瞬间保持复位等 LK 驱动跑起来之后再主动拉高。如果默认拉高芯片提前进入工作状态主控还没完成初始化I2C 就可能因为总线时序不匹配而锁死。3.3 在 LK 的显示链路里注册 LT9611配置完引脚之后LT9611 的驱动代码要挂到 LK 的显示链路中。不同 MTK 平台挂的方式不完全一样但核心都是在一个显示初始化函数里调用桥接驱动/* 在 LK 的显示初始化处增加桥接芯片的调用 */ static void display_preinit(void) { /* 先初始化 I2C 控制器 */ mtk_i2c_init(I2C_CHANNEL_0); /* 再调用 LT9611 驱动做桥接初始化 */ lt9611_dsi2hdmi_init(); } /* 帧缓冲准备好之后数据就从 DSI 接口送进 LT9611 */ static void display_postinit(void) { lt9611_enable_hdmi_output(); }display_preinit 里做的是上电时序和寄存器序列初始化display_postinit 里打开 HDMI 输出通道。两步必须分开因为 LT9611 必须要等输入的 MIPI DSI 时钟稳定之后才能开始输出 HDMI。如果提前打开输出电视端会反复握手失败表现就是信号闪断。这个流程里还要注意 DSI 的参数。MTK 的 DSI 输出 lane 数、数据速率和 LT9611 的输入要求要对上。常见配置是 4 lane、数据速率 891Mbps对应 1080p60Hz。如果 DSI 的 lane 数配成 2 laneLT9611 会因为带宽不足只能输出 720p甚至直接无信号。这个参数一般在 LK 的显示配置头文件里定义改的时候记得和 kernel 侧保持一致不然就会出现 LK 正常、kernel 花屏的诡异问题。3.4 验证 1080p 输出看 EDID别只看屏幕亮没亮移植完成后不要只凭屏幕有画面就判断成功。LT9611 内部有一个 EDID ROM里面存的是它支持的最大分辨率。1080p 只是默认值如果电视或显示器支持 4KEDID 里会给出一组 4K 的时序但 LT9611 的输出模式没有同步切换画面就会花。我的验证习惯是先看 EDID 解析结果。在 LK 阶段串口会输出一组 HDMI 的信息帧其中包括像素时钟、分辨率、色深。在 kernel 阶段可以用 dmesg 搜 lt9611 相关的打印。如果 EDID 显示正确但画面仍然不对检查两处一处是 DSI 的时序参数是不是按 1080p60 配置的另一处是 LT9611 的输出模式寄存器有没有被 kernel 阶段的驱动覆盖。我遇到过一次 LK 正常、进 kernel 花屏的情况最后定位到是 kernel 的 DSI 驱动初始化时把 lane 数从 4 改成了 2LT9611 没收到新参数还在按 4 lane 的输入做 HDMI 输出时序错位。注意改完任何显示参数都要重新烧录 LK 和 boot 两个镜像只烧其中一个会导致两个阶段的配置不一致。4. 避坑指南LT9611 移植必踩的四个高频问题4.1 开机 logo 出不来串口停在 HDCP 查询现象按下电源键电视一直黑屏串口最后输出停在 LT9611 HDCP 查询之后没有任何日志。原因LK 阶段 LT9611 初始化时做了 HDCP Key 读取但芯片的 HDCP Key 是空白的驱动没有跳过机制阻塞了后续的 HDMI 输出初始化。这种情况在公版芯片上很常见芯片出厂时 Key 区域往往没有烧录量产机型才会写进去。解决在驱动初始化序列里加一个 HDCP 状态检查如果读取到 Key 无效就直接跳过 HDCP 握手把 LT9611 设为非 HDCP 直通模式if (lt9611_hdcp_key_valid() ! 0) { printf([LT9611] HDCP key invalid, skip HDCP\n); lt9611_set_hdcp_mode(0); } else { lt9611_set_hdcp_mode(1); }lt9611_hdcp_key_valid 每次读 HDCP 状态寄存器如果返回非 0说明芯片里的 Key 区域是空或者校验失败。LT9611 没写 Key 的时候直接走 HDCP 会卡在握手阶段电视那边会一直显示无信号。加了跳过逻辑之后至少能保证 HDMI 无加密直通输出等真正需要 HDCP 的场景再补 Key。4.2 花屏进了 kernel 之后画面撕裂现象开机 logo 正常进系统之后画面上下抖动文字边缘有紫色拖影。原因kernel 阶段 DSI 输出参数被重新配置了但 LT9611 的输出寄存器没有得到同步更新。具体来说是 DSI 的像素时钟或者 lane 数跟 LK 阶段不一致LT9611 按旧的输出时序在处理新输入信号。解决在 kernel 的 LT9611 驱动里加一个输入参数检测函数每次 DSI 状态改变时主动读取 LT9611 的 link status 寄存器对比期望输入参数不一致就重写输出时序。这里的核心是别让 kernel 的显示框架只更新 DSI 侧的参数要联动更新 LT9611 侧。还有一种是色彩空间错误导致的花屏现象是画面整体偏绿或者偏紫原因往往是 YUV 和 RGB 的配置没对上检查 LT9611 的输入格式寄存器确保它和 DSI 端输出的 pixel format 一致。4.3 电视显示无信号但 HDMI 线拔插一次就好了现象刚开机电视显示无信号把 HDMI 线拔了再插一次画面就出来了。原因这是 HPD热插拔检测电平问题。LT9611 的 HPD 引脚输出的是脉冲电视在开机瞬间没有捕获到之后不再主动查询。驱动把 HPD 引脚配成了普通 GPIO没有做边沿触发的中断处理。解决把 HPD 引脚在 dws 里改成中断输入并在驱动中注册上升沿中断。如果平台的中断资源紧张可以用一种更粗暴但有效的办法在 HDMI 输出初始化完成后延时 300ms再主动拉低一次 HPD、拉高一次人为制造一个拔插脉冲。这个技巧在多个项目上救过急缺点是会有一次短暂的握手丢失但远比电视完全无信号可接受。如果做了人为拔插还是不行量一下 HPD 引脚的电平正常应该接近 5V如果只有 3V 不到可能是驱动能力不够需要在 dws 里把 HPD 引脚的驱动能力调高一档。4.4 I2C 地址冲突扫描总线发现 0x3B 和 0x3D 都有设备现象i2cdetect 扫描时发现 0x3B 和 0x3D 都有 ACKLT9611 驱动访问 0x3B 成功但读出来的寄存器全是 0xFF。原因LT9611 的地址引脚 A0 悬空芯片上电后地址漂移或者存在两个地址状态。读寄存器全 FF 说明驱动访问到了错误的地址真正在工作的芯片是另一个地址。解决先在 i2cdetect 里用两种地址各写一个寄存器对比返回值的差异。正常情况下只有一个地址有正确的响应。确认后把驱动里的 I2C 地址改成实际响应正确的那个。还是要回到原理图看 A0 引脚是上拉还是下拉驱动必须跟硬件一一对应。这种问题别尝试在软件里做地址试探每改一次要编译烧录一次效率太低直接用万用表量 A0 的电平最省事。如果是悬空状态让硬件加一个默认下拉固定到 0x3B避免每次上电状态不确定。5. 调试手段串口日志、I2C 寄存器、示波器三轮排查5.1 串口日志先看 LK 阶段的打印再做 kernel 对比LT9611 的驱动代码里通常会包含初始化打印状态包括I2C 探测结果、芯片 ID 读取、link 建立状态。拿到一份新的 LT9611 源码包第一件事不是编译而是先 grep 驱动里的 printf 日志。# 在源码目录里检索调试日志关键字 grep -rn lt9611\|LT9611 lk/lt9611_dsi2hdmi.c | head -40重点看这些日志的打印条件。很多是失败才打印比如 I2C transfer error、register mismatch。如果一条错误日志都没有但 HDMI 还是没输出可以把日志级别调高或者临时加打印把关键寄存器的读取值打出来。我一般会加在读寄存器函数附近reg lt9611_read_reg(0x21); printf([LT9611] chip id 0x%x\n, reg); if (reg ! 0x61) { printf([LT9611] chip id mismatch, expected 0x61\n); }chip id 读出来不对基本可以判定是地址错了、信号没上拉到芯片、或者芯片根本没上电。这三个方向用示波器量一次就能定位比反复改编译烧录省时间。还有一种情况是串口完全没有 LT9611 的打印说明驱动代码压根没被调用到先检查 makefile 有没有编进去再检查调用函数有没有被条件编译宏挡住。遇到过一次平台代码里用了一个#ifdef HDMI_SUPPORT把初始化代码包起来了而工程配置里没定义这个宏导致整段驱动都是死代码。5.2 I2C 寄存器级验证直接从 shell 读写 LT9611kernel 起来之后最快速的验证手段是直接在串口 shell 里操作 I2C 总线。确认 I2C 通道后用 i2cget 和 i2cset 读写。比如 LT9611 的 chip id 寄存器通常位于 0x21读它i2cget -y 0 0x3b 0x21 # 正常输出: 0x61 或 0x62如果执行报错先确认总线号。MTK 平台的 i2c 总线编号顺序不完全和硬件外设顺序一致用 i2cdetect -l 列出总线列表找到挂在 LT9611 所在控制器下那条。如果 -y 0 不对换成 -y 1 或者 -y 2 重新试。i2cget 返回 0xff 基本就是地址错了返回异常说明芯片没进正常工作模式。读写寄存器前要确认 LT9611 是否处于正常模式下。这类桥接芯片有专门的寄存器写保护位第一次写入必须解锁否则所有写操作都会被忽略。原厂初始化序列里一般会先写解锁寄存器如果你手动 i2cset 去改某一个输出参数要注意先按原厂序列完成解锁。还有一个实用技巧把驱动里初始化序列涉及的所有寄存器地址和值打印出来和原厂参考代码逐条比对。LT9611 这类芯片的寄存器配置是联动关系比如输出分辨率改了像素时钟分频和 HFP 参数要一起改缺一项画面就会有问题挨个比对寄存器是最有效的排错方式。5.3 示波器量 MIPI 信号和 HPD 波形I2C 通了、寄存器也对但画面依然不对这个时候建议上示波器。重点量三个信号MIPI DSI 的 clock lane 差分对、LT9611 输出的 TMDS clock、HPD 引脚电平。测量点预期结果MIPI clock 对有稳定差分波形频率约 445.5MHz1080p60TMDS clock 对有稳定差分波形频率约 148.5MHz1080p60 标准 TMDS clockHPD 引脚高电平 4.8V~5.3V插拔时跳变MIPI 侧没有波形先查 DSI 的 lane 配置和时钟是否使能这个通常由 LK 阶段的显示驱动控制。TMDS 侧没有波形说明 LT9611 没有进入输出模式查它的 PLL 锁定寄存器如果 PLL 没锁上多半是输入时钟有问题。HPD 没拉高查引脚是否被其他外设占用或者驱动能力不够。示波器测量 MIPI 时注意探头的地线尽量用最短地线差分对用差分探头。没有差分探头时可以分别量 P 端和 N 端看相位关系但这个办法只能粗略判断有没有信号不能精确判断时序是否合规。6. 进阶把默认 1080p 改成你需要的分辨率和时序6.1 在驱动里修改输出时序LT9611 的输出时序由一组 I2C 寄存器控制包括像素时钟分频、HFP、HSYNC、VFP、VSYNC 等参数。资源里的 lt9611_v1_3_MTK658_0628.c 提供了一套完整初始化序列改动要点是先定位到时序配置段/* 以 1080p60Hz 为例修改前确认这些值 */ static const unsigned char lt9611_1080p_timing[] { 0x00, 0x00, 0x05, 0x00, /* pixel clock相关 */ 0x08, 0x02, 0x00, 0x00, /* HSYNC 宽度 */ /* ... 中间省略其他时序字段 ... */ };改成 720p 时最省事的做法是找原厂参考代码里 720p 的数组整体替换。自己手动改每个字段容易出错因为 LT9611 对时序的依赖是按像素周期计算的差一个数画面就会偏移或者出黑边。我的习惯是先确认目标分辨率的 modeline再从 modeline 里推出 HFP、HSYNC、VFP、VSYNC最后按数据手册换算成寄存器值。容易忽略的是 color depth1080p 默认 8bit如果输出 10bitLT9611 内部像素时钟要提高很多人改完分辨率忘记改色深导致暗部出现色块。6.2 处理 EDID 和 HPD 的特殊场景默认 EDID 里包含多个分辨率电视端会选择一个输出。如果你的产品接的是固定显示器推荐直接改 EDID只广播一个分辨率避免电视端和 LT9611 在握手时反复切换时序。常见做法是在驱动里加一个 EDID 覆盖函数从 EDID 的 DTD 块里找到目标分辨率的时序描述把其他分辨率对应的 DTD 清空。还有一个技巧是 HPD 时序不满足老式显示器时在驱动初始化完成后强制拉低 HPD、延时 200ms、再拉高模拟一次完整的拔插动作这个对间歇性黑屏很有效。6.3 验证修改结果的流程改完时序和 EDID 后按这个顺序验证串口确认初始化日志无 errori2cget 读取修改后的时序寄存器确认写入用支持 1080p 和 720p 的显示器分别测试最后接目标设备确认画面无花屏、闪烁、过扫描。我做驱动移植到现在已经形成固定习惯每次拿到新的 LT9611 源码包先看 dws 里 GPIO 复用是否和原理图一致再看 I2C 地址是否对应最后才看初始化序列。这个顺序只要有一处错了后面全是白折腾。从那以后凡是涉及桥接芯片的移植我都强制自己先花十分钟做一次文件、引脚、地址的三方核对再做编译烧录。希望帮到你。本文还有配套的精品资源点击获取
简介面向联发科平台的LT9611驱动源码包聚焦MTK芯片上LT9611型号设备默认输出1080p的驱动实现适合嵌入式驱动工程师、系统集成人员参考。压缩包仅5个文件包含3个C源码文件和2个dws配置文件整体约21KB。C源码分别对应LK引导阶段与kernel内核阶段中DSI转HDMI的驱动逻辑dws文件则用于配置显示相关的引脚复用和参数能够帮助梳理从驱动注册、I2C通信、寄存器初始化到1080p时序输出的完整链路。已有974人学习可配合屏幕规格书和芯片手册进行驱动移植、输出参数调整或显示异常排查。借助这份精简代码开发者可以快速理解LT9611在MTK平台上的挂载方式对比官方驱动校准分辨率与像素时钟并将代码整合到自己的系统镜像中显著缩短显示模块的开发验证周期。对于需要定制视频输出或修复高清显示问题的场景其中关于引脚配置、初始化流程和时序参数的细节均有直接参考价值。1. MTK平台上的LT9611这块DSI转HDMI桥接芯片决定了你开机logo能不能亮mtk平台 lt9611 这个组合最近在我手上至少跟进了三轮 bring-up。LT9611 是龙迅的方案做 DSI 转 HDMI 桥接主控用 MIPI DSI 输出桥接芯片转成 HDMI 给显示器或者电视默认就是 1080p。很多平板、盒子、车载中控的 HDMI 输出都走这条路径。我拿到这份 mtk-lt9611 源码包时第一反应是看 LK 阶段那份 lt9611_dsi2hdmi.c——MTK 的开机 logo 是 LK 画的HDMI 输出能不能在 bootloader 阶段起来直接决定用户按下电源键之后看到的是 logo 还是黑屏。这个包适合正在做 MTK 平台 HDMI 移植的 BSP 工程师也适合刚接手这类项目、想搞明白 DSI 转 HDMI 到底怎么配置的驱动入门者。2. 源码包的结构LK 与 Kernel 两套驱动一条数据链路2.1 五个关键文件谁管初始化谁管时序谁管引脚这份资源的核心文件其实不多但每个都不能少。先说文件职责再讲调用关系。文件所在阶段职责lk/lt9611_dsi2hdmi.cLKbootloader 阶段初始化 LT9611输出开机 logokernel/lt9611_dsi2hdmi.cKernel系统起来后的显示驱动负责正常的 HDMI 输出lt9611_v1_3_MTK658_0628.c参考原厂针对 MTK658 平台的 V1.3 版本参考代码0628 是构建日期标记codegen.dws配置MTK 的引脚复用配置定义 I2C、复位、使能引脚tb8735ap1_lr_ztk.dws配置板级 DWS适配 tb8735ap1_lr_ztk 这块具体硬件的 GPIO 分配项目代号 stomachhcc 应该就是这个方案在你们工程里的内部命名具体含义得问硬件那边但源码包里 dws 文件名对应的就是具体板子。最容易被忽略的是最后一个板级 dws。codegen.dws 是芯片级的通用复用表tb8735ap1_lr_ztk.dws 才是这块板子真正的引脚分配。我之前接过一个项目两个 dws 里的复位引脚不一致代码里用的是 GPIO 28dws 里复用成了 PWM 功能结果 LT9611 一直不复位I2C 完全不通。这种问题光看驱动代码永远查不出来必须逐个引脚对 dws。2.2 LK 阶段开机 logo 能不能亮全靠这段驱动MTK 的 LKLittle Kernel是 bootloader负责初始化内存、显示、触摸这类最小外设。开机 logo 就是在 LK 里画的。LT9611 要在 LK 阶段工作驱动必须被编译进 LK 镜像并且在一个很窄的时序窗口内完成上电、复位、I2C 初始化。为什么 LK 里要单独放一份驱动不能把这事全丢给 kernel因为从按下电源键到内核起来中间大概两三秒的时间完全由 LK 接管这期间电视必须已经检测到 HDMI 信号。如果只靠 kernel 初始化按下电源键到画面出来可能拖到五六秒用户体验会很糟。常见的调用路径是这样的/* LK 显示初始化流程中HDMI 桥接芯片的接入点 */ static int hdmi_bridge_init(void) { /* 1. 拉复位引脚给桥接芯片一个干净的上电时序 */ gpio_set_value(LT9611_RESET_PIN, 0); mdelay(10); gpio_set_value(LT9611_RESET_PIN, 1); mdelay(20); /* 2. 通过 I2C 写初始化序列 */ lt9611_init_registers(); /* 3. 读取芯片状态确认输出就绪 */ if (lt9611_check_link() ! 0) { printf([LT9611] link failed at LK\n); return -1; } return 0; }这里有几个动作是固定的先拉低复位、延时、再拉高复位这是为了保证芯片每次上电都从一个确定的寄存器状态开始。mdelay 的时长不是随便写的10ms 和 20ms 是数据手册里建议的最小值我一般习惯再往上加一点余量因为 LK 阶段时钟刚起来I2C 抖动比较明显。LT9611 的 I2C 地址默认是 0x3B加上写位就是 0x76。这个地址在 LK 驱动里通常是硬编码的如果硬件做了地址偏移比如 A0 引脚被拉高地址会变成 0x3D驱动里就得同步改。我第一次调这个芯片的时候花了半天查 I2C 不通最后发现是原理图上 A0 接了上拉而驱动还在用 0x3B。这个教训我后面会专门展开。2.3 Kernel 阶段驱动从 LK 手里接棒系统进入 kernel 之后显示输出会从 LK 的 framebuffer 切换到真正的 DRM/KMS 驱动。MTK 平台的显示框架会枚举所有显示通路包括 DSI、DPI、HDMI。LT9611 所在的 DSI 转 HDMI 通路在 kernel 里可能注册成一个 i2c client也可能注册成一个 panel bridge取决于平台的驱动模型。kernel 阶段至少要做三件事在设备树里给 LT9611 分配正确的 I2C 总线确保它挂在 main bus 而不是 sensor bus把 dws 里配好的 GPIO 复用关系保存下来复位、使能、HPD 都要对应在显示框架里注册桥接回调让 DRM 在模式设置时把时序参数通过 I2C 写进 LT9611。一个典型的设备树节点长这样i2c0 { status okay; lt9611: lt96113b { compatible lontium,lt9611; reg 0x3b; reset-gpios pio 28 GPIO_ACTIVE_LOW; hpd-gpios pio 29 GPIO_ACTIVE_HIGH; pinctrl-names default; pinctrl-0 lt9611_pins; status okay; }; };reg 地址要和 LK 阶段硬编码的 I2C 地址保持一致。reset-gpios 的 GPIO 编号必须和 dws 里的复用结果一致否则 gpio_request 会直接失败。hpd-gpios 是热插拔检测引脚如果这个引脚没配好HDMI 线插上去之后系统检测不到外接显示器电视屏幕就是无信号。我在 kernel 里调试 LT9611 时有个习惯先用 i2cdetect 扫一遍总线确认芯片在枚举阶段能被发现再去看 DRM 的日志。i2cdetect 是 Linux 下最直接的验证手段能迅速把问题分成 I2C 不通和驱动配置不对两类。3. 移植步骤从复制文件到输出 1080p四步走3.1 把源文件放进工程并加入编译移植的第一步是把驱动文件放进对应的目录。按照 MTK 的源码结构LK 的代码通常在 bootable/bootloader/lk/ 下kernel 的驱动在 drivers/ 下面。拿到这份源码包之后先把 lk/lt9611_dsi2hdmi.c 拷进 LK 的显示驱动目录kernel/lt9611_dsi2hdmi.c 拷进 kernel 的显示驱动目录然后在对应的 makefile 里加一行# bootable/bootloader/lk/target/xxx/display/ 下的 makefile obj-y lt9611_dsi2hdmi.oobj-y 表示这个文件会被编译进 LK 镜像。LK 固定用 obj-y因为 LK 没有模块机制所有驱动都是静态编译的。加完 makefile 之后编译一次 LK确认没有编译错误再用烧录工具把新的 boot 镜像写进去。MTK 的工程编译 LK 和 boot 镜像是两条命令先用 ./mk 之类的方式确认你的 target 名再执行对应分支的编译。忘了 target 名是最常见的低级错误我有一阵子没碰 MTK每次都要回看 README 才能想起来。编译阶段有一个很常见的报错LK 的环境里没有完整的内核头文件如果你直接用了mdelay这类函数编译器会提示 implicit declaration。处理方法是在文件头部显式包含 LK 提供的头文件#include platform/mt_gpio.h #include platform/mt_i2c.h #include printf.h这三个头文件分别对应 GPIO 操作、I2C 控制器访问和串口打印。LK 的头文件路径和 kernel 完全不一样不能直接拿 kernel 的 include 来凑否则编译到链接阶段才会暴露符号缺失的问题排查起来很费时间。3.2 配置 codegen.dws引脚复用错了后面全白搭codegen.dws 是 MTK 的引脚配置工具生成的本质是一个文本文件里面按 GPIO 编号列出每个引脚的复用功能、上下拉、驱动能力。LT9611 会用到这么几组引脚引脚组复用功能配置要点I2C SCL/SDAGPIO/I2C 复用必须选 I2C 功能编号要和设备树一致复位 RESETGPIO 输出设置为输出、默认低电平使能 ENGPIO 输出设置为输出、默认高电平HPD 检测GPIO 输入设置为输入、带上拉用于检测 HDMI 是否插入用文本方式打开 codegen.dws找到对应 GPIO 的配置行按上表修改。如果你用的是图形化工具改完记得重新导出别直接在源码目录里手动编辑——图形工具导出的格式里包含了额外的校验信息手动改动可能导致编译通过但实际配置不生效。这个我踩过导出的 dws 和手写的 dws 在 MTK 的工具链里是两个处理路径手写文件的加载结果经常是复位引脚变成普通输入。我一般会在 dws 里把复位引脚配置成 GPIO 输出且默认拉低。初始为低电平的作用是让 LT9611 在上电瞬间保持复位等 LK 驱动跑起来之后再主动拉高。如果默认拉高芯片提前进入工作状态主控还没完成初始化I2C 就可能因为总线时序不匹配而锁死。3.3 在 LK 的显示链路里注册 LT9611配置完引脚之后LT9611 的驱动代码要挂到 LK 的显示链路中。不同 MTK 平台挂的方式不完全一样但核心都是在一个显示初始化函数里调用桥接驱动/* 在 LK 的显示初始化处增加桥接芯片的调用 */ static void display_preinit(void) { /* 先初始化 I2C 控制器 */ mtk_i2c_init(I2C_CHANNEL_0); /* 再调用 LT9611 驱动做桥接初始化 */ lt9611_dsi2hdmi_init(); } /* 帧缓冲准备好之后数据就从 DSI 接口送进 LT9611 */ static void display_postinit(void) { lt9611_enable_hdmi_output(); }display_preinit 里做的是上电时序和寄存器序列初始化display_postinit 里打开 HDMI 输出通道。两步必须分开因为 LT9611 必须要等输入的 MIPI DSI 时钟稳定之后才能开始输出 HDMI。如果提前打开输出电视端会反复握手失败表现就是信号闪断。这个流程里还要注意 DSI 的参数。MTK 的 DSI 输出 lane 数、数据速率和 LT9611 的输入要求要对上。常见配置是 4 lane、数据速率 891Mbps对应 1080p60Hz。如果 DSI 的 lane 数配成 2 laneLT9611 会因为带宽不足只能输出 720p甚至直接无信号。这个参数一般在 LK 的显示配置头文件里定义改的时候记得和 kernel 侧保持一致不然就会出现 LK 正常、kernel 花屏的诡异问题。3.4 验证 1080p 输出看 EDID别只看屏幕亮没亮移植完成后不要只凭屏幕有画面就判断成功。LT9611 内部有一个 EDID ROM里面存的是它支持的最大分辨率。1080p 只是默认值如果电视或显示器支持 4KEDID 里会给出一组 4K 的时序但 LT9611 的输出模式没有同步切换画面就会花。我的验证习惯是先看 EDID 解析结果。在 LK 阶段串口会输出一组 HDMI 的信息帧其中包括像素时钟、分辨率、色深。在 kernel 阶段可以用 dmesg 搜 lt9611 相关的打印。如果 EDID 显示正确但画面仍然不对检查两处一处是 DSI 的时序参数是不是按 1080p60 配置的另一处是 LT9611 的输出模式寄存器有没有被 kernel 阶段的驱动覆盖。我遇到过一次 LK 正常、进 kernel 花屏的情况最后定位到是 kernel 的 DSI 驱动初始化时把 lane 数从 4 改成了 2LT9611 没收到新参数还在按 4 lane 的输入做 HDMI 输出时序错位。注意改完任何显示参数都要重新烧录 LK 和 boot 两个镜像只烧其中一个会导致两个阶段的配置不一致。4. 避坑指南LT9611 移植必踩的四个高频问题4.1 开机 logo 出不来串口停在 HDCP 查询现象按下电源键电视一直黑屏串口最后输出停在 LT9611 HDCP 查询之后没有任何日志。原因LK 阶段 LT9611 初始化时做了 HDCP Key 读取但芯片的 HDCP Key 是空白的驱动没有跳过机制阻塞了后续的 HDMI 输出初始化。这种情况在公版芯片上很常见芯片出厂时 Key 区域往往没有烧录量产机型才会写进去。解决在驱动初始化序列里加一个 HDCP 状态检查如果读取到 Key 无效就直接跳过 HDCP 握手把 LT9611 设为非 HDCP 直通模式if (lt9611_hdcp_key_valid() ! 0) { printf([LT9611] HDCP key invalid, skip HDCP\n); lt9611_set_hdcp_mode(0); } else { lt9611_set_hdcp_mode(1); }lt9611_hdcp_key_valid 每次读 HDCP 状态寄存器如果返回非 0说明芯片里的 Key 区域是空或者校验失败。LT9611 没写 Key 的时候直接走 HDCP 会卡在握手阶段电视那边会一直显示无信号。加了跳过逻辑之后至少能保证 HDMI 无加密直通输出等真正需要 HDCP 的场景再补 Key。4.2 花屏进了 kernel 之后画面撕裂现象开机 logo 正常进系统之后画面上下抖动文字边缘有紫色拖影。原因kernel 阶段 DSI 输出参数被重新配置了但 LT9611 的输出寄存器没有得到同步更新。具体来说是 DSI 的像素时钟或者 lane 数跟 LK 阶段不一致LT9611 按旧的输出时序在处理新输入信号。解决在 kernel 的 LT9611 驱动里加一个输入参数检测函数每次 DSI 状态改变时主动读取 LT9611 的 link status 寄存器对比期望输入参数不一致就重写输出时序。这里的核心是别让 kernel 的显示框架只更新 DSI 侧的参数要联动更新 LT9611 侧。还有一种是色彩空间错误导致的花屏现象是画面整体偏绿或者偏紫原因往往是 YUV 和 RGB 的配置没对上检查 LT9611 的输入格式寄存器确保它和 DSI 端输出的 pixel format 一致。4.3 电视显示无信号但 HDMI 线拔插一次就好了现象刚开机电视显示无信号把 HDMI 线拔了再插一次画面就出来了。原因这是 HPD热插拔检测电平问题。LT9611 的 HPD 引脚输出的是脉冲电视在开机瞬间没有捕获到之后不再主动查询。驱动把 HPD 引脚配成了普通 GPIO没有做边沿触发的中断处理。解决把 HPD 引脚在 dws 里改成中断输入并在驱动中注册上升沿中断。如果平台的中断资源紧张可以用一种更粗暴但有效的办法在 HDMI 输出初始化完成后延时 300ms再主动拉低一次 HPD、拉高一次人为制造一个拔插脉冲。这个技巧在多个项目上救过急缺点是会有一次短暂的握手丢失但远比电视完全无信号可接受。如果做了人为拔插还是不行量一下 HPD 引脚的电平正常应该接近 5V如果只有 3V 不到可能是驱动能力不够需要在 dws 里把 HPD 引脚的驱动能力调高一档。4.4 I2C 地址冲突扫描总线发现 0x3B 和 0x3D 都有设备现象i2cdetect 扫描时发现 0x3B 和 0x3D 都有 ACKLT9611 驱动访问 0x3B 成功但读出来的寄存器全是 0xFF。原因LT9611 的地址引脚 A0 悬空芯片上电后地址漂移或者存在两个地址状态。读寄存器全 FF 说明驱动访问到了错误的地址真正在工作的芯片是另一个地址。解决先在 i2cdetect 里用两种地址各写一个寄存器对比返回值的差异。正常情况下只有一个地址有正确的响应。确认后把驱动里的 I2C 地址改成实际响应正确的那个。还是要回到原理图看 A0 引脚是上拉还是下拉驱动必须跟硬件一一对应。这种问题别尝试在软件里做地址试探每改一次要编译烧录一次效率太低直接用万用表量 A0 的电平最省事。如果是悬空状态让硬件加一个默认下拉固定到 0x3B避免每次上电状态不确定。5. 调试手段串口日志、I2C 寄存器、示波器三轮排查5.1 串口日志先看 LK 阶段的打印再做 kernel 对比LT9611 的驱动代码里通常会包含初始化打印状态包括I2C 探测结果、芯片 ID 读取、link 建立状态。拿到一份新的 LT9611 源码包第一件事不是编译而是先 grep 驱动里的 printf 日志。# 在源码目录里检索调试日志关键字 grep -rn lt9611\|LT9611 lk/lt9611_dsi2hdmi.c | head -40重点看这些日志的打印条件。很多是失败才打印比如 I2C transfer error、register mismatch。如果一条错误日志都没有但 HDMI 还是没输出可以把日志级别调高或者临时加打印把关键寄存器的读取值打出来。我一般会加在读寄存器函数附近reg lt9611_read_reg(0x21); printf([LT9611] chip id 0x%x\n, reg); if (reg ! 0x61) { printf([LT9611] chip id mismatch, expected 0x61\n); }chip id 读出来不对基本可以判定是地址错了、信号没上拉到芯片、或者芯片根本没上电。这三个方向用示波器量一次就能定位比反复改编译烧录省时间。还有一种情况是串口完全没有 LT9611 的打印说明驱动代码压根没被调用到先检查 makefile 有没有编进去再检查调用函数有没有被条件编译宏挡住。遇到过一次平台代码里用了一个#ifdef HDMI_SUPPORT把初始化代码包起来了而工程配置里没定义这个宏导致整段驱动都是死代码。5.2 I2C 寄存器级验证直接从 shell 读写 LT9611kernel 起来之后最快速的验证手段是直接在串口 shell 里操作 I2C 总线。确认 I2C 通道后用 i2cget 和 i2cset 读写。比如 LT9611 的 chip id 寄存器通常位于 0x21读它i2cget -y 0 0x3b 0x21 # 正常输出: 0x61 或 0x62如果执行报错先确认总线号。MTK 平台的 i2c 总线编号顺序不完全和硬件外设顺序一致用 i2cdetect -l 列出总线列表找到挂在 LT9611 所在控制器下那条。如果 -y 0 不对换成 -y 1 或者 -y 2 重新试。i2cget 返回 0xff 基本就是地址错了返回异常说明芯片没进正常工作模式。读写寄存器前要确认 LT9611 是否处于正常模式下。这类桥接芯片有专门的寄存器写保护位第一次写入必须解锁否则所有写操作都会被忽略。原厂初始化序列里一般会先写解锁寄存器如果你手动 i2cset 去改某一个输出参数要注意先按原厂序列完成解锁。还有一个实用技巧把驱动里初始化序列涉及的所有寄存器地址和值打印出来和原厂参考代码逐条比对。LT9611 这类芯片的寄存器配置是联动关系比如输出分辨率改了像素时钟分频和 HFP 参数要一起改缺一项画面就会有问题挨个比对寄存器是最有效的排错方式。5.3 示波器量 MIPI 信号和 HPD 波形I2C 通了、寄存器也对但画面依然不对这个时候建议上示波器。重点量三个信号MIPI DSI 的 clock lane 差分对、LT9611 输出的 TMDS clock、HPD 引脚电平。测量点预期结果MIPI clock 对有稳定差分波形频率约 445.5MHz1080p60TMDS clock 对有稳定差分波形频率约 148.5MHz1080p60 标准 TMDS clockHPD 引脚高电平 4.8V~5.3V插拔时跳变MIPI 侧没有波形先查 DSI 的 lane 配置和时钟是否使能这个通常由 LK 阶段的显示驱动控制。TMDS 侧没有波形说明 LT9611 没有进入输出模式查它的 PLL 锁定寄存器如果 PLL 没锁上多半是输入时钟有问题。HPD 没拉高查引脚是否被其他外设占用或者驱动能力不够。示波器测量 MIPI 时注意探头的地线尽量用最短地线差分对用差分探头。没有差分探头时可以分别量 P 端和 N 端看相位关系但这个办法只能粗略判断有没有信号不能精确判断时序是否合规。6. 进阶把默认 1080p 改成你需要的分辨率和时序6.1 在驱动里修改输出时序LT9611 的输出时序由一组 I2C 寄存器控制包括像素时钟分频、HFP、HSYNC、VFP、VSYNC 等参数。资源里的 lt9611_v1_3_MTK658_0628.c 提供了一套完整初始化序列改动要点是先定位到时序配置段/* 以 1080p60Hz 为例修改前确认这些值 */ static const unsigned char lt9611_1080p_timing[] { 0x00, 0x00, 0x05, 0x00, /* pixel clock相关 */ 0x08, 0x02, 0x00, 0x00, /* HSYNC 宽度 */ /* ... 中间省略其他时序字段 ... */ };改成 720p 时最省事的做法是找原厂参考代码里 720p 的数组整体替换。自己手动改每个字段容易出错因为 LT9611 对时序的依赖是按像素周期计算的差一个数画面就会偏移或者出黑边。我的习惯是先确认目标分辨率的 modeline再从 modeline 里推出 HFP、HSYNC、VFP、VSYNC最后按数据手册换算成寄存器值。容易忽略的是 color depth1080p 默认 8bit如果输出 10bitLT9611 内部像素时钟要提高很多人改完分辨率忘记改色深导致暗部出现色块。6.2 处理 EDID 和 HPD 的特殊场景默认 EDID 里包含多个分辨率电视端会选择一个输出。如果你的产品接的是固定显示器推荐直接改 EDID只广播一个分辨率避免电视端和 LT9611 在握手时反复切换时序。常见做法是在驱动里加一个 EDID 覆盖函数从 EDID 的 DTD 块里找到目标分辨率的时序描述把其他分辨率对应的 DTD 清空。还有一个技巧是 HPD 时序不满足老式显示器时在驱动初始化完成后强制拉低 HPD、延时 200ms、再拉高模拟一次完整的拔插动作这个对间歇性黑屏很有效。6.3 验证修改结果的流程改完时序和 EDID 后按这个顺序验证串口确认初始化日志无 errori2cget 读取修改后的时序寄存器确认写入用支持 1080p 和 720p 的显示器分别测试最后接目标设备确认画面无花屏、闪烁、过扫描。我做驱动移植到现在已经形成固定习惯每次拿到新的 LT9611 源码包先看 dws 里 GPIO 复用是否和原理图一致再看 I2C 地址是否对应最后才看初始化序列。这个顺序只要有一处错了后面全是白折腾。从那以后凡是涉及桥接芯片的移植我都强制自己先花十分钟做一次文件、引脚、地址的三方核对再做编译烧录。希望帮到你。本文还有配套的精品资源点击获取
