企业官网建设流程全解析

简介：面向MediaTek平台的LT9611 HDMI显示驱动源码包，专为嵌入式开发与驱动集成场景准备，帮助开发者在MTK方案中正确适配LT9611转换芯片，并默认输出1080p全高清画面。资源内包含LK引导阶段与内核层的驱动实现，以及硬件配置相关文件，可用于智能电视、机顶盒或其他需要高清输出的设备项目。压缩包共5个文件，含3个C源码文件和2个.dws配置文件，前者覆盖驱动主体逻辑与接口初始化，后者提供管脚复用和显示参数配置，整包仅21KB，结构紧凑，方便直接对照源码理解代码路径。目前已有964人学习下载，说明其在同类驱动调试工作中具备一定参考价值。开发者可借助lt9611_dsi2hdmi源码和codegen配置，梳理DSI转HDMI的初始化流程，理解MTK658平台上的驱动适配方式，为二次开发、移植或问题排查提供直接依据。

1. MTK 平台上 LT9611 桥接移植：先认清方向，再动设备树

在 MTK 平台上调 LT9611，最容易翻车的地方不是驱动代码，而是把方向搞反。LT9611 是龙迅半导体的一款 HDMI 转 MIPI DSI/CSI 桥接芯片，常被用在车载、工业视频采集项目上，把 HDMI 信号接入 MTK 的 MIPI CSI 接口。很多工程师习惯性地把它当 DSI 转 HDMI 来配，结果 I2C 读写正常，v4l2-ctl 拉流却一片黑；另一种错误是照抄其他 SoC 的 dts，却没有确认 lane 数与极性，导致图像花绿。下面从桥接原理讲起，再到设备树接线、驱动集成、参数调试和 EDID 验证，把 LT9611 在 MTK 平台上的完整路径走一遍。

2. LT9611 与 MTK 平台的对接原理：HDMI 到 MIPI CSI 的桥接链路

LT9611 不是一个简单的电平转换器。它内部集成了 HDMI 接收器、视频处理、MIPI CSI/DSI 发送器和 I2C 控制寄存器组。在 MTK 平台上，通常把它绑定到 i2c 总线上，通过i2c-client驱动来初始化，并把输出的 MIPI CSI-2 信号接入 MTK 的 SENINF。以下按信号链、驱动框架和上电时序三个角度拆解，把「为什么选 LT9611」和「驱动里先干什么」一次说清。

2.1 信号链与数据通道：为什么 lane 数和极性最容易出问题

HDMI 输入端的像素时钟和 MIPI 输出端的字节时钟并不相等。LT9611 会把 HDMI 数据流重新打包成 CSI-2 包，再按指定的 lane 数并行发送。常见做法是 1080p60 下用 4 条 data lane，每条 lane 的差分速率约 1Gbps。如果 MTK 的 SENINF 配置成 2-lane 接收，就需要在 LT9611 寄存器里把 4-lane 改成 2-lane，并同步修改 dts 里 endpoint 的>static const struct v4l2_subdev_ops lt9611_ops = { .core = &lt9611_core_ops, .pad = &lt9611_pad_ops, .video = &lt9611_video_ops, }; static int lt9611_s_stream(struct v4l2_subdev *sd, int enable) { struct lt9611 *lt = v4l2_get_subdevdata(sd); int ret; if (enable) { /* 先打开 MIPI TX 时钟，再写入初始化序列 */ ret = lt9611_write(lt, 0x80, 0x01); if (ret < 0) return ret; usleep_range(3000, 5000); ret = lt9611_init_sequence(lt); if (ret < 0) return ret; } else { /* 关闭 datalane，避免 MTK 进入休眠后链路残留 */ lt9611_write(lt, 0x80, 0x00); } return 0; }

代码里的0x80寄存器只是一个示意地址，它不是芯片手册里的通用定义，实际实现请按 LT9611 手册里的 MIPI PHY power-down 位来写。lt9611_init_sequence负责按选定的分辨率和 lane 数写一组寄存器，参数来自 dts 解析结果。把初始化放到s_stream里而不是 probe 里，是为了避免链路建立前就全速运行，导致开机功耗偏高和 I2C 读时序竞争。这里有个细节：usleep_range不能用太短的值，LT9611 在 PLL 重新锁定前，连续访问寄存器会返回不可靠数据。

2.3 上电时序：reset 释放前，I2C 访问一定会失败

