1. SA8155 平台概述

本章是《SA8155 显示驱动开发：KMS 框架与 CRTC 初始配置》的起点。我们将从芯片特性、显示子系统硬件架构和开发环境搭建三个维度，为后续的 KMS 驱动开发打下坚实基础。SA8155 是高通第三代车载座舱平台的核心 SoC，其显示子系统集成了多个显示控制器、DSI/DP 接口和硬件合成器，对 Linux KMS 驱动的实现提出了独特要求。

1.1 SA8155 芯片关键特性

SA8155 基于 7nm 制程，专为智能座舱和车载信息娱乐系统设计。以下表格归纳了与显示驱动开发最相关的芯片特性：

特性类别 具体参数 驱动开发影响
CPU 架构 Qualcomm Kryo 485 (8 核，最高 2.84GHz) 多核调度影响 CRTC 中断处理延迟
GPU Adreno 640 (支持 Vulkan/OpenGL ES) GPU 合成与 KMS 的 Framebuffer 交互
显示控制器 3x Display Controller (DPU)，支持 4K@60fps 每个 DPU 对应一个 CRTC，需独立初始化
显示接口 4x DSI (每路 4-lane)、2x DP (eDP/DP) Encoder/Connector 类型多样，绑定关系复杂
硬件合成 Smart DMA、Layer Mixer (最多 8 层) KMS Plane 数量与硬件层数直接对应
内存带宽 LPDDR5，最高 64GB/s 高分辨率多图层合成对带宽的依赖
视频编解码 支持 4K 解码 (H.265/H.264) 视频播放场景下的显示管道配置
开发提示：SA8155 的 DPU（Display Processing Unit）是 KMS 驱动中 CRTC 的硬件实体。每个 DPU 内部包含独立的 Timing Controller、Layer Mixer 和色彩处理模块。在后续章节中，我们将深入分析 DPU 的寄存器映射和初始化序列。

1.2 显示子系统架构

SA8155 的显示子系统采用分层流水线架构，从内存中的 Framebuffer 到物理显示面板，数据经过多个硬件模块处理。下图展示了核心模块及其数据流关系：

SA8155 显示子系统架构图 SA8155 显示子系统架构 系统内存 Framebuffer 缓冲区 DPU 0 (CRTC 0) Timing Gen + Mixer 4 层硬件合成 DPU 1 (CRTC 1) Timing Gen + Mixer 4 层硬件合成 DPU 2 (CRTC 2) Timing Gen + Mixer 4 层硬件合成 DSI 0 / DSI 1 4-lane MIPI DP 0 / eDP DisplayPort DP 1 / HDMI 外部显示 仪表屏 1920x720 中控屏 1920x1080 副驾屏 1920x720 架构要点说明： 1. 每个 DPU 独立驱动一个 CRTC，支持不同的时序和分辨率。 2. 数据流：Framebuffer → DPU Layer Mixer → 显示接口 → 面板。 3. KMS 驱动中，DPU 对应 struct drm_crtc，接口对应 struct drm_encoder。 4. 硬件合成层数（8 层）决定了 KMS Plane 的最大数量。
架构关键点：SA8155 的显示子系统采用“多 DPU + 多接口”的独立管道设计。每个 DPU 内部包含独立的 Timing Controller（生成 VBlank/HSync）、Layer Mixer（硬件合成）和色彩处理管线。在 KMS 框架中，一个 DPU 实例对应一个 struct drm_crtc，其内部的 Layer Mixer 通道对应 struct drm_plane。这种 1:N（CRTC:Plane）的关系是驱动初始化的核心。

1.3 显示驱动开发环境搭建

SA8155 的显示驱动开发通常基于高通提供的 LE（Linux Embedded）或 QNX 环境。以下步骤以 Linux KMS 驱动开发为例，说明环境搭建流程：

1.3.1 硬件准备清单

  • 目标板：SA8155 开发板（如 MTP/HDK）或量产板，确保 DPU 供电和时钟正常。
  • 调试工具：USB 串口（UART）、JTAG 调试器（如 Lauterbach）、逻辑分析仪（用于 DSI/DP 信号分析）。
  • 显示设备：MIPI DSI 面板（仪表/中控）、DP 显示器（用于调试外部显示）。
  • 主机：Ubuntu 20.04/22.04 x86_64 工作站，至少 16GB 内存，200GB 磁盘空间。

1.3.2 软件工具链安装

组件 版本/工具 用途
交叉编译器 gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu 编译 ARM64 内核和驱动
内核源码 Qualcomm msm-5.4 / msm-5.10 (LA.UM.9.x) 包含 DPU 和 DSI 驱动源码
DTB 工具 dtc (Device Tree Compiler) v1.6+ 编译设备树，配置显示接口
文件系统 Buildroot / Yocto (含 libdrm, mesa) 提供用户态测试工具 (modetest, kmstest)
调试工具 trace-cmd, kernelshark, drm_info 跟踪 KMS 事件和 CRTC 状态

1.3.3 内核配置关键选项

在 make menuconfig 中，必须启用以下 Kconfig 选项才能支持 SA8155 的 KMS 显示驱动：

