From fa32811512fca220aa4484440dee93550377689c Mon Sep 17 00:00:00 2001
From: Tang ZZ <tom@radxa.com>
Date: Sat, 15 Aug 2026 19:34:41 +0800
Subject: [PATCH] docs(mali-gpu): add glxinfo/es2_info renderer verification
 steps

Add a 'Verify the OpenGL renderer' section to the Mali GPU driver
switching guide (bilingual zh/en), showing how to confirm the active
renderer via glxinfo/es2_info, and explaining that llvmpipe means
software rendering (driver not active) while es2_info shows the Mali
GPU name when the Mali driver is in use.

Addresses radxa-docs/docs#520
---
 docs/common/radxa-os/_mali-gpu.mdx                 | 14 ++++++++++++++
 .../current/common/radxa-os/_mali-gpu.mdx          | 14 ++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/docs/common/radxa-os/_mali-gpu.mdx b/docs/common/radxa-os/_mali-gpu.mdx
index 3a225b10e..5ac8dda4d 100644
--- a/docs/common/radxa-os/_mali-gpu.mdx
+++ b/docs/common/radxa-os/_mali-gpu.mdx
@@ -208,3 +208,17 @@ sudo apt list libmali-* --installed
 Listing... Done
 libmali-bifrost-g52-g13p0-x11-wayland-gbm/rk3566-bookworm-test,now 1.9-1 arm64 [installed]
 ```
+
+### 验证 OpenGL 渲染器
+
+运行以下命令，查看当前生效的 OpenGL / OpenGL ES 渲染器：
+
+```bash
+glxinfo | grep "OpenGL renderer"
+es2_info | grep "OpenGL ES renderer"
+```
+
+- 使用 Mali 驱动时，`es2_info` 应显示对应的 Mali GPU 名称，例如 `Mali-G610`（RK3588 系列）或 `Mali-G52`（RK356X/RK3576 系列）。
+- 由于 Mali 驱动不支持桌面 OpenGL（见上文特性表），`glxinfo` 显示 `llvmpipe` 属于正常现象，请以 `es2_info` 的输出为准。
+- 使用 Panfrost/Panthor 驱动时，`glxinfo` 与 `es2_info` 应显示 `Panfrost` 或 `Panthor`。
+- 如果 `es2_info` 显示 `llvmpipe`，说明 GPU 驱动未生效，当前为软件渲染，请检查上述步骤是否完整执行。
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_mali-gpu.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_mali-gpu.mdx
index 2c5eefd3b..d6590d7eb 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_mali-gpu.mdx
+++ b/i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_mali-gpu.mdx
@@ -210,3 +210,17 @@ sudo apt list libmali-* --installed
 Listing... Done
 libmali-bifrost-g52-g13p0-x11-wayland-gbm/rk3566-bookworm-test,now 1.9-1 arm64 [installed]
 ```
+
+### Verify the OpenGL renderer
+
+Run the following commands to check the currently active OpenGL / OpenGL ES renderer:
+
+```bash
+glxinfo | grep "OpenGL renderer"
+es2_info | grep "OpenGL ES renderer"
+```
+
+- When using the Mali driver, `es2_info` should show the corresponding Mali GPU name, for example `Mali-G610` (RK3588 series) or `Mali-G52` (RK356X/RK3576 series).
+- Since the Mali driver does not support desktop OpenGL (see the feature table above), it is normal for `glxinfo` to show `llvmpipe`; rely on the `es2_info` output instead.
+- When using the Panfrost/Panthor driver, both `glxinfo` and `es2_info` should show `Panfrost` or `Panthor`.
+- If `es2_info` shows `llvmpipe`, the GPU driver is not active and software rendering is in use; check whether all the steps above have been completed.