Troubleshooting Guide - mbucchia/Oasis-Driver-for-Windows-Mixed-Reality GitHub Wiki
Checklist before beginning
GO THROUGH ALL THESE STEPS BEFORE SEEKING SUPPORT.
Making sure your configuration is supported:
- My headset is a Windows Mixed Reality headset listed here. Oasis does not work on non-WMR headsets.
- My computer is equipped with an Nvidia or AMD graphics card. Oasis does not support Intel graphic cards.
- As of writing (9/27), HP Reverb G1 is not supported on AMD.
- My computer runs the latest Windows 11. Developer does not provide support for non-current versions of Windows.
- My Graphics Card driver is up-to-date. Developer does not provide support for older drivers.
- The "Oasis Driver for Windows Mixed Reality" application in Steam is up-to-date. Developer does not provide support for older versions of the application.
- SteamVR is up-to-date. If running the SteamVR Beta, please opt-out of the Beta and try with the stable version.
- My headset's USB is connected through USB 3.0. If you don't use USB 3.0 your controllers will not be tracking!
- Take a look at the Known Issues. Some issues are already documented and being worked on. Please use patience.
Quick steps that resolve 99% of the issues:
- I have restarted the computer. This solves the majority of problems.
- I have (re)run the Procedure to unlock headset and controllers for Oasis. Always try re-running the unlock procedure in case of issues.
- I have (re)done Pairing Motion Controllers.
- I have done Clearing Environment Data in the Settings and re-done Setting up tracking.
Steam forum
Take a look at theThe Steam discussions forum should be filled with other users sharing their experience, and sometimes provide effective solutions to common issues.
Check your cabling
9 issue out of 10 is resolved by fixing a connection issue (eg: try a different USB).
Making sure the Oasis driver is enabled
Following certain types of crashes, SteamVR may disable drivers in order to ensure "Safe Mode". Make sure that the "oasis" Add-on is turned On in SteamVR's Settings, under "Startup/Shutdown", and "Manage Add-Ons". If "Manage Add-Ons" is not visible, try enabling "Advanced Settings" in the bottom-left corner.
Clearing Environment Data
1st attempt
When first moving from the Mixed Reality Portal to Oasis Driver for Windows Mixed Reality, some data may be incorrect carried over. This may lead to a recurring crash shortly after opening SteamVR. To eliminate this issue, open SteamVR's Settings, then under "Windows Mixed Reality", set "Clear Environment Data" to "Clear on next start". Restart SteamVR to complete the operation. Complete SteamVR Room Setup.
2nd attempt
If that still doesn't solve the issue, you may have to manually delete some files. Make sure SteamVR is shut down. Open a File Explorer window, then type C:\ProgramData
in the navigation bar. Note that this folder is typically hidden by Windows, therefore you must type in the full name to enter it.
Find the folder named WindowsHolographicDevices
and delete it.
You may now start SteamVR and perform the "Clear Environment Data" steps above once again. At this point now, all the previous data should really be gone.
Making sure SteamVR is set as OpenXR runtime
Application using OpenXR require manual selection of the OpenXR runtime. In SteamVR's Settings, under "OpenXR", make sure that "Current OpenXR Runtime" is set to "SteamVR". Otherwise, click "Set SteamVR As OpenXR Runtime":
Disabling ALL other SteamVR Add-Ons
To remove any unnecessary variables from the troubleshooting process, turn of all SteamVR Add-Ons other than "oasis" in SteamVR's Settings, under "Startup/Shutdown", then "Manage Add-Ons". If "Manage Add-Ons" is not visible, try enabling "Advanced Settings" in the bottom-left corner.
Disabling ALL OpenXR API Layers
To remove any unnecessary variables from the troubleshooting process, turn of all OpenXR API Layers in SteamVR's Settings, under "OpenXR", then "Manage OpenXR API Layers". If "Manage OpenXR API Layers" is not visible, try enabling "Advanced Settings" in the bottom-left corner.
Restoring settings to Defaults
Reset all settings to default values in order to eliminate bogus settings. In SteamVR's Settings, under "Windows Mixed Reality", click "Reset Page To Default", then restart SteamVR.