1. 课程导入
在嵌入式显示、车载座舱、桌面 Linux 与高端电视盒子等场景中，HDR（High Dynamic Range，高动态范围）已经从“加分项”变成“基础能力”。但真正把 HDR 跑通，难点往往不在应用层，而在内核显示管线：DRM/KMS 如何描述色彩空间、如何传递元数据、如何与 VBlank 中断协同，以及当画面闪烁、撕裂、色彩发灰时，如何定位是驱动、硬件还是时序问题。本课程围绕“HDR 支持”与“VBlank 同步调试”两条主线，带你从概念到代码、从配置到排障，建立一套可复用的工程方法。
一、学习目标：从“能显示”到“显示正确且稳定”
本课程不满足于让屏幕亮起来，而是追求三个层次的目标：
- 理解 HDR 在 DRM 中的表达方式：掌握色彩空间（Colorspace）、HDR 元数据（HDR Metadata）、EDID/DisplayID 中的 HDR 静态元数据，以及 DRM 属性如何映射到硬件寄存器。
- 掌握 VBlank 同步机制：理解 VBlank 中断、Page Flip、原子提交（Atomic Commit）与帧缓冲切换之间的时序关系，能解释“为什么画面会撕裂或抖动”。
- 具备独立调试能力：能使用 modetest、kmstest、drm_info、tracefs/ftrace、debugfs 等工具，结合内核日志与寄存器读写，定位 HDR 与 VBlank 相关问题。
二、核心概念：DRM/KMS 显示管线中的关键对象
要调试 HDR 与 VBlank，必须先建立对象模型。Linux DRM 将显示系统抽象为若干对象：CRTC（扫描输出控制器）、Encoder（编码器）、Connector（连接器）、Plane（图层）、Framebuffer（帧缓冲）与 Property（属性）。HDR 相关能力通常挂在 Connector 和 CRTC 上，例如 Colorspace、HDR_OUTPUT_METADATA、max_bpc、max_luminance 等属性；而 VBlank 同步则围绕 CRTC 的扫描周期展开，Page Flip 事件在 VBlank 期间生效，保证帧切换不撕裂。
下面这张图展示了本节最值得先看清的整体关系：应用通过 DRM 接口提交帧，内核 DRM/KMS 将 HDR 属性与 VBlank 事件分别下发到显示控制器，最终由 Connector 输出到面板或显示器。
三、整体框架：从属性配置到中断同步的完整链路
HDR 与 VBlank 并不是两个孤立模块，它们在原子提交（Atomic Commit）中交汇。一次典型的 HDR 帧提交包含以下步骤：
- 能力探测：读取 Connector 的 EDID，解析 HDR 静态元数据块，确认显示器支持的色彩空间与最大亮度。
- 属性设置：在 Atomic Request 中设置
Colorspace、HDR_OUTPUT_METADATA、max_bpc等属性。 - 带宽与格式校验：检查当前分辨率、刷新率、色深与色彩空间组合是否超过链路带宽。
- 提交与生效：调用
drmModeAtomicCommit，驱动在 VBlank 期间切换帧缓冲并更新寄存器。 - 事件确认：等待 Page Flip 完成事件，确认本帧已正确显示，再提交下一帧。
这条链路中，任何一步出错都会表现为“HDR 不生效”或“画面异常”。例如，属性设置成功但带宽不足，会出现色彩断层；VBlank 事件延迟过大，会导致帧率不稳或撕裂。
四、实战路线：工具、命令与调试入口
本课程后续将围绕以下工具链展开实战。你可以先建立环境认知，后续章节会逐一深入。
| 工具/接口 | 用途 | 典型命令或路径 |
|---|---|---|
| modetest | 查看 KMS 对象、属性与当前状态 | modetest -M rockchip -c |
| drm_info | 导出 DRM 设备能力与属性树 | drm_info --all |
| debugfs | 查看驱动内部状态与寄存器 | /sys/kernel/debug/dri/0/ |
| ftrace / tracefs | 跟踪 VBlank 中断与 Page Flip 时序 | trace-cmd record -e drm:* |
| 内核日志 | 捕获 HDR 属性校验与带宽错误 | dmesg | grep -i hdr |
modetest -M <driver> -c 和 drm_info --all，保存一份基线状态。后续任何修改都可以与基线对比，快速判断是属性变化还是驱动行为变化。
五、常见误区与复盘思路
初学者最容易陷入三个误区：
- 只改应用层，不看内核属性：HDR 是否生效，最终由 DRM 属性与硬件寄存器决定，应用层设置只是请求。
- 把 VBlank 当成“定时器”：VBlank 是扫描时序事件，不是普通定时器；错过一个 VBlank，帧就要等下一个周期。
- 忽略带宽与色深约束：4K@60Hz + 10bit + BT.2020 可能超出 HDMI 2.0 带宽，必须降色深或启用 DSC。
Colorspace 与 HDR_OUTPUT_METADATA 是否同时生效，再检查显示器是否真正进入 HDR 模式。很多“HDR 无效”其实是元数据未下发或显示器未切换。
本课程将沿着“概念—属性—提交—中断—排障”的路径推进。你不需要一开始就记住所有寄存器，但需要建立一条清晰的判断链：先看属性，再看提交，再看中断，最后看硬件。掌握这条链路，HDR 与 VBlank 的调试就不再是碰运气，而是可复现、可验证的工程过程。