Update documentation for Vive Pro 2

This commit is contained in:
Beyley Cardellio
2025-09-19 17:45:38 -07:00
parent 4714d56058
commit e88360c299
2 changed files with 29 additions and 1 deletions

View File

@@ -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.

View File

@@ -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 | ? | ? | ? |