summary refs log tree commit diff stats
path: root/docs/system
diff options
context:
space:
mode:
authorAntonio Caggiano <antonio.caggiano@collabora.com>2024-10-25 00:03:11 +0300
committerAlex Bennée <alex.bennee@linaro.org>2024-10-28 16:56:36 +0000
commit94d0ea1c19289d76ced934711fccd2269e69bb29 (patch)
tree4fb102e07cb3763894f0eb9afe389645bc89b5af /docs/system
parent1333fd0693a87bd509c025e6212fcfeced948a15 (diff)
downloadfocaccia-qemu-94d0ea1c19289d76ced934711fccd2269e69bb29.tar.gz
focaccia-qemu-94d0ea1c19289d76ced934711fccd2269e69bb29.zip
virtio-gpu: Support Venus context
Request Venus when initializing VirGL and if venus=true flag is set for
virtio-gpu-gl device.

Signed-off-by: Antonio Caggiano <antonio.caggiano@collabora.com>
Signed-off-by: Huang Rui <ray.huang@amd.com>
Signed-off-by: Dmitry Osipenko <dmitry.osipenko@collabora.com>
Message-Id: <20241024210311.118220-14-dmitry.osipenko@collabora.com>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Diffstat (limited to 'docs/system')
-rw-r--r--docs/system/devices/virtio-gpu.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/system/devices/virtio-gpu.rst b/docs/system/devices/virtio-gpu.rst
index cb73dd7998..b7eb0fc0e7 100644
--- a/docs/system/devices/virtio-gpu.rst
+++ b/docs/system/devices/virtio-gpu.rst
@@ -71,6 +71,17 @@ representation back to OpenGL API calls.
 .. _Gallium3D: https://www.freedesktop.org/wiki/Software/gallium/
 .. _virglrenderer: https://gitlab.freedesktop.org/virgl/virglrenderer/
 
+Translation of Vulkan API calls is supported since release of `virglrenderer`_
+v1.0.0 using `venus`_ protocol. ``Venus`` virtio-gpu capability set ("capset")
+requires host blob support (``hostmem`` and ``blob`` fields) and should
+be enabled using ``venus`` field. The ``hostmem`` field specifies the size
+of virtio-gpu host memory window. This is typically between 256M and 8G.
+
+.. parsed-literal::
+    -device virtio-gpu-gl,hostmem=8G,blob=true,venus=true
+
+.. _venus: https://gitlab.freedesktop.org/virgl/venus-protocol/
+
 virtio-gpu rutabaga
 -------------------