diff --git a/content/docs/steamvr/pairing.md b/content/docs/steamvr/pairing.md index fcc95aa..d9e6bd4 100644 --- a/content/docs/steamvr/pairing.md +++ b/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 -Vive Pro controllers, or VIVE Trackers you'll need enough receivers (one for -each device). +To pair lighthouse-tracked hardware such as the Valve Index "Knuckles" Controllers, +HTC Vive Wands, HTC Vive Pro controllers, Tundra Labs Trackers or VIVE Trackers you'll +need enough receivers (generally one for each device). -Receivers can be either: -- watchman dongles (plugged in your computer, preferably not on an USB hub) -- if you have a lighthouse HMD (e.g. Valve Index, HTC Vive, Bigscreen Beyond), - there will be two already built-in (for both controllers) +Receivers can be: +- Watchman dongles (plugged in your computer, preferably not on a USB hub) + - Tundra Labs "SW"-series dongles (now discontinued) can theoretically connect + 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_` with `` 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 ` in the opened shell. -When pairing new devices, -you'll want to find a receiver that isn't paired with a device already. After a -receiver is selected, you can run `identifycontroller` to check if the receiver +When pairing new devices, you'll want to find a receiver that isn't paired with a device already. +After a 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