summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorKarmjit Mahil <Karmjit.Mahil@imgtec.com>2023-06-23 10:38:16 +0100
committerMarge Bot <emma+marge@anholt.net>2023-07-11 09:44:29 +0000
commit9b72ece4ec8b05f5c897fe8f555729334370122d (patch)
tree8fab5c1f83a71b2b9962f4002fd26ec1234fcf12 /docs
parente88c0bb945c99e11ee944f27ebfc2403b157ea83 (diff)
docs: Add inital PowerVR driver documentation
Signed-off-by: Karmjit Mahil <Karmjit.Mahil@imgtec.com> Reviewed-by: Frank Binns <frank.binns@imgtec.com> Closes: https://gitlab.freedesktop.org/mesa/mesa/-/issues/8048 Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/23992>
Diffstat (limited to 'docs')
-rw-r--r--docs/drivers/powervr.rst46
-rw-r--r--docs/index.rst1
2 files changed, 47 insertions, 0 deletions
diff --git a/docs/drivers/powervr.rst b/docs/drivers/powervr.rst
new file mode 100644
index 00000000000..45c100bed78
--- /dev/null
+++ b/docs/drivers/powervr.rst
@@ -0,0 +1,46 @@
+PowerVR
+=======
+
+PowerVR is a Vulkan driver for Imagination Technologies PowerVR GPUs, starting
+with those based on the Rogue architecture.
+
+The driver is **not yet fully conformant** so it requires exporting
+``PVR_I_WANT_A_BROKEN_VULKAN_DRIVER=1`` to the environment before running any
+Vulkan content.
+
+The following hardware is currently in active development:
+
+========= =========== ============== ======= ==========
+Product Series B.V.N.C Vulkan Conformant
+========= =========== ============== ======= ==========
+GX6250 Series 6XT 4.40.2.51 1.0 No
+AXE-1-16M A-Series 33.15.11.3 1.0 No
+BXS-4-64 B-Series 36.53.104.796 1.0 No
+========= =========== ============== ======= ==========
+
+In some cases, a product name is shared across multiple BVNCs so to check for
+support make sure the BVNC matches the one listed. As the feature set and
+hardware issues can vary between BVNCs, additional driver changes might be
+necessary even for devices sharing the same product name.
+
+Hardware documentation can be found at: https://docs.imgtec.com/
+
+Note: GPUs prior to Series6 do not have the hardware capabilities required to
+support Vulkan and therefore cannot be supported by this driver.
+
+Chat
+----
+
+PowerVR developers and users hang out on IRC at ``#powervr`` on OFTC. Note
+that registering and authenticating with ``NickServ`` is required to prevent
+spam. `Join the chat. <https://webchat.oftc.net/?channels=powervr>`_
+
+Hardware glossary
+-----------------
+
+.. glossary:: :sorted:
+
+ BVNC
+ Set of four numbers used to uniquely identify each GPU (Series6 onwards).
+ This is used to determine the GPU feature set, along with any known
+ hardware issues.
diff --git a/docs/index.rst b/docs/index.rst
index 30b333d76bf..9841841f177 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -89,6 +89,7 @@ Linux, FreeBSD, and other operating systems.
drivers/lima
drivers/llvmpipe
drivers/panfrost
+ drivers/powervr
drivers/radv
drivers/svga3d
drivers/v3d