Skip to content
luyanaaPublic

About

lohg: Wayland compositor + GL ES for OpenEuler container under OpenHarmony

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WayDisplay — 从 openEuler 容器向 HarmonyOS 转发 Wayland/Mesa/Vulkan

两个组件构成一条链路:鸿蒙侧一个自研的最小 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

快速开始

0. 前置

  • 鸿蒙设备:HarmonyOS / OpenHarmony,API 26,已开 hdc 调试;DevEco command-line-tools(devecocli/hdc)。
  • openEuler 侧:gcc、waypipe、socat、Mesa(virpipe 驱动),可选 glmark2。 nix 环境下的路径探测见 guest/env.sh(也可用发行版包,覆盖 MESA_DIR 等变量即可)。

1. 鸿蒙侧

# 构建并安装 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) 链路

2. openEuler 侧

# 会话(脚本会自动从设备 HTTP 投递根拉取 guest/vtest_relay.c 现场编译中继 A)
sh guest/session.sh gldemo        # 或 glmark2 / 任意 wayland 应用
sh guest/session2.sh glmark2      # 追加会话(多应用并行)

一键(由设备侧投递执行):

bash device/scripts/bootup.sh --app gldemo

文档

  • docs/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 头下编译)。

License

内部使用授权;wayland / waypipe / libffi / virglrenderer / libepoxy / Mesa 等遵循各自原始许可证 (WayDisplay/entry/src/main/cpp/ 下嵌入的 wayland 客户端源码为 MIT)。

About

lohg: Wayland compositor + GL ES for OpenEuler container under OpenHarmony

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages