# Software Overview

## **Glove Connection**

1. Open the Udcap Driver software and insert the glove USB adapter into the computer's USB port.
2. Press and hold the power button on the glove for 1 seconds to power it on.
3. The glove icon turning turquoise indicates a successful connection of the glove.

* If the gloves are \[No Connected], please go to Firmware Update - [Pairing](https://udcap-vr-gloves-document.gitbook.io/udcap/software-setup/pages/q634rkPlMMX6FZSeWjTT#id-2.-glove-and-signal-receiver-pairing).

<div align="left"><figure><img src="/files/NgNtRUgyTYqRetzCfJQk" alt="" width="294"><figcaption></figcaption></figure> <figure><img src="/files/b87dMoOlUJ5s908OngvT" alt="" width="294"><figcaption></figcaption></figure></div>

4. **After calibration, the Home Page displays:**

* **Battery** level
* **Glove frame rate** (>100 FPS = normal range)
* **RSSI signal strength**

<div align="left"><figure><img src="/files/QzREFs0kmLNhbiqsdv1Y" alt="" width="293"><figcaption></figcaption></figure></div>

***

## **Calibration**

### **Quick Calibration**

* Press the power button on the glove control box for 1 second to initiate calibration. Follow voice prompts to complete the process.
* Press the F1 hotkey to trigger quick calibration.

### **Action Calibration**

{% hint style="warning" %}
Based on hand shape and the intensity of movement, the first calibration may take around 20-40 minutes. After recalibration, the duration will increase. A calibration every hour is normal for continued proper functioning.
{% endhint %}

1. After the glove is successfully connected, click the action calibration button.

<div align="left"><figure><img src="/files/A9zlrAWbKvab5VKxpZHd" alt="" width="294"><figcaption></figcaption></figure></div>

2. Follow the tutorial to perform the three calibration actions:&#x20;

   ① Lightly make a fist,&#x20;

   ② Close five fingers together,

   ③ Spread out five fingers.

<div align="left"><figure><img src="/files/qP3OyrkSEFGXaod9Q3WU" alt="" width="563"><figcaption></figcaption></figure></div>

3. Motion calibration posture reminder

① Lightly make a fist

<div align="left"><figure><img src="/files/FEaJpkXoBi9j1rJEtH3a" alt=""><figcaption></figcaption></figure></div>

② Close five fingers together

<figure><img src="/files/Z2a3JT99R7rwJC7lHY5w" alt=""><figcaption></figcaption></figure>

③ Spread out five fingers

<figure><img src="/files/NSE9AATeGU9nLQpPRBag" alt=""><figcaption></figcaption></figure>

***

## **Hand Capture**

1. In the software menu, select "Hand Capture" to open or close the hand capture page.
2. Hold down the **right mouse button** and drag the page to rotate the hand model. Click the **camera button** to reset the view.
3. Click the maximize button on the hand capture page to view the hand capture in a separate window.

<div align="left"><figure><img src="/files/e2cZa3CY4tgmsElJzH0Z" alt="" width="296"><figcaption></figcaption></figure></div>

4. The left side of the page shows your calibration results: dark green represents perfect, light green represents excellent, yellow represents good, and red represents poor.

<div align="left"><figure><img src="/files/HGj6zD7oXDah3WF0AeLD" alt="" width="563"><figcaption></figcaption></figure></div>

5. You can switch between displaying the hand model or hand data on the separate page.

{% hint style="danger" %}
**Note:** Red, yellow, and green only represent the quality of your calibration, and do not indicate whether the sensors are damaged.
{% endhint %}

6. The "Export Data" button enables the export of the current calibration data.

<div align="left"><figure><img src="/files/mjzzmMBqEZv4VUCBDsX2" alt="" width="563"><figcaption></figcaption></figure></div>

***

## **Controller**

#### Controller Overview

You can open the independent controller page.The VR gloves can cover and map all the operation modes of a general VR controller.

1. The joystick and A/B buttons have the same logic as a general VR controller.
2. Thumb bending maps to the TrackPad touchpad.
3. Index finger bending maps to the Trigger button.
4. Middle and ring finger bending map to the Grip button.
5. Pressing the A and B buttons simultaneously maps to the system button.

<div align="left"><figure><img src="/files/XQgv8uWO0OgDUk8slqOY" alt="" width="563"><figcaption></figcaption></figure></div>

#### **Joystick Calibration**

1. When using for the first time, it is recommended to calibrate the joystick to ensure accuracy.

<div align="left"><figure><img src="/files/2RnYReduQM1Vq7stcwtk" alt="" width="563"><figcaption></figcaption></figure></div>

2. Follow the tutorial to perform the two calibration steps: center point calibration and range calibration.

{% hint style="warning" %}
Before clicking the **calibration**, make sure that **both joysticks** have been operated as instructed.
{% endhint %}

<div><figure><img src="/files/hi4ZLHcMy5RypEOKfES5" alt="" width="563"><figcaption></figcaption></figure> <figure><img src="/files/oug47u4a6ugK03aHKF1X" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
When the index finger is naturally bent, pushing the joystick left may result in an upward/downward force angle, causing non-pure horizontal input detection.

**Solution:** [**SteamVR Joystick Calibration Steps**](https://udcap-vr-gloves-document.gitbook.io/udcap/software-setup/pages/whqJOEw6j78lupXy1AMt#id-7.-how-to-recalibrate-the-joystick-direction-when-the-gloves-joystick-module-misaligns-due-to-finger)
{% endhint %}

#### **Controller Settings**

1. each button has a selection box.
   * Selection box-checked, the button takes effect.
   * Selection Box-Canceled, the button is disabled. If the button is disabled, the button no longer displays the visual effect of being pressed.
2. TrackPad, Trigger, Grip have two thresholds.
   1. The previous threshold is the trigger threshold, which represents that the button was touched.
   2. The latter threshold is the click threshold, which means that the button was fully pressed.
   3. The ratio between the two thresholds represents the range value of the button.
3. **Control Module Quick Off**

* &#x20;When enabled, long-press the thumbstick for 5 seconds to disable the thumbstick on that side. Repeat to re-enable.

<div align="left"><figure><img src="/files/aEWtxUjLievrU5CebexB" alt="" width="563"><figcaption></figcaption></figure></div>

#### Vibration Feedback

* Two buttons can control the vibration feedback switch.
* You can click on the vibration points to test and experience the vibration effects of the joystick module.

<div align="left"><figure><img src="/files/llq0BjybReefceZPow1K" alt="" width="563"><figcaption></figcaption></figure></div>

***

## Hand setting (fine-tuning of motion-capture effect)

See details in the [【Hand Setting】](/udcap/software-setup/hand-setting-beta-detailed-explanation.md) section.

***

## **Spatial** Orientation

1. **Enable Spatial Tracking (SteamVR connection required):**\
   Spatial tracking opens in a separate page.

<figure><img src="/files/SWb8nbhKKxSNUXeKIqFp" alt="" width="332"><figcaption></figcaption></figure>

2. **Select a Preset Plan:**\
   Choose the spatial tracking plan preset according to the type of locator you are using, and then save it.

<figure><img src="/files/Cas7rKTqgF1eEF9pxzpJ" alt="" width="563"><figcaption></figcaption></figure>

3. **Custom Adjustments:**
   1. If you need to adjust the spatial position of the glove, you can modify the parameters based on the preset plan according to your preferences.
   2. The ± symbol can adjust the direction or angle of the spatial position (position offset and degrees offset), or you can manually modify the val.&#x20;

{% hint style="warning" %}
If you are using a non-Lighthouse tracked headset, you need to install Space Calibrator or other tools to calibrate the spatial position between the headset and SteamVR.
{% endhint %}

***

## **General**

1. **Data Transmission Settings:**

   1. Supports two data transmission formats: **VMC** (Virtual Motion Capture) and **OSC** (Open Sound Control).
   2. After enabling VMC or OSC transmission in the software, set the same channel in the receiving software. (For details, see the VMC settings.)

   <figure><img src="/files/0YsauPUq7MLacaf4nmov" alt="" width="563"><figcaption></figcaption></figure>
2. **Auto-start**

* UDCAP will start or stop along with the SteamVR.

3. **Controller Priority:**

* When using the glove, if you encounter a situation where the controllers or other devices (e.g., Pico series, HTC series) are competing for control, it is recommended to set the control priority to **High** for the glove.

{% hint style="warning" %}
**Note: After adjusting "Controller Priority", restart SteamVR for the settings to take effect.**
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://udcap-vr-gloves-document.gitbook.io/udcap/software-setup/software-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.