# 核心 DRM/KMS 框架
CONFIG_DRM=y
CONFIG_DRM_KMS_HELPER=y
CONFIG_DRM_MSM=y                  # 高通 MSM DRM 驱动
CONFIG_DRM_MSM_DPU=y             # DPU 显示控制器驱动
CONFIG_DRM_MSM_DSI=y             # DSI 接口驱动
CONFIG_DRM_MSM_DP=y              # DisplayPort 接口驱动
CONFIG_DRM_MSM_HDMI=y            # HDMI 输出（如需要）

# 时钟和电源管理
CONFIG_COMMON_CLK_QCOM=y
CONFIG_QCOM_GDSC=y               # 电源域控制
CONFIG_QCOM_RPMH=y               # 资源状态管理

# 设备树支持
CONFIG_OF=y
CONFIG_OF_GPIO=y                 # 面板复位/背光 GPIO
常见陷阱：SA8155 的 DPU 驱动依赖 CONFIG_DRM_MSM_DPU 而非旧版的 CONFIG_DRM_MSM_MDP5。如果内核配置了错误的显示控制器，CRTC 初始化将失败，dmesg 中会出现 msm_dpu: unknown hardware version 错误。务必确认内核源码中 drivers/gpu/drm/msm/disp/dpu1/ 目录存在。

1.3.4 设备树配置示例

SA8155 的显示接口信息通过设备树（Device Tree）传递给内核。以下是一个简化的 DSI 显示节点配置：

/* sa8155-dpu.dtsi - DPU 控制器节点 */
&mdss_mdp {
    compatible = "qcom,sa8155-dpu";
    reg = <0x0 0xae00000 0x0 0x100000>,
          <0x0 0xaf00000 0x0 0x100000>;
    reg-names = "mdp_phys", "vbif_phys";
    clocks = <&dispcc DISP_CC_MDSS_MDP_CLK>,
             <&dispcc DISP_CC_MDSS_VSYNC_CLK>;
    clock-names = "bus", "vsync";
    interrupts = <GIC_SPI 83 IRQ_TYPE_LEVEL_HIGH>;
    interrupt-controller;
    #interrupt-cells = <1>;

    /* 每个 DPU 实例对应一个 CRTC */
    dpu_intf0: dpu-intf@ae01000 {
        compatible = "qcom,dpu-intf";
        reg = <0x0 0xae01000 0x0 0x200>;
        interface-type = "dsi";
        qcom,dpu-engine-id = <0>;
    };

    dpu_intf1: dpu-intf@ae01200 {
        compatible = "qcom,dpu-intf";
        reg = <0x0 0xae01200 0x0 0x200>;
        interface-type = "dsi";
        qcom,dpu-engine-id = <1>;
    };
};

/* 面板节点 - 连接到 DSI 0 */
&dsi0 {
    compatible = "qcom,dsi-ctrl-6g";
    reg = <0x0 0xae94000 0x0 0x400>;
    clocks = <&dispcc DISP_CC_MDSS_DSI0_CLK>;
    clock-names = "iface";
    phys = <&dsi0_phy>;
    phy-names = "dsi";
    #address-cells = <1>;
    #size-cells = <0>;

    panel@0 {
        compatible = "boe,ne135fbm-n41", "panel-dsi";
        reg = <0>;
        vdd-supply = <&pm8150_l11>;
        avdd-supply = <&pm8150_l17>;
        reset-gpios = <&tlmm 75 GPIO_ACTIVE_LOW>;
        backlight = <&pm8150_pwm>;
    };
};

1.3.5 验证环境是否就绪

完成内核编译和烧录后，通过以下步骤验证显示驱动环境是否正常工作：

  1. 检查内核模块加载：启动后执行 lsmod | grep msm，确认 msm 和 dpu 模块已加载。
  2. 查看 CRTC 枚举：运行 cat /sys/kernel/debug/dri/0/state，查看 CRTC 和 Plane 的状态。
  3. 测试基本显示：使用 modetest -M msm -c 列出所有 CRTC、Encoder 和 Connector。
  4. 检查中断：执行 cat /proc/interrupts | grep dpu，确认 DPU 中断号已注册。
  5. 验证 VBlank：运行 modetest -M msm -v 观察 VBlank 计数是否递增。
快速诊断：如果 modetest -c 没有输出任何 CRTC，最常见的原因是设备树中 DPU 的 compatible 字符串与驱动不匹配，或者 DPU 的时钟/电源域未正确使能。检查 dmesg | grep dpu 的输出，定位初始化失败的具体阶段。

1.4 本章小结

本章完成了 SA8155 显示驱动开发的平台认知铺垫：

  • 掌握了 SA8155 芯片的显示相关特性，特别是 3 个独立 DPU 和多种显示接口的硬件布局。
  • 理解了显示子系统的分层架构：Framebuffer → DPU (CRTC) → 接口 (Encoder) → 面板 (Connector)。
  • 搭建了完整的开发环境，包括交叉编译器、内核配置、设备树编写和验证步骤。
← 上一章 📖 返回目录 下一章 →