第12篇:HWC硬件合成深度解析:DRM Atomic是怎么和HWC配合送画面的

50 阅读11分钟

前言

前面我们吃透了DRM子系统、Atomic原子提交、Panel驱动、MIPI、ESD检测...。很多人看懂内核DRM之后,会卡在一个核心疑问: SurfaceFlinger收集了App、状态栏、导航栏、视频、弹窗这么一大堆图层,这些图层是如何从Android图形HAL层,一步步转化成DRM能够识别的Atomic State,最终交给DPU硬件输出到屏幕?

HWC(Hardware Composer,硬件合成器)就是这个链路的枢纽。 很多新手误区:以为HWC只是简单“转发画面”。HWC的核心职责是硬件能力协商 + 图层翻译器 + DRM Atomic的上层封装者。 Atomic DRM设计的“整帧校验、一次性提交、失败回滚”,本质就是为了适配HWC多Overlay图层同步刷新的需求。如果没有HWC,SurfaceFlinger只能全部走GPU合成,多图层、低功耗视频场景性能和功耗会严重恶化。

本文从HWC架构、HWC2核心数据结构、prepare/set完整时序、Device/Client合成底层逻辑、图层参数映射、DMA-BUF + fence同步、HWC组装Atomic State的代码片段、异常场景、全链路调试手段完整展开。

一、HWC定位:SurfaceFlinger的协商助手,DRM的上层代理

SurfaceFlinger(SF)是Android系统图层管理器:所有应用、SystemUI、壁纸、视频播放器都会提交Surface,每个Surface对应一个独立图层Layer。 SF的工作:收集一帧所有图层、按Z序排序、接收VSync信号触发一帧合成。 SF本身没有硬件合成能力,它只有两条输出路径:

  1. 交给GPU(GL/Vulkan)做软件合成(Client合成)
  2. 交给HWC,由SOC DPU硬件Overlay做硬件合成(Device合成)

HWC的核心价值一句话:评估当前帧的图层,判断哪些DPU硬件Overlay通道可以承接,不能承接的交给SF走GPU合并。

DPU硬件能力是有上限的:Overlay通道数量、支持buffer格式、压缩格式、缩放范围、旋转、行对齐、带宽上限,这些限制全部由HWC驱动感知,并在prepare阶段反馈给SF。

HWC不是标准内核驱动,它属于 Android HAL(硬件抽象层),跑在用户态;HWC驱动内部再调用libdrm,和内核DRM驱动交互。 层级自上而下: App → Surface → SurfaceFlinger → HWC2 HAL → libdrm → DRM Core → DPU驱动 → MIPI/HDMI → Panel

GPU合成:N个图层 → GPU渲染混合 → 1个Framebuffer → HWC送屏 HWC硬件合成:N个独立图层 + 各自DMA-BUF → DPU多个Overlay通道硬件叠加 → 直接输出画面

二、HWC2 核心数据结构

现在Android 10及以上主流都是HWC2,HWC3在新版Android引入,后面单独说明差异。HWC2最核心两个对象:

  1. HWC2_Display:代表一个显示设备(主屏/副屏),一个Display对应DRM里一个CRTC+Connector
  2. HWC2_Layer:一个图层,对应一个App窗口、状态栏、视频层等,一个Layer未来有可能映射到DRM Plane

每个HWC2_Layer携带的关键信息(这些就是后面传给DRM的原始参数):

// 实际在hwcomposer2.h中定义
struct HWC2_Layer {
    buffer_handle_t buffer;    // 图形buffer,包含fd,后续转DMA-BUF
    int32_t z;                 // Z序,越大越在上层
    float alpha;               // 全局透明度
    HWC2_BlendMode blend;      // 混合模式:预乘alpha / 非预乘
    HWC2_Rect src;             // src_rect:源buffer裁剪区域
    HWC2_Rect dst;             // dst_rect:屏幕上目标窗口
    HWC2_Transform transform;  // 旋转、镜像
    uint32_t compositionType;  // 【关键】HWC2_COMPOSITION_DEVICE / CLIENT / SOLID_COLOR
    int acquireFence;          // acquire fence:buffer就绪信号
    int releaseFence;          // release fence:DPU用完buffer,还给SF/GPU
};

