[vulkan] Add a doc to describe generic Vulkan environment setup
Closes https://github.com/google/iree/pull/1881
COPYBARA_INTEGRATE_REVIEW=https://github.com/google/iree/pull/1881 from antiagainst:vulkan-setup ba528de13b69c2e7ed7b3aaa3fc7d0d67caa2cfb
PiperOrigin-RevId: 311211997
diff --git a/docs/GetStarted/getting_started_linux_vulkan.md b/docs/GetStarted/getting_started_linux_vulkan.md
index 557645d..924f123 100644
--- a/docs/GetStarted/getting_started_linux_vulkan.md
+++ b/docs/GetStarted/getting_started_linux_vulkan.md
@@ -10,7 +10,8 @@
tightly integrated fashion on accelerators like GPUs.
This guide will walk you through using IREE's compiler and runtime Vulkan
-components.
+components. For generic Vulkan development environment set up and trouble
+shooting, please see [this doc](generic_vulkan_env_setup.md).
## Prerequisites
@@ -33,10 +34,9 @@
### Background
-Vulkan applications interface with Vulkan "drivers", "layers", and "extensions"
-through the Vulkan loader. See LunarG's
-[Architecture of the Vulkan Loader Interfaces](https://vulkan.lunarg.com/doc/view/latest/windows/loader_and_layer_interface.html)
-page for more information.
+Please see
+[Generic Vulkan Development Environment Setup and Troubleshooting](generic_vulkan_env_setup.md)
+for generic Vulkan concepts and development environment setup.
### Quick Start
@@ -74,24 +74,6 @@
If these tests pass, you can skip down to the next section.
-### Setting up the Vulkan Loader
-
-If you see failures to find `libvulkan.so.1` (the Vulkan loader), install it by
-either:
-
-* Updating your system's GPU drivers
-* Installing the [Vulkan SDK](https://www.lunarg.com/vulkan-sdk/)
-* Building the Vulkan loader
- [from source](https://github.com/KhronosGroup/Vulkan-Loader)
-
-You may also need to set `LD_LIBRARY_PATH` and `LD_PRELOAD` to load the desired
-version of the loader. For example:
-
-```shell
-$ LD_LIBRARY_PATH={PATH_TO_VULKAN_SDK}/x86_64/lib/
-$ LD_PRELOAD=libvulkan.so.1
-```
-
### Setting up SwiftShader
If your system lacks a physical GPU with compatible Vulkan drivers, or you just
@@ -141,6 +123,13 @@
$ export VK_LAYER_PATH=$PWD/bazel-bin/external/vulkan_extensionlayer/:$VK_LAYER_PATH
```
+### Setting up the Vulkan Loader
+
+IREE relies on the `VK_KHR_timeline_semaphore` extension. The minimal loader
+version supporting this extenion is `1.1.124`. So if you see failures regarding
+timeline semaphore, in addtion to setting up the extension layer, please also
+check to make sure the loader is at a proper version.
+
### Support in Bazel Tests
Bazel tests run in a sandbox, which environment variables may be forwarded to
