Code 1002

## Overview

Error Code 1002 indicates that the remote VR application failed to initialize due to a VR streaming startup failure. This error occurs when the server-side VR runtime (SteamVR) is unable to launch its rendering engine, preventing a stream from being established between the host machine and the VR client.

## Symptoms

- The VR headset remains black or displays a connection timeout after launching the application
- The LarkXR client disconnects shortly after session initiation
- Server-side logs indicate SteamVR engine failure or GPU initialization errors
- Error Code 1002 is returned during the VR streaming handshake phase

## Root Cause Analysis

The most common cause of Error Code 1002 is an **NVIDIA graphics driver incompatibility with SteamVR**. When the installed NVIDIA driver version exceeds the supported threshold, SteamVR's compositor or rendering pipeline fails to initialize, which in turn causes the LarkXR streaming service to abort the session.

This issue typically manifests after:

- Recent NVIDIA driver updates via Windows Update or GeForce Experience
- Manual driver upgrades without verifying SteamVR compatibility
- Migration to new GPU hardware with factory-installed recent drivers

## Affected Driver Versions

NVIDIA driver versions **newer than 581.80** have been observed to trigger this incompatibility with the SteamVR runtime engine used in LarkXR deployments.

## Resolution

To resolve Error Code 1002, downgrade or reinstall the NVIDIA driver to **version 581.80 or earlier**.

**Steps:**

1. Download the appropriate NVIDIA driver (version 581.80 or lower) from the [NVIDIA Driver Archive](https://www.nvidia.com/Download/Find.aspx)
2. Run the installer with **Administrator privileges**
3. During installation, select **Custom (Advanced)**
4. Check the **Perform a clean installation** option to remove existing driver profiles and settings that may conflict with SteamVR
5. Complete the installation and **restart** the host machine
6. Verify that SteamVR launches successfully in standalone mode before reconnecting via LarkXR

## Verification

After completing the driver rollback:

- Launch SteamVR directly on the host to confirm the compositor initializes without error
- Check that the GPU is recognized under **SteamVR > Settings > General > Advanced > GPU**
- Reconnect via the LarkXR VR client and confirm the session establishes without returning Code 1002

## Prevention

- **Pin driver versions** on production streaming hosts to prevent automatic updates
- **Disable Windows Update driver installation** for graphics adapters via Group Policy or system settings
- **Test SteamVR compatibility** in a staging environment before applying driver updates to live LarkXR nodes