Get Started

So you just became the proud owner of our latest Positional Tracker and you cannot wait to get started ? Well you are in the right place !

First, here are a few links to other documentations :

Documentation & Examples :

Tutorials :

 

We will guide you through the installation process, from unpacking to calibration, and at the a quick example of how to connect it to Unity. Ready ? Let’s get this party started !

1. Unpacking

What’s in the box ? This part will help you identify which part is which 🙂

 

Gateway

This is the brain of VR Tracker, it will do all the calculations.

untitled.140

Camera

The cameras are a bit bigger than the gateway, and you can identify the camera module at the center (small round reflective lens)

Tracking Camera 03

 

Tag

The Tag is the part that will be tracked. It has a micro USB port to charge it, a slide switch to turn it ON and OFF, a pushbutton for different uses (calibration…) and an expansion port.

The Tag comes with its holder (red part), that can be easily attached to a VR headset strap and allow to change Tags just by sliding it.

Under the Tag you will find a QR Code and a number printed. There is also an NFC chip behind the stickers. They all contain the same information : the Tag unique ID. Here is how you can use them : if you a mobile VR application, you can ask users to scan their Tag (QR, NFC) so that this Tag is then associated to the smartphone.

untitled.157

 

2. Starting the Gateway

NOTE: Always connect the Gateway first !

The first you need to do in any installation is to start the Gateway first (at least 2 minutes before the Cameras).

Installing the Gateway is super easy : plug in the power supply and you are good to go !

After a minute ou two you will see a new Wifi network called “VR Tracker Gateway“. All your devices requiring position need to be connected to this network.

You might want to know the password, be ready it’s pretty complicated : “vrtracker”

Your devices connected to the Wifi can also access internet, but only if you plug the ethernet cable between your home router and the Gateway.

Your Gateway is started ! Let’s install the cameras now

 

3. Installing the Cameras

For the Cameras, you need to place them in a place where they will be able to cover the expected area. To see the coverage area of the cameras, once the gateway is started, and the cameras are ON, pick a tag. Make sure that the tag is connected to the gateway, it should have a blue light.

When a camera is tracking a tag, you should see a red light on the camera, it means that the camera is detecting a tag. So now that you have a tracked tag, move around and see the limit of the current coverage area of the camera, once the tag is lost, the red light of the camera should turn off.

So now adjust the cameras by orienting them so that they cover the area you expected. If you want to cover a wider area, you can try to put the cameras as far as possible.

Now that the cameras are positioned, Let’s move to the Calibration :)!

 

4. Calibrate the Cameras


Start by downloading the calibration tool here. You will have more details on how to calibrate the cameras on this page, but here are the main steps :

  1. Select the Cameras

    Select the different cameras that you want to calibrate.

  2. Select a tag for the calibration

    For the calibration, you need only one tag that will be used to indicate the different coordinates. Turn on a Tag, wait untill the tag is connected to the gateway (wait for the blue light).

  3. Start the calibration

    Click on the “Validate Camera Selection” button, it will turn the system in calibration mode, one tag will turn into calibration mode, its light should be now in violet.

  4. Add the calibration points

    Enter the different coordinates that you want to use for the calibration. The more point you have, the more precise the system will be.

  5. Calibrate

    Once you have added all the calibration point that you wanted, now let’s calibrate. You have two possibilities for the calibration.

    • Press the Space bar to send a message to the tag to flash. The first time you press the Space bar, it will show you the first position where you need to put the tag. Then press again the Space bar to send the message to the calibration tag. You can press the Space bar until the message Calibration Finished appear.
    • You can also use the push-button on the tag to launch a flash. So follow the order of the different positions that you have added.

    Be careful to not mix the two methods, it will be difficult to you to know where you are in your calibration.

  6. Stop the calibration

    Once you have launch a flash from the tag from the different position, press the “Stop Calibration” button, it the end the calibration of the system and your cameras will be ready for use :).

 

5. Let’s the game begin !

Now that you have your system calibrated, the system will be able to give you the position of the different tags in the covered area. So you can connect now a user to the gateway and assign a tag to the user. Once you have assign a tag to the user, the gateway will send to you the 3D position of the tag.

To assign a tag to the user, you can send the command : “cmd=assignatag”, it will assign the first available tag to the user.
Once the assignment is done, you will received the command : “cmd=info&msg=assignmentsuccess&uid=tag_id”, you will find in the message the tag id so that you can enable the orientation for example.
Once the assignment is done, you will receive the position of the tag in the following way : “cmd=position&uid=Tag_id&x=xCoordinate&y=yCoordinate&z=zCoordinate”.