compositionType 是prepare阶段HWC回填的结果,是整个合成流程的开关:

  • HWC2_COMPOSITION_DEVICE:HWC承诺,DPU硬件Overlay可以直接处理这个图层
  • HWC2_COMPOSITION_CLIENT:硬件不支持,SF必须把这个图层交给GPU合并
  • HWC2_COMPOSITION_SOLID_COLOR:纯色图层,HWC直接硬件填充,不需要buffer

坑点:compositionType是逐帧协商的结果,每一帧都可能变,这就是很多页面切换闪屏的根源。

HWC3变化简要: HWC3是HWC2的升级,增加了异步提交、分层刷新、更好的PSR/低功耗支持,接口改动,但底层依然依赖DRM Atomic,驱动侧的核心逻辑一致。

三、两大合成模式:Device硬件合成 & Client GPU合成,完整时序拆解

3.1 Device模式(硬件合成,优先走)

触发条件:图层格式、尺寸、缩放、数量、带宽全部在DPU硬件规格内。 完整时序:

  1. VSync信号到达SF,SF开始收集本帧所有Layer,按Z序排序
  2. SF调用 prepare(display, numLayers, layers),把全部图层下发给HWC HAL
  3. HWC驱动内部逻辑:
    • 查询DRM,获取当前可用Plane数量、支持格式、scaler能力、带宽水位
    • 逐个遍历Layer,做硬件能力校验
    • 校验通过:标记 compositionType = DEVICE
    • 校验失败:标记为 CLIENT
  4. HWC返回给SF,告诉SF:哪些图层我硬件能扛
  5. SF拿到标记结果,这一批DEVICE图层不进GPU,直接保留独立buffer
  6. SF调用 set(display, numLayers, layers),下发最终图层集合
  7. HWC驱动在set阶段:把所有DEVICE图层,组装成一个DRM Atomic State
  8. 调用libdrm drmModeAtomicCommit,进入Atomic流程:DRM先check,全部校验通过,一次性提交给DPU
  9. DPU多个Overlay通道并行读取各个图层的DMA-BUF,硬件做alpha混合、叠加、缩放,输出到Panel
  10. 帧渲染完成,VBlank中断上来,HWC回填release fence,通知SF:buffer已经用完,可以回收

3.2 Client模式(GPU合成,兜底)

触发条件:

图层超出硬件能力:不支持的YUV格式、压缩格式、超大缩放、overlay通道耗尽、特殊混合模式。

时序:

  1. 同样prepare协商,HWC把无法硬件处理的Layer标记为 CLIENT
  2. SF收到CLIENT标记后,把所有CLIENT图层打包,交给GPU(GL/Vulkan)渲染合并
  3. GPU输出一张合并后的单一Buffer,生成一个新Layer
  4. SF把这个合并后的新Layer,标记为DEVICE,再次交给HWC
  5. HWC只需要把这一个图层下发DRM Primary Plane,走Atomic提交
  6. DPU只需要一个overlay通道,直接送出这一张合成好的画面

工程里最常见:混合合成。一部分图层DEVICE,一部分CLIENT。 例:视频层格式支持,走硬件Overlay;弹窗用了特殊滤镜,标记CLIENT,GPU合并弹窗+背景,再作为一个图层交给DPU。 混合模式最容易出时序bug,因为每一帧CLIENT/DEVICE集合都可能变化。

四、HWC set阶段:图层参数如何翻译成DRM Atomic State

这是驱动工程师最关心的一段:HWC拿到HWC2_Layer数组,怎么变成DRM的state、plane、property。 下面是libdrm层简化逻辑伪代码(高通/MTK平台HWC驱动内部都有类似逻辑):

