两个组件构成一条链路:鸿蒙侧一个自研的最小 Wayland compositor(HAP,把每个 Wayland 窗口映射为独立鸿蒙窗口),openEuler 侧一组 wayland/GL 转发脚本与一个协议感知中继, 让容器里没有 GPU、没有显示设备的图形应用把画面与输入搬到鸿蒙宿主上执行。
┌─ openEuler 容器/VM ─────────────────────────────┐ ┌─ HarmonyOS 设备 ──────────────────────────┐
│ 应用 (GL) │ │ │
│ ├─ 显示: waypipe server ──TCP:5902──────────────┼─────▶│ WayDisplay HAP: TCP 桥 → waypipe-c → 合成器│
│ │ (每应用一条通道) │ │ → 每个 Wayland toplevel = 一个鸿蒙子窗口 │
│ └─ 渲染: virpipe ──unix──┐ │ │ │
│ → relay A ─────────┼──TCP:5903────────────┼─────▶│ relay B → vtest 服务端 → EGL/GLES │
│ │ │ │ → Maleoon GPU │
└───────────────────────────┴──────────────────────┘ └──────────────────────────────────────────┘
- 中继(
guest/vtest_relay.c,A/B 两端同一份源码):把服务端给的资源 fd 换成客户侧 memfd, 并做双向内容镜像(Mesa 协议 ≥2 把上传数据直接写共享内存、只发通知,所以 A→B 方向必须 先镜像后转发,否则几何全丢 —— 详见 docs §24)。支持多连接与 SIGPIPE 隔离。 - WayDisplay HAP(
WayDisplay/):最小 compositor(wl_compositor/wl_shm/wl_seat/wl_output/ xdg_wm_base + linux-dmabuf)+ 进程内 waypipe-c 客户端 + TCP 桥 + 多窗口宿主(ArkTS)。
| 路径 | 内容 |
|---|---|
WayDisplay/ |
鸿蒙侧 HAP 工程(自研 compositor / NAPI / ArkTS 多窗口宿主) |
guest/ |
openEuler 侧:中继源码、会话脚本、HTTP 投递根(glsrc/)、诊断脚本、内核模块配方 |
device/ |
鸿蒙侧运行时:vtest 服务端(源码 + 预编译)、自建 epoxy/virglrenderer、运维脚本 |
tools/ |
宿主侧小工具(vm_exec.py / loh_exec.py)与中继回环冒烟测试(relay_smoke.py) |
docs/ |
主技术文档(§0–§30 全过程与结论)与平台需求说明 |
evidence/ results/ |
真机截图与跑分/协议 trace |
- 鸿蒙设备:HarmonyOS / OpenHarmony,API 26,已开 hdc 调试;DevEco command-line-tools(
devecocli/hdc)。 - openEuler 侧:
gcc、waypipe、socat、Mesa(virpipe驱动),可选glmark2。 nix 环境下的路径探测见guest/env.sh(也可用发行版包,覆盖MESA_DIR等变量即可)。
# 构建并安装 HAP(签名配置需本机生成,见 WayDisplay/README.md)
cd WayDisplay && devecocli signature generate && devecocli build && devecocli run --device <serial>
# 部署本仓库到设备后,一键启动全链路
bash device/scripts/bootup.sh # 服务端 + 中继 B + watchdog + HAP + 客户侧 socat 桥
bash device/scripts/bootup.sh --venus # 附带 venus(:5904) 链路# 会话(脚本会自动从设备 HTTP 投递根拉取 guest/vtest_relay.c 现场编译中继 A)
sh guest/session.sh gldemo # 或 glmark2 / 任意 wayland 应用
sh guest/session2.sh glmark2 # 追加会话(多应用并行)一键(由设备侧投递执行):
bash device/scripts/bootup.sh --app gldemodocs/wayland-mesa-forward-plan.md—— 主技术文档:实测现状、架构、每一步踩坑与结论、 启动脚本与复现流程(§25)、多窗口映射(§26)、中继多连接(§27)、窗口状态双向传递(§28)、 跑分(§29)、Vulkan/venus 研究(§30)。docs/平台需求说明-virtio-gpu.md—— 向平台方提出的 virtio-gpu 挂载需求(原生 GPU 直通正路)。
| 项 | 状态 |
|---|---|
| GL 全链路(VM 应用 → virpipe → 中继 → 鸿蒙 GPU → 独立窗口) | ✅ 真机验证,窗口实时更新(glmark2 上屏 Score 50 / 离屏 281) |
| 多窗口映射(每 Wayland toplevel = 独立鸿蒙窗口,移动/缩放/输入/关闭) | ✅ 真机验证 |
| 多 GL 应用并行(中继多连接) | ✅ 真机验证 |
| venus/Vulkan | 🚧 握手/资源/ring 全链路打通;OH 侧 virglrenderer 1.3.0 解析不了 Mesa 26.2.4 的 venus 命令(-EINVAL),待版本对齐 |
| 上屏成本 > 离屏(CPU 上屏 + waypipe 帧差分) | 已知;优化方向见 docs §29 |
| virtio-gpu 缺失(平台侧) | 原生 GPU 直通正路受阻,见 docs/平台需求说明-virtio-gpu.md |
- 中继:
tools/relay_smoke.py在 openEuler 24.03 容器内对guest/vtest_relay.c跑通 7/7 (分帧、fd 替换、上传镜像 —— 后者是 docs §24 的核心修复)。见tools/README.md。 - 真机链路结论:见
docs/wayland-mesa-forward-plan.md§18/§24/§28(各节均附证据与截图索引)。 - 未复验项:HAP 构建需要设备上的 DevEco/OHOS SDK,
device/vtsrv/的服务端源码同理 (shims/面向 musl/OHOS 头,不能在发行版 glibc 头下编译)。
内部使用授权;wayland / waypipe / libffi / virglrenderer / libepoxy / Mesa 等遵循各自原始许可证
(WayDisplay/entry/src/main/cpp/ 下嵌入的 wayland 客户端源码为 MIT)。