diff --git a/app/src/main/java/com/droiddeck/launcher/glasses/Glasses.kt b/app/src/main/java/com/droiddeck/launcher/glasses/Glasses.kt
index f14d92da2f..419ea0b192 100644
--- a/app/src/main/java/com/droiddeck/launcher/glasses/Glasses.kt
+++ b/app/src/main/java/com/droiddeck/launcher/glasses/Glasses.kt
@@ -563,7 +563,7 @@ object Glasses {
val device = selected?.first
val m = selected?.second
val controllable = m?.let(::canOpenModel) == true
- val permitted = controllable && device != null && (m === XrealModel || usb.hasPermission(device))
+ val permitted = controllable && device != null && (m is XrealModel || usb.hasPermission(device))
val identity = device?.let {
GlassesModeState.Device(it.productId, if (permitted) runCatching { it.serialNumber }.getOrNull() else null)
}
@@ -614,9 +614,9 @@ object Glasses {
sbs = sbsByDisplay,
switching3d = modeState.pendingStereo,
brightnessMax = m?.brightnessMax ?: 8, volumeMax = m?.volumeMax ?: 8,
- sunblock = if (m === XrealModel) it.sunblock else _settings.value.sunblock ?: it.sunblock,
+ sunblock = if (m is XrealModel) it.sunblock else _settings.value.sunblock ?: it.sunblock,
hardwareControls = m?.hardwareControls == true &&
- (device?.vendorId == VitureProtocol.VENDOR_ID || m === XrealModel || m is RokidModel),
+ (device?.vendorId == VitureProtocol.VENDOR_ID || m is XrealModel || m is RokidModel),
supportsDisplayModeControl = m?.supportsDisplayModeControl == true,
hasSunblock = m?.hasSunblock == true,
diagonalFovDeg = m?.diagonalFovDeg ?: 46f,
@@ -624,7 +624,7 @@ object Glasses {
noSignal = noSignal,
sbs90 = m?.sbs90 == true,
rates2d = m?.rates2d ?: listOf(60, 90, 120),
- experimental = m === XrealModel || (m is VitureProtocol.Model && m.family == VitureProtocol.Family.PRO2 && !m.needsSdk),
+ experimental = m is XrealModel || (m is VitureProtocol.Model && m.family == VitureProtocol.Family.PRO2 && !m.needsSdk),
supportsScreen3dof = link?.hasImu == true,
supports30Hz = display?.let(::supports30Hz) == true,
supportsSpatial = (link as? VitureSdkLink)?.isCarina == true,
@@ -660,8 +660,8 @@ object Glasses {
else VitureSdk.marketName(device.productId)?.let(VitureProtocol::sdkModel)
?: VitureProtocol.model(device.productId, name)
}
- else if (XrealModel.matches(device.vendorId, device.productId)) XrealModel
- else RokidModel.model(device.vendorId, device.productId, name)
+ else XrealModel.model(device.vendorId, device.productId)
+ ?: RokidModel.model(device.vendorId, device.productId, name)
?: RayNeoModel.model(device.vendorId, device.productId, name)
}
@@ -729,8 +729,8 @@ object Glasses {
VitureSdkLink.open(usb, device, File(app.noBackupFilesDir, "viture"), sdkListener(generation),
(model as? VitureProtocol.Model)?.family, spatial)
} else VitureLink.open(usb, device, linkListener(generation))
- } else if (model === XrealModel) {
- XrealLink.open(app, xrealListener(generation))
+ } else if (model is XrealModel) {
+ XrealLink.open(app, model as XrealModel, xrealListener(generation))
} else if (model is RokidModel) {
RokidLink.open(usb, device, rokidListener(generation))
} else {
diff --git a/app/src/main/java/com/droiddeck/launcher/glasses/XrealLink.kt b/app/src/main/java/com/droiddeck/launcher/glasses/XrealLink.kt
index 18ce636eed..d2ea72d4d4 100644
--- a/app/src/main/java/com/droiddeck/launcher/glasses/XrealLink.kt
+++ b/app/src/main/java/com/droiddeck/launcher/glasses/XrealLink.kt
@@ -10,6 +10,7 @@ import java.util.concurrent.atomic.AtomicReference
internal class XrealLink internal constructor(
private val connector: XrealConnector,
private val listener: Listener,
+ private val model: XrealModel = XrealModel.ONE_S,
) : GlassesLink {
interface Listener {
fun onReady()
@@ -29,7 +30,8 @@ internal class XrealLink internal constructor(
private val worker = Thread(::run, "xreal-control").apply { isDaemon = true; start() }
companion object {
- fun open(context: Context, listener: Listener) = XrealLink(AndroidXrealConnector(context), listener)
+ fun open(context: Context, model: XrealModel, listener: Listener) =
+ XrealLink(AndroidXrealConnector(context), listener, model)
}
override fun send(msgId: Int, payload: ByteArray): Boolean {
@@ -43,9 +45,10 @@ internal class XrealLink internal constructor(
if (msgId == VitureProtocol.MSG_GET_IMU) return true
val valid = when (msgId) {
VitureProtocol.MSG_GET_DISPLAY -> true
- VitureProtocol.MSG_DISPLAY -> value in 2..5 || value == XrealModel.NATIVE_60HZ
- VitureProtocol.MSG_BRIGHTNESS -> value in 0..9
- VitureProtocol.MSG_FILM -> value in 0..1
+ VitureProtocol.MSG_DISPLAY -> if (model.stereoOnlyControl) value == 5 || value == XrealModel.NATIVE_60HZ
+ else value in 2..5 || value == XrealModel.NATIVE_60HZ
+ VitureProtocol.MSG_BRIGHTNESS -> !model.stereoOnlyControl && value in 0..9
+ VitureProtocol.MSG_FILM -> !model.stereoOnlyControl && value in 0..1
else -> false
}
return valid && commands.offer(Command(msgId, value))
@@ -61,12 +64,12 @@ internal class XrealLink internal constructor(
channels = connector.connect()
connection.set(channels)
if (!running) break
- val control = XrealControl(channels)
+ val control = XrealControl(channels, stereoOnly = model.stereoOnlyControl)
listener.onValue(VitureProtocol.MSG_GET_DISPLAY, control.display())
val current = channels
reports = Thread({
try {
- var filter = XrealOrientationFilter()
+ var filter = XrealOrientationFilter(model.flipsYz)
var wasTracking = false
var lastSensor = System.nanoTime()
while (running && connection.get() === current) {
@@ -75,7 +78,7 @@ internal class XrealLink internal constructor(
if (sample != null) {
lastSensor = System.nanoTime()
val enabled = tracking
- if (enabled && !wasTracking) filter = XrealOrientationFilter()
+ if (enabled && !wasTracking) filter = XrealOrientationFilter(model.flipsYz)
wasTracking = enabled
if (enabled) filter.update(sample)?.let {
if (running && ready && tracking && connection.get() === current)
@@ -149,7 +152,11 @@ internal class XrealLink internal constructor(
}
}
-internal class XrealControl(private val channels: XrealChannels, private val settleDelayMs: Long = 150) {
+internal class XrealControl(
+ private val channels: XrealChannels,
+ private val settleDelayMs: Long = 150,
+ private val stereoOnly: Boolean = false,
+) {
private var transaction = 0
private fun exchange(command: Int, value: Int? = null): ByteArray {
transaction = if (transaction == Int.MAX_VALUE) 1 else transaction + 1
@@ -163,26 +170,42 @@ internal class XrealControl(private val channels: XrealChannels, private val set
throw IOException("XREAL control response was not received")
}
fun display(): Int {
+ if (stereoOnly) return stereoDisplay()
val reply = exchange(XrealProtocol.GET_DISPLAY)
return XrealProtocol.numeric(reply)?.takeIf { it in 2..5 || it == XrealModel.NATIVE_60HZ }
?: throw IOException("Unsupported XREAL display response: ${reply.take(32).joinToString("") { "%02x".format(it) }}")
}
+ private fun stereoDisplay(): Int {
+ val reply = exchange(XrealProtocol.GET_INPUT)
+ return when {
+ XrealProtocol.acknowledged(reply) -> XrealModel.NATIVE_60HZ
+ else -> when (XrealProtocol.numeric(reply)) {
+ 0 -> XrealModel.NATIVE_60HZ
+ 1 -> 5
+ else -> throw IOException("Unsupported XREAL stereo response: ${reply.take(32).joinToString("") { "%02x".format(it) }}")
+ }
+ }
+ }
fun changeDisplay(mode: Int): Int {
val stereo = mode == 5
set(XrealProtocol.SET_INPUT, if (stereo) 1 else 0)
val current = awaitDisplay { (it == 5) == stereo }
- if (current == mode) return current
+ if (current == mode || stereoOnly) return current
set(XrealProtocol.SET_DISPLAY, mode)
return awaitDisplay { it == mode }
}
private fun awaitDisplay(matches: (Int) -> Boolean): Int {
val deadline = System.nanoTime() + 8_000_000_000L
repeat(40) {
- val reply = exchange(XrealProtocol.GET_DISPLAY)
- val value = XrealProtocol.numeric(reply)
- if (value != null && matches(value)) return value
- if (value == null && !XrealProtocol.acknowledged(reply))
- throw IOException("Invalid XREAL display transition response")
+ if (stereoOnly) {
+ stereoDisplay().let { if (matches(it)) return it }
+ } else {
+ val reply = exchange(XrealProtocol.GET_DISPLAY)
+ val value = XrealProtocol.numeric(reply)
+ if (value != null && matches(value)) return value
+ if (value == null && !XrealProtocol.acknowledged(reply))
+ throw IOException("Invalid XREAL display transition response")
+ }
if (System.nanoTime() > deadline) throw IOException("XREAL display transition timed out")
Thread.sleep(settleDelayMs)
}
diff --git a/app/src/main/java/com/droiddeck/launcher/glasses/XrealModel.kt b/app/src/main/java/com/droiddeck/launcher/glasses/XrealModel.kt
index 2de2236c78..70b81995e1 100644
--- a/app/src/main/java/com/droiddeck/launcher/glasses/XrealModel.kt
+++ b/app/src/main/java/com/droiddeck/launcher/glasses/XrealModel.kt
@@ -1,25 +1,63 @@
package com.droiddeck.launcher.glasses
-object XrealModel : GlassesModel {
- const val VENDOR_ID = 0x3318
- const val PRODUCT_1S = 0x043e
- const val NATIVE_60HZ = 29
- override val name = "XREAL 1S"
+internal class XrealModel private constructor(
+ override val name: String,
+ val family: Family,
+ override val diagonalFovDeg: Float,
+) : GlassesModel {
+ enum class Family {
+ ONE_S,
+ ONE,
+ AURA,
+ }
+
override val controllable = true
override val brightnessMax = 9
override val volumeMax = 0
- override val hasSunblock = true
- override val diagonalFovDeg = 52f
+ override val hasSunblock get() = family == Family.ONE_S
+ override val hardwareControls get() = family == Family.ONE_S
override val sbs90 = false
+ override val rates2d get() = if (family == Family.ONE_S) super.rates2d else listOf(60)
- fun matches(vid: Int, pid: Int) = vid == VENDOR_ID && pid == PRODUCT_1S
- fun isDisplay(name: String) = name.contains("XREAL", ignoreCase = true)
+ // Only the 1S has been exercised with SET_DISPLAY; the Aura is known to reboot on an unexpected index.
+ val stereoOnlyControl get() = family != Family.ONE_S
+
+ // The Aura reports x right, y up, z back; the rest of the One family is a half turn about x from it.
+ val flipsYz get() = family != Family.AURA
override fun mode(hz: Int, sbs: Boolean) = when {
sbs -> 5
+ stereoOnlyControl -> NATIVE_60HZ
hz >= 120 -> 4
hz >= 90 -> 3
else -> NATIVE_60HZ
}
override fun modeForStep(step: Int): Int? = null
+
+ override fun toString() = name
+
+ companion object {
+ const val VENDOR_ID = 0x3318
+ const val PRODUCT_1S = 0x043e
+ const val NATIVE_60HZ = 29
+
+ val ONE_S = XrealModel("XREAL 1S", Family.ONE_S, 52f)
+ val ONE = XrealModel("XREAL One", Family.ONE, 50f)
+ val ONE_PRO = XrealModel("XREAL One Pro", Family.ONE, 57f)
+ val ONE_PRO_PLUS = XrealModel("XREAL One Pro+", Family.ONE, 57f)
+ val AURA = XrealModel("XREAL Aura", Family.AURA, 70f)
+
+ // The odd product ids one below these are the glasses' recovery mode.
+ private val products = mapOf(
+ PRODUCT_1S to ONE_S,
+ 0x0438 to ONE,
+ 0x0436 to ONE_PRO,
+ 0x0444 to ONE_PRO_PLUS,
+ 0x043a to AURA,
+ )
+
+ fun model(vid: Int, pid: Int): XrealModel? = if (vid == VENDOR_ID) products[pid] else null
+ fun matches(vid: Int, pid: Int) = model(vid, pid) != null
+ fun isDisplay(name: String) = name.contains("XREAL", ignoreCase = true)
+ }
}
diff --git a/app/src/main/java/com/droiddeck/launcher/glasses/XrealOrientationFilter.kt b/app/src/main/java/com/droiddeck/launcher/glasses/XrealOrientationFilter.kt
index c10bb94735..8bf8dd30e7 100644
--- a/app/src/main/java/com/droiddeck/launcher/glasses/XrealOrientationFilter.kt
+++ b/app/src/main/java/com/droiddeck/launcher/glasses/XrealOrientationFilter.kt
@@ -2,12 +2,13 @@ package com.droiddeck.launcher.glasses
import kotlin.math.abs
-internal class XrealOrientationFilter {
+internal class XrealOrientationFilter(private val flipYz: Boolean = true) {
private val fusion = ImuFusion()
fun update(sample: XrealProtocol.Sample): FloatArray? = fusion.update(sample.timeNs,
- Vec3(sample.accel.x, -sample.accel.y, -sample.accel.z),
- Vec3(sample.gyro.x, -sample.gyro.y, -sample.gyro.z))
+ sample.accel.headAxes(), sample.gyro.headAxes())
+
+ private fun Vec3.headAxes() = if (flipYz) Vec3(x, -y, -z) else this
}
internal class ImuFusion {
diff --git a/app/src/main/java/com/droiddeck/launcher/glasses/XrealProtocol.kt b/app/src/main/java/com/droiddeck/launcher/glasses/XrealProtocol.kt
index 09bed01796..dbf6bb031e 100644
--- a/app/src/main/java/com/droiddeck/launcher/glasses/XrealProtocol.kt
+++ b/app/src/main/java/com/droiddeck/launcher/glasses/XrealProtocol.kt
@@ -13,6 +13,7 @@ internal object XrealProtocol {
const val REPORT = 0x2836
const val GET_DISPLAY = 0x275e
const val SET_DISPLAY = 0x275f
+ const val GET_INPUT = 0x2821
const val SET_INPUT = 0x2822
const val SET_BRIGHTNESS = 0x271c
const val SET_DIMMER = 0x2727
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index 70235af997..5193d6f7fd 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -3347,7 +3347,7 @@
Done
Waiting for the glasses’ USB Ethernet connection. This phone may not expose it to apps.
The XREAL connection was interrupted or returned an unsupported response. Retrying…
- Experimental 1S support. Use Follow mode and disable stabilization in the glasses menu. Tracking directions and display modes still need device testing.
+ Experimental XREAL 1S, One, One Pro, One Pro+ and Aura support. Use Follow mode and turn off stabilization in the glasses menu; on the Aura, also turn off Spatial Anchor. Head tracking and 2D/3D switching are tested on the Aura.
Experimental Pro 2 head tracking. Brightness, volume, and display switching are not supported yet.
Picture position
Top
diff --git a/app/src/test/java/com/droiddeck/launcher/glasses/Glasses3dRoutingTest.kt b/app/src/test/java/com/droiddeck/launcher/glasses/Glasses3dRoutingTest.kt
index d40441552d..9d08945cd8 100644
--- a/app/src/test/java/com/droiddeck/launcher/glasses/Glasses3dRoutingTest.kt
+++ b/app/src/test/java/com/droiddeck/launcher/glasses/Glasses3dRoutingTest.kt
@@ -30,7 +30,8 @@ class Glasses3dRoutingTest {
RayNeoModel.model(0x1bbb, 0xaf50, "RayNeo Air 4 Pro")!!,
RayNeoModel.model(0x3941, 0xaf50, "RayNeo GT")!!,
RayNeoModel.model(0x3941, 0xaf50, "RayNeo GT MAX")!!,
- XrealModel,
+ XrealModel.ONE_S,
+ XrealModel.AURA,
)
private fun field(name: String) = Glasses::class.java.getDeclaredField(name).apply { isAccessible = true }
diff --git a/app/src/test/java/com/droiddeck/launcher/glasses/GlassesUsbTest.kt b/app/src/test/java/com/droiddeck/launcher/glasses/GlassesUsbTest.kt
index 14dcf26d69..ba2d444afd 100644
--- a/app/src/test/java/com/droiddeck/launcher/glasses/GlassesUsbTest.kt
+++ b/app/src/test/java/com/droiddeck/launcher/glasses/GlassesUsbTest.kt
@@ -252,10 +252,14 @@ class GlassesUsbTest {
.apply { isAccessible = true }.invoke(Glasses, ask)
}
- @Test fun xreal1SUsesExactIdentityAndExcludesAirOneProAndRecoveryProducts() {
- assertEquals(XrealModel, Glasses.deviceModel(device(0x043e, 0x3318, "XREAL 1S")))
+ @Test fun xrealOneFamilyUsesExactIdentityAndExcludesAirAndRecoveryProducts() {
+ assertEquals(XrealModel.ONE_S, Glasses.deviceModel(device(0x043e, 0x3318, "XREAL 1S")))
+ assertEquals(XrealModel.ONE, Glasses.deviceModel(device(0x0438, 0x3318, "XREAL One")))
+ assertEquals(XrealModel.ONE_PRO, Glasses.deviceModel(device(0x0436, 0x3318, "XREAL One Pro")))
+ assertEquals(XrealModel.ONE_PRO_PLUS, Glasses.deviceModel(device(0x0444, 0x3318, "XREAL 1 Pro+")))
+ assertEquals(XrealModel.AURA, Glasses.deviceModel(device(0x043a, 0x3318, "XREAL Aura")))
assertTrue(Glasses.isGlassesDisplayName("XREAL 1S"))
- for (pid in listOf(0x043d, 0x0435, 0x0436, 0x0424, 0xffff)) {
+ for (pid in listOf(0x043d, 0x0435, 0x0437, 0x0439, 0x0443, 0x0424, 0xffff)) {
assertEquals(null, Glasses.deviceModel(device(pid, 0x3318, "XREAL 1S")))
}
assertEquals(null, Glasses.deviceModel(device(0x043e, 0x1234, "XREAL 1S")))
diff --git a/app/src/test/java/com/droiddeck/launcher/glasses/XrealOrientationFilterTest.kt b/app/src/test/java/com/droiddeck/launcher/glasses/XrealOrientationFilterTest.kt
index 4aa94d69bc..abd38d30bf 100644
--- a/app/src/test/java/com/droiddeck/launcher/glasses/XrealOrientationFilterTest.kt
+++ b/app/src/test/java/com/droiddeck/launcher/glasses/XrealOrientationFilterTest.kt
@@ -60,6 +60,12 @@ class XrealOrientationFilterTest {
}
}
+ @Test fun auraAxesAreNotFlippedLikeTheRestOfTheOneFamily() {
+ val aura = XrealOrientationFilter(flipYz = false).update(sample(1000000, accel = Vec3(0f, 9.81f, 0f)))!!
+ assertTrue(matrix(aura)[7] > 0.99f)
+ assertNull(XrealOrientationFilter(flipYz = false).update(sample(1000000, accel = Vec3(0f, 0f, 0f))))
+ }
+
@Test fun capturedNeutralGravityStartsUprightBeforeRecenter() {
val pose = XrealOrientationFilter().update(sample(1000000,
accel = Vec3(-0.0909f, -9.6529f, -1.0731f)))!!
diff --git a/app/src/test/java/com/droiddeck/launcher/glasses/XrealProtocolTest.kt b/app/src/test/java/com/droiddeck/launcher/glasses/XrealProtocolTest.kt
index c84cd7cdba..23f4f5af1c 100644
--- a/app/src/test/java/com/droiddeck/launcher/glasses/XrealProtocolTest.kt
+++ b/app/src/test/java/com/droiddeck/launcher/glasses/XrealProtocolTest.kt
@@ -69,6 +69,20 @@ class XrealProtocolTest {
assertEquals(26, output.size())
}
+ @Test fun stereoOnlyControlSwitches3dWithoutDisplayModeCommands() {
+ val output = ByteArrayOutputStream()
+ val replies = response(XrealProtocol.GET_INPUT, 1, byteArrayOf(0x22, 0)) +
+ response(XrealProtocol.SET_INPUT, 2, byteArrayOf(0x22, 0)) +
+ response(XrealProtocol.GET_INPUT, 3, byteArrayOf(0x22, 2, 0x10, 1))
+ val control = XrealControl(channels(replies.inputStream(), output), stereoOnly = true, settleDelayMs = 0)
+ assertEquals(XrealModel.NATIVE_60HZ, control.display())
+ assertEquals(5, control.changeDisplay(5))
+ val written = output.toByteArray().inputStream()
+ val commands = List(3) { XrealProtocol.read(written).command }
+ assertEquals(listOf(XrealProtocol.GET_INPUT, XrealProtocol.SET_INPUT, XrealProtocol.GET_INPUT), commands)
+ assertFalse(commands.any { it == XrealProtocol.GET_DISPLAY || it == XrealProtocol.SET_DISPLAY })
+ }
+
@Test fun unrelatedResponsesCannotKeepControlWaitingForever() {
val replies = ByteArrayOutputStream().apply { repeat(32) { write(frame(0x272e, ByteArray(8))) } }
val control = XrealControl(channels(replies.toByteArray().inputStream(), ByteArrayOutputStream()))
@@ -79,7 +93,9 @@ class XrealProtocolTest {
val reply = byteArrayOf(0x22, 2, 0x10, 0x1d)
val control = XrealControl(channels(response(0x275e, 1, reply).inputStream(), ByteArrayOutputStream()))
assertEquals(29, control.display())
- assertEquals(29, XrealModel.mode(60, false))
+ assertEquals(29, XrealModel.ONE_S.mode(60, false))
+ assertEquals(29, XrealModel.AURA.mode(120, false))
+ assertEquals(5, XrealModel.AURA.mode(60, true))
}
@Test fun stereoWaitsForEdidChangeWithoutSendingASecondModeCommandWhileBusy() {
diff --git a/docs/smart-glasses-support.md b/docs/smart-glasses-support.md
index 0446bdb34e..123c1451c7 100644
--- a/docs/smart-glasses-support.md
+++ b/docs/smart-glasses-support.md
@@ -22,11 +22,11 @@ This describes the integrations implemented in DroidDeck as of 2026-10-24. A rec
| **VITURE Luma Ultra** | SDK-dependent Carina transport | Yes | **Experimental, opt-in** | **Experimental, opt-in** |
| Recognized RayNeo / TCL Air-series devices | Integrated RayNeo USB transport | Yes, with orientation calibration controls | No | No |
| RayNeo GT-series devices matching the supported USB identity, including GT Max identification | Integrated GT USB/IMU path | Yes, with orientation calibration controls | No | No |
-| **XREAL 1S** | **Experimental**; exact USB identity plus the device's USB-Ethernet control/IMU connection | Yes, when that connection is ready | No | No |
+| **XREAL 1S, One, One Pro, One Pro+, Aura** | **Experimental**; exact USB identity plus the device's USB-Ethernet control/IMU connection. Head tracking and 2D/3D switching are tested on the Aura | Yes, when that connection is ready | No | No |
| Rokid Max / Max 2; Rokid Air under the Max USB identity | Integrated Rokid USB transport (vendor control requests and HID IMU reports) | Yes | No | No |
-| Other XREAL models; unrecognized glasses; display adapters and docks | Display-only where Android exposes a usable display; automatic glasses routing also requires display recognition | No supported app tracking connection | No | No |
+| Other XREAL models (Air family and others); unrecognized glasses; display adapters and docks | Display-only where Android exposes a usable display; automatic glasses routing also requires display recognition | No supported app tracking connection | No | No |
-RayNeo's Air-series recognition uses its known USB identity or a RayNeo/TCL Air name under the accepted vendor IDs; it is not a per-model certification list. The GT vendor path requires the specific supported product ID. Rokid recognition requires USB 04d2:162f (Max/Air) or 04d2:2002 (Max 2), plus a Rokid product name, since that vendor ID is shared with unrelated devices. Max 2 reports the USB product name "Rokid Max2". Hardware checks cover the Max and Max 2; the Air follows the same published protocol untested. XREAL support currently targets **1S only**: One, One Pro, Air-family devices, and recovery-mode products are not enabled by the 1S transport. VITURE Pro 2 is identified through SDK validation rather than a guessed product ID. A dock does not supply the connected glasses' sensors by itself.
+RayNeo's Air-series recognition uses its known USB identity or a RayNeo/TCL Air name under the accepted vendor IDs; it is not a per-model certification list. The GT vendor path requires the specific supported product ID. Rokid recognition requires USB 04d2:162f (Max/Air) or 04d2:2002 (Max 2), plus a Rokid product name, since that vendor ID is shared with unrelated devices. Max 2 reports the USB product name "Rokid Max2". Hardware checks cover the Max and Max 2; the Air follows the same published protocol untested. XREAL support targets the 1S, One, One Pro, One Pro+ and Aura by exact USB product ID; Air-family devices and recovery-mode products are not enabled by this transport. VITURE Pro 2 is identified through SDK validation rather than a guessed product ID. A dock does not supply the connected glasses' sensors by itself.
The final column refers specifically to Luma Ultra's stereo tracking cameras. DroidDeck's separate phone-camera and physical-controller features are independent of this matrix.
@@ -43,6 +43,7 @@ All display modes depend on the phone's video output, the cable/adapter, and And
| VITURE Pro 2 | 1080p per eye; 2D and SBS | Brightness and volume; no electrochromic-film control |
| RayNeo Air/GT | 2D/SBS switching; resolution and refresh follow available Android modes | Orientation calibration; no app brightness, volume, or dimming commands |
| XREAL 1S | Supported 1S display-mode commands, including native 1200p/60 Hz and SBS | Brightness and dimming toggle; no app volume command |
+| XREAL One, One Pro, One Pro+, Aura | 2D and SBS only, switched with the glasses' 3D input command; the display-mode set command is never sent (an unexpected index reboots the Aura) | No app brightness, dimming or volume commands |
| Rokid Max / Max 2 | 1080p at 60 or 120 Hz in 2D; SBS at 1080p/60, 1200p/60, or 1200p/90 | Brightness; volume follows Android's USB audio volume; no dimming film |
| Rokid Air | 1080p/60 in 2D and SBS | Brightness; volume follows Android's USB audio volume |
@@ -56,7 +57,7 @@ The pointer is left out of the picture when it cannot be drawn where the game is
## Setup and app-wide behavior
-1. Connect the glasses through a compatible video/data connection. Accept USB access when requested. For XREAL 1S, Android must also expose the glasses' USB-Ethernet network; the app leaves Steam's Internet connection on its normal network.
+1. Connect the glasses through a compatible video/data connection. Accept USB access when requested. For XREAL 1S, One, One Pro, One Pro+ and Aura, Android must also expose the glasses' USB-Ethernet network; the app leaves Steam's Internet connection on its normal network.
2. Open **Setup → Smart glasses**. Enable glasses output and **3DoF virtual screen**. This selects the tracked screen and saves the setting without forcing SBS or changing brightness.
3. Adjust screen width and distance, then recenter while looking where the screen should sit. The same settings apply when navigating DroidDeck, opening a non-Steam launcher, or entering a game/desktop session.
4. On an SDK-enabled Luma Ultra, optionally enable positional tracking and set the floor from the current eye height. Use the tracking setup and recovery controls for calibration or recentering. SteamVR startup defers Luma positional initialization until two seconds after SteamVR reports running.
@@ -85,4 +86,4 @@ If only a flat picture is available, check video output first, then the control
- [Agent diagnostics and capture commands](agent-control.md)
- [RayNeo attribution and protocol references](third-party/rayneo/README.md)
-The capability definitions are maintained in [VITURE models](../app/src/main/java/com/droiddeck/launcher/glasses/VitureProtocol.kt), [RayNeo models](../app/src/main/java/com/droiddeck/launcher/glasses/RayNeoModel.kt), [XREAL 1S](../app/src/main/java/com/droiddeck/launcher/glasses/XrealModel.kt), [Rokid](../app/src/main/java/com/droiddeck/launcher/glasses/RokidModel.kt), and [connection capability routing](../app/src/main/java/com/droiddeck/launcher/glasses/Glasses.kt). Update this matrix when those integrations change.
+The capability definitions are maintained in [VITURE models](../app/src/main/java/com/droiddeck/launcher/glasses/VitureProtocol.kt), [RayNeo models](../app/src/main/java/com/droiddeck/launcher/glasses/RayNeoModel.kt), [XREAL](../app/src/main/java/com/droiddeck/launcher/glasses/XrealModel.kt), [Rokid](../app/src/main/java/com/droiddeck/launcher/glasses/RokidModel.kt), and [connection capability routing](../app/src/main/java/com/droiddeck/launcher/glasses/Glasses.kt). Update this matrix when those integrations change.