docs/panfrost: document vulkan support

We have some limited support for Vulkan these days. Let's document that.

Acked-by: Boris Brezillon <boris.brezillon@collabora.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/32836>
This commit is contained in:
Erik Faye-Lund
2025-01-02 15:31:25 +01:00
committed by Marge Bot
parent a5c3c452b8
commit dab7b23d3a

View File

@@ -6,25 +6,29 @@ GPUs based on the Midgard and Bifrost microarchitectures. It is **conformant**
on `Mali-G52 <https://www.khronos.org/conformance/adopters/conformant-products/opengles#submission_949>`_,
`Mali-G57 <https://www.khronos.org/conformance/adopters/conformant-products/opengles#submission_980>`_
and `Mali-G610 <https://www.khronos.org/conformance/adopters/conformant-products/opengles#submission_1053>`_,
but **non-conformant** on other GPUs. The following hardware is currently
supported:
but **non-conformant** on other GPUs.
+--------------------+---------------+-----------+--------+
| Models | Architecture | OpenGL ES | OpenGL |
+====================+===============+===========+========+
| T600, T620, T720 | Midgard (v4) | 2.0 | 2.1 |
+--------------------+---------------+-----------+--------+
| T760, T820, T830 | Midgard (v5) | 3.1 | 3.1 |
| T860, T880 | | | |
+--------------------+---------------+-----------+--------+
| G72 | Bifrost (v6) | 3.1 | 3.1 |
+--------------------+---------------+-----------+--------+
| G31, G51, G52, G76 | Bifrost (v7) | 3.1 | 3.1 |
+--------------------+---------------+-----------+--------+
| G57 | Valhall (v9) | 3.1 | 3.1 |
+--------------------+---------------+-----------+--------+
| G310, G610 | Valhall (v10) | 3.1 | 3.1 |
+--------------------+---------------+-----------+--------+
PanVK, the Vulkan implementation in the Panfrost driver stack, is currently
**non-conformant** on all GPUs.
The following hardware is currently supported:
+--------------------+---------------+-----------+--------+--------+
| Models | Architecture | OpenGL ES | OpenGL | Vulkan |
+====================+===============+===========+========+========+
| T600, T620, T720 | Midgard (v4) | 2.0 | 2.1 | |
+--------------------+---------------+-----------+--------+--------+
| T760, T820, T830 | Midgard (v5) | 3.1 | 3.1 | |
| T860, T880 | | | | |
+--------------------+---------------+-----------+--------+--------+
| G72 | Bifrost (v6) | 3.1 | 3.1 | 1.0 |
+--------------------+---------------+-----------+--------+--------+
| G31, G51, G52, G76 | Bifrost (v7) | 3.1 | 3.1 | 1.0 |
+--------------------+---------------+-----------+--------+--------+
| G57 | Valhall (v9) | 3.1 | 3.1 | |
+--------------------+---------------+-----------+--------+--------+
| G310, G610 | Valhall (v10) | 3.1 | 3.1 | 1.0 |
+--------------------+---------------+-----------+--------+--------+
Other Midgard and Bifrost chips (e.g. G71) are not yet supported.
@@ -32,7 +36,7 @@ Older Mali chips based on the Utgard architecture (Mali-400, Mali-450) are
supported in the :doc:`Lima <lima>` driver, not Panfrost. Lima is also
available in Mesa.
Other graphics APIs (Vulkan, OpenCL) are not supported at this time.
Other graphics APIs (OpenCL) are not supported at this time.
Building
--------
@@ -46,7 +50,7 @@ it's easy to add support, see the commit ``cff7de4bb597e9`` as an example.
LLVM is *not* required by Panfrost's compilers. LLVM support in Mesa can
safely be disabled for most OpenGL ES users with Panfrost.
Build like ``meson . build/ -Dvulkan-drivers=
Build like ``meson . build/ -Dvulkan-drivers=panfrost
-Dgallium-drivers=panfrost -Dllvm=disabled`` for a build directory
``build``.