// 简化HWC驱动set内部逻辑
int hwc_build_atomic_state(hwc2_display_t *disp, HWC2_Layer *layers, int layer_cnt)
{
    drmModeAtomicReq *req = drmModeAtomicAlloc();
    uint32_t crtc_id = disp->crtc_id;
    uint32_t connector_id = disp->conn_id;
    int plane_idx = 0;
    // 遍历所有标记为DEVICE的layer
    for(int i = 0; i < layer_cnt; i++) {
        HWC2_Layer *layer = &layers[i];
        if(layer->compositionType != HWC2_COMPOSITION_DEVICE)
            continue;
        // 分配一个空闲DRM Plane(Primary / Overlay)
        uint32_t plane_id = disp->planes[plane_idx++];
        // 1. 绑定buffer,hwc buffer_handle -> dma_buf fd
        int buf_fd = buffer_handle_get_dma_buf_fd(layer->buffer);
        drmModeAtomicAddProperty(req, plane_id, prop_fb_id, get_fb_id(buf_fd));
        // 2. 源裁剪 src_rect
        drmModeAtomicAddProperty(req, plane_id, prop_src_x, layer->src.left);
        drmModeAtomicAddProperty(req, plane_id, prop_src_y, layer->src.top);
        drmModeAtomicAddProperty(req, plane_id, prop_src_w, layer->src.right - layer->src.left);
        drmModeAtomicAddProperty(req, plane_id, prop_src_h, layer->src.bottom - layer->src.top);
        // 3. 目标窗口 dst_rect
        drmModeAtomicAddProperty(req, plane_id, prop_dst_x, layer->dst.left);
        drmModeAtomicAddProperty(req, plane_id, prop_dst_y, layer->dst.top);
        drmModeAtomicAddProperty(req, plane_id, prop_dst_w, layer->dst.right - layer->dst.left);
        drmModeAtomicAddProperty(req, plane_id, prop_dst_h, layer->dst.bottom - layer->dst.top);
        // 4. Z序、透明度、transform
        drmModeAtomicAddProperty(req, plane_id, prop_zpos, layer->z);
        drmModeAtomicAddProperty(req, plane_id, prop_alpha, layer->alpha * 255);
        drmModeAtomicAddProperty(req, plane_id, prop_rotation, layer->transform);
    }
    // 绑定CRTC和Connector,触发刷新
    drmModeAtomicAddProperty(req, crtc_id, prop_active, 1);
    drmModeAtomicAddProperty(req, crtc_id, prop_mode_id, disp->mode_id);
    // 发起Atomic提交,和第11篇的commit流程对接
    int ret = drmModeAtomicCommit(disp->drm_fd, req, DRM_MODE_ATOMIC_ALLOW_MODESET, NULL);
    if(ret < 0) {
        // atomic check失败,整帧丢弃,不会局部刷新,符合原子语义
        drmModeAtomicFree(req);
        return ret;
    }
    drmModeAtomicFree(req);
    return 0;
}

关键映射对照表

| HWC Layer参数 | DRM Atomic Property | 含义 | | --- | --- | --- | | z | zpos | 图层叠加顺序,数值越大越在上层 | | alpha | alpha | 图层全局透明度 | | src_rect | src_x/src_y/src_w/src_h | 在buffer里面裁剪哪一块 | | dst_rect | dst_x/dst_y/dst_w/dst_h | 在屏幕上摆放位置和大小 | | transform | rotation | 旋转、镜像 | | buffer_handle | FB_ID + DMA-BUF fd | 帧缓存 | | blendMode | blend | 预乘alpha混合 |

重要约束:

一个DEVICE图层,占用一个DRM Plane。 如果SOC DPU只有4个Overlay通道,超过4个DEVICE图层,多余的图层一定会被HWC标记为CLIENT,交给GPU合并。 这是几乎所有平台通用硬限制。

五、Fence同步:AcquireFence / ReleaseFence,HWC和DRM的同步屏障

很多花屏、随机闪屏,根源不是参数错,是fence同步时序错乱。

  • acquire_fence:获取栅栏。GPU/渲染端还在写buffer,fence没signal之前,DPU绝对不能读这个buffer。HWC下发到DRM的时候,会把这个fence传给DRM,DRM等待fence就绪才启动扫描。
  • release_fence:释放栅栏。DPU扫描完成、不再使用这个buffer之后,signal这个fence,通知SF/GPU:buffer可以回收复用。

