【Loongson/LS2H】HDMI 显示从 PMON 到 Linux 内核完整打通（配置 + 驱动 + 排查全流程）
【Loongson/LS2H】HDMI 显示从 PMON 到 Linux 内核完整打通（配置 + 驱动 + 排查全流程）
一、问题背景
在龙芯平台开发过程中，经常遇到这样的问题：
- ✅ PMON 阶段 HDMI 正常显示
- ❌ Linux 内核启动后 HDMI 黑屏
- ❌ rootfs 阶段无任何显示
这说明：
硬件正常，但内核显示链路没有正确建立
本文将从配置、驱动、设备树（如涉及）、调试方法几个方面，完整梳理 HDMI 显示打通流程。
二、显示链路整体原理
1. 启动阶段显示流程
PMON → 内核 → rootfs| 阶段 | 显示来源 |
|---|---|
| PMON | 固件初始化 HDMI |
| 内核 | DRM / FB 驱动重新初始化 |
| rootfs | fbcon / kms 接管 |
⚠️ 关键点：
内核不会继承 PMON 的显示状态，必须重新初始化硬件
三、内核显示方案选择
在 LS2H / Loongson 平台，主要有两种方案：
1. simplefb（临时方案）
CONFIG_FB_SIMPLE=y特点：
- 依赖 PMON framebuffer
- 不真正初始化 HDMI
- 仅用于“能亮”
👉 适合调试早期阶段
2. DRM（推荐方案）
CONFIG_DRM_LSDC=y特点：
- 真正驱动显示控制器
- 支持分辨率切换
- 可用于 GUI / Wayland / X11
👉最终必须使用 DRM
四、最小可用内核配置（关键）
1. DRM 核心
CONFIG_DRM=yCONFIG_DRM_KMS_HELPER=yCONFIG_DRM_FBDEV_EMULATION=y2. Loongson 显示驱动（核心）
CONFIG_DRM_LOONGSON_VGA=yCONFIG_DRM_LSDC=yCONFIG_DRM_LSDC_PCI_DRIVER=y⚠️ 必须是：
=y不能是：
=m否则会出现：
- 内核阶段黑屏
- rootfs 才加载模块
3. framebuffer 兜底
CONFIG_FB=yCONFIG_FB_SIMPLE=yCONFIG_FRAMEBUFFER_CONSOLE=y作用：
- 提供 early console
- 防止驱动异常时完全黑屏
五、必须关闭的无关配置（重点避坑）
1. PC/服务器显卡驱动
# CONFIG_DRM_AMD is not set# CONFIG_DRM_RADEON is not set# CONFIG_DRM_NOUVEAU is not set# CONFIG_DRM_AST is not set# CONFIG_DRM_SMI is not set2. HDMI bridge（ARM平台）
# CONFIG_DRM_DW_HDMI is not set# CONFIG_DRM_RCAR_DW_HDMI is not set# CONFIG_DRM_SII902X is not set# CONFIG_DRM_TI_TFP410 is not set3. Panel（LCD用）
# CONFIG_DRM_PANEL_SIMPLE is not set4. USB 显卡
# CONFIG_DRM_UDL is not set5. TinyDRM
# CONFIG_DRM_TINYDRM is not set六、设备树（DT）说明
⚠️ Loongson 特点
多数 Loongson 平台：
- ❌ 不依赖设备树控制 HDMI
- ✔ 使用平台驱动（PCI / 固定寄存器）
👉 因此：
HDMI 通常不需要额外 DT 配置
如果是 DT 平台（扩展说明）
需要：
hdmi@xxx { compatible = "..."; status = "okay"; };但 LS2H 一般无需配置
七、启动参数（boot.cfg）
推荐参数
append"console=tty0"或强制分辨率：
append"video=HDMI-A-1:1024x768"八、常见问题排查
1. 编译时报错（寄存器未定义）
LS2H_DC_REG_BASE undeclared原因：
- 未开启 SoC 支持
- 头文件未包含
解决：
CONFIG_MACH_LOONGSON=y2. 内核黑屏
排查：
dmesg|grep-idrm情况1：只有 simplefb
simple-framebuffer👉 说明：
- DRM 未生效
- 只是 PMON 继承
情况2：lsdc 初始化成功
lsdc drm initialized👉 正常
3. HDMI 无信号
检查：
- 驱动是否加载
- 分辨率是否支持
- 时钟是否初始化
九、推荐调试流程（工程实践）
Step 1：验证 simplefb
CONFIG_FB_SIMPLE=y👉 确认硬件 OK
Step 2：启用 DRM
CONFIG_DRM_LSDC=yStep 3：关闭冗余驱动
👉 逐步精简
Step 4：验证日志
dmesg|grep-E"drm|fb"十、最终最小配置总结
CONFIG_DRM=yCONFIG_DRM_KMS_HELPER=yCONFIG_DRM_FBDEV_EMULATION=yCONFIG_DRM_LOONGSON_VGA=yCONFIG_DRM_LSDC=yCONFIG_DRM_LSDC_PCI_DRIVER=yCONFIG_FB=yCONFIG_FB_SIMPLE=yCONFIG_FRAMEBUFFER_CONSOLE=y十一、总结
HDMI 显示问题本质是：
❌ 内核没有正确接管显示控制器
✅ 正确配置 DRM + LS2H 驱动即可解决
十二、一句话经验总结
PMON 能亮 ≠ 内核能亮
内核必须重新初始化 HDMI 硬件
十三、实践建议
- 以 defconfig 为基础，不要在污染配置上修
- DRM 驱动必须内建（=y）
- 逐步裁剪，避免一次性删除
十四、LSDC 显示驱动源码解析（核心）
在前文中我们已经完成了 HDMI 的配置与点亮，但如果想彻底掌握显示问题定位能力，必须理解：
👉内核驱动到底是如何把 HDMI 点亮的？
本章以drivers/gpu/drm/lsdc/为核心，对 LSDC 驱动进行源码级解析。
一、驱动整体结构
LSDC（Loongson Display Controller）驱动属于 DRM 子系统，其结构如下：
drivers/gpu/drm/lsdc/ ├── lsdc_drv.c // 驱动入口 ├── lsdc_kms.c // KMS核心 ├── lsdc_output.c // 输出（HDMI/VGA） ├── lsdc_pll.c // 像素时钟 ├── lsdc_irq.c // 中断 ├── lsdc_regs.h // 寄存器定义二、驱动初始化流程
1. 驱动入口（probe）
staticintlsdc_pci_probe(structpci_dev*pdev,...)主要做三件事：
✔ 1）映射寄存器
mmio=pci_iomap(pdev,0