平台: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 性能。
文中涉及的源码调整只保留在本地调试环境,不随文章发布;读者可以按文章思路在自己的代码树上复现。
本文基于真实设备调试记录整理,涉及的命令和日志均来自本机环境;不同产品/内核版本请按实际情况调整。