前言
前面我们吃透了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本身没有硬件合成能力,它只有两条输出路径:
- 交给GPU(GL/Vulkan)做软件合成(Client合成)
- 交给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最核心两个对象:
- HWC2_Display:代表一个显示设备(主屏/副屏),一个Display对应DRM里一个CRTC+Connector
- 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硬件规格内。 完整时序:
- VSync信号到达SF,SF开始收集本帧所有Layer,按Z序排序
- SF调用 prepare(display, numLayers, layers),把全部图层下发给HWC HAL
- HWC驱动内部逻辑:
- 查询DRM,获取当前可用Plane数量、支持格式、scaler能力、带宽水位
- 逐个遍历Layer,做硬件能力校验
- 校验通过:标记 compositionType = DEVICE
- 校验失败:标记为 CLIENT
- HWC返回给SF,告诉SF:哪些图层我硬件能扛
- SF拿到标记结果,这一批DEVICE图层不进GPU,直接保留独立buffer
- SF调用 set(display, numLayers, layers),下发最终图层集合
- HWC驱动在set阶段:把所有DEVICE图层,组装成一个DRM Atomic State
- 调用libdrm drmModeAtomicCommit,进入Atomic流程:DRM先check,全部校验通过,一次性提交给DPU
- DPU多个Overlay通道并行读取各个图层的DMA-BUF,硬件做alpha混合、叠加、缩放,输出到Panel
- 帧渲染完成,VBlank中断上来,HWC回填release fence,通知SF:buffer已经用完,可以回收
3.2 Client模式(GPU合成,兜底)
触发条件:
图层超出硬件能力:不支持的YUV格式、压缩格式、超大缩放、overlay通道耗尽、特殊混合模式。
时序:
- 同样prepare协商,HWC把无法硬件处理的Layer标记为 CLIENT
- SF收到CLIENT标记后,把所有CLIENT图层打包,交给GPU(GL/Vulkan)渲染合并
- GPU输出一张合并后的单一Buffer,生成一个新Layer
- SF把这个合并后的新Layer,标记为DEVICE,再次交给HWC
- HWC只需要把这一个图层下发DRM Primary Plane,走Atomic提交
- 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 → 随机花屏。
六、典型异常场景、根因拆解
- 页面切换瞬间闪一下,图层一会有一会消失 根因:prepare阶段评估不稳定,同一图层,上一帧DEVICE,下一帧CLIENT。合成模式切换,GPU合成buffer和硬件overlay切换,中间帧时序断层。 排查:抓每帧layer的compositionType日志,看是否频繁跳变。
- 视频无法走Overlay,永远CLIENT合成 根因:
- 视频buffer格式、压缩格式不在DPU支持列表
- buffer内存对齐不满足DPU要求
- 视频缩放比例超出scaler硬件范围 排查:看HWC日志里layer的format,对比drm支持的plane格式列表。
- Z序错乱,下层界面盖在状态栏上面
根因:
- HWC把z值传给DRM zpos属性时顺序颠倒
- 部分平台DPU zpos不是数值越大在上,硬件本身是反向排序(平台私有差异)
- 组装Atomic state时plane添加顺序错误
- Atomic commit返回失败,画面不刷新
根因:
HWC组装state参数非法,在DRM的atomic check阶段被拦截(比如dst_rect超出屏幕、不支持的transform),整帧丢弃,不会局部生效。 排查:dmesg打开drm.debug,看atomic check报错日志。
- 多窗口打开多了,帧率下降、功耗变高
根因: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是否校验通过。
八、小结
- HWC2运行在用户态HAL层,核心两个接口 prepare(预审协商)、set(提交画面);prepare只评估,不提交;set阶段才会组装DRM Atomic State。
- 合成模式分为DEVICE硬件合成、CLIENT GPU合成,项目中混合合成是常态,也是bug高发区。
- HWC Layer的Z序、alpha、裁剪、旋转、buffer,会一一映射到DRM Plane的property,每一个DEVICE图层占用一个Overlay Plane,受硬件通道上限约束。
- Acquire/Release fence是buffer同步核心,很多随机花屏是栅栏同步异常。
- HWC是Atomic DRM最主要的上层消费者,HWC的一帧,对应DRM一次Atomic Commit,要么全部生效,要么全部回滚,保证画面无撕裂、无半帧刷新。
理解HWC和DRM Atomic协同,就打通了Android上层图形栈到内核显示驱动的链路。