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.
  • 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:

Take a look at the Steam forum

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

image image

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.

image

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.

image

Find the folder named WindowsHolographicDevices and delete it.

image

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":

image

image

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.

image

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.

image