HTC Vive Tracker Developer Manuallines
  1. Manuals
  2. Brands
  3. HTC Manuals
  4. Video Gaming Accessories
  5. Vive Tracker
  6. Developer manuallines

HTC Vive Tracker Developer Manuallines

Hide thumbs Also See for Vive Tracker:
Table of Contents

Advertisement

Quick Links

Download this manual
HTC Vive Tracker
Developer Guidelines
Ver. 1.3

Advertisement

Table of Contents
loading

Related Manuals for HTC Vive Tracker

Summary of Contents for HTC Vive Tracker

  • Page 1 HTC Vive Tracker Developer Guidelines Ver. 1.3...
  • Page 2 ©2016-2017 HTC Corporation. All Rights Reserved. HTC, the HTC logo, Vive, the Vive logo, and all other HTC product and services names are the trademarks or registered trademarks of HTC Corporation and its affiliates in the U.S. and other countries.

  • Page 3: Table Of Contents

    Contents Introduction ............................ 1 Use cases ............................ 1 Hardware requirements ......................... 3 Interface ............................4 Radio frequency (RF) ........................5 Power ............................6 Optics ............................6 Docking ............................7 Docking embodiments ......................... 7 Mechanical considerations ......................10 Apparel size ..........................11 Main feature ..........................

  • Page 4: Introduction

    PC. An accessory attached to Vive Tracker can: • Simulate buttons of the Vive controller through the underlying Pogo pin. • Send specific data to a PC via the USB interface of Vive Tracker or use its original approach to do it. Use cases There are five use cases supported by Vive Tracker.
  • Page 5 Use Case 5: Use Case 5: simulating buttons of the Vive controller or passing data to a PC via the Vive Tracker. This case is similar to Use Case 3, but the accessory connects with the Vive Tracker to transfer data...

  • Page 6: Hardware Requirements

    A compatible accessory may be attached to the Vive Tracker to send specific data to a PC through the USB interface of the Vive Tracker. The Vive Tracker needs to pair with the dongle to transfer data to a PC. The figure below describes the conceptual architecture.

  • Page 7: Interface

    VDD = 3.3 V Symbol Parameter Unit High-level output voltage VDD - 0.4 Low-level output voltage High-level input voltage 0.7VDD Low-level input voltage 0.3VDD High-level output current Low-level output current High-level input current Low-level input current HTC Confidential and Proprietary...

  • Page 8: Radio Frequency (Rf)

    01/19/2017 Ver. 1.3 Radio frequency (RF) To establish a stable wireless connection between the Vive Tracker and the dongle, the OTA performance of Vive Tracker cannot downgrade to more than 3dB when an accessory is attached to the Vive Tracker.

  • Page 9: Power

    Table: Micro USB connector and Pogo pin indication Optics The field of view (FOV) of Vive Tracker is 270 degrees. Avoid placing the structure within the view angle, since it will block responses from Vive Tracker sensors when placed in that direction.

  • Page 10: Docking

    Furthermore, Vive Tracker has constraining features, such as the longer screw cannot fasten all the way in. The user should be able to easily attach and detach Vive Tracker with two hands. One hand holds the tracker, and the other one holds the accessory.
  • Page 11 Users are able to attach the Vive Tracker to any object/surface that is intended to be tracked. If the object/surface is smooth and stiff, it is recommended to use stronger adhesive tape for attaching the docking base to the specific object/surface (ex. 3M VHB tape).
  • Page 12 Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 Improper Vive Tracker placement may cause the accessory body to obstruct the tracking performance. The mounting distance between tracking FOV and the related accessory size is shown below: 270 degree tracking FOV No tracking area...

  • Page 13: Mechanical Considerations

    Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 Mechanical considerations This section describes the mechanical considerations for developers to build various accessories that are compatible to fit or mount with the Vive Tracker. Figure: Vive Tracker HTC Confidential and Proprietary...

  • Page 14: Apparel Size

    Developer Guidelines Developer Guidelines Vive Tracker Vive Tracker Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 Apparel size Figure: Vive Tracker with different angle The overall size of the Vive Tracker is Ф99.65mm * 42.27mm (H). HTC Confidential and Proprietary...

  • Page 15: Main Feature

    4.2 Stabilizing pin recess for constraining the tracking from rotation. 4.3 Pogo pin port (spring contact-type) for optional electrical connection to the accessory. 4.4 Friction pad for providing steady friction between the accessory and Vive Tracker. 5. USB USB P P P P ort ort: Used for electrical connection to the accessory through a micro USB cable.

  • Page 16: Docking Mechanism

    Friction Pad Figure: Docking with standard tripod cradle Vive Tracker can be mounted on the cradle head first, and then attached to the main body of the accessory (similar to how a camera is mounted on a tripod). HTC Confidential and Proprietary...

  • Page 17: Docking With Side Tightening Wheel (W/ Electric Connection If Needed)

    It is recommended that the spinning wheel should have a larger diameter (25 mm or greater) for better operation. This example is able to use the Pogo pin for extending the electric connection to somewhere else. HTC Confidential and Proprietary...

  • Page 18: Accessory Design

    Stabilizing Pin for better tracking performance . • Screw thread design The screw thread type that applies to Vive Tracker is 1/4” screw with 1.27 mm pitch. For detailed information, please refer to ISO 1222-2010, pages 3-5. HTC Confidential and Proprietary...

  • Page 19: Design Of Pogo Pin Pad

    Vive Tracker Vive Tracker Vive Tracker Vive Tracker Developer Guidelines Developer Guidelines Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 Design of Pogo Pin Pad Pin definition (Vive Tracker) HTC Confidential and Proprietary...
  • Page 20 Vive Tracker Vive Tracker Vive Tracker Vive Tracker Developer Guidelines Developer Guidelines Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 Pogo Pin Pad reference design Electrical HTC Confidential and Proprietary...
  • Page 21 Vive Tracker Vive Tracker Vive Tracker Vive Tracker Developer Guidelines Developer Guidelines Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 Mechanical HTC Confidential and Proprietary...
  • Page 22 Vive Tracker Vive Tracker Vive Tracker Vive Tracker Developer Guidelines Developer Guidelines Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 HTC Confidential and Proprietary...
  • Page 23 Vive Tracker Vive Tracker Vive Tracker Vive Tracker Developer Guidelines Developer Guidelines Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 HTC Confidential and Proprietary...
  • Page 24 Vive Tracker Developer Guidelines Developer Guidelines Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 Coordinate system The coordinate system of Vive Tracker is “Right Right Right Right- - - - hande hande hande handed coordinate system d coordinate system...
  • Page 25 Datum C is set to be the intersection point between the centerline of Stabilizing Pin and Datum A. The coordinate system is constructed by the Datum frame of Datum A, the line of Datum B and Datum C, and Datum C itself. HTC Confidential and Proprietary...

  • Page 26: Software Components

    This section describes software components for the HTC Vive Tracker. If you are an accessory maker, you can transfer data through Vive Tracker. You may refer to the detailed data format transfer between an accessory and Vive Tracker in the Data format section.
  • Page 27 1. Pogo pin Please refer to hardware requirement section for detailed information on button simulation. 2. USB full speed host and HID class. The Vive tracker will act as a USB device to transfer data to/from the accessory. Vive Tracker...

  • Page 28: Data Format

    PC through Vive Tracker when the USB interface is used. The data format transfer from an accessory to Vive Tracker is sent by a USB HID feature report. It is similar to the user interface of the Vive controller. Interval to send data should be longer than 10 ms.
  • Page 29 Pad X value, value from -32768 to 32767 Pad Y value Pad Y value, value from -32768 to 32767 Trigger Raw Trigger Raw, value from 0 to 65535 Battery Level Battery Level, Reserved Table: Data Format (Accessory to Vive Tracker) HTC Confidential and Proprietary...

  • Page 30: Accessory Integration

    After the center of an accessory has been decided during the design, the following degrees and distance of an accessory based on actual integration condition can be measured. For detailed information regarding the center of the Vive Tracker, refer to guidelines related to the hardware and mechanical design.
  • Page 31 : Center distance of z axis between accessory and tracker Content developers can collect the above information and transform Tracker pose to accessory pose. Assume Tracker rotation matrix is , accessory rotation matrix ∗ And accessory position HTC Confidential and Proprietary...
  • Page 32 Vector3 tracker_position = SteamVR_Controller.Input(3).transform.pos; Quaternion tracker_rotation = SteamVR_Controller.Input(3).transform.rot; //Transform current Tracker pose to Accessory pose GameObject.Find("Accessory ").transform.rotation = tracker_rotation * delta_rotation; GameObject.Find("Accessory ").transform.position = tracker_position + (tracker_rotation * delta_rotation) * delta_displacement; Figure: Unity example code for accessory integration (1) HTC Confidential and Proprietary...
  • Page 33 Ver. 1.3 Another Unity example code shows how to transform the accessory by comparing vectors parallel to y-axis and z-axis of the Vive Tracker (AxisY_Tracker, AxisZ_Tracker in example below) and the accessory (AxisY_Accessory, AxisZ_Accessory in example below). public class Accessory : MonoBehaviour { const Vector3 AxisY_Tracker = new Vectors(AxisY_Tracker_X, AxisY_Tracker_Y, AxisY_Tracker_Z);...

  • Page 34: Unity Integration

    PC’s USB port. Right- click on one of the existing controller’s icon and click “Pair Controller” in the pop-up menu (shown in figure below). Press the Power button on Vive Tracker for 2 seconds, and then release it to enter the paring mode.
  • Page 35 You can download Unity is 5.3.5f1 Personal from https://store.unity.com/download?ref=personal Figure: Unity Version You need to import SteamVR Plugin into your project first. If you do not have it yet, you can download it from the Asset Store in Unity. Figure: Unity Asset Store HTC Confidential and Proprietary...
  • Page 36 01/19/2017 Ver. 1.3 In the developer version of Vive Tracker, it will use a similar approach and naming as you did to create content for the Vive controller. The steps to create content for Vive Tracker are as follows (with figures from Unity): Step 1 Step 1: Add “CameraRig”...
  • Page 37 Developer Guidelines Developer Guidelines Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 Step 2: Create 3D Object for Vive Tracker. In this example, “Capsule” is used. Step 2 Step 2 Step 2 Figure: Create 3D Object HTC Confidential and Proprietary...
  • Page 38 Developer Guidelines Developer Guidelines Developer Guidelines Developer Guidelines HTC Corporation 01/19/2017 Ver. 1.3 Step 3: Add Component > “SteamVR_Tracked Object” to the 3D Object “Capsule”. Step 3: Step 3: Step 3: Figure: Add Component “SteamVR_Tracked Object” HTC Confidential and Proprietary...
  • Page 39 Step 4: Set size of Objects item in “SteamVR Controller Manager”. In this example, one Vive Step 4: Step 4: Step 4: Tracker is used in the setup. Figure: Set size of object in “SteamVR Controller Manager” HTC Confidential and Proprietary...
  • Page 40 Ver. 1.3 Step 5 5 5 5 : : : : Set “Capsule” object to “Element0” on the “Objects” item in “SteamVR Controller Step Step Step Manager”. Figure: Set type of object in “SteamVR Controller Manager” HTC Confidential and Proprietary...
  • Page 41 Step 6: After completing the steps mentioned above, press the “Run” button in Unity. When you Step 6 Step 6 Step 6 move Vive Tracker, you will see the Capsule object is also moving in the content. Figure: Execution of Unity HTC Confidential and Proprietary...

  • Page 42: Firmware Upgrade

    For the device in DVT stage, please follow below steps to upgrade the firmware with upgradeFirmware.zip file first. *Note: Please check the device number on the power key of your Vive Tracker. If the device number starts with D, it is DVT stage.

Table of Contents