Skip to content

docs(mali-gpu): add glxinfo/es2_info renderer verification steps #2017

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tangzz-radxa wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(mali-gpu): add glxinfo/es2_info renderer verification steps #2017

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/common/radxa-os/_mali-gpu.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 驱动未生效，当前为软件渲染，请检查上述步骤是否完整执行。
14 changes: 14 additions & 0 deletions i18n/en/docusaurus-plugin-content-docs/current/common/radxa-os/_mali-gpu.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Loading