radxa-docs · CodeChenL · May 8, 2025
@@ -0,0 +1,29 @@
+Wayland 是 X11 窗口系统协议和架构的替代品，往往有着更良好的图形性能表现。但是由于 Rockchip Debian SDK 并没有提供相应的支持，因此 Radxa OS 默认也关闭了 GDM 的 Wayland 模式。如果您想使用 Wayland 运行图形软件/桌面，可以按照以下步骤进行操作：
+
+:::warning
+某些 Rockchip 提供的视频/图形软件栈未对 Wayland 进行适配，开启 Wayland 后可能会出现性能下降/图形错乱等意料之外的现象。
+:::
+
+1. 编辑 `/etc/gdm3/daemon.conf`，并将 `WaylandEnable` 取消注释后设置为 `true`：
+
+```bash
+sudo nano /etc/gdm3/daemon.conf
+```
+
+`/etc/gdm3/daemon.conf` 修改后应包含以下内容：
+
+```
+[daemon]
+# Uncomment the line below to force the login screen to use Xorg
+WaylandEnable=true
+```
+
+2. 重启系统以应用新配置：
+
+```bash
+sudo reboot
+```
+
+3. 重启后，即可在登陆时的右下角选择 Wayland 会话：
+
+![wayland_gdm.webp](/img/common/wayland/wayland_gdm.webp)
diff --git a/docs/compute-module/cm3/radxa-os/wayland.md b/docs/compute-module/cm3/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
diff --git a/docs/compute-module/cm3i/radxa-os/wayland.md b/docs/compute-module/cm3i/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
diff --git a/docs/compute-module/cm3j/radxa-os/wayland.md b/docs/compute-module/cm3j/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
diff --git a/docs/compute-module/cm5/radxa-os/wayland.md b/docs/compute-module/cm5/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
diff --git a/docs/compute-module/nx5/radxa-os/wayland.md b/docs/compute-module/nx5/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
diff --git a/docs/rock3/e25/radxa-os/wayland.md b/docs/rock3/e25/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
diff --git a/docs/rock3/rock3a/radxa-os/wayland.md b/docs/rock3/rock3a/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
diff --git a/docs/rock3/rock3b/radxa-os/wayland.md b/docs/rock3/rock3b/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
diff --git a/docs/rock3/rock3c/radxa-os/wayland.md b/docs/rock3/rock3c/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
diff --git a/docs/rock5/rock5itx/radxa-os/wayland.md b/docs/rock5/rock5itx/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# 开启 Wayland 会话
+
+<Wayland />
@@ -0,0 +1,29 @@
+Wayland is a replacement for the X11 window system protocol and architecture, Wayland is a replacement for the X11 window system protocol and architecture, and often has better graphics performance. However, since Rockchip Debian SDK does not provide corresponding support, Radxa OS also disables GDM's Wayland mode by default. If you want to use Wayland to run graphics software/desktop, you can follow the steps below:
+
+:::warning
+Some Rockchip video/graphic software stacks are not compatible with Wayland, enabling Wayland may result in unexpected phenomena such as performance degradation or graphical glitches.
+:::
+
+1. Edit `/etc/gdm3/daemon.conf`, and set `WaylandEnable` to `true` after uncommenting:
+
+```bash
+sudo nano /etc/gdm3/daemon.conf
+```
+
+`/etc/gdm3/daemon.conf` should contain the following content after modification:
+
+```
+[daemon]
+# Uncomment the line below to force the login screen to use Xorg
+WaylandEnable=true
+```
+
+2. Reboot system to apply new config：
+
+```bash
+sudo reboot
+```
+
+3. After restart, you can select the Wayland session in the lower right corner during login:
+
+![wayland_gdm.webp](/img/common/wayland/wayland_gdm.webp)
diff --git a/...n/docusaurus-plugin-content-docs/current/compute-module/cm3/radxa-os/wayland.md b/...n/docusaurus-plugin-content-docs/current/compute-module/cm3/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/.../docusaurus-plugin-content-docs/current/compute-module/cm3i/radxa-os/wayland.md b/.../docusaurus-plugin-content-docs/current/compute-module/cm3i/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/.../docusaurus-plugin-content-docs/current/compute-module/cm3j/radxa-os/wayland.md b/.../docusaurus-plugin-content-docs/current/compute-module/cm3j/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/...n/docusaurus-plugin-content-docs/current/compute-module/cm5/radxa-os/wayland.md b/...n/docusaurus-plugin-content-docs/current/compute-module/cm5/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/...n/docusaurus-plugin-content-docs/current/compute-module/nx5/radxa-os/wayland.md b/...n/docusaurus-plugin-content-docs/current/compute-module/nx5/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock3/e25/radxa-os/wayland.md b/i18n/en/docusaurus-plugin-content-docs/current/rock3/e25/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3a/radxa-os/wayland.md b/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3a/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3b/radxa-os/wayland.md b/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3b/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3c/radxa-os/wayland.md b/i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3c/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5itx/radxa-os/wayland.md b/i18n/en/docusaurus-plugin-content-docs/current/rock5/rock5itx/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/zero/zero3/radxa-os/wayland.md b/i18n/en/docusaurus-plugin-content-docs/current/zero/zero3/radxa-os/wayland.md
@@ -0,0 +1,5 @@
+import Wayland from "../../../common/radxa-os/\_wayland.mdx";
+
+# Enabling Wayland Session
+
+<Wayland />