From e88360c2995e04795613aa43238ba5d5243a5110 Mon Sep 17 00:00:00 2001 From: Beyley Cardellio Date: Fri, 19 Sep 2025 17:45:38 -0700 Subject: [PATCH] Update documentation for Vive Pro 2 --- content/docs/fossvr/monado/vive_pro_2.md | 28 ++++++++++++++++++++++++ content/docs/hardware/_index.md | 2 +- 2 files changed, 29 insertions(+), 1 deletion(-) create mode 100644 content/docs/fossvr/monado/vive_pro_2.md diff --git a/content/docs/fossvr/monado/vive_pro_2.md b/content/docs/fossvr/monado/vive_pro_2.md new file mode 100644 index 0000000..7c4e1b5 --- /dev/null +++ b/content/docs/fossvr/monado/vive_pro_2.md @@ -0,0 +1,28 @@ +--- +weight: 200 +title: Vive Pro 2 +--- + +# Using the Vive Pro 2 with the Monado OpenXR Runtime + +As of [this MR](https://gitlab.freedesktop.org/monado/monado/-/merge_requests/2581), +the Vive Pro 2 is natively supported by Monado with both the `steamvr_lh` and `survive` drivers. +To benefit from this native support, you are expected to remove the Vive Pro 2 driver for SteamVR +from your system, as the SteamVR driver will conflict with Monado when using the `steamvr_lh` driver. + +You are also required to manually set an environment variable to tell Monado what render ICD (IPD) to use, +since as of now, it is unknown how to calculate the actual lens IAD (IPD). + +To do so, set the `SURVIVE_OVERRIDE_ICD`, or `LH_OVERRIDE_ICD` environment variables, +depending on what driver you intend to use, to your physical IOD (IPD) in milimeters. +As an example, use `SURVIVE_OVERRIDE_ICD=68.5` for 68.5mm. + +## Configuring Monado's Vive Pro 2 driver + +The Monado Vive Pro 2 driver has a variety of configuration options, +which are set through environment variables, a list of which are provided below: + +- `VP2_RESOLUTION` [`0`-`5`]: Sets the resolution of the Vive Pro 2, expects an integer, [possible options are provided here](https://gitlab.freedesktop.org/monado/monado/-/blob/vp2-distortion/src/xrt/drivers/vp2/vp2_hid.h#L26). To get the highest possible resolution, set it to `5`. The higher resolutions require kernel patches on AMD GPUs, or usage of the Nvidia driver 580+ open kernel modules. The kernel patches can be found on the main HMD list. +- `VP2_DEFAULT_BRIGHTNESS` [`0.0`-`1.3`]: Sets the default brightness of the HMD on startup. Full brightness is known to cause overheating and audio interference. +- `VP2_NOISE_CANCELLING` [`false`/`false`]: Enables or disables noice cancelling on the microphone. +- `VP2_USE_FALLBACK_DISTORTION` [`true`/`false`]: Setting this to `true` will disable the Vive Pro 2 distortion algorithm, and fall back to the generic lighthouse distortion. Only use if you know what you are doing. diff --git a/content/docs/hardware/_index.md b/content/docs/hardware/_index.md index 455776b..77d8b42 100644 --- a/content/docs/hardware/_index.md +++ b/content/docs/hardware/_index.md @@ -43,7 +43,7 @@ A non-comprehensive table of various VR/XR devices and the drivers that support | HTC Vive | ✅ | ✅ | 🚧 (WiVRn PC-PC stream) | | HTC Vive Pro | ✅ | ✅ | 🚧 (WiVRn PC-PC stream) | | HTC Vive Pro Eye | ✅ | ✅ | 🚧 (WiVRn PC-PC stream) | -| HTC Vive Pro 2 | ✅ (custom [driver and patches](https://github.com/CertainLach/VivePro2-Linux-Driver)) | ✅ (With two kernel patches [1](https://github.com/CertainLach/VivePro2-Linux-Driver/blob/master/kernel-patches/0002-drm-edid-parse-DRM-VESA-dsc-bpp-target.patch) [2](https://github.com/CertainLach/VivePro2-Linux-Driver/blob/master/kernel-patches/0003-drm-amd-use-fixed-dsc-bits-per-pixel-from-edid.patch), AMD GPUs or Nvidia driver 580+ open kernel modules.) | -- | +| HTC Vive Pro 2 | ✅ (custom [driver and patches](https://github.com/CertainLach/VivePro2-Linux-Driver)) | ✅ (With kernel patches required for full resolution on AMD [<= 6.14](https://gist.github.com/galister/08cddf10ac18929647d5fb6308df3e4b/raw/0f6417b6cb069f19d6c28b730499c07de06ec413/combined-bsb-6-10.patch) and [>= 6.15](bigscreen-beyond-kernel-6.15.patch).) | -- | | Bigscreen Beyond | ✅ (with kernel patch for [<= 6.14](https://gist.github.com/galister/08cddf10ac18929647d5fb6308df3e4b/raw/0f6417b6cb069f19d6c28b730499c07de06ec413/combined-bsb-6-10.patch) and [>= 6.15](bigscreen-beyond-kernel-6.15.patch), AMD GPUs or Nvidia driver 580+ open kernel modules.) | ✅ (with kernel patch for [<= 6.14](https://gist.github.com/galister/08cddf10ac18929647d5fb6308df3e4b/raw/0f6417b6cb069f19d6c28b730499c07de06ec413/combined-bsb-6-10.patch) and [>= 6.15](bigscreen-beyond-kernel-6.15.patch), AMD GPUs or Nvidia driver 580+ open kernel modules.) | -- | | Somnium VR1 | ⚠️ Rumored successful internal test by Somnium. | ⚠️ Rumored successful internal test by Somnium. | ⚠️🚧 (WiVRn PC-PC stream) | | VRgineers XTAL | ? | ? | ? | -- 2.49.1