From 33d2240f13e88c83489b32502ea6142f1e0feb66 Mon Sep 17 00:00:00 2001
From: galister <3123227-galister@users.noreply.gitlab.com>
Date: Mon, 23 Sep 2024 09:05:49 +0000
Subject: [PATCH] wivrn: add slimevr

---
 content/docs/fossvr/wivrn/_index.md | 37 ++++++++++++++++++++++++++---
 1 file changed, 34 insertions(+), 3 deletions(-)

diff --git a/content/docs/fossvr/wivrn/_index.md b/content/docs/fossvr/wivrn/_index.md
index 5f5d697..8e2726b 100644
--- a/content/docs/fossvr/wivrn/_index.md
+++ b/content/docs/fossvr/wivrn/_index.md
@@ -19,7 +19,14 @@ Should you utilize [Envision](/docs/fossvr/envision/) for WiVRn setup, please en
 
 Use WiVRn with a cable instead of Wifi. Use a 5Gbps cable & port at the very least.
 
-Steps:
+WiVRn version: 0.19+
+
+Using Envision: 
+- Connect the headset via USB
+- Click the `Start WiVRn Client (Wired)` button in Envision.
+  - If it's not there, an Envision update might be necessary.
+
+Manual steps:
 - Connect the headset via USB
 - If WiVRn is running on the headset, close it now.
 - While in the system lobby of the headset, run the following `adb` commands on the PC:
@@ -28,12 +35,12 @@ Steps:
   adb shell am start -a android.intent.action.VIEW -d "wivrn+tcp://127.0.0.1" org.meumeu.wivrn
   ```
 
-  (Setting TCP-only mode via config is no longer required as of WiVRn 0.19)
-
 ## WiVRn + Lighthouse driver
 
 This section covers using WiVRn with any lighthouse-tracked device: Index/Vive controllers, Vive/Tundra trackers, etc.
 
+WiVRn version: 0.19+
+
 Have SteamVR installed (no need to run it).
 
 In Envision, set WiVRn Profile as such:
@@ -63,3 +70,27 @@ To re-discover devices, restart WiVRn server.
 
 At this point, your lighthouse devices will be randomly floating about somewhere. To calibrate them, follow the guide in the [Motoc README](https://github.com/galister/motoc/blob/main/README.md).
 
+## [Experimental] WiVRn + SlimeVR trackers
+
+This section covers using WiVRn with SlimeVR trackers (not via OSC). Tracking fidelity is reported to be similar to what's achievable with the SteamVR-native solution.
+
+Current state: Fully usable, but with quirks.
+
+Use WiVRn APK version: 0.19.1 (exact)
+
+In Envision, set WiVRn Profile as such:
+- XR Service Repo:
+  - `https://github.com/galister/wivrn.git`
+- XR Service Branch:
+  - `solarxr`
+- XR Service CMake Flags:
+  - `WIVRN_FEATURE_SOLARXR=ON`
+
+Perform a **Clean Build** after changing these!
+
+- Always start SlimeVR server before starting WiVRn. 
+- Do not quit SlimeVR server mid-session; trackers will not work until WiVRn is restarted.
+- _Full Reset_ is sensitive to direction.
+  - There is a direction that one needs to face towards for the full reset to work properly.
+  - It will take some trial and error to find this direction. 
+  - Upstream issue: [SlimeVR-Server#1159](https://github.com/SlimeVR/SlimeVR-Server/issues/1159)
\ No newline at end of file