Merge branch 'patch-4' into 'main'

Extend lighthouse-tracked pairing

See merge request lvra/lvra.gitlab.io!119

content/docs/steamvr/pairing.md

@@ -5,14 +5,53 @@ title: Pairing
 
 # Pairing Lighthouse Controllers or Trackers
 
-To pair lighthouse-capable hardware such as the Valve Index or HTC
+To pair lighthouse-tracked hardware such as the Valve Index "Knuckles" Controllers,
-Vive Pro controllers, or VIVE Trackers you'll need enough receivers (one for
+HTC Vive Wands, HTC Vive Pro controllers, Tundra Labs Trackers or VIVE Trackers you'll
-each device).
+need enough receivers (generally one for each device).
 
-Receivers can be either:
+Receivers can be:
-- watchman dongles (plugged in your computer, preferably not on an USB hub)
+- Watchman dongles (plugged in your computer, preferably not on a USB hub)
-- if you have a lighthouse HMD (e.g. Valve Index, HTC Vive, Bigscreen Beyond),
+  - Tundra Labs "SW"-series dongles (now discontinued) can theoretically connect
-  there will be two already built-in (for both controllers)
+  3 or even 4 (depending on the version) devices. However stability leaves
+  much to be desired when connecting more than 2 (respectively 3) devices.
+- If you have a lighthouse-tracked HMD (e.g. Valve Index, HTC Vive, Bigscreen Beyond),
+two receivers (for the controllers) are already built in.
+
+## Assigning Trackers
+
+After pairing Trackers, you need to assign roles to each tracker.
+
+This can be done through SteamVR _Settings > Controllers > Manage Trackers_
+
+Alternatively you can also edit the settings-file `$HOME/.steam/steam/config/steamvr.vrsettings` by adding the following section:
+
+```json
+"trackers" : {
+      "/devices/lighthouse/LHR-xxx" : "TrackerRole_LeftShoulder",
+      "/devices/lighthouse/LHR-xxx" : "TrackerRole_RightShoulder",
+      "/devices/lighthouse/LHR-xxx" : "TrackerRole_Waist",
+      "/devices/lighthouse/LHR-xxx" : "TrackerRole_LeftFoot",
+      "/devices/lighthouse/LHR-xxx" : "TrackerRole_RightFoot"
+   }
+```
+Replace LHR-`xxx` with the Serialnumber of each tracker.
+Serialnumbers can be obtained (after pairing) from `$HOME/.steam/steam/config/lighthouse/lhr-xxx`
+
+TrackerRoles are formatted `TrackerRole_<yyy>` with `<yyy>` one of:
+- None
+- Handed
+- LeftFoot
+- RightFoot
+- LeftShoulder
+- RightShoulder
+- LeftElbow
+- RightElbow
+- LeftKnee
+- RightKnee
+- Waist
+- Chest
+- Camera
+- Keyboard
 
 ## Pairing via SteamVR
 
@@ -36,9 +75,8 @@ You'll be greeted by a shell which starts by listing the serial number of attach
 dongles and built-in, if your HMD is connected).
 
 Selecting a receiver is done by running `serial <serialnumber>` in the opened shell.
-When pairing new devices,
+When pairing new devices, you'll want to find a receiver that isn't paired with a device already.
-you'll want to find a receiver that isn't paired with a device already. After a
+After a receiver is selected, you can run `identifycontroller` to check if the receiver
-receiver is selected, you can run `identifycontroller` to check if the receiver
 is paired with a device (assuming the device is on).
 
 In general, built-in HMD receivers will have longer serial numbers than dongle