3. SA8155 DPU驱动架构：DPU驱动在DRM框架中的位置、msm_dpu驱动模块、dpu_kms核心结构体

SA8155的显示子系统基于高通骁龙平台的Display Processing Unit (DPU) 硬件模块。在Linux内核中，DPU驱动被封装为msm_dpu驱动模块，并作为DRM/KMS框架的一个具体实现。理解DPU驱动在DRM框架中的位置、模块组成以及核心结构体dpu_kms，是进行DPU中断配置与显示时序开发的基础。

3.1 DPU驱动在DRM框架中的位置

在DRM框架中，msm_dpu驱动位于DRM Core与硬件抽象层之间。它向上通过struct drm_driver和struct drm_mode_config_funcs注册到DRM核心，向下直接操作DPU硬件寄存器。

下图展示了DPU驱动在DRM软件栈中的层级关系：

从图中可以看出，msm_dpu驱动模块是连接DRM核心与DPU硬件的桥梁。它实现了DRM框架定义的struct drm_mode_config_funcs回调，包括fb_create、output_poll_changed等，并管理着dpu_kms这一核心结构体。

3.2 msm_dpu驱动模块

msm_dpu驱动模块是SA8155显示驱动的核心实现。它由多个子模块组成，每个子模块对应DRM框架中的一个组件。下表列出了主要子模块及其职责：

msm_dpu驱动模块的初始化流程如下：

1. 平台驱动探测： 内核调用dpu_kms_probe()，匹配设备树节点，获取MMIO基地址和中断号。
2. DRM设备注册： 调用drm_dev_alloc()分配struct drm_device，并将dpu_kms结构体关联到drm_device->dev_private。
3. 模式配置初始化： 设置drm_mode_config的min_width、max_width、funcs等参数。
4. 子模块创建： 依次创建dpu_encoder、dpu_crtc、dpu_plane，并注册到DRM框架。
5. 中断注册： 通过devm_request_irq()注册DPU中断处理函数，包括VSYNC、帧完成、错误中断等。
6. DRM设备注册： 调用drm_dev_register()，使设备对用户空间可见。

3.3 dpu_kms核心结构体

dpu_kms是msm_dpu驱动中最重要的数据结构，它封装了整个DPU显示子系统的状态和控制信息。该结构体定义在drivers/gpu/drm/msm/disp/dpu1/dpu_kms.h中。

以下是dpu_kms结构体的核心字段及其作用：

struct dpu_kms {
    struct drm_device *dev;           // 关联的DRM设备
    struct platform_device *pdev;     // 平台设备指针

    void __iomem *mmio;               // DPU寄存器MMIO基地址
    unsigned long mmio_size;          // MMIO区域大小

    struct dpu_hw_catalog *catalog;   // 硬件能力描述表
    struct dpu_rm *rm;                // 资源管理器

    struct dpu_irq_controller irq_ctrl; // 中断控制器

    struct dpu_encoder *encoders[DPU_MAX_ENCODERS]; // 编码器数组
    struct dpu_crtc *crtcs[DPU_MAX_CRTCS];         // CRTC数组
    struct dpu_plane *planes[DPU_MAX_PLANES];       // 平面数组

    struct clk *core_clk;             // DPU核心时钟
    struct clk *vsync_clk;            // VSYNC时钟
    struct clk *axi_clk;              // AXI总线时钟

    struct regulator *vdd;            // DPU电源域

    bool has_danger_ctrl;             // 是否支持危险控制
    bool has_idle_pc;                 // 是否支持空闲电源管理
};

下表对关键字段进行详细说明：

下图展示了dpu_kms结构体与各子模块之间的关系：