Update documentation for Vive Pro 2
This commit is contained in:
28
content/docs/fossvr/monado/vive_pro_2.md
Normal file
28
content/docs/fossvr/monado/vive_pro_2.md
Normal 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.
|
||||
@@ -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 | ? | ? | ? |
|
||||
|
||||
Reference in New Issue
Block a user