LT9611 的 I2C 接口虽然容易访问，但在 reset 还没释放前，芯片内部核心没启动，读寄存器要么返回 0xff，要么导致总线挂死。通用的顺序是：先给 AVDD 和 DVDD 供电，等电压建立完成，再拉高 reset，延迟至少 10ms，才能访问 I2C。有的板子把 reset 和 enable 接在一起，这会导致放电时同时掉电，MTK 平台上的 LDO 又有软启动，结果就是每次开机时序都不一致，偶尔第一次拉流是黑屏，第二次又恢复正常。

上电时序不能只靠 dts 里的reset-gpios自动完成。在 I2C 检测失败时，先确认 reset 引脚有没有被 pinctrl 正确的GPIO_ACTIVE_LOW驱动，再看原理图里的供电时序是否满足手册。

提示：如果 reset 释放后第一次 I2C 读失败，可以重试一次；桥接芯片的振荡器需要时间起振，不要在第一毫秒就报错。

3. MTK 设备树接线：从 i2c 节点到 SENINF 的完整 dts 配置

3.1 最小 i2c 设备树节点：compatible、reg、reset 与供电

先给一个能跑起来的最小 dts 节点，挂在 i2c2 总线上：

&i2c2 { pinctrl-names = "default"; pinctrl-0 = <&i2c2_pins>; lt9611: lt9611@3b { compatible = "lontium,lt9611"; /* 与驱动 of_match_table 严格一致 */ reg = <0x3b>; /* 由 AD 引脚决定，0x39 或 0x3b */ reset-gpios = <&pio 27 GPIO_ACTIVE_LOW>; /* 低电平复位 */ interrupt-parent = <&pio>; interrupts = <28 IRQ_TYPE_LEVEL_LOW>; avdd-supply = <&mt6358_vemc_reg>; status = "okay"; port { lt9611_csi_ep: endpoint { remote-endpoint = <&seninf_ep>; bus-type = <4>; /* 4 = MIPI CSI-2 */ >&seninf { status = "okay"; ports { #address-cells = <1>; #size-cells = <0>; port@0 { reg = <0>; /* 物理 CSI 通道号 */ seninf_ep: endpoint { remote-endpoint = <&lt9611_csi_ep>; >&pio { lt9611_pins: lt9611-pins { pins_cmd_dat { pinmux = <PINMUX_GPIO28__FUNC_GPIO28>; input-enable; input-schmitt-enable; }; }; };

这里的input-schmitt-enable就是 mtk pinctrl 里 IES/SMT 配置的一种写法：IES 启用输入路径，SMT 决定是否开启迟滞。对 HPD 信号，不开启会导致电平在阈值附近抖动，LT9611 的驱动每几百毫秒就重新初始化一次，表现为输出抽搐或流中断。另一个容易漏的是 GPIO 外部上拉电阻：HPD 的信号由源端驱动，接收侧必须有上拉，否则插上源端也检测不到电平变化。

3.4 probe 顺序和失败日志：先看 -EPROBE_DEFER

如果 probe 顺序不对，驱动会反复返回-EPROBE_DEFER，这是正常现象。日志里出现lt9611: probe defer时，先查 supply 依赖、pinctrl 依赖和 GPIO 控制器是否 ready。不要为了消日志把 probe 改为异步，LT9611 的初始化需要严格的供电和复位顺序，异步 probe 会放大时基竞争问题。常见做法是在i2c_device_id表里同时匹配 id 和 compatible，保留一个读取 chip id 的函数在 probe 里先验证 I2C 通路，读到的值不对就直接返回-ENODEV，这样能尽早暴露接线错误。

4. LT9611 在 MTK 上的调试参数：寄存器读写、链路检查与花屏定位

设备树配好只算万里长征走了一半。LT9611 这类桥接芯片，寄存器初始化、MIPI 链路参数和电源纹波都会影响最终图像。下面给出从 I2C 直接操作到 v4l2 拉流定位的完整调试顺序。

4.1 用 i2ctransfer 直接读写寄存器

在没有串口 log 或者驱动还没跑起来时，i2c-tools 是检查 LT9611 状态最快的手段。先确认设备挂在哪条总线，再对寄存器做读写：

# 读 0x3b 设备的 0x20 寄存器 i2ctransfer -y -f 2 w1@0x3b 0x20 r1 # 写 0x21 寄存器为 0x01 i2ctransfer -y -f 2 w2@0x3b 0x21 0x01

第一条命令表示向 2 号总线上地址 0x3b 的设备写入 1 字节的寄存器偏移 0x20，然后读 1 字节。第二条命令的w2表示先发 1 字节偏移 0x21，再发 1 字节数据 0x01。-f表示强写，即使该地址已被驱动占用也要执行，适合调试。如果读回来始终是 0xff，先检查 reset 和供电；如果读出值会变，说明 I2C 通路有电平竞争，需要看上拉电阻和总线速率。

4.2 media-ctl 和 v4l2-ctl 确认链路与格式

设备树连好之后，用媒体控制器查看实际生效的拓扑：

# 查看所有 subdev 的 pad 连接 media-ctl -p # 列出所有 subdev 节点 v4l2-ctl --list-subdevs # 查看某个 subdev 的当前格式 v4l2-ctl -d /dev/v4l-subdev2 --get-fmt

media-ctl -p会打印所有 subdev 的 pad 连接情况，重点看 LT9611 source pad 是否与 seninf sink pad 处于 active 状态。如果没有连接，说明 dts 里 remote-endpoint 写错了。--get-fmt能拿到当前 subdev 的输出格式，如果显示 0x0000 或为空，说明芯片没有完成时序锁定。完成链路确认后，再用/dev/video0拉流：

v4l2-ctl -d /dev/video0 --stream-mmap --stream-count=30

拉流能成功不代表图像没问题，接下来看花屏特征。

4.3 推荐起点参数：常见分辨率下的 lane 与时序

这些数值不是固定的，LT9611 内部 PLL 的分频系数由寄存器配置决定。起点可以先按这个表设，然后通过示波器测 MIPI 数据 lane 的差分信号，再微调 HS 时钟直到图像正确。低分辨率调试时尽量降 lane 数，减少变量，确认通路后再升分辨率。

注意：不同批次的 LT9611 对 HS 时钟的容限不同，改完寄存器后一定要实测图像，不能只靠计算。

4.4 花屏与丢帧的排错清单

花屏的第一怀疑对象是 lane 顺序和极性。检查 dts 里的>echo on > /sys/devices/platform/13000000.i2c2/power/control

具体路径要和设备树里的 i2c 节点 address 对应，有些 SoC 上是 13800000.i2c2，需要按实际平台调整。这里用/sys/devices/platform/下的目录，实际调试时先ls /sys/bus/i2c/devices/找到设备名，再反查平台目录。

5. 从 EDID 逆推时序：LT9611 输出参数的验证技巧

LT9611 的输入侧是 HDMI，输出时序需要与源端的 EDID 匹配。很多时候驱动代码看起来没问题，但图像错位，其实是 EDID 里第一个详细时序描述符（DTD）跟驱动预设的分辨率相差几个像素。与其反复读寄存器猜，不如把 EDID 抓出来直接解析。

5.1 解析 EDID 中的 DTD 参数

EDID 一般可以从/sys/class/drm/card0-HDMI-A-1/edid拿到。下面这个脚本解析标准 DTD 里的有效像素、消隐和像素时钟：

import sys def parse_dtd(dtd): if dtd[0] == 0 and dtd[1] == 0: return None h_active = ((dtd[4] & 0xf0) << 4) | dtd[2] h_blank = ((dtd[4] & 0x0f) << 8) | dtd[3] v_active = ((dtd[7] & 0xf0) << 4) | dtd[5] v_blank = ((dtd[7] & 0x0f) << 8) | dtd[6] pixclk_10khz = dtd[0] | (dtd[1] << 8) return { "pixclk_khz": pixclk_10khz * 10, "h_active": h_active, "v_active": v_active, "h_total": h_active + h_blank, "v_total": v_active + v_blank, } with open(sys.argv[1], "rb") as f: edid = f.read() for i in range(4): off = 0x36 + i * 18 t = parse_dtd(edid[off:off+18]) if t: print(t)

脚本里的0x36是 EDID 中第一个 DTD 的偏移，每个 DTD 占 18 字节，标准块里最多 4 个。h_blank和v_blank的高位被分散在字节 4 和字节 7 的 nibble 中，所以需要移位合并。运行方式是把 EDID 文件路径作为参数。得到 h_total 和 v_total 后，和 LT9611 内部分频配置反推出来的时序做对比，偏差超过 1% 就要查寄存器或者换 EDID 源。如果 EDID 读取失败，先用 DDC 写入命令触发一次读取，再观察 dmesg 里 LT9611 的 EDID 状态寄存器是否更新，这一步往往能分辨是 DDC 总线问题还是接线问题。

本文还有配套的精品资源，点击获取