4. modeset 流程详解：用户态 ioctl 调用链、atomic_check 与 atomic_commit

Modeset（模式设置）是显示子系统中最核心的操作，涉及分辨率、刷新率、平面布局、CRTC 连接等状态的切换。本章深入剖析从用户态 DRM ioctl 发起请求，到内核 atomic_check 校验、再到 atomic_commit 硬件生效的完整调用链，帮助调试人员精准定位故障环节。

4.1 用户态 ioctl 调用链

用户态程序（如 Weston、Xorg、libdrm 测试工具）通过 drmModeAtomicCommit 或 drmModeSetCrtc 等接口触发 modeset。底层均通过 ioctl(fd, DRM_IOCTL_MODE_ATOMIC, &req) 进入内核。

内核侧入口函数为 drm_atomic_ioctl，其核心处理流程如下：

1. 解析属性：从用户态拷贝 drm_mode_atomic 结构，提取 object id、property id、value。
2. 构建 state：调用 drm_atomic_state_alloc 分配状态对象，将属性填入对应 plane_state、crtc_state、connector_state。
3. 执行 atomic_check：调用驱动注册的 .atomic_check 回调，验证状态可行性。
4. 执行 atomic_commit：根据 flags 选择同步或异步提交，调用 .atomic_commit 回调。

4.2 atomic_check：状态校验阶段

atomic_check 是 modeset 流程中的“守门员”，负责验证新状态是否合法。该回调在持有 drm_modeset_lock 的上下文中执行，不允许睡眠或等待硬件。

4.2.1 校验内容清单

4.2.2 调试方法

• 添加 WARN_ON：在 .atomic_check 中插入 drm_WARN_ON，当校验失败时打印调用栈。
• 使用 drm_dbg_atomic：输出每个 state 的关键字段，如 crtc->state->mode、plane->state->src。
• 检查返回值：atomic_check 返回 -EINVAL 时，用户态会收到 errno，但具体原因需从 dmesg 获取。

4.3 atomic_commit：硬件生效阶段

atomic_commit 负责将校验通过的状态真正应用到硬件。根据 flags 不同，提交方式分为同步（阻塞）和异步（非阻塞）两种。

4.3.1 提交模式对比

4.3.2 驱动实现要点

驱动在 .atomic_commit 中通常执行以下步骤：

1. 更新寄存器：将 state 中的参数写入硬件寄存器（如 timing generator、plane 地址）。
2. 触发更新：向硬件发送更新触发信号（如写 UPDATE_REG 寄存器）。
3. 等待 vblank：同步模式下等待垂直消隐期，避免撕裂。
4. 发送事件：异步模式下通过 drm_crtc_send_vblank_event 通知用户态。

4.4 完整 modeset 调用链示例

以下是一个典型 4K@60 分辨率切换的完整调用链，包含关键函数与返回值：

// 用户态调用
drmModeAtomicCommit(fd, &req, DRM_MODE_ATOMIC_ALLOW_MODESET, NULL);

// 内核调用链（ftrace 输出）
drm_atomic_ioctl()                          // 入口
  drm_atomic_state_alloc()                  // 分配 state
  drm_atomic_check_only()                   // 校验入口
    i915_atomic_check()                     // i915 驱动 check
      intel_crtc_atomic_check()             // CRTC 时钟校验
      intel_plane_atomic_check()            // 平面格式校验
      intel_connector_atomic_check()        // 连接器状态校验
    drm_atomic_check_planes()               // 全局平面校验
  drm_atomic_commit()                       // 提交入口
    drm_atomic_helper_commit()              // 辅助函数
      drm_atomic_helper_swap_state()        // 交换新旧 state
      intel_atomic_commit_tail()            // 驱动提交尾部
        intel_update_crtc()                 // 写 CRTC 寄存器
        intel_update_plane()                // 写平面寄存器
        intel_wait_for_vblank()             // 等待 vblank
        drm_crtc_send_vblank_event()        // 发送事件（异步模式）

4.5 故障排查清单