From c13b40404a32ee3aa86195eb5e3a6ec4c62e02dd Mon Sep 17 00:00:00 2001
From: galister <3123227-galister@users.noreply.gitlab.com>
Date: Fri, 13 Sep 2024 15:45:47 +0000
Subject: [PATCH] add wivrn-lighthouse guide

---
 content/docs/fossvr/wivrn/_index.md | 36 ++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/content/docs/fossvr/wivrn/_index.md b/content/docs/fossvr/wivrn/_index.md
index 56f2331..34e4333 100644
--- a/content/docs/fossvr/wivrn/_index.md
+++ b/content/docs/fossvr/wivrn/_index.md
@@ -15,4 +15,38 @@ It's very similar in purpose to [Monado](/docs/fossvr/monado/), but for standalo
 
 Current limitations are a fixed bitrate and network protocol streaming only, please ensure your headset is on a stable network or utilize an ethernet adapter to your headset to operate in a quasi-wired mode.
 
-Should you utilize [Envision](/docs/fossvr/envision/) for WiVRn setup, please ensure your APK and WiVRn server match as closely as possible. Check the WiVRn github [actions](https://github.com/WiVRn/WiVRn/actions) for an APK matching your server build to install to your headset.
\ No newline at end of file
+Should you utilize [Envision](/docs/fossvr/envision/) for WiVRn setup, please ensure your APK and WiVRn server match as closely as possible. Check the WiVRn github [actions](https://github.com/WiVRn/WiVRn/actions) for an APK matching your server build to install to your headset.
+
+## WiVRn + Lighthouse driver
+
+This section covers using WiVRn with any lighthouse-tracked device: Index/Vive controllers, Vive/Tundra trackers, etc. Important steps are marked with 🔴.
+
+🔴 Have SteamVR installed (no need to run it).
+
+🔴 In Envision, set WiVRn Profile as such:
+- XR Service CMake Flags:
+  - `WIVRN_FEATURE_STEAMVR_LIGHTHOUSE=ON`
+- Environment Variables:
+  - `WIVRN_USE_STEAMVR_LH=1`
+  - `LH_DISCOVER_WAIT_MS=6000`
+
+🔴 Perform a **Clean Build** after changing these!
+
+If not using Envision, simply pass `-DWIVRN_FEATURE_STEAMVR_LIGHTHOUSE=ON` to cmake and export the env variables before starting `wivrn-server`.
+
+🔴 Grab [Motoc](/docs/fossvr/motoc/), this can calibrate the two tracking technologies to work together.
+
+Discovery happens only on first connection, so be sure to **have all lighthouse devices powered on and in line of sight of base stations before connecting the headset!**
+
+Once a device is discovered, it may be powered off and then back on later.
+
+🔴 Once video appears in the headset, check `motoc monitor` to make sure your devices all show up.
+
+If one or more devices are missing, try:
+- Spread the devices out more; lighthouse devices get discovered quicker if they're not piled up on each other. Simply strapping them on is good, too.
+- Increase `LH_DISCOVER_WAIT_MS`, though this delays the client on first connection.
+
+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).
+