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>`_, 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>`_ `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>`_, 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 but **non-conformant** on other GPUs.
supported:
+--------------------+---------------+-----------+--------+ PanVK, the Vulkan implementation in the Panfrost driver stack, is currently
| Models | Architecture | OpenGL ES | OpenGL | **non-conformant** on all GPUs.
+====================+===============+===========+========+
| T600, T620, T720 | Midgard (v4) | 2.0 | 2.1 | The following hardware is currently supported:
+--------------------+---------------+-----------+--------+
| T760, T820, T830 | Midgard (v5) | 3.1 | 3.1 | +--------------------+---------------+-----------+--------+--------+
| T860, T880 | | | | | Models | Architecture | OpenGL ES | OpenGL | Vulkan |
+--------------------+---------------+-----------+--------+ +====================+===============+===========+========+========+
| G72 | Bifrost (v6) | 3.1 | 3.1 | | T600, T620, T720 | Midgard (v4) | 2.0 | 2.1 | |
+--------------------+---------------+-----------+--------+ +--------------------+---------------+-----------+--------+--------+
| G31, G51, G52, G76 | Bifrost (v7) | 3.1 | 3.1 | | T760, T820, T830 | Midgard (v5) | 3.1 | 3.1 | |
+--------------------+---------------+-----------+--------+ | T860, T880 | | | | |
| G57 | Valhall (v9) | 3.1 | 3.1 | +--------------------+---------------+-----------+--------+--------+
+--------------------+---------------+-----------+--------+ | G72 | Bifrost (v6) | 3.1 | 3.1 | 1.0 |
| G310, G610 | Valhall (v10) | 3.1 | 3.1 | +--------------------+---------------+-----------+--------+--------+
+--------------------+---------------+-----------+--------+ | 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. 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 supported in the :doc:`Lima <lima>` driver, not Panfrost. Lima is also
available in Mesa. 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 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 LLVM is *not* required by Panfrost's compilers. LLVM support in Mesa can
safely be disabled for most OpenGL ES users with Panfrost. 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 -Dgallium-drivers=panfrost -Dllvm=disabled`` for a build directory
``build``. ``build``.