2. drm_info 工具介绍：安装、基本用法与输出格式概览

drm_info 是 DRM 子系统调试工具链中最轻量、最直接的诊断工具。它通过读取内核 DRM 核心导出的 /sys/kernel/debug/dri/ 调试接口，将显卡设备、CRTC、Encoder、Connector、Plane 以及 Framebuffer 的拓扑关系与状态以结构化文本输出。与 modetest 偏重模式测试不同，drm_info 专注于“静态拓扑快照”，是性能计数器分析前必须掌握的基线工具。

2.1 安装方式

drm_info 是 drm-utils 工具集的一部分，主流发行版可直接通过包管理器安装：

2.2 基本用法

drm_info 的命令行接口非常简洁，核心参数不超过 5 个：

# 查看所有 DRM 设备（默认行为）
drm_info

# 指定具体设备节点（如 card0）
drm_info /dev/dri/card0

# 仅输出拓扑结构，不显示详细属性
drm_info --topology

# 输出 JSON 格式，便于脚本解析
drm_info --json

# 显示帮助信息
drm_info --help

最常用的调试场景是直接运行 drm_info 不加参数，它会枚举系统中所有 DRM 设备并打印完整拓扑。对于多 GPU 系统（如笔记本集显+独显），可通过 /dev/dri/card0、card1 分别查看。

2.3 输出格式概览

drm_info 的输出采用缩进层级结构，每个层级对应 DRM 子系统的核心对象。以下是一个典型输出片段（以 Intel i915 驱动为例）：

DRM device 0: /dev/dri/card0
  driver: i915
  version: 1.6.0
  description: Intel Graphics
  date: 20230101
  capabilities: [RENDER, PRIME, ATOMIC]
  props:
    - EDID: blob
    - DPMS: enum {On, Standby, Suspend, Off}
  CRTC 0:
    id: 32
    mode: 1920x1080@60Hz
    props:
      - ACTIVE: 1
      - MODE_ID: 42
    Encoder 0:
      id: 33
      type: TMDS
      possible_crtcs: 0x1
      Connector 0:
        id: 34
        type: HDMI-A-1
        status: connected
        modes:
          - 1920x1080@60Hz
          - 1280x720@60Hz
        props:
          - CRTC_ID: 32
  Plane 0:
    id: 35
    type: PRIMARY
    formats: XR24, AR24, XR30, AR30, NV12
    props:
      - CRTC_ID: 32
      - FB_ID: 0
  Plane 1:
    id: 36
    type: OVERLAY
    formats: XR24, AR24, NV12
    props:
      - CRTC_ID: 0
      - FB_ID: 0

输出结构可归纳为以下层级关系：

2.4 DRM 拓扑关系 SVG 图

下图展示了 drm_info 输出的核心对象拓扑关系，帮助理解 CRTC、Encoder、Connector、Plane 之间的连接与绑定：

2.5 关键输出字段解读

以下字段在性能计数器分析中需要重点关注：

• capabilities：若包含 ATOMIC，表示驱动支持原子操作，这是现代合成流水线的基础。若缺少此标志，性能计数器中的合成延迟可能不准确。
• CRTC 的 mode：当前显示分辨率与刷新率。高分辨率高刷新率场景下，Plane 合成压力增大，性能计数器中的 vblank 间隔会缩短。
• Plane 的 formats：列出该层支持的像素格式。若目标格式不在列表中，合成将回退到 GPU 渲染，导致性能计数器中的 gpu_cycles 飙升。
• Connector 的 status：connected 表示物理连接正常；disconnected 表示无显示器接入，此时 CRTC 可能处于空闲状态。
• props 中的 CRTC_ID：标识 Plane 当前绑定到哪个 CRTC。若多个 Plane 绑定到同一 CRTC，合成器需要做硬件合成或合成回退。

2.6 输出格式对比：文本 vs JSON