Skip to content

Commit ff448ec

Browse files
authored
Cleanup and Update Quest Pro hardware doc page (#69)
* update warning about quest pro green crud issue * minor cleanup of MQLink instructions * removed old 'oculus' references; updated steamlink settings instructions to match steamvr 2.8 update; cleaned up section about continuous calibration * cleanup of tips and tricks section by putting them all into details modals * added quest pro dead ft page * made steamlink instructions and warning a bit clearer * hide now unnecessary info mentioning required virtual desktop version as it was mostly confusing people
1 parent 2a054a5 commit ff448ec

File tree

8 files changed

+213
-90
lines changed

8 files changed

+213
-90
lines changed
3.56 MB
Loading
463 KB
Loading
290 KB
Loading
336 KB
Loading
510 KB
Loading
5.59 KB
Loading
Lines changed: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
---
2+
sidebar_class_name: hidden
3+
description: Information about the infamous Quest Pro FT dying phenomena
4+
---
5+
6+
import {PageCard} from '@site/src/components/Cards.tsx'
7+
import {TroubleShootTable, CustomLink, TextColor} from '@site/src/components/Utils.tsx'
8+
import ReactPlayer from 'react-player'
9+
import Link from '@docusaurus/Link';
10+
import useBaseUrl from '@docusaurus/useBaseUrl';
11+
import Admonition from '@theme/Admonition';
12+
13+
# The Quest Pro's Dying Face Tracking Problem
14+
15+
The Quest Pro has a well-known failure point for its face tracking system, with numerous users who have encountered the exact same symptoms.
16+
How the story typically goes:
17+
18+
1. The eye and face tracking was working fine until it wasn't
19+
2. The eye tracking calibration on the headset works
20+
3. The eye and face tracking are nonfunctional *only* when attempting using eye and face tracking simultaneously.
21+
22+
The problem is moisture getting in the headset.
23+
Sweat and other moisture will find their way into the headset if you use the headset like a VRC user would.
24+
This is especially true if you do things like Just Dance, VR workouts, or long sessions of Beat Saber with the headset.
25+
The problem may be exacerbated if you live in a humid and warm environment.
26+
27+
An example of what your Quest Pro's front plate might look like on the inside after a fair bit of use:
28+
29+
<div style={{
30+
width: '75%',
31+
height: 'auto',
32+
margin: 'auto',
33+
display: 'block'
34+
}}>
35+
<img src={require("./img/quest/quest_pro_front_plate_sweaty.jpg").default} alt="teh_venom's Quest Pro front plate moisture example" />
36+
</div>
37+
38+
<!-- Through headset teardowns from members of the face tracking community, we have found that the cause of this problem is an oversight in the headset design. -->
39+
40+
## Issue Analysis
41+
The fundamental problem that develops is *corrosion* on the face tracking illuminator boards on the bottom of the headset.
42+
The Quest Pro has 4 boards with little IR LEDs on them that turn on when you use face tracking.
43+
The outer pair of these boards are completely exposed (not encased into the plastic frame with adhesive like the inner pair), and unfortunately placed right
44+
next to the intake vent that runs along the edge of the headset.
45+
Moisture, whether it be sweat from the lens side of the headset finding its way between the rubber flap and lens modules down to the bottom of the headset, or moisture from the user's breath / other
46+
sourcefinding its way into the headset through the intake vent, will end up condensing on the exposed solder points of the face tracking illuminator board.
47+
48+
<div style={{
49+
width: '75%',
50+
height: 'auto',
51+
margin: 'auto',
52+
display: 'block'
53+
}}>
54+
<img src={require("./img/quest/quest_pro_bottom_labeled.png").default} alt="Quest Pro FT LEDs and potential moisture ingress areas" />
55+
</div>
56+
57+
This eventually causes a green corrosion to appear on the outer LED boards, as well as other exposed metal bits in the area, such as the body of the face tracking camera.
58+
Eventually this corrosion ("green crud") causes one or some of the LEDs to fail.
59+
60+
<div style={{
61+
width: '75%',
62+
height: 'auto',
63+
margin: 'auto',
64+
display: 'block'
65+
}}>
66+
<img src={require("./img/quest/quest_pro_crud.jpg").default} alt="The Quest Pro 'Green Crud' from corrosion" />
67+
</div>
68+
69+
<div style={{
70+
width: '75%',
71+
height: 'auto',
72+
margin: 'auto',
73+
display: 'block'
74+
}}>
75+
<img src={require("./img/quest/quest_pro_crud_1.jpg").default} alt="The Quest Pro 'Green Crud' from corrosion" />
76+
</div>
77+
78+
The LEDs for face tracking ***and eye tracking*** are driven by a single, *shared* driver IC ([TLC59401](https://www.ti.com/product/TLC59401#tech-docs)).
79+
What this means is, if the user *only has eye tracking enabled*, which means the face tracking LEDs on the bottom of the headset are *not being driven*, everything will seem fine.
80+
However, when something attempts to use the face tracking, the IC detects that something is wrong (due to the corroded face tracking LED board) and effectively gets shut down,
81+
taking all the illuminators with it, eye and face.
82+
With no (or very dim) lights, the cameras for tracking your eyes and face can't see anything clearly, and tracking looks dead.
83+
84+
## Detection
85+
86+
If your Quest Pro's face tracking seems to have stopped working, you can easily verify whether or not the cause is this problem
87+
88+
1. Make sure that you can still complete eye tracking calibration
89+
2. Install the [Aura](https://www.meta.com/experiences/aura/5367350470041414/) application from the Meta Quest store
90+
3. Run Aura and test eye and face tracking with the alien flower girl head. It might take a little bit of time to start at first
91+
- If the alien girl's eyes and face are unresponsive, you most likely have corroded face tracking LEDs
92+
- If the alien girl's eyes and face are completely responsive and expressive, you probably have a VRCFT-setup related issue, and not damaged hardware
93+
4. You could also use a smartphone's camera to observe the eye and face tracking LEDs (they will show up as purple-ish dots). Run Aura as above, and take off the headset.
94+
If you notice that one or more of the LEDs on the bottom are missing (there should be 3 LEDs per outer board), then you definitely have the problem.
95+
96+
Example Quest Pro (cropped image from [evg-zhabotinsky](https://www.reddit.com/r/QuestPro/comments/12tfqzr/busted_face_tracking_kills_otherwise_working_eye/)) with dead LEDs on one side:
97+
98+
<div style={{
99+
width: '50%',
100+
height: 'auto',
101+
margin: 'auto',
102+
display: 'block'
103+
}}>
104+
<img src={require("./img/quest/quest_pro_dead_leds_example.png").default} alt="Dead face tracking LED example from evg-zhabotinsky" />
105+
</div>
106+
107+
## Repair
108+
109+
For now, refer to this [VRCFT Discord post](https://discord.com/channels/849300336128032789/1294044503832789042)
110+
111+
## Prevention
112+
113+
For now, refer to this [VRCFT Discord post](https://discord.com/channels/849300336128032789/1294044503832789042)
114+
115+
---
116+
117+
Big thanks to community members tikkaqrow, cucumberworks, [evg-zhabotinsky](https://www.reddit.com/r/QuestPro/comments/12tfqzr/busted_face_tracking_kills_otherwise_working_eye/) on Reddit, and teh_venom
118+
for their knowledge contributions to this niche issue (and pictures).

0 commit comments

Comments
 (0)