OpenHarmony开源GPU库Mesa3D适配说明

本文档主要讲解在OpenHarmony中，Mesa3D的适配方法及原理说明。

环境说明：

OHOS版本: 适用3.2-Beta3及以上

内核版本: linux-5.10

硬件环境: Dayu200-rk3568

一、背景介绍
OpenHarmony对图形的渲染，支持CPU和GPU两种方式。为了支持流畅的用户体现，GPU适配是必不可少的。OpenHarmony使用GPU渲染，就必须依赖OpenGL接口。

OpenGL(Open Graphics Library) 开放图形库，是用于渲染2D、3D矢量图形的跨语言、跨平台的应用程序编程接口(仅定义了接口及规范，没有实现)。OpenGL的高效性(利用了图形加速硬件)依赖于显示设备厂家的硬件及实现。

OpenGL API实现的方式又分为闭源及开源两种方式。闭源实现一般由设备厂家完成，这种方式充分保证了它的高效性，但移植起来比较麻烦。今天我们要重点介绍的是另外一种开源实现的方式：mesa3D。

Mesa3D 图形库就是OpenGL API的一种开源实现。新版本还支持OpenCL、OpenGL ES等等。Mesa3D对上提供标准的OpenGL接口，对下使用Gallium框架，屏蔽驱动差异。在RK3568中，panfrost对ARM GPU提供了非常好的开源驱动支持。

二、适配方法
在RK3568 GPU 开源库mesa3D适配时，我们同时依赖了drm panfrost的实现。目前OpenHarmony 3.2-Release基线中，支持4.19及5.10两个Linux版本，而只有5.10才提供了对panfrost的支持。如果当前Linux版本不支持panfrost，那就需要升级内核版本，或者把panfrost移植到当前版本上。

2.1 适配框架说明
以下是我们这次适配的框架示意图:

通过上图我们可以看出，一个大致的UI显示流程如下：

JS创建window->调用skia完成接口封装->调用mesa3D的OpenGL接口完成渲染->返回EglSurface数据->送到Dislay HDI的GFX合成->调用KMS完成数据转换->LCD硬件完成显示

2.2 适配前提条件
从适配框架图可以看出，GPU适配，需要建立在Dislay HDI、DRM、LCD驱动完整的基础之上，否则Launcher没有启动，也不能确定适配是否完好。所以，在GPU适配之前，需要确保在CPU渲染的基础上，Launcher是能正常启动的。

CPU渲染修改方法： 设置graphic_standard_feature_ace_enable_gpu = false。包含在以下路径中:

foundation/graphic/standard/graphic_config.gni
productdefine/common/inherit/rich.json
productdefine/common/products/ohos-arm64.json

编译过程中，旧版本可能会报如下错误:

解决方案如下:

vendor/hihope/rk3568/config.json
"ace_engine_feature_enable_web = false"

使用CPU模式能正常进入桌面，代表系统启动正常。

2.3 Mesa3D适配
依赖库安装

sudo apt-get install -y meson cmake llvm ninja-build pkg-config 
python3 -m pip install meson==0.62.0
python -m pip install --upgrade pip
pip install mako atomic  markupsafe

合入patch

https://gitee.com/openharmony/third_party_mesa3d/pulls/13 //mesa3D相关 必须合入 https://gitee.com/zleoyu/device_soc_rockchip/commit/4467466a50adca43f26a77912cab710901f909e4 //合入产品配置 必须合入。