From dab7b23d3a2525869c80aba9e19b1277385b5645 Mon Sep 17 00:00:00 2001
From: Erik Faye-Lund <erik.faye-lund@collabora.com>
Date: Thu, 2 Jan 2025 15:31:25 +0100
Subject: [PATCH] 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>
---
 docs/drivers/panfrost.rst | 44 +++++++++++++++++++++------------------
 1 file changed, 24 insertions(+), 20 deletions(-)

diff --git a/docs/drivers/panfrost.rst b/docs/drivers/panfrost.rst
index e5fa53406ea..5df751d9fd4 100644
--- a/docs/drivers/panfrost.rst
+++ b/docs/drivers/panfrost.rst
@@ -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``.