Module: Mesa Branch: main Commit: 9b72ece4ec8b05f5c897fe8f555729334370122d URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=9b72ece4ec8b05f5c897fe8f555729334370122d
Author: Karmjit Mahil <[email protected]> Date: Fri Jun 23 10:38:16 2023 +0100 docs: Add inital PowerVR driver documentation Signed-off-by: Karmjit Mahil <[email protected]> Reviewed-by: Frank Binns <[email protected]> Closes: https://gitlab.freedesktop.org/mesa/mesa/-/issues/8048 Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/23992> --- docs/drivers/powervr.rst | 46 ++++++++++++++++++++++++++++++++++++++++++++++ docs/index.rst | 1 + 2 files changed, 47 insertions(+) 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
