FAQ and Troubleshooting
This section includes additional tips and frequently asked questions about using your headset.
If can’t find an answer to your question, you can send your inquiry to Varjo Support. If you want to report a bug, please reach out to email@example.com. Thank you!
Connecting the headset
Can I use adapters for connecting the Varjo VR-1 to my computer?
We recommend connecting the headset to a computer using the Link Box without adapters. For example, if your laptop does not have full DisplayPort, it is better to use DisplayPort to Mini-DP cable rather than an adapter. We cannot guarantee functionality with adapters.
I connected the headset to my desktop PC using the Link Box but I cannot see the image on my headset display.
There can be a few reasons why this is happening. Try the following:
- Ensure that you have connected the DisplayPort cables and USB-A cable to your desktop PC using the connectors on the back of your PC. In many cases, the connectors on the back are routed to the USB root and connectors in front are behind a USB hub. This may cause a connectivity issue.
- Check that the Link Box is connected to a wall power socket using the Varjo-supplied power source.
- If your PC has both an integrated graphics card and a dedicated graphics card, use the ports on your dedicated graphics card.
- Make sure you have connected the cables in the right order. Unplug both headset cables from the Link Box and reconnect the cables (in this order): 1) First connect the Link Box to your computer and a power socket. 2) Connect the red optical cable from the headset to the Link Box. 3) Connect the blue optical cable from the headset to the Link Box.
I connected the headset to my laptop using the Link Box but I cannot see the image on my headset display.
There are specific requirements for supported graphics card and connectors defined in the System requirements. Please make sure your laptop is compatible with the requirements.
After you have determined compatibility, try the following:
VR-2 Pro, VR-2, and VR-1
- VR-2 Pro and VR-2 only: Choose the appropriate cables (DisplayPort-DisplayPort or DisplayPort-Mini DisplayPort) and select a connectivity option depending on the type of computer and what ports it has.
- Make sure you have connected the cables in the right order. Unplug the headset from the Link Box and reconnect the cables (in this order): 1) First connect the Link Box to your computer and a power socket. 2) Connect the red optical cable. 3) Connect the blue optical cable from the headset to the Link Box.
XR-1 Developer Edition
- Choose the appropriate cables (DisplayPort-DisplayPort or DisplayPort-Mini DisplayPort) depending on the type of computer and what ports it has.
- Ensure that the XR camera cable is connected to a port with the Thunderbolt icon.
- Make sure you have connected the cables in the right order. Unplug the headset from the Link Box and reconnect the cables (in this order): 1) First connect the Link Box to your computer and a power socket. 2) Connect the XR camera cable from the headset to your computer. 3) Connect the red optical cable from the headset to the Link Box. 4) Connect the blue optical cable from the headset to the Link Box.
I connected the headset using an external dock between my headset and Windows computer for extra ports. I cannot see the image on my headset display.
- External docks act as a USB hub and may cause compatibility issues. We recommend connecting laptops using the Link Box directly and without connectors or adapters. See the System requirements for more details.
- Some desktop motherboards have USB 3.0 routed through an internal hub and this will place USB devices too far in the USB chain. To solve this, locate a USB 3.0 port that is directly connected to the USB root. We recommended connecting to a port on the back of the computer as these are likely connected to the USB root.
I shut down my computer, but the headset does not turn off.
The headset is powered by the Link Box power supply. When plugged into a wall socket, the headset remains powered on even if you turn off your computer.
When the headset is not used for a longer period of time, it is recommended to unplug the Link Box from the wall socket and disconnect the headset’s blue optical cable from the Link Box. Unplugging both cables will shut down the headset.
Setting up the headset
I have finished the setup steps but can’t get my VR application to show up on the headset. Instead, I can see my Windows desktop extended on the headset displays.
Make sure you have the latest NVIDIA graphics card drivers installed. Check the supported driver versions from the System requirements.
AMD GPUs are not currently supported by the Varjo VR-1.
The headset doesn’t work after a Windows or graphics driver update.
You may need to uninstall and reinstall the Varjo Base software.
I am having trouble getting the setup to work on a Windows 10, N version.
Windows N versions don’t include all media framework libraries the software depends on. Install the latest Windows Media Feature Pack and try running the setup again.
Starting an application
My VR application doesn’t start.
There can be several reasons why an application doesn’t start. First verify that this software has worked on your Varjo headset before.
If this is the first time you are using the software on the Varjo headset
If you have an application that has been created for another VR headset, you need to port your application to work with the Varjo headset. See the details in Develop for Varjo for how to integrate your existing apps with the Varjo headset.
If the software has previously worked on this Varjo headset
If you have trouble starting your VR application, or the image doesn’t appear full screen on the headset displays, try the following steps:
- Close all running VR applications.
- Unplug the headset. Wait for a few seconds and then reconnect the headset cables.
- Navigate to the Support tab and Restart the Varjo System. Alternatively, right-click on Varjo Base on the Windows taskbar and select Restart Varjo System.
- If you don’t see Varjo Base appearing on the Windows taskbar, navigate to the Windows Start menu and start Varjo Base again.
- Wait 30 seconds.
- Launch your VR application again.
My OpenVR or OpenXR application doesn’t work with Varjo headset.
The Varjo headset is compatible with OpenVR and OpenXR software and is enabled by default.
In some situations (e.g. you have been using headsets from other manufacturers with your computer), you may need to enable them manually. Navigate to the System tab and choose Enable OpenVR or Enable OpenXR.
Displays and image quality
Headset performance is lower than expected when using VR/XR applications.
Rendering the headset view in several windows at the same time will require a lot of processing power and may impact performance.
It is recommended that you use the Analytics window in Varjo Base as the primary mirroring window and minimize all other windows. Navigate to Developer tools and choose Analytics window, then minimize the Varjo Base main window.
Also note that if your application opens a mirror window in Windows and you are running Varjo Base simultaneously: 1) Keep only one mirror window open in the foreground of Windows, and 2) minimize all other unnecessary windows.
My application appears in lower resolution than expected.
If your application supports both Varjo Native and OpenVR or OpenXR, it may be running in OpenVR / OpenXR mode instead of Varjo Native. In this case, it is indicated in Varjo Base in the Headset view title bar.
To resolve this, disable OpenVR or OpenXR and restart the application.
My OpenVR application doesn’t run smoothly.
The Varjo headset’s screen pixel density is much higher than that of other headset manufacturers. 100% resolution in SteamVR for the Varjo headset is 4096 x 4096 pixels per eye and this may be too demanding for some video cards and heavy applications.
If you are experiencing performance issues, you can adjust the resolution through the SteamVR settings.
- In the SteamVR application, choose Menu > Settings > Video .
- Select Enable custom resolution and adjust the resolution to the desired setting.
- Restart your VR application.
Tip: You can adjust the resolution from 20% to 500% of the original quality. Note that after 8K resolution is reached, there is no need to increase the resolution further as you will not see any additional image improvement.
If you need to create an exception to the general resolution for individual VR applications, this can be performed through the Applications settings. Refer to the instructions below.
Important: This application-specific setting is a multiplier of the general resolution under the Video settings. When set to 100%, your VR application will use the general resolution specified in the Video settings. Only change it from 100% if necessary.
- In the SteamVR application, choose Menu > Settings > Applications.
- Locate the application(s) in the list and adjust the resolution to the desired setting.
- Restart your VR application.
One or more of the headset displays are off or they show a corrupted image.
1. Reset the headset: Press and hold both the System and Application buttons until the LED light blinks red once. Release the buttons.
Wait until the headset restarts and check that the displays show the correct image.
2. If that doesn’t work, unplug the Link Box power cable and restart your computer.
After your computer has restarted, re-connect the Link Box power cable. The headset will restart.
Check that the displays show the correct image now.
The screen flickers, or the image does not update smoothly on the headset displays.
The border between the focus and the peripheral areas doesn’t look smooth.
This can happen if your headset is not positioned optimally on your face, or the lens distance has not been adjusted to correctly match your eyes.
1. Navigate to the Headset tab in Varjo Base.
Ensure that Automatic interpupillary distance and Automatic headset positioning have been turned on.
If you don’t want to use automatic interpupillary distance, ensure that the value you have manually entered matches your interpupillary distance.
2. Put your headset on again.
The headset will show on-screen instructions for optimally positioning the device on your face.
When the Headset position guidance is displayed, the headset will automatically re-adjust the headset lenses for your eyes. You will hear a short buzzing sound during the adjustment.
I connected XR-1 Developer Edition to my computer, but the mixed reality cameras don’t show any image.
There are a few reasons why this may be happening. Try the following:
- Unplug and reconnect the Link Box power cable.
- Check the XR camera cable connection on your computer. Make sure the port you are using has the Thunderbolt Lightning icon.
- The XR camera cable needs to be connected directly to the motherboard’s Thunderbolt port, or if you are using a Thunderbolt expansion card, the ports in that card. There may also be other USB-C ports on the motherboard or the graphics card – do not use those.
- Download the latest Thunderbolt driver for your motherboard. See links to manufacturer’s pages in the System requirements.
- Make sure to approve the Thunderbolt connection for the headset. See Getting started with XR-1 Developer Edition, Step 3 for instructions on how to approve the connection.
- If any of the above doesn’t resolve your issue, the Thunderbolt settings in BIOS may be incorrect. Consult your motherboard manufacturer’s instructions on how to check and edit the BIOS settings for that specific motherboard.
Using positional tracking
The headset image does not update when I move.
Headset tracking has been lost. You can confirm your base stations’ tracking status in the Varjo Base status area above the Headset view window. Try slowly waving the headset towards the base stations to regain tracking.
The SteamVR™ tracking elements are placed behind the front plate and on both sides of the Varjo headset. Be sure not to cover or occlude the SteamVR™ tracking elements with your hands. Ensure that the base stations are pointing towards the headset in all positions, also when you move or turn around in the room. The minimum recommended distance between the base stations and the headset is 1.5 meters or 5 feet. Please be aware that reflective surfaces may interfere with tracking; if possible, cover all reflective surfaces in the base stations’ field of view.
How can I reset the floor height or forward direction?
Floor height and default orientation are defined using the Room Setup in the SteamVR application.
- Close your VR application on your computer.
- Open Varjo Base and navigate to the System tab. Open SteamVR room setup.
- From the Room setup instructions, Launch SteamVR and wait for the application to open. Alternatively, launch SteamVR manually from your Windows computer.
- In the SteamVR application window, go to Menu > Room Setup and follow the instructions. It is recommended that you choose the “Standing Only” setup, which is the most straightforward way to complete the setup. Please note that choosing “Standing Only” does not prevent you from playing VR experiences that have been created for room scale.
- After you’ve completed the room setup, return to Varjo Base.
- Press Done. Floor height and forward direction are now reset.
How can I reset my position in VR?
Tracking reset is currently possible only in enabled Unity applications. See Developer documentation for Unity for further information.
Using eye tracking
I can’t get the eye tracking calibration to start.
For the eye tracking to work accurately, the headset needs to be placed firmly and aligned straight so that the cameras can see your eye movements. See detailed instructions for using the Eye tracking in the Get to know your headset section.
Eye tracking calibration always finishes with the error: “Calibration unsuccessful”.
There are two options for calibrating your Varjo headset:
- In Varjo Base:
Select Calibrate eye tracking in the Tools panel on the left side of the Varjo Base window.
- In the headset:
Press the System button. In the Calibration tab, Start eye tracking.
Eye tracking has been designed to work with most eyeglasses and contact lenses. However, the technology is not guaranteed to work with all medical devices or eye conditions.
Using hand tracking
My hand tracking is not working.
When the Leap Motion control panel application is running, it displays an icon in the notification area of the Windows Taskbar or Mac Finder bar. You can use the menu attached to the icon to open the control panel and visualizer. When the Leap Motion controller is plugged in and working properly, the icon turns green. Other colors indicate errors and abnormal operating conditions:
|The module is unplugged (or Leap Motion software hasn’t detected it yet).|
|The module and software are operating normally.|
|Indicates that a smudge or other contamination might be clouding the sensor window.|
|Indicates that tracking has been suspended because Leap Motion frame rate is below the acceptable threshold. USB bandwidth contention is the primary correctable cause of poor performance and can often be resolved by plugging the sensor into a different USB port, plugging the controller directly into the computer rather than using USB hubs or extender cables, or removing other USB devices.|
|Indicates that the Leap Motion frame rate is below the acceptable threshold and you have turned off the Avoid Poor Performance option in the Leap Motion Control Panel. Tracking continues with greatly reduced reliability.|
|Indicates that an update is available for the Leap Motion software. Open the Leap Motion Control Panel to install the update.|
For more information about Leap Motion including set-up, FAQ and tutorials, please visit https://support.leapmotion.com/hc/en-us
My controllers are not working.
The controllers are connected using the SteamVR application. See the setup steps in the Getting started guide.
Please note: if you have paired your controllers with another VR headset, they will need to be paired again with the Varjo headset.
The System button in my Vive controller does not work.
When using applications developed for the Varjo headset, the Vive controller System button does not have any functionality and currently remains a limitation. However, when using SteamVR (OpenVR) applications, the System button functions as expected.
You can also access the Varjo System settings at any time by pressing the headset System button once.
Using headphones and audio
What kind of headphones can I use with the Varjo headset?
The Varjo headset has a 3.5mm AHJ (CTIA) standard audio connector. It is located between the face mask and the headset body, next to the right eye lens. You can use headphones with and without a built-in microphone.
Which audio format is supported by the Varjo headset?
2 channel 16-bit, 44.1kHz/48kHz sampling rate for playback and recording is supported.
I connected my headphones to the Varjo headset, but I cannot hear anything.
Audio may not be routed to the Varjo headset.
- On your Windows PC, select Start and type in Sound.
- Select Sound (Control Panel) from the list of results.
- Open the Playback tab, and select USB Audio Device > OK.
Using the headset for extended periods of time
The headset gets warm during use.
The headset may get warm during extended periods of continuous use. This is not dangerous. If the headset feels uncomfortably warm to wear, unplug the headset and let it cool down. Place it on a flat surface with the vents on the top of the headset facing up.
The headset shuts down automatically.
This may be due to ambient temperature rising above a defined limit. Varjo headsets automatically shut down when they have reached their internal temperature limit.
Unplug the headset and allow it to cool down for 15 minutes.
Varjo Base shows an error message.
Varjo Base can detect several different errors and always displays the recommended steps for how to recover. Please follow the instructions shown in Varjo Base.
You can view advanced technical details about the error in Varjo Base. This may be helpful if you need to connect Varjo Support about your issue.
If your problem persists and you can’t get the headset working, please report your problem to Varjo Support.
The SteamVR status window shows an error message.
When running SteamVR applications, SteamVR may show error messages related to displaying SteamVR content. Follow the instructions given by the SteamVR app. Resetting the SteamVR app may also provide a solution.
Otherwise, you can ignore the error messages displayed by the SteamVR application.
For issues related to the headset or other Varjo-specific errors, always refer to the instructions and messages appearing in Varjo Base.
The headset LED light blinks differently than usual.
The System button has an LED light that indicates the different states of the headset.
|LED is green||The headset is working normally.|
|LED blinks white||There are two possibilities:
|LED blinks white twice and stops||A notification is shown in Varjo Base (and the headset if notifications have been enabled). See details and instructions in Varjo Base.|
|LED blinks red||The headset is not functioning properly and no image is displayed. There can be several reasons for this. See error details and instructions in Varjo Base for correcting the issue.|
|LED is blue, or blinks blue and white||The headset firmware is updating. The LED is solid blue during connection to PC and starts blinking blue and white during the firmware update process.|