VRfree® 3D Stylus
The following guide and manual relates to the VRfree® 3D Stylus, build 2021.
VRfree® 3D Stylus
VRfree® system package contents:
- 1 VRfree® Headmodule, to be fastened to the headset or to a stationary position.
- 1 VRfree® 3D Stylus
- 1 NB-8L batteries, within the Headmodule (please remove the battery from the Headmodule)
- 3 cables (below the interior carton): 1 long USB-C to USB-A for the Headmodule, 1 short USB-C to USB-A cable for the Wristmodule, 1 short USB-C to USB-C cable to connect the Headmodule to the HTC Vive/Vive Pro/Focus or the Oculus Quest.
Before you get started - charge batteries
Please remove the battery from the Headmodule. You will not need it unless you use the system in a standalone mode (untethered, with a Quest or a Focus).
Re-charge the Tracker by connecting it to a USB-power source via its USB-C socket.
List of features
- Frequency / Status LED: Indicates what frequency your Headmodule is on. Your VRfree Headmodule can communicate with the Wristmodules on one of 7 different pre-set frequencies, each represented by a different colour. Make sure that your Head- and Wristmodule run on the same frequency ie colour when powered on. You can cycle through these preset frequencies by pushing the button repeatedly.
- Frequency selection: Select one of 7 different pre-set frequencies, each represented by a different colour. You can cycle through these preset frequencies by pushing the button repeatedly.
- USB-C slot: Plug-in the USB-C cable connection to your PC or mobile HMD.
- Charge-enable button: Only relevant if you connect your Headmodule to a mobile HMD such as Oculus Quest 1/2, Vive Focus 1, 2, 3 or similar. The button allows you to choose whether the Headmodule battery draws power (gets charged) from the mobile HMD or not.
- Power button: powers on your VRfree® Headmodule.
- Battery lid: keeps your 3.7V, 700mAh, 2.6Wh rechargeable battery in place.
List of features
- Power button: This powers on your 3D Stylus.
- Frequency selection button: Select one of 7 different pre-set frequencies, each represented by a different colour. You can cycle through these preset frequencies by pushing the button repeatedly.
- Action button: This button performs a primary task / action assigned to the 3D Stylus similar to the left button of a mouse. In some programs this may refer to painting or drawing, in others it may mean something else.
- Frequency / Status LED: Indicates what frequency your 3D Stylus is on. Your VRfree 3D Stylus can communicate with the Headmodule on one of 7 different pre-set frequencies, each represented by a different colour. Make sure that your Headmodule and your 3D Stylus run on the same frequency ie colour when powered on. You can cycle through these preset frequencies by pushing the button repeatedly.
- USB-C socket: Plug-in your USB-C cable here to calibrate the 3D Stylus or to charge its battery.
- Tracking beacon: To verify that your VRfree® 3D Stylus is connected to the VRfree® Headmodule on the right frequency hold the silver transducer close to your ear while both 3D Stylus and the Headmodule are powered on. If you can hear a crackling noise the 3D Stylus is correctly connected.
- Free programmable button: This button can be programmed to perform a function of your liking. Please refer to the Unity Script for more details.
- Connect the long USB-C cable to the Headmodule and your PC (Videolink). If you have a HTC Vive or Vive Pro, use the short USB-C cable to connect the VRfree® Headmodule to the extra USB-socket of the Vive (the signal is fed through to the PC).
- Power on the Headmodule. The Frequency and Status LEDs should light up.
Register your 3D Stylus with the system:
- Download the VRfree® Setup (here) if you haven't already done so.
- Connect your 3D Stylus to your PC using the provided USB-A to USB-C cable.
- Switch on your 3D Stylus by pressing the Power button (1).
- Open the VRfree® Setup menu and click on "Device Configuration": see here.
- Your "Device Configuration" should already be preset to this setting.
- You can select an ID of your liking, the preset is 0. If you change it, memorize or write down the number. You will need to activate this ID at your Headmodule.
- Disconnect the 3D Stylus.
- Connect your Headmodule to your PC using the provided USB-A to USB-C cable.
- Switch on your Headmodule by pressing the Power button.
- Open the VRfree® Setup menu and again click on "Device Configuration": see here.
- Within the "Device Configuration" menu, check the two fields "Enable Rotation" and "Enable Position" next to the ID that you chose earlier in Step 4: see here
- Press "Save Configuration"
- Disconnect the 3D Stylus
- Perform a "Tracker Orientation Calibration": see here. Please follow the calibration steps shown in the videos.
- With that your 3D Stylus is registered with your Headmodule and can communicate with your system.
IMPORTANT: The more devices you register per headmodule, the lower the update frequency of any single one device! You can see that in the "Device Configuration" menu: When operating 6 trackers plus 2 gloves the "distance measurement frequency" drops from 50Hz to 12.5Hz. For best performance you should therefore only have those devices registered in the "Device Configuration" that you really need for that specific task / simulation!
VRfree® Headmodule - Hardware Calibration
- Please download the VRfree setup zip on the V2 Download Page, extract and run it (Videolink).
- If you haven't already done so, attach your VRfree® Headmodule to your headset and connect it via the long USB-C to USB-A cable (for the HTC Vive/Pro use the short USB-C to USB-C cable as illustrated here).
- Now run the VRfree setup program.
- Select "Head Module IMU Calibration" from the Menu (Videolink).
- Follow the steps in the VRfree® Headmodule IMU Calibration Video on the left or use this Youtube link
Testing your 3D Stylus in the VRfree® Setup Scene
- Make sure your Headmodule and your 3D Stylus are switched on and communicate on the same frequency (LED colour). To check you can hold the 3D Stylus to your ear. If you hear a faint crackling sound then the 3D Stylus is communicating with the Headmodule.
Now, within the VRfree Setup please select the "Handpose calibration". Put on your headset and test the accuracy of your Tracker's position and orientation.
Setting up a Unity Scene for the VRfree® Stylus
- Please open a new Unity project in version 2019.2.6f1
- In Unity go to "Project Settings" - "Player". There enable "Virtual Reality Supported" from the "XR Settings".
- In Unity go to "Window" - "Package Manager" and install the "XR Legacy Input Helpers"
- Then download, unblock (file properties) and unzip this file: VRfreePluginUnity_2.6.5_2021-12-06.unitypackage
- Drag the above package into the Unity project assets ie import all.
- Open/Doubleclick the StylusScene from Assets/VRfree/Samples
- When you click "Play" now, you should be able to use the Stylus to paint in 3D.