Atomic commit内部会把fence一并传给DRM驱动,DRM在drm_fence框架下做等待。 典型bug:acquire fence丢失,DPU读到还没写完的buffer → 随机花屏。

六、典型异常场景、根因拆解

  1. 页面切换瞬间闪一下,图层一会有一会消失 根因:prepare阶段评估不稳定,同一图层,上一帧DEVICE,下一帧CLIENT。合成模式切换,GPU合成buffer和硬件overlay切换,中间帧时序断层。 排查:抓每帧layer的compositionType日志,看是否频繁跳变。
  2. 视频无法走Overlay,永远CLIENT合成 根因:
  • 视频buffer格式、压缩格式不在DPU支持列表
  • buffer内存对齐不满足DPU要求
  • 视频缩放比例超出scaler硬件范围 排查:看HWC日志里layer的format,对比drm支持的plane格式列表。
  1. Z序错乱,下层界面盖在状态栏上面

根因:

  • HWC把z值传给DRM zpos属性时顺序颠倒
  • 部分平台DPU zpos不是数值越大在上,硬件本身是反向排序(平台私有差异)
  • 组装Atomic state时plane添加顺序错误
  1. Atomic commit返回失败,画面不刷新

根因:

HWC组装state参数非法,在DRM的atomic check阶段被拦截(比如dst_rect超出屏幕、不支持的transform),整帧丢弃,不会局部生效。 排查:dmesg打开drm.debug,看atomic check报错日志。

  1. 多窗口打开多了,帧率下降、功耗变高

根因:Overlay通道耗尽,大量图层回退CLIENT,GPU负载暴涨。

七、完整调试清单(分层,HWC层 → DRM层 → 图形栈)

7.1 HWC HAL日志

开启HWC trace,打印每帧prepare/set的layer明细:

  • 每个layer:buffer fd、format、src/dst rect、z、alpha、compositionType、acquire/release fence 重点观察:相邻帧同一个layer的compositionType是否抖动。

7.2 DRM 状态dump

# 查看当前DRM所有crtc、plane、connector、property,看HWC下发的state是否生效
cat /sys/kernel/debug/dri/0/state
# 查看plane支持的格式、能力
cat /sys/kernel/debug/dri/0/plane*
# modetest查看硬件plane能力清单
modetest -M <你的drm驱动名>
# 打开drm debug,打印atomic check、commit详细日志
echo 0x1f > /sys/module/drm/parameters/debug

核对:HWC日志声明下发的图层,是否真实出现在dri state里面。 如果HWC打印set成功,但是dri state没有更新,大概率是atomic commit静默失败。

7.3 图形栈全链路日志对齐

抓取三类日志,按VSync时间戳对齐:

  • SurfaceFlinger log:SF的layer收集、VSync触发、GPU合成标记
  • HWC hal log:prepare、set、compositionType
  • DRM dmesg:atomic check、commit、vblank中断、fence等待

一个高效定位思路:先看HWC有没有把图层标记DEVICE;再看HWC有没有组装正确atomic req;再看DRM atomic是否校验通过。

八、小结

  1. HWC2运行在用户态HAL层,核心两个接口 prepare(预审协商)、set(提交画面);prepare只评估,不提交;set阶段才会组装DRM Atomic State。
  2. 合成模式分为DEVICE硬件合成、CLIENT GPU合成,项目中混合合成是常态,也是bug高发区。
  3. HWC Layer的Z序、alpha、裁剪、旋转、buffer,会一一映射到DRM Plane的property,每一个DEVICE图层占用一个Overlay Plane,受硬件通道上限约束。
  4. Acquire/Release fence是buffer同步核心,很多随机花屏是栅栏同步异常。
  5. HWC是Atomic DRM最主要的上层消费者,HWC的一帧,对应DRM一次Atomic Commit,要么全部生效,要么全部回滚,保证画面无撕裂、无半帧刷新。

理解HWC和DRM Atomic协同,就打通了Android上层图形栈到内核显示驱动的链路。