Home - mbucchia/Oasis-Driver-for-Windows-Mixed-Reality GitHub Wiki

image

Hello and Welcome to the Oasis Driver for Windows Mixed Reality documentation.

----> OFFICIAL STEAM STORE PAGE <----

----> OFFICIAL DISCUSSIONS FORUM <----

If you are here, then you are most likely looking for one of the following things:

Quickstart

Before you get started, it is important to understand the following:

  • Mixed Reality Portal is not needed and will not do anything.
  • Windows Mixed Reality for SteamVR (Steam store) is not needed and will not do anything.
  • OpenXR (and OpenXR Tools) for Windows Mixed Reality (Microsoft store) is not needed and will not do anything.
  • Headset companion apps, such as the Mixed Reality Headset or HP Reverb G2 VR Headset Setup (Microsoft Store) are not needed and will not function.

You don't need to uninstall the above in order to use Oasis. You will need to install SteamVR from Steam if you don't already have it.

Then it is 5 simple steps:

  1. If you are running Windows 11 23H2, disable the Mixed Reality device in Device Manager to avoid interference. You may re-enable it later if you choose to not use Oasis.

  2. Install Oasis Driver for Windows Mixed Reality.

  3. Pair your motion controllers using Windows settings. If you don't have motion controllers, you can skip this step.

  4. Run the unlock procedure.

    The most common issue you might encounter here is: "Unexpected error while opening MR USB device: 6". This means Mixed Reality Portal (on older Windows 11) is interfering. This means you missed step 1) above.

  5. Run the Room Setup.

    The most common issue you might encounter above is a random crash(!) after a few seconds... This is a common issue after first setup. If you encounter this issue, please delete the C:\ProgramData\WindowsHolographicDevices folder as explained here.

⚠️ **GitHub.com Fallback** ⚠️