Skip to main content

Set Up VRPN Device for HMD

To set up a tracker as an VRPN device, you will need 2 softwares, VRPN-OpenVR and OpenVR-SpaceCalibrator.

Install

VRPN-OpenVR: Download & GitHub

OpenVR-SpaceCalibrator: Download / GitLab

VRPN-OpenVR​

VRPN-OpenVR is required to let XRCC recognized your tracker as a VRPN device.

  1. Download VRPN-OpenVR.exe

  2. In stream VR steamvr.settings file, add the following setting to the file with a text editor. (Only add the driver_null part if you are setting up without a HMD)

tip

steamvr.settings usually local at C:\Program Files (x86)\Steam\config

{
   "jsonid" : "vrsettings",
   "steamvr" : {
      "directModeEdidPid" : 43521,
      "directModeEdidVid" : 53794,
      "forcedDriver" : "null",
      "requireHmd" : true,
      "enableHomeApp" : false,
      "activateMultipleDrivers" : true
   },
   "driver_null" : {
      "enable" : true,
      "id" : "Null Driver",
      "serialNumber" : "Null 4711",
      "modelNumber" : "Null Model Number",
      "windowX" : 100,
      "windowY" : 100,
      "windowWidth" : 1920,
      "windowHeight" : 1080,
      "renderWidth" : 1280,
      "renderHeight" : 720,
      "secondsFromVsyncToPhotons" : 0.1,
      "displayFrequency" : 60
   }
}

  1. Launch SteamVR and pair your tracker normally.

  2. Run the VRPN-OpenVR.exe and keep it running while StreamVR is active.

    • If the tracker is connected successfully, the status of the tracker will be shown in the command line interface

  3. Open a VXR config file.

  4. Under Devices tab, create a new VRPN Device

    1. Enter whatever name you want, as long as the name is unique
    2. Enter the tracker name displayed in the command line + @localhost in the address field
    3. Choose Tracker as the device type

  5. Now you have set up a VRPN tracker and you can link it to an entity.

OpenVR-SpaceCalibrator​

OpenVR-SpaceCalibrator is required to match the tracker position to your HMD. You can skip this step if the tracker's in-game position is already correct.

  1. Install OpenVR-SpaceCalibrator

  2. Launch SteamVR and you should see a OpenVR-SpaceCalibrator tab in the Stream VR menu inside the HMD.

note

StreamVR might disable OpenVR-SpaceCalibrator on startup. Enable OpenVR-SpaceCalibrator in StreamVR -> Settings -> Startup/Shutdown -> Manage Add-Ons and turn on 01spacecalibrator.

  1. In OpenVR-SpaceCalibrator, Set Reference Space to your HMD (e.g. oculus) and Target Space to your tracker (e.g. lighthouse)

  2. On Reference Space side, select a controller for calibration (recommend Right Controller). On Target Space side, select a tracker to calibrate.

  1. Hold your selected controller and tracker in the same hand firmly and press Start Calibration.

  2. Move and rotate your hand around in an ∞ shape motion slowly a few times, like you're calibrating the compass on your phone, until calibration complete.

  1. You should see your tracker position show correctly in StreamVR. Fine tune the tracker calibration with Edit Calibration.