前言
面向 Android/Linux 显示驱动工程师,基于主线 Linux DRM 开源代码,聚焦显示控制器、Panel、MIPI DSI 场景;区分 legacy drm 和 atomic drm,讲清楚为什么现在驱动都要上 Atomic。
适用范围:已经会移植 panel、会用 modetest,想搞懂 DRM 提交、状态检查、硬件刷帧的底层流程。
一、什么是 Atomic DRM?为什么要有它?
早期 DRM 是 legacy 模式:单独设置 CRTC、单独设置 Connector、单独设置 Plane,接口是分散的。 问题非常明显:
- 多个硬件寄存器分批配置,无法保证原子性;在中间状态时会出现闪屏、花屏、黑屏、时序错乱;
- 没有统一校验接口,参数非法时,一部分硬件已经改了,一部分没改,很难回滚;
- 不适合多图层叠加、多屏、DP/MIPI 同步、DSC 压缩、刷新率切换这类复杂场景。
Atomic 核心**:**一次显示配置变更,打包成一个统一的 drm_atomic_state,先全部校验,校验通过后,一次性提交给硬件。要么全部成功,要么全部return,不会出现中间不一致状态,这就是“原子”。
总结:Atomic = 批量状态收集 + 统一合法性校验 + 原子提交 + 回滚保障。
Android 平台 HWC、SurfaceFlinger 最终下发的显示配置就是走 Atomic DRM 接口,这也是现在所有新 Panel、DSI 驱动强制要求实现 atomic 回调的根本原因。
关键概念
- drm_atomic_state:本次提交的总状态容器,保存本次所有要修改的对象(crtc / plane / connector / property)
- drm_crtc_state:CRTC(显示控制器)状态
- drm_plane_state:图层状态(图层位置、大小、buffer、format)
- drm_connector_state:connector 状态(使能、模式、链路参数,MIPI DSI 时序)
- property:DRM 属性(DRM 把配置封装成属性,atomic 就是修改属性)
二、Atomic Commit 阶段
Atomic Commit 拆成两个阶段:prepare(准备阶段) 和 commit(提交阶段)
两个阶段分离,是设计精髓,很多驱动bug都出在这里时序搞错。
- Prepare 阶段(可重复、可回滚、不碰硬件寄存器) 函数入口:->atomic_prepare() 工作:软件层面校验参数、资源预留、计算时钟、检查带宽、检查图层叠加合法性、检查模式时序是否满足panel spec。特点是可以多次调用;不发硬件指令、不修改硬件寄存器;失败直接返回,不影响硬件。
- Commit 阶段(硬件生效阶段,不能失败) 函数入口:->atomic_commit() 工作:把 prepare 校验好的配置,写到硬件寄存器、触发控制器刷新、启动 MIPI DSI 传输、切换面板时序。 特点是prepare 已经把所有风险拦完,commit 理论上不允许失败;硬件真正发生变化。
补充:还有 async commit(异步提交,用于帧刷新,不阻塞)和 sync commit(同步提交,阻塞等待硬件完成),Android 里 HWC 大量使用 async atomic。
三、完整调用链路
用户态/上层(modetest / HWC)→ DRM 框架 → 驱动回调
上层调用 drmModeAtomicCommit()
└── drm_atomic_commit()
├── drm_atomic_check() // 全局校验入口
│ ├── 各个helper:crtc/plane/connector atomic_check
│ └── 驱动自定义 ->atomic_check 回调
├── drm_atomic_prepare_commit() // prepare 阶段
│ └── 驱动 ->atomic_prepare
└── drm_atomic_commit_tail() // commit 阶段,真正刷硬件
└── 驱动 ->atomic_commit
drm_atomic_check 是第一道关口:所有参数合法性检查,必须放在 check 里,不要放到 commit 里。很多新手驱动bug:校验写在commit,参数错了硬件已经改一半,会花屏的。
四、驱动侧核心回调 + 开源代码片段
说明:代码来自开源 Linux 主线 drm panel 驱动
1. 驱动注册 atomic 回调
static const struct drm_connector_helper_funcs panel_connector_helper_funcs = {
.atomic_check = panel_atomic_check,
.atomic_commit = panel_atomic_commit,
};
static const struct drm_crtc_helper_funcs panel_crtc_helper_funcs = {
.atomic_prepare = panel_crtc_atomic_prepare,
.atomic_commit = panel_crtc_atomic_commit,
};
2. atomic_check (校验,只做软件检查,不碰硬件)
static int panel_atomic_check(struct drm_connector *conn,
struct drm_atomic_state *state)
{
struct drm_connector_state *conn_state = drm_atomic_get_new_connector_state(state, conn);
struct panel *panel = to_panel(conn);
struct drm_display_mode *mode = &conn_state->mode;
// 1. 检查模式是否在panel支持时序列表内
if (!panel_is_mode_valid(panel, mode)) {
DRM_DEBUG_ATOMIC("panel not support this mode %dx%d\n", mode->hdisplay, mode->vdisplay);
return -EINVAL;
}
// 2. MIPI DSI 速率、lane数校验
if (dsi_mode_to_bitrate(mode) > panel->max_bitrate) {
DRM_DEBUG_ATOMIC("dsi bitrate exceed limit\n");
return -EINVAL;
}
// 3. 上电状态约束:如果connector要enable,必须保证电源、复位资源就绪
if (conn_state->crtc && !panel->power_on) {
DRM_DEBUG_ATOMIC("need power on panel before enable\n");
}
return 0;
}
3. atomic_prepare(资源准备,不写寄存器)
static void panel_crtc_atomic_prepare(struct drm_crtc *crtc,
struct drm_atomic_state *state)
{
struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
struct panel *panel = crtc->dev->dev_private;
DRM_DEBUG_ATOMIC("%s: prepare crtc, enable=%d\n", __func__, crtc_state->enable);
// 预计算PLL、时钟参数,保存到state,这里只是软件计算,不写寄存器
if (crtc_state->enable) {
panel_calc_pll_param(panel, &crtc_state->mode);
}
}
4. atomic_commit(真正操作硬件、上电、发DSI初始化序列)
static void panel_crtc_atomic_commit(struct drm_crtc *crtc,
struct drm_atomic_state *state)
{
struct drm_crtc_state *old_state = drm_atomic_get_old_crtc_state(state, crtc);
struct drm_crtc_state *new_state = drm_atomic_get_new_crtc_state(state, crtc);
struct panel *panel = crtc->dev->dev_private;
DRM_DEBUG_ATOMIC("%s: commit crtc, old_en=%d new_en=%d\n",
__func__, old_state->enable, new_state->enable);
// 从关闭 → 打开:上电、复位、发送MIPI DSI panel初始化序列
if (!old_state->enable && new_state->enable) {
panel_power_on(panel);
panel_reset_sequence(panel);
panel_send_dsi_init_cmds(panel);
}
// 打开 → 关闭:下电、关闭MIPI链路
else if (old_state->enable && !new_state->enable) {
panel_send_dsi_shutdown_cmds(panel);
panel_power_off(panel);
}
// 时序变更,不开关屏:只更新DSI时序寄存器
if (new_state->enable &&
drm_mode_changed(&old_state->mode, &new_state->mode)) {
panel_update_dsi_timing(panel, &new_state->mode);
}
}
日志:DRM_DEBUG_ATOMIC 是drm专门的atomic调试日志,打开 drm.debug=0x1e 才能打印,不要随便用pr_info污染dmesg。
五、常见坑
- 在 atomic_check / atomic_prepare 里面写硬件寄存器:会打乱原子性,造成随机花屏
- check阶段漏校验带宽、MIPI速率,commit阶段硬件报错,无法回滚
- 混淆old_state和new_state:old是变更前状态,new是本次要生效状态,判断开关屏必须对比两者
- 同步/异步commit混用:异步commit不能在回调里做阻塞等待(比如等待panel稳定)
- 忘记 drm_atomic_get_new_xxx_state 拿状态,直接读crtc->state,拿到旧状态,逻辑错乱
六、调试手段
- 内核启动参数:drm.debug=0x1e 打开atomic全量日志
- modetest 带atomic参数提交,代替legacy模式:
modetest -M xxx -a -s <conn>:<mode>
-a 就是使用atomic接口提交,用来验证你的atomic回调是否正常
3. 看debugfs节点:/sys/kernel/debug/dri/0/state,导出当前atomic状态树,看property、crtc/plane/connector状态
七、小结
Atomic DRM 不是一个简单的“新接口”,是一套状态管理框架。
核心思想:先收集全部变更 > 统一校验 > 准备资源 > 一次性硬件生效。
现在所有Android平台、新的DSI/eDP驱动都强制atomic,看懂这个流程定位闪屏、切换刷新率、多图层、HWC相关bug会快很多。