fdo-mirrors/mesa
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/mesa/mesa.git synced 2026-05-05 13:58:04 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

docs/pvr: add drm-shim documentation

Browse source 
Signed-off-by: Simon Perretta <simon.perretta@imgtec.com>
Reviewed-by: Frank Binns <frank.binns@imgtec.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/39453>
This commit is contained in:
Simon Perretta 2026-01-22 10:51:19 +00:00 • committed by Marge Bot
parent ba104d3e92
commit e49e4945a3
1 changed files with 25 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
docs/drivers/powervr.rst
View file

@ -96,6 +96,31 @@ dispatch macros and make sure to instantiate it once per architecture.
To avoid confusion, please do not add functions that are prefixed with
``pvr_arch_`` if they are not part of the system described here.
drm-shim
--------
PowerVR implements ``drm-shim``, stubbing out the powervr DRM kernel interface.
This allows for use-cases such as offline compiler testing and control-stream
dumping.
To build Mesa with the PowerVR drm-shim, configure Meson with
``-Dvulkan-drivers=imagination`` and ``-Dtools=drm-shim``.
The drm-shim binary will be built to
``build/src/imagination/drm-shim/libpowervr_noop_drm_shim.so``.
To use, set the ``LD_PRELOAD`` environment variable to the drm-shim binary.
By default, drm-shim mocks a BXS-4-64 with a BVNC of 36.53.104.796,
however this can be overridden by setting the ``PVR_SHIM_DEVICE_BVNC``
environment variable. The value to set should match those found in the
``struct pvr_device_ident`` instances defined in
``src/imagination/common/device_info/*.h``.
The reported quirks and enhancements can be overridden by setting the
``PVR_SHIM_MUSTHAVE_QUIRKS``, ``PVR_SHIM_QUIRKS``, and ``PVR_SHIM_ENHANCEMENTS``
environment variables. These should be set to a comma/semicolon-separated list
of quirk/enhancement IDs.
Chat
----