第11篇:Atomic DRM 原理与 Commit 完整流程解析

38 阅读6分钟

前言

面向 Android/Linux 显示驱动工程师,基于主线 Linux DRM 开源代码,聚焦显示控制器、Panel、MIPI DSI 场景;区分 legacy drm 和 atomic drm,讲清楚为什么现在驱动都要上 Atomic。

适用范围:已经会移植 panel、会用 modetest,想搞懂 DRM 提交、状态检查、硬件刷帧的底层流程。

一、什么是 Atomic DRM?为什么要有它?

早期 DRM 是 legacy 模式:单独设置 CRTC、单独设置 Connector、单独设置 Plane,接口是分散的。 问题非常明显:

  1. 多个硬件寄存器分批配置,无法保证原子性;在中间状态时会出现闪屏、花屏、黑屏、时序错乱;
  2. 没有统一校验接口,参数非法时,一部分硬件已经改了,一部分没改,很难回滚;
  3. 不适合多图层叠加、多屏、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都出在这里时序搞错。

  1. Prepare 阶段(可重复、可回滚、不碰硬件寄存器) 函数入口:->atomic_prepare() 工作:软件层面校验参数、资源预留、计算时钟、检查带宽、检查图层叠加合法性、检查模式时序是否满足panel spec。特点是可以多次调用;不发硬件指令、不修改硬件寄存器;失败直接返回,不影响硬件。
  2. 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。

五、常见坑

  1. 在 atomic_check / atomic_prepare 里面写硬件寄存器:会打乱原子性,造成随机花屏
  2. check阶段漏校验带宽、MIPI速率,commit阶段硬件报错,无法回滚
  3. 混淆old_state和new_state:old是变更前状态,new是本次要生效状态,判断开关屏必须对比两者
  4. 同步/异步commit混用:异步commit不能在回调里做阻塞等待(比如等待panel稳定)
  5. 忘记 drm_atomic_get_new_xxx_state 拿状态,直接读crtc->state,拿到旧状态,逻辑错乱

六、调试手段

  1. 内核启动参数:drm.debug=0x1e 打开atomic全量日志
  2. 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会快很多。