lvra.gitlab.io/content/docs/fossvr/envision/wmr_controllers_on_arch.md
2025-04-26 07:55:55 +02:00

2.6 KiB

weight title
100 WMR Controller Tracking on Arch

Envision Installation on Arch with Controller Tracking

Recommendations:

  • Paru as the Arch AUR helper
  • KDE as the desktop environment for better compatibility with SteamVR (may not be necessary)

Paru:

Paru GitHub Repository

sudo pacman -S --needed base-devel
git clone https://aur.archlinux.org/paru.git
cd paru
makepkg -si

Monado Vulkan Layers

These are only needed if you have an NVIDIA Card and a Nvidia Driver before 565.77.01.

Monado Vulkan Layers AUR

Paru Installation

paru -S monado-vulkan-layers-git

Normal Installation with compiling manually

git clone https://aur.archlinux.org/monado-vulkan-layers-git.git
cd monado-vulkan-layers-git
makepkg -i
  • -> Install dependencies and, if needed, run makepkg -i again.

Envision-XR with Paru

Envision-XR AUR

paru -S envision-xr-git

Envision Setup

  • Select WMR default.

WMR default

  • Duplicate and adjust settings:
    • XR Service Repo:
    https://gitlab.freedesktop.org/thaytan/monado
    
    • XR Service Branch:
    dev-constellation-controller-tracking
    
    WMR adjusted settings
  • Save and build the profile.
  • Plug in the VR headset & turn on the controllers.
  • Click Start on Monado.
  • Once ready, launch a game on Steam.

Important Notes:

  • Do not close Envision before starting the game.

  • If changing the game:

    • Close the game.
    • Leave Monado open.
    • Start the new game.
  • Always turn on the controllers before starting Envision.

  • Update controller firmware while running Windows. It's necessary for controllers to work in Linux, updating them from Linux is currently impossible.

  • Make sure that you don't factory-reset the controllers (performed by long-pressing the pairing button when controllers are off). This action restores the factory firmware version.

  • If monado fails to start with the following error, you likely need to update the firmware in Mixed Reality Portal:

    WARN [wmr_controller_send_fw_cmd] Controller fw read timed out after 250 ms
    ERROR [wmr_bt_controller_create] WMR Controller (Bluetooth): Failed to create controller
    ERROR [wmr_create_bt_controller] Failed to create WMR controller (Bluetooth)