OpenHarmony UIS7885 图形从mali_kbase+libmali切换为panfrost+Mesa 22.2.4

平台:Unisoc UIS7885(UMS9620)/ Mali-G57 r0p1

**
系统:OpenHarmony Linux 6.6.101 master 分支
屏幕:1080×2400,60Hz
目标:把闭源 mali_kbase + libmali 用户态,切换为内核 panfrost + 用户态 Mesa 22.2.4
说明:文中涉及的源码调整只保留在本地调试环境,不随文章发布。**

0. 先说结论

这次调试最值得先写进文章里的,不是 Mesa,也不是 panfrost,而是一个很多人会忽略的地方:

图形驱动调试时,先改 init 的 critical 配置,保证图形服务崩溃只重启服务,不触发整机 reboot,并且 hdc 一直活着。

图形驱动 bring-up 阶段,渲染服务崩溃是常态。如果 render_service / foundation 还是 critical=1,init 在服务反复崩溃后会直接 ExecReboot("panic")。表现就是:

• 屏幕黑一下,整机重启;

• hdc 掉线,日志还没来得及抓;

• 误以为是“内核 panic”,其实是 init 按 critical 策略主动重启。

所以我们先从 init 的 critical 配置讲起,再讲后面的 Mesa 和帧率。

1. 先保命:三个 cfg 的 critical 到底怎么改

1.1 critical 数组的语义

OpenHarmony init 解析服务配置的代码在:

base/startup/init/services/init/init_service_manager.c

核心函数是 GetCritical(),critical 数组是三个元素:

“critical” : [isCritical, crashCount, crashTime]

字段 含义
isCritical 1
crashCount 在 crashTime 秒内允许的崩溃次数
crashTime 统计窗口,单位秒

关键代码:

criticalSize = cJSON_GetArraySize(arrItem);

…

int value = (int)cJSON_GetNumberValue(crashCountItem);

INIT_ERROR_CHECK(value > 0, return SERVICE_FAILURE, “… crash count invalid”);

curServ->crashCount = value;

value = (int)cJSON_GetNumberValue(crashTimeItem);

INIT_ERROR_CHECK(value > 0, return SERVICE_FAILURE, “… crash time invalid”);

curServ->crashTime = value;

if (attrValue == 1) {

curServ->attribute |= flag;

}

服务崩溃后的处理在 init_common_service.c:

if (service->attribute & SERVICE_ATTR_CRITICAL) {

if (!CalculateCrashTime(service, service->crashTime, service->crashCount)) {

    INIT_LOGE("ServiceReap error critical service crashed %s %d", ...);

    ExecReboot("panic");

}

} else if (…) {

// 非 critical:延迟后重启服务,不 reboot

ServiceReStartTimer(service, service->crashTime \* SEC_TO_MSEC);

}

所以:

• critical=1:崩溃次数超过阈值,整机重启;

• critical=0:只做服务重启,不会 reboot;

• crashCount / crashTime 必须 > 0,写 [0,0,240] 不是“永不重启”,而是配置解析失败,整条服务定义可能被 init 丢弃。

这是最容易踩的坑:把 crashCount 写成 0,服务直接起不来,hdc 和 UI 一起没。

1.2 foundation.cfg:把 foundation 改为非 critical

文件:foundation/.../etc/profile/foundation.cfg(安装后在 /system/etc/init 等路径)

- “critical” : [1, 4, 240],

+ “critical” : [0, 1, 240],

含义:

• 原来是 critical 服务:4 次崩溃 / 240 秒 → reboot;

• 改成非 critical:foundation 崩溃时 init 不会重启整机;

• crashCount=1 是合法值,保证配置能被解析;

• crashTime=240 保留原统计窗口。

foundation 是系统服务框架(sa_main)的入口,图形栈、窗口、很多系统服务都挂在它下面。Mesa bring-up 时 foundation 崩溃非常常见,所以这个必须优先改。

1.3 graphic.cfg:把 render_service 改为非 critical

文件:foundation/graphic/graphic_2d/graphic.cfg

- “critical” : [1, 5, 60],

+ “critical” : [0, 1, 60],

原来 render_service 是 5 次崩溃 / 60 秒 → reboot。
改后 render_service 崩溃只会按 init 策略重启,不会把整机带走。

Mesa 调试期间,render_service 是最容易炸的进程:EGL 初始化失败、panfrost 提交异常、buffer/fence 处理错误,都可能 SIGSEGV。这个配置是“保命三件套”里最关键的。

1.4 appspawn.cfg:把 appspawn 改为非 critical

文件:base/startup/appspawn/etc/appspawn.cfg

- “critical” : [1, 4, 240],

+ “critical” : [0, 1, 240],

appspawn 是应用孵化器。图形栈异常时应用可能批量崩溃,appspawn 如果是 critical,4 次/240 秒就会 reboot。
改成非 critical,保证调试时“应用崩了但机器还在”。

1.5 init.uis7885.cfg:render node 权限与路径

文件:device/board/revoview/wukong100/cfg/init.uis7885.cfg

- “chmod 666 /dev/dri/renderD129”,

- “chown system graphics /dev/dri/renderD129”,

+ “chmod 666 /dev/dri/renderD128”,

+ “chown system graphics /dev/dri/renderD128”,

panfrost 注册的是 renderD128,而 UIS7885 原来 Mali 闭源栈用的是 renderD129。
这个不改,render_service 打开 render node 会失败,表现是 EGL 初始化失败、黑屏或崩溃。

2. 保证 hdc 一直可用

cfg 改完只是第一步,调试时还要保证“图形崩了,hdc 还在”。

2.1 hdcd 本身不要是 critical

developtools/hdc/src/daemon/etc/hdcd.root.cfg 里 hdcd 服务没有写 critical,默认就是非 critical。
这是好事:render_service / foundation 崩了,hdcd 一般不会跟着 reboot。

2.2 USB gadget 配置

device/board/revoview/wukong100/cfg/init.uis7885.usb.cfg 里负责:

• 创建 /dev/usb-ffs/hdc;

• 挂载 functionfs;

• 设置 sys.usb.config;

• 启动 hdcd。

调试前确认:

hdc list targets

hdc shell param get init.svc.hdcd

hdc shell param get sys.usb.config

hdc shell ps -ef | grep hdcd

正常应看到:

init.svc.hdcd=running

sys.usb.config=hdc

hdcd … /system/bin/hdcd

2.3 图形崩溃后的自救命令

即使 foundation / render_service 崩了,只要 hdcd 在,就能:

# 看进程

hdc shell ps -ef | grep -E “foundation|render_service”

# 拉崩溃日志

hdc shell ls -lt /data/log/faultlog/faultlogger | head

hdc file recv /data/log/faultlog/faultlogger/ ./

# 重启服务(不重启整机)

hdc shell service_control start foundation

hdc shell service_control start render_service

# 看 hilog

hdc shell hilog -x | grep -E “RenderService|EGL|panfrost|hdi”

如果 USB hdc 真的掉了,再考虑:

hdc kill

hdc start

或者用设备网络 hdc(如果产品打开了 tcp 模式):

hdc tconn :8710

经验:图形 bring-up 阶段,hdc 是生命线。cfg critical 改好、hdcd 保活,比多改十个渲染参数都重要。

注意:cfg 只能避免“服务崩溃触发 init reboot”,不能兜底内核 panic 或 init 自身崩溃; 内核/early boot 阶段仍然建议接串口,hdc 只能覆盖用户态服务崩溃这一类问题。

3. 环境与整体切换方案

3.1 内核:panfrost 只做 render-only DRM

UIS7885 的显示控制器走 sprd DRM(card0),GPU 是 Mali-G57。
如果 panfrost 和显示驱动抢 card0,会出现 probe 顺序、primary minor、显示节点冲突。

内核侧主要做了两件事:

1. panfrost 作为 render-only DRM,不分配 primary(card) minor,只保留 render node;

2. 增加 Unisoc 7885 的 GPU 电源/时钟/DVFS 适配 panfrost_sprd.c。

结果:

/dev/dri/card0 → sprd 显示控制器

/dev/dri/renderD128 → panfrost GPU

3.2 用户态:Mesa 22.2.4 + panfrost

mesa_lib64/ 放 5 个文件:

libEGL.so.1.0.0

libGLESv1_CM.so.1.1.0

libGLESv2.so.2.0.0

libglapi.so.0.0.0

panfrost_dri.so

安装到 /vendor/lib64/chipsetsdk,并生成:

libEGL_impl.so → libEGL.so.1.0.0

libGLESv1_impl.so → libGLESv1_CM.so.1.1.0

libGLESv2_impl.so → libGLESv2.so.2.0.0

libGLESv3_impl.so → libGLESv2.so.2.0.0

libglapi.so.0 → libglapi.so.0.0.0

同时 GPU 的 BUILD.gn 不再安装 libmali 的 *_impl.so,避免和 Mesa 符号链接打架。

3.3 GpuApitype=0:不要走 Vulkan

vendor/revoview/wukong100/etc/param/phone.para:

persist.sys.graphic.GpuApitype = 0

Mesa 22.2.4 这套只编了 OpenGL/GLES,没有 Vulkan 驱动。如果 GpuApitype=1,render_service 会走 Vulkan 路径,直接崩。

验证:

param get persist.sys.graphic.GpuApitype

# 0

4. 帧率问题:表面是 GetFramebuffer,根因在 display HAL

4.1 现象

切换 Mesa 后,UI 能起来,但操作明显卡:

• 滑动设置页面,画面一秒跳一下;

• hitrace 里 RenderFrame 每 3 帧后固定空 1.002 秒;

• ProcessComposerFrame / Repaint 每次 1.001 秒。

4.2 定位

hitrace 显示:

HdiOutput::PrepareCompleteIfNeed 1.001s

PrepareCompleteIfNeed() 里:

if (needFlush) {

return FlushScreen(compClientLayers);   // -> GetFramebuffer()

}

GetFramebuffer() 里有:

bufferCond_.wait_for(lock, 1000ms, …);

所以表面看是 GetFramebuffer 等 1000ms。
但不应该直接改这个 1000ms:它只是结果,不是原因。

4.3 根因:needFlushFb 被无条件置为 true

display HAL 在:

device/soc/unisoc/p7885/hardware/display/src/display_device/core/hdi_display.cpp

int32_t HdiDisplay::PrepareDisplayLayers(bool *needFlushFb)

{

...

mComposer->Prepare(layers, \*mClientLayer);

...

\*needFlushFb = true;   // 旧代码:无条件 true

return DISPLAY_SUCCESS;

}

即使 ScreenNode 是 device composition,也会告诉 RS “需要 flush framebuffer”。

而 panfrost + 当前显示路径下,没有 producer 往 HdiFramebufferSurface 的队列里补 buffer,availableBuffers_ 一直是空的,GetFramebuffer() 只能等满 1000ms。

4.4 修复:只在实际 client composition 时 flush

修复方式:

// Only request a client framebuffer flush when this prepare actually

// selected GPU/client composition for the client target.

*needFlushFb = (mClientLayer->GetAcceleratorType() != ACCELERATOR_NON);

mClientLayer 的加速器类型:

• ACCELERATOR_NON:没有 client target,全部 device composition;

• ACCELERATOR_DPU:需要 client target 输出给 DPU;

• ACCELERATOR_GSP/GPU:需要 GPU/GSP 合成。

只有非 NON 时才 flush,GetFramebuffer() 的 1000ms 代码一行没改。

4.5 其他配套调整

• Mesa OHOS buffer usage: Mesa OHOS EGL 在 dequeue 前把 ANativeWindow usage 置为:

text CPU_READ | CPU_WRITE | MEM_DMA | HW_RENDER | HW_TEXTURE | HW_COMPOSER = 0x70B

修复前 ScreenNode usage 是 0x49,buffer 没有 GPU/显示标志,DPU 直出受限。

• display HAL commit: display HAL 普通帧去掉 DRM_MODE_ATOMIC_ALLOW_MODESET;
IN_FENCE_FD 为 -1 时显式清 fence,避免沿用旧 fence。

• Mesa EGL KHR 符号导出: Mesa 22 默认把 eglCreateImageKHR / eglCreateSyncKHR / eglDestroyImageKHR / eglDestroySyncKHR / eglDupNativeFenceFDANDROID 定义成 static,只通过 eglGetProcAddress 暴露。
但 OHOS 的 librender_service_base / libegl_image / libpost_proc_gl 需要这些动态符号,否则运行期报:

text eglCreateImageKHR: symbol not found

处理方式是把它们改成全局导出,并显式 visibility("default")。

5. 结果:从 1fps 到接近满 60

修复后,用 10_display_fps_analysis_skill 实测(Settings 长滑动):

frames=384 dur=7.14s

fps_window=53.8

fps_active=59.79

p50=16.64ms

p95=16.69ms

jank>20ms=1.6%

vsync_mult={1:377, 2:2, …}

GSP0=0.0/s

DISPC=120.3/s

也就是说:

• 活跃滑动期 59.79fps,基本满帧;

• 窗口平均 53.8fps(包含启动/首帧空档);

• p50 16.64ms,正好是 60Hz 一帧;

• jank 只有 1.6%。

hitrace 里 Repaint 从 1.001 秒降到 p50 2ms,PrepareCompleteIfNeed 不再出现 1 秒等待。

对比:

指标 修复前 修复后
UI 帧率 约 2.7fps 活跃期 59.79fps
Repaint 1.001s p50 2ms
1 秒空档 固定出现 消失
GetFramebuffer 未改(1000ms) 未改(1000ms)

6. 关于“格式转换 CPU 参与”

调试时用 hiperf 抓过 render_service,发现过很高的 memcpy:

SkImage_GaneshBase::onReadPixels → readPixels → memcpy 49.5%

_mesa_ReadnPixelsARB → st_ReadPixels → memcpy 97.6%

RSSurfaceCaptureTaskParallel::Run

这是 surface capture / 录屏/截图 路径:GPU 读回像素,再 CPU memcpy。
它确实会让 CPU 大量参与格式转换,但它不是正常 UI 合成路径,而是采屏工具的开销。

也就是说:

• 正常滑动时,不应每帧走 glReadPixels;

• 如果用 liveview / 录屏工具测帧率,工具本身会拖慢 UI;

• 测 FPS 以 skill 10 的 composer 时间戳 + hitrace 为准;

• 录屏只用于看“画面是否正常”,不要用它判断真实帧率。

7. 图形是否正常

修复后截图:

• 文字清晰;

• 图标、圆角、阴影正常;

• 无花屏、无颜色错乱、无缺块。

8. 调试命令速查

# 亮屏

hdc shell power-shell wakeup

hdc shell power-shell display -s 100

# 检查 GPU / render node

hdc shell ls -l /dev/dri

hdc shell cat /sys/class/drm/renderD128/device/uevent

# 检查 GpuApitype

hdc shell param get persist.sys.graphic.GpuApitype

# 检查 hdc

hdc list targets

hdc shell param get init.svc.hdcd

# 抓 hitrace

hdc shell ‘hitrace -t 8 -b 32768 -o /data/local/tmp/trace graphic’

hdc file recv /data/local/tmp/trace ./

# skill 10 测帧率

hdc shell ‘sh /data/local/tmp/measure_swipe.sh 540 1900 540 700 6 /data/local/tmp/fps’

9. 踩坑清单

现象 原因 处理
改完 cfg 服务直接不启动 critical 数组 crashCount=0,init 解析失败
图形崩一下整机重启 foundation/render_service 还是 critical=1 改 [0,1,...] 非 critical
hdc 跟着没了 服务 critical reboot / hdcd USB 配置问题 先保 hdcd,再查 sys.usb.config
EGL 初始化失败 renderD129 而不是 renderD128
render_service 起不来 GpuApitype=1 走 Vulkan,但 Mesa 没 Vulkan
1 秒一帧 display HAL 无条件 needFlushFb=true 按 mClientLayer 加速器类型按需 flush
libEGL 报 KHR 符号找不到 Mesa 把 KHR 入口定义成 static 导出 KHR 符号
录屏时帧率很低 liveview 采屏走 readPixels + memcpy 用 skill 10/hitrace 测真实帧率

10. 结语

这次 UIS7885 + Linux 6.6 master 的 Mesa/Panfrost 切换,核心经验可以压缩成三句话:

1. 先改 cfg critical,保住 hdc 和整机:图形崩溃只重启服务,不 reboot;

2. 不要改 GetFramebuffer 的 1000ms:它只是症状,根因是 display HAL 无条件 needFlushFb=true;

3. 格式转换的 CPU 开销要看来源:正常合成路径不应该每帧 glReadPixels,采屏工具的 memcpy 不能当成 UI 性能。

文中涉及的源码调整只保留在本地调试环境,不随文章发布;读者可以按文章思路在自己的代码树上复现。

本文基于真实设备调试记录整理,涉及的命令和日志均来自本机环境;不同产品/内核版本请按实际情况调整。

2 个赞