fdo-mirrors/mesa
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/mesa/mesa.git synced 2025-12-20 13:50:11 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

docs: update venus driver page

Browse source 
Most implementation defined behaviors have been properly defined via
new maintenance extensions, and the mapping support is the only one
left on the table...in a very unfortunate way for historical reasons.

Meanwhile, update the host driver list for the latest that has been
tested working. Two major KVM improvements have also been documented
along with the setups that rely on those.

Acked-by: Dmitry Osipenko <dmitry.osipenko@collabora.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34225>
This commit is contained in:
Yiwei Zhang 2025-03-26 22:49:53 -07:00 • committed by Marge Bot
parent c6757cb8f0
commit 9d0e7d8722
1 changed files with 30 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

43
docs/drivers/venus.rst
View file

@ -17,17 +17,36 @@ The Venus renderer requires
- :ext:`VK_EXT_image_drm_format_modifier` - :ext:`VK_EXT_image_drm_format_modifier`
- :ext:`VK_EXT_queue_family_foreign` - :ext:`VK_EXT_queue_family_foreign`
from the host driver. However, it violates the spec in some places currently from the host driver. However, it violates the spec and relies on
and also relies on implementation-defined behaviors in others. It is not implementation-defined behaviors to support ``vkMapMemory`` (see `below
expected to work on all drivers meeting the requirements. It has only been <#vk-memory-property-host-visible-bit>`__). It is not expected to work on all
tested with drivers meeting the requirements. It has only been tested with:
- ANV 21.1 or later - ANV 21.1 or later
- RADV 21.1 or later (the host kernel must have - RADV 21.1 or later
``CONFIG_TRANSPARENT_HUGEPAGE`` disabled because of this `KVM issue - Note: you need 6.13 or later kernel that already has `this KVM series
<https://github.com/google/security-research/security/advisories/GHSA-7wq5-phmq-m584>`__) <https://lore.kernel.org/all/20241010182427.1434605-1-seanjc@google.com/>`__,
- TURNIP 22.0 or later or prior kernel patched with `this prior art
- Mali r32p0 or later <https://lore.kernel.org/all/20240229025759.1187910-1-stevensd@google.com/>`__.
- Note: for dGPU with Intel CPU, you need 6.11 or later kernel patched with
`this KVM change
<https://lore.kernel.org/all/20240309010929.1403984-6-seanjc@google.com/>`__
(it was `temporarily reverted
<https://lore.kernel.org/all/20240915073010.5860-1-pbonzini@redhat.com/>`__
due to a Bochs DRM driver regression that has already been `fixed
<https://lore.kernel.org/all/20240909131643.28915-1-yan.y.zhao@intel.com/>`__).
- Turnip 22.0 or later
- PanVK 25.1 or later
- Lavapipe 22.1 or later
- Mali (Proprietary) r32p0 or later
- NVIDIA (Proprietary) 570.86 or later
- Note: if with Intel CPU, you need 6.11 or later kernel patched with
`this KVM change
<https://lore.kernel.org/all/20240309010929.1403984-6-seanjc@google.com/>`__
(it was `temporarily reverted
<https://lore.kernel.org/all/20240915073010.5860-1-pbonzini@redhat.com/>`__
due to a Bochs DRM driver regression that has already been `fixed
<https://lore.kernel.org/all/20240909131643.28915-1-yan.y.zhao@intel.com/>`__).
The Venus driver requires supports for The Venus driver requires supports for
@ -40,10 +59,8 @@ The Venus driver requires supports for
from the virtio-gpu kernel driver, unless vtest is used. That usually means from the virtio-gpu kernel driver, unless vtest is used. That usually means
the guest kernel should be at least 5.16 or have the parameters back ported, the guest kernel should be at least 5.16 or have the parameters back ported,
paired with hypervisors such as `crosvm paired with hypervisors such as `crosvm <https://crosvm.dev>`__, or `QEMU
<https://chromium.googlesource.com/chromiumos/platform/crosvm>`__, or `patched <https://www.qemu.org>`__.
qemu
<https://www.collabora.com/news-and-blog/blog/2021/11/26/venus-on-qemu-enabling-new-virtual-vulkan-driver/>`__.
vtest vtest
----- -----