Add Monado display issue troubleshooting

This commit is contained in:
Sapphire 2025-04-08 19:57:49 +00:00
parent 9a3bc24490
commit 02cb26ba19

View file

@ -36,3 +36,15 @@ OpenComposite is REQUIRED to operate Monado in conjunction with Steam games. Pro
## Envision
[Envision](/docs/fossvr/envision/) provides a fairly low-barrier setup and development of both Monado and OpenComposite on most any modern distro.
# Troubleshooting
## [NVIDIA-specific] "NVIDIA: No allowlisted displays found!"
This may be caused by a few different issues:
- NVIDIA driver misnaming the display: If you see a display simply named "NVIDIA" in the output, the NVIDIA driver may be using a fallback name.
This can be worked around by setting the environment variable `XRT_COMPOSITOR_FORCE_NVIDIA_DISPLAY="NVIDIA"`.
- HMD display missing from the list: Try replugging the trident cable.
## "vkAcquireXlibDisplayEXT: VK_ERROR_UNKNOWN (0x000058b7a0764a80)"
- Try unplugging and replugging the trident cable.