diff --git a/404.html b/404.html index 3544b5b..89b9b39 100644 --- a/404.html +++ b/404.html @@ -15,7 +15,7 @@
Skip to content

404

PAGE NOT FOUND

But if you don't change your direction, and if you keep looking, you may end up where you are heading.

Released under the MIT License.

- + \ No newline at end of file diff --git a/about.html b/about.html index 79d0a00..368af07 100644 --- a/about.html +++ b/about.html @@ -18,7 +18,7 @@
Skip to content

Our Team

The development of EyeTrackVR is guided by an international team, some of whom have chosen to be featured below.

EyeTrackVR developers are a group of people who are passionate about the field of augmented and virtual reality.

Prohurtz

Prohurtz

Creator / Lead Software Developer / Documentor / Hardware Developer

Summer

Summer

Machine Learning Engineer / Data Scientist / App Developer

lorow

lorow

Lead Firmware Developer / App Developer

DaOfficialWizard

DaOfficialWizard

Firmware Developer / Documentation Manager / App Developer

Contributors

Those who have actively contributed to development.
Community Support

Philosophy

The guides on this website include some of our team's own notes (not all of them are polished) that we disclose for other people to use.

Here, we hope you may find something useful to you.

We advocate the Open Source model.

This is why we strive to make our work open to other people for consultation, replication and reuse.

Released under the MIT License.

- + \ No newline at end of file diff --git a/archive/fox_ir_v2_build_instructions.html b/archive/fox_ir_v2_build_instructions.html index da4c815..4e23701 100644 --- a/archive/fox_ir_v2_build_instructions.html +++ b/archive/fox_ir_v2_build_instructions.html @@ -19,7 +19,7 @@
Skip to content

Fox IR V2 Buil dInstructions

Step 15: Prepare to solder IR LED PCB V2s

Get your magnifying glass out, it's time to solder very smol things.

Gather 4 PCBs, 4 IR LEDs, and 2 ~700ohm resistors.

'img'

698ohm resistors and V2 PCBs

Here are the PCB pin-out labels:

'img'

V2

LED labels:

'img'

The green markings and notched corners mark the positive sides of the LEDs pictured above.

If you have different LEDs, please consult their datasheet.

Some terminology related to them:

5V: 5-volt power in.

GND: Ground or power out.

AR: After-Resistor this is to be used as the power in on the 2nd PCB in series as resistors are not needed on the 2nd PCB since they are on the 1st one.

SNG: Single resistor, use this as 5V in if you are using only 1 ~700ohm resistor on V3 boards (not recommended).

Negative: This marks the negative side of the LED.

Positive: This marks the positive side of the LED.

Step 17: Solder resistors on PCB V2

You only need 1 PCB to have a resistor per eye.

'img'

Tin the resistor pads.

'img'

Hold the resistor in place.

'img'

Solder one end.

'img'

Flip to the other side of the resistor and solder it.

'img'

Solder LEDs on PCB V2

'img'

Tin the pads

'img'

Place the resistor on the pads in the correct orientation.

'img'

Solder each side of the resistor. Be careful not to solder at too high of a temp, recommended soldering temp is 230C with a max of 245C.

'img'

The LED is flipped in this Image, the green dot should face AWAY from the PCB.

Wire up the PCBs V2

Basic full wiring diagram of IR PCBs V2.

'drawing'

The PCB that receives the 5V power is the one with the resistor. The second one, which gets its power from the ground pin of the first, does not have a resistor on it and its power input pin is the AR pin (After-Resistor). The 2nd PCBs ground pin goes to the ground of the system, in the diagram it is the ESPs ground pin.

Released under the MIT License.

- + \ No newline at end of file diff --git a/assets/how_to_build_part_list.md.3f326f04.js b/assets/how_to_build_part_list.md.a401e11d.js similarity index 73% rename from assets/how_to_build_part_list.md.3f326f04.js rename to assets/how_to_build_part_list.md.a401e11d.js index 0982093..90e4664 100644 --- a/assets/how_to_build_part_list.md.3f326f04.js +++ b/assets/how_to_build_part_list.md.a401e11d.js @@ -1 +1 @@ -import{_ as w,o as a,c as r,k as e,F as d,D as m,t as i,a1 as A,a2 as f,p as _,m as C,H as k,a as p,Q as y}from"./chunks/framework.0394bef4.js";const b={data(){return{tracker:2,components:[{name:"ESP Microcontroller",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:1.85,costAll:()=>this.tracker*0,links:"If you already have a supported camera capable ESP32 or sourced elsewhere."},{name:"Seeed Studio XIAO Sense ESP32-S3",amount:()=>this.tracker,cost:12.87,costAll:()=>this.tracker*12.87+3.18,links:'AliExpress XIAO Sense Recommended'},{name:"ESP32-CAM",amount:()=>this.tracker,cost:12.87,costAll:()=>this.tracker*4.69+3.18,links:'AliExpress ESP32 CAM Requires additional programmer'},{name:"FREENOVE ESP32-S3-WROOM",amount:()=>this.tracker,cost:19.95,costAll:()=>this.tracker*19.95,links:'Amazon Large, more expensive than XIAO'}],selectedChoice:1},{name:"Camera",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you already have a supported camera or sourced elsewhere."},{name:"130 Degree NO-IR",amount:()=>this.tracker,cost:5.41,costAll:()=>this.tracker*5.41,links:'AliExpress Select "Color: 75MM-130 Degree" Must manually remove IR filter'},{name:"160 Degree IR",amount:()=>this.tracker,cost:4.26,costAll:()=>this.tracker*4.26,links:'AliExpress Select "Color: 75MM-160 850nm"'}],selectedChoice:1},{name:"IR LEDs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:'IR LED Safety If you already have safe IR LED hardware and know what you are doing.'},{name:"Official V4 mini Solder-less Kit",amount:()=>1,cost:28,costAll:()=>this.tracker+28+3,links:'ETVR Store Length depending on HMD'},{name:"Official V4 mini Bring Your Own Wires Kit",amount:()=>1,cost:24,costAll:()=>this.tracker+24+3,links:'ETVR Store Must solder up your own wires'},{name:"Official V4 lite Assemble Yourself",amount:()=>1,cost:7,costAll:()=>this.tracker+7+3,links:'ETVR Store Must assemble yourself'}],selectedChoice:2},{name:"USB Hub",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you already have safe IR LED hardware and know what you are doing."},{name:"4 port USB 3.2 LDLrui (MTT Usually)",amount:()=>1,cost:17.99,costAll:()=>this.tracker+17.99,links:'Amazon Usually these are MTT, but sometimes not'},{name:"4 port USB 3.2 Sitecom CN-385 Hub (MTT)",amount:()=>1,cost:40.53,costAll:()=>this.tracker+17.99,links:'Amazon Known good MTT hub, but expensive'},{name:"4 port USB 2.0 Breakout (Not MTT)",amount:()=>1,cost:1.41,costAll:()=>this.tracker+1.41+1.99,links:'AliExpress Small but non MTT hub breakout'},{name:"3 port USB 3.0 Hub With Power Passthrough (MTT)",amount:()=>1,cost:17.99,costAll:()=>this.tracker+1.41,links:'Amazon Great for Quest due to power passthrough'}],selectedChoice:1},{name:"3D Printed Mounts",choices:[{name:"Print Yourself",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you have a 3d printer or have access to one somewhere."},{name:"JLCPCB Print Service, JLC3DP",amount:()=>this.tracker,cost:2,costAll:()=>this.tracker*2+5,links:'JLC3DP '}],selectedChoice:0}],total:0}},methods:{updatePrices(){let s=0;this.components.forEach(o=>{if(o.choices.length>1){const c=o.choices[o.selectedChoice];s+=c.costAll(this.tracker)}}),this.total=s},switchSelect(s,o){this.$set(o,"selectedChoice",s.target.value),this.updatePrices()}},mounted(){this.updatePrices()}},g=s=>(_("data-v-b5690fe3"),s=s(),C(),s),E=g(()=>e("thead",null,[e("tr",null,[e("th",null,"Component"),e("th",null,"Choice"),e("th",null,"Amount"),e("th",null,"Cost"),e("th",null,"Cost All"),e("th",null,"Links")])],-1)),v=["onUpdate:modelValue","onChange"],x=["value"],B={key:1},P=["innerHTML"];function T(s,o,c,S,n,u){return a(),r("div",null,[e("table",null,[E,e("tbody",null,[(a(!0),r(d,null,m(n.components,t=>(a(),r("tr",{key:t.name},[e("th",null,i(t.name),1),e("td",null,[t.choices.length>1?A((a(),r("select",{key:0,"onUpdate:modelValue":l=>t.selectedChoice=l,onChange:l=>u.switchSelect(l,t)},[(a(!0),r(d,null,m(t.choices,(l,h)=>(a(),r("option",{key:h,value:h},i(l.name),9,x))),128))],40,v)),[[f,t.selectedChoice]]):(a(),r("span",B,i(t.choices[0].name),1))]),e("td",null,i(t.selectedChoice?t.choices[t.selectedChoice].amount(n.tracker):0),1),e("td",null,i(t.selectedChoice?"$"+t.choices[t.selectedChoice].cost:0),1),e("td",null,i(t.selectedChoice?"~$"+t.choices[t.selectedChoice].costAll(n.tracker)*100/100:0),1),e("td",{innerHTML:t.selectedChoice?t.choices[t.selectedChoice].links:""},null,8,P)]))),128))])]),e("p",null,"Total: $"+i(n.total.toFixed(2)),1)])}const O=w(b,[["render",T],["__scopeId","data-v-b5690fe3"]]);const I={data(){return{tracker:2,components:[{name:"Type A USB Breakout",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:1.85,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"Type A USB Breakout Bare (AliExpress)",amount:()=>1,cost:1.18,costAll:()=>this.tracker+1.18,links:'AliExpress'},{name:"Type A USB Breakout Bare (Amazon)",amount:()=>1,cost:6.49,costAll:()=>this.tracker+5.49,links:'Amazon'},{name:"Type A USB Breakout With Cover (AliExpress)",amount:()=>1,cost:2.2,costAll:()=>this.tracker+1.2+1.99,links:'AliExpress'},{name:"Type A USB Breakout With Wire and Cover (Amazon)",amount:()=>1,cost:9.6,costAll:()=>this.tracker+8.6,links:'Amazon'}],selectedChoice:0},{name:"USB-C Breakout",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress Male & Female",amount:()=>1,cost:1.19,costAll:()=>this.tracker+1.19+1.37,links:'AliExpress Choose: "Color: 5Set".'},{name:"AliExpress Vertical Male",amount:()=>1,cost:2.37,costAll:()=>this.tracker+.37+1.99,links:'AliExpress'}],selectedChoice:0},{name:"Wire for ESPs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need wire or already have."},{name:"Silicone Wire Kit",amount:()=>1,cost:5.96,costAll:()=>this.tracker+5.96+.99,links:'AliExpress 30 AWG or lower'},{name:"Generic Wire",amount:()=>1,cost:.7,costAll:()=>this.tracker+.7+1.24,links:'AliExpress Select "Specification: 30 AWG or lower"'}],selectedChoice:0},{name:"Wire for LEDs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need wire or already have."},{name:"Silicone Wire Kit",amount:()=>1,cost:5.96,costAll:()=>this.tracker+5.96+.99,links:'AliExpress 30 AWG or higher'},{name:"Generic Wire",amount:()=>1,cost:.7,costAll:()=>this.tracker+.7+1.24,links:'AliExpress Select "Specification: 30 AWG or higher"'}],selectedChoice:0},{name:"Camera Extension Cables",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress 24pin 0.5mm Pitch",amount:()=>1,cost:1.33,costAll:()=>this.tracker+.33+1.99,links:'AliExpress Choose: "Insert Type: 24p 0.5mm pitch" and Type A. Length depends on HMD, usually 150mm or 200mm.'},{name:"Adafruit 24 pin 0.5mm pitch",amount:()=>this.tracker,cost:1.35,costAll:()=>this.tracker*1.35+6,links:'Adafruit 250mm'}],selectedChoice:0},{name:"Camera Extension Connectors",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress 24 pin",amount:()=>1,cost:1.32,costAll:()=>this.tracker+.32+1.99,links:'AliExpress Choose: "Pins: 24P".'},{name:"Adafruit 24 pin",amount:()=>this.tracker,cost:.86,costAll:()=>this.tracker*.865+6,links:'Adafruit'}],selectedChoice:0},{name:"External Antennas",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress Small",amount:()=>1,cost:.16,costAll:()=>this.tracker*.16+3.48,links:'AliExpress Choose: "Color: 2.4G Antenna".'},{name:"Amazon Large",amount:()=>1,cost:9.99,costAll:()=>this.tracker+7.99,links:'Amazon'}],selectedChoice:0},{name:"USB-C Cables",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"Short USB-C to USB-C Amazon",amount:()=>1,cost:6.29,costAll:()=>this.tracker+5.29,links:'Amazon'},{name:"Short USB-A to USB-C Amazon",amount:()=>1,cost:7.99,costAll:()=>this.tracker+5.99,links:'Amazon'}],selectedChoice:0},{name:"V4 LED Wire Extensions/Replacements",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"110mm Extension/Replacement",amount:()=>1,cost:1.5,costAll:()=>this.tracker+1.5+5,links:'ETVR Store'},{name:"200mm Extension/Replacement",amount:()=>1,cost:1.5,costAll:()=>this.tracker+1.5+5,links:'ETVR Store'}],selectedChoice:0}],total:0}},methods:{updatePrices(){let s=0;this.components.forEach(o=>{if(o.choices.length>1){const c=o.choices[o.selectedChoice];s+=c.costAll()}}),this.total=s}},mounted(){this.updatePrices()}},M=s=>(_("data-v-c404ea88"),s=s(),C(),s),D=M(()=>e("thead",null,[e("tr",null,[e("th",null,"Component"),e("th",null,"Choice"),e("th",null,"Amount"),e("th",null,"Cost"),e("th",null,"Cost All"),e("th",null,"Links")])],-1)),R=["onUpdate:modelValue"],W=["value"],V={key:1},U=["innerHTML"];function z(s,o,c,S,n,u){return a(),r("div",null,[e("table",null,[D,e("tbody",null,[(a(!0),r(d,null,m(n.components,t=>(a(),r("tr",{key:t.name},[e("th",null,i(t.name),1),e("td",null,[t.choices.length>1?A((a(),r("select",{key:0,"onUpdate:modelValue":l=>t.selectedChoice=l,onChange:o[0]||(o[0]=(...l)=>u.updatePrices&&u.updatePrices(...l))},[(a(!0),r(d,null,m(t.choices,(l,h)=>(a(),r("option",{key:h,value:h},i(l.name),9,W))),128))],40,R)),[[f,t.selectedChoice]]):(a(),r("span",V,i(t.choices[0].name),1))]),e("td",null,i(t.selectedChoice?t.choices[t.selectedChoice].amount(n.tracker):0),1),e("td",null,i(t.selectedChoice?"$"+t.choices[t.selectedChoice].cost:0),1),e("td",null,i(t.selectedChoice?"~$"+t.choices[t.selectedChoice].costAll(n.tracker)*100/100:0),1),e("td",{innerHTML:t.selectedChoice?t.choices[t.selectedChoice].links:""},null,8,U)]))),128))])]),e("p",null,"Total: $"+i(n.total.toFixed(2)),1)])}const L=w(I,[["render",z],["__scopeId","data-v-c404ea88"]]),q=e("p",null,"WIP new parts list. 3D printed parts will live on their own page.",-1),N=e("p",null,[p("Use the "),e("strong",null,"interactive"),p(" tables below to select parts!")],-1),F=e("h1",{id:"required-parts",tabindex:"-1"},[p("Required Parts: "),e("a",{class:"header-anchor",href:"#required-parts","aria-label":'Permalink to "Required Parts:"'},"​")],-1),$=e("h1",{id:"additional-parts",tabindex:"-1"},[p("Additional Parts: "),e("a",{class:"header-anchor",href:"#additional-parts","aria-label":'Permalink to "Additional Parts:"'},"​")],-1),Y=y('

Table adjusted from the table on SlimeVR's Docs which was created by Carl

ESP setup options:

DANGER

There are two primary categories of trackers supported: wireless and wired. It's super important that you really look at all your options and consider your use case before making a decision.

Option 1: Wireless over WiFi 2.4 GHz

Wireless Capable ESPs:

This offers a good starting point as the ESP32 CAM boards are cheaper than wired capable trackers. However, they can be a bit more temperamental and if you are using a wired headset, they don't really make sense.

Pros:

Cons:

Option 2: Wired over USB Serial (in beta)

Wired Capable ESPs:

This is our latest setup recommended for users with wired headsets such as the Valve Index.

Pros:

Cons:

',19),K=JSON.parse('{"title":"Required Parts:","description":"","frontmatter":{},"headers":[],"relativePath":"how_to_build/part_list.md","filePath":"how_to_build/part_list.md","lastUpdated":1710897358000}'),H={name:"how_to_build/part_list.md"},Q=Object.assign(H,{setup(s){return(o,c)=>(a(),r("div",null,[q,N,F,k(O),$,k(L),Y]))}});export{K as __pageData,Q as default}; +import{_ as w,o as a,c as r,k as e,F as d,D as m,t as i,a1 as A,a2 as f,p as _,m as C,H as k,a as p,Q as y}from"./chunks/framework.0394bef4.js";const b={data(){return{tracker:2,components:[{name:"ESP Microcontroller",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:1.85,costAll:()=>this.tracker*0,links:"If you already have a supported camera capable ESP32 or sourced elsewhere."},{name:"Seeed Studio XIAO Sense ESP32-S3",amount:()=>this.tracker,cost:12.87,costAll:()=>this.tracker*12.87+3.18,links:'AliExpress XIAO Sense Recommended'},{name:"ESP32-CAM",amount:()=>this.tracker,cost:12.87,costAll:()=>this.tracker*4.69+3.18,links:'AliExpress ESP32 CAM Requires additional programmer'},{name:"FREENOVE ESP32-S3-WROOM",amount:()=>this.tracker,cost:19.95,costAll:()=>this.tracker*19.95,links:'Amazon Large, more expensive than XIAO'}],selectedChoice:1},{name:"Camera",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you already have a supported camera or sourced elsewhere."},{name:"130 Degree NO-IR",amount:()=>this.tracker,cost:5.41,costAll:()=>this.tracker*5.41,links:'AliExpress Select "Color: 75MM-130 Degree" Must manually remove IR filter'},{name:"160 Degree IR",amount:()=>this.tracker,cost:4.26,costAll:()=>this.tracker*4.26,links:'AliExpress Select "Color: 75MM-160 850nm"'}],selectedChoice:1},{name:"IR LEDs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:'IR LED Safety If you already have safe IR LED hardware and know what you are doing.'},{name:"Official V4 mini Solder-less Kit",amount:()=>1,cost:28,costAll:()=>this.tracker+28+3,links:'ETVR Store Length depending on HMD'},{name:"Official V4 mini Bring Your Own Wires Kit",amount:()=>1,cost:24,costAll:()=>this.tracker+24+3,links:'ETVR Store Must solder up your own wires'},{name:"Official V4 lite Assemble Yourself",amount:()=>1,cost:7,costAll:()=>this.tracker+7+3,links:'ETVR Store Must assemble yourself'}],selectedChoice:2},{name:"USB Hub",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you already have safe IR LED hardware and know what you are doing."},{name:"4 port USB 3.2 LDLrui (MTT Usually)",amount:()=>1,cost:17.99,costAll:()=>this.tracker+17.99,links:'Amazon Usually these are MTT, but sometimes not'},{name:"4 port USB 3.2 Sitecom CN-385 Hub (MTT)",amount:()=>1,cost:40.53,costAll:()=>this.tracker+17.99,links:'Amazon Known good MTT hub, but expensive'},{name:"4 port USB 2.0 Breakout (Not MTT)",amount:()=>1,cost:1.41,costAll:()=>this.tracker+1.41+1.99,links:'AliExpress Small but non MTT hub breakout'},{name:"3 port USB 3.0 Hub With Power Passthrough (MTT)",amount:()=>1,cost:17.99,costAll:()=>this.tracker+1.41,links:'Amazon Great for Quest due to power passthrough'}],selectedChoice:1},{name:"3D Printed Mounts",choices:[{name:"Print Yourself",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you have a 3d printer or have access to one somewhere."},{name:"JLCPCB Print Service, JLC3DP",amount:()=>this.tracker,cost:2,costAll:()=>this.tracker*2+5,links:'JLC3DP '}],selectedChoice:0}],total:0}},methods:{updatePrices(){let s=0;this.components.forEach(o=>{if(o.choices.length>1){const c=o.choices[o.selectedChoice];s+=c.costAll(this.tracker)}}),this.total=s},switchSelect(s,o){this.$set(o,"selectedChoice",s.target.value),this.updatePrices()}},mounted(){this.updatePrices()}},g=s=>(_("data-v-b5690fe3"),s=s(),C(),s),E=g(()=>e("thead",null,[e("tr",null,[e("th",null,"Component"),e("th",null,"Choice"),e("th",null,"Amount"),e("th",null,"Cost"),e("th",null,"Cost All"),e("th",null,"Links")])],-1)),v=["onUpdate:modelValue","onChange"],x=["value"],B={key:1},P=["innerHTML"];function T(s,o,c,S,n,u){return a(),r("div",null,[e("table",null,[E,e("tbody",null,[(a(!0),r(d,null,m(n.components,t=>(a(),r("tr",{key:t.name},[e("th",null,i(t.name),1),e("td",null,[t.choices.length>1?A((a(),r("select",{key:0,"onUpdate:modelValue":l=>t.selectedChoice=l,onChange:l=>u.switchSelect(l,t)},[(a(!0),r(d,null,m(t.choices,(l,h)=>(a(),r("option",{key:h,value:h},i(l.name),9,x))),128))],40,v)),[[f,t.selectedChoice]]):(a(),r("span",B,i(t.choices[0].name),1))]),e("td",null,i(t.selectedChoice?t.choices[t.selectedChoice].amount(n.tracker):0),1),e("td",null,i(t.selectedChoice?"$"+t.choices[t.selectedChoice].cost:0),1),e("td",null,i(t.selectedChoice?"~$"+t.choices[t.selectedChoice].costAll(n.tracker)*100/100:0),1),e("td",{innerHTML:t.selectedChoice?t.choices[t.selectedChoice].links:""},null,8,P)]))),128))])]),e("p",null,"Total: $"+i(n.total.toFixed(2)),1)])}const O=w(b,[["render",T],["__scopeId","data-v-b5690fe3"]]);const I={data(){return{tracker:2,components:[{name:"Type A USB Breakout",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:1.85,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"Type A USB Breakout Bare (AliExpress)",amount:()=>1,cost:1.18,costAll:()=>this.tracker+1.18,links:'AliExpress'},{name:"Type A USB Breakout Bare (Amazon)",amount:()=>1,cost:6.49,costAll:()=>this.tracker+5.49,links:'Amazon'},{name:"Type A USB Breakout With Cover (AliExpress)",amount:()=>1,cost:2.2,costAll:()=>this.tracker+1.2+1.99,links:'AliExpress'},{name:"Type A USB Breakout With Wire and Cover (Amazon)",amount:()=>1,cost:9.6,costAll:()=>this.tracker+8.6,links:'Amazon'}],selectedChoice:0},{name:"USB-C Breakout",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress Male & Female",amount:()=>1,cost:1.19,costAll:()=>this.tracker+1.19+1.37,links:'AliExpress Choose: "Color: 5Set".'},{name:"AliExpress Vertical Male",amount:()=>1,cost:2.37,costAll:()=>this.tracker+.37+1.99,links:'AliExpress'}],selectedChoice:0},{name:"Wire for ESPs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need wire or already have."},{name:"Silicone Wire Kit",amount:()=>1,cost:5.96,costAll:()=>this.tracker+5.96+.99,links:'AliExpress 30 AWG or lower'},{name:"Generic Wire",amount:()=>1,cost:.7,costAll:()=>this.tracker+.7+1.24,links:'AliExpress Select "Specification: 30 AWG or lower"'}],selectedChoice:0},{name:"Wire for LEDs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need wire or already have."},{name:"Silicone Wire Kit",amount:()=>1,cost:5.96,costAll:()=>this.tracker+5.96+.99,links:'AliExpress 30 AWG or higher'},{name:"Generic Wire",amount:()=>1,cost:.7,costAll:()=>this.tracker+.7+1.24,links:'AliExpress Select "Specification: 30 AWG or higher"'}],selectedChoice:0},{name:"Camera Extension Cables",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress 24pin 0.5mm Pitch",amount:()=>1,cost:1.33,costAll:()=>this.tracker+.33+1.99,links:'AliExpress Choose: "Insert Type: 24p 0.5mm pitch" and Type A. Length depends on HMD, usually 150mm or 200mm.'},{name:"Adafruit 24 pin 0.5mm pitch",amount:()=>this.tracker,cost:1.35,costAll:()=>this.tracker*1.35+6,links:'Adafruit 250mm'}],selectedChoice:0},{name:"Camera Extension Connectors",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress 24 pin",amount:()=>1,cost:1.32,costAll:()=>this.tracker+.32+1.99,links:'AliExpress Choose: "Pins: 24P".'},{name:"Adafruit 24 pin",amount:()=>this.tracker,cost:.86,costAll:()=>this.tracker*.865+6,links:'Adafruit'}],selectedChoice:0},{name:"External Antennas",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress Small",amount:()=>1,cost:.16,costAll:()=>this.tracker*.16+3.48,links:'AliExpress Choose: "Color: 2.4G Antenna".'},{name:"Amazon Large",amount:()=>1,cost:9.99,costAll:()=>this.tracker+7.99,links:'Amazon'}],selectedChoice:0},{name:"USB-C Cables",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"Short USB-C to USB-C Amazon",amount:()=>1,cost:6.29,costAll:()=>this.tracker+5.29,links:'Amazon'},{name:"Short USB-A to USB-C Amazon",amount:()=>1,cost:7.99,costAll:()=>this.tracker+5.99,links:'Amazon'}],selectedChoice:0},{name:"V4 LED Wire Extensions/Replacements",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"110mm Extension/Replacement",amount:()=>1,cost:1.5,costAll:()=>this.tracker+1.5+5,links:'ETVR Store'},{name:"200mm Extension/Replacement",amount:()=>1,cost:1.5,costAll:()=>this.tracker+1.5+5,links:'ETVR Store'}],selectedChoice:0}],total:0}},methods:{updatePrices(){let s=0;this.components.forEach(o=>{if(o.choices.length>1){const c=o.choices[o.selectedChoice];s+=c.costAll()}}),this.total=s}},mounted(){this.updatePrices()}},M=s=>(_("data-v-9ca22bca"),s=s(),C(),s),D=M(()=>e("thead",null,[e("tr",null,[e("th",null,"Component"),e("th",null,"Choice"),e("th",null,"Amount"),e("th",null,"Cost"),e("th",null,"Cost All"),e("th",null,"Links")])],-1)),R=["onUpdate:modelValue"],W=["value"],V={key:1},U=["innerHTML"];function z(s,o,c,S,n,u){return a(),r("div",null,[e("table",null,[D,e("tbody",null,[(a(!0),r(d,null,m(n.components,t=>(a(),r("tr",{key:t.name},[e("th",null,i(t.name),1),e("td",null,[t.choices.length>1?A((a(),r("select",{key:0,"onUpdate:modelValue":l=>t.selectedChoice=l,onChange:o[0]||(o[0]=(...l)=>u.updatePrices&&u.updatePrices(...l))},[(a(!0),r(d,null,m(t.choices,(l,h)=>(a(),r("option",{key:h,value:h},i(l.name),9,W))),128))],40,R)),[[f,t.selectedChoice]]):(a(),r("span",V,i(t.choices[0].name),1))]),e("td",null,i(t.selectedChoice?t.choices[t.selectedChoice].amount(n.tracker):0),1),e("td",null,i(t.selectedChoice?"$"+t.choices[t.selectedChoice].cost.toFixed(2):0),1),e("td",null,i(t.selectedChoice?"~$"+t.choices[t.selectedChoice].costAll(n.tracker).toFixed(2):0),1),e("td",{innerHTML:t.selectedChoice?t.choices[t.selectedChoice].links:""},null,8,U)]))),128))])]),e("p",null,"Total: $"+i(n.total.toFixed(2)),1)])}const L=w(I,[["render",z],["__scopeId","data-v-9ca22bca"]]),q=e("p",null,"WIP new parts list. 3D printed parts will live on their own page.",-1),F=e("p",null,[p("Use the "),e("strong",null,"interactive"),p(" tables below to select parts!")],-1),N=e("h1",{id:"required-parts",tabindex:"-1"},[p("Required Parts: "),e("a",{class:"header-anchor",href:"#required-parts","aria-label":'Permalink to "Required Parts:"'},"​")],-1),$=e("h1",{id:"additional-parts",tabindex:"-1"},[p("Additional Parts: "),e("a",{class:"header-anchor",href:"#additional-parts","aria-label":'Permalink to "Additional Parts:"'},"​")],-1),Y=y('

Table adjusted from the table on SlimeVR's Docs which was created by Carl

ESP setup options:

DANGER

There are two primary categories of trackers supported: wireless and wired. It's super important that you really look at all your options and consider your use case before making a decision.

Option 1: Wireless over WiFi 2.4 GHz

Wireless Capable ESPs:

This offers a good starting point as the ESP32 CAM boards are cheaper than wired capable trackers. However, they can be a bit more temperamental and if you are using a wired headset, they don't really make sense.

Pros:

Cons:

Option 2: Wired over USB Serial (in beta)

Wired Capable ESPs:

This is our latest setup recommended for users with wired headsets such as the Valve Index.

Pros:

Cons:

',19),K=JSON.parse('{"title":"Required Parts:","description":"","frontmatter":{},"headers":[],"relativePath":"how_to_build/part_list.md","filePath":"how_to_build/part_list.md","lastUpdated":1710897358000}'),H={name:"how_to_build/part_list.md"},Q=Object.assign(H,{setup(s){return(o,c)=>(a(),r("div",null,[q,F,N,k(O),$,k(L),Y]))}});export{K as __pageData,Q as default}; diff --git a/assets/how_to_build_part_list.md.3f326f04.lean.js b/assets/how_to_build_part_list.md.a401e11d.lean.js similarity index 90% rename from assets/how_to_build_part_list.md.3f326f04.lean.js rename to assets/how_to_build_part_list.md.a401e11d.lean.js index c9020e3..1f137e1 100644 --- a/assets/how_to_build_part_list.md.3f326f04.lean.js +++ b/assets/how_to_build_part_list.md.a401e11d.lean.js @@ -1 +1 @@ -import{_ as w,o as a,c as r,k as e,F as d,D as m,t as i,a1 as A,a2 as f,p as _,m as C,H as k,a as p,Q as y}from"./chunks/framework.0394bef4.js";const b={data(){return{tracker:2,components:[{name:"ESP Microcontroller",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:1.85,costAll:()=>this.tracker*0,links:"If you already have a supported camera capable ESP32 or sourced elsewhere."},{name:"Seeed Studio XIAO Sense ESP32-S3",amount:()=>this.tracker,cost:12.87,costAll:()=>this.tracker*12.87+3.18,links:'AliExpress XIAO Sense Recommended'},{name:"ESP32-CAM",amount:()=>this.tracker,cost:12.87,costAll:()=>this.tracker*4.69+3.18,links:'AliExpress ESP32 CAM Requires additional programmer'},{name:"FREENOVE ESP32-S3-WROOM",amount:()=>this.tracker,cost:19.95,costAll:()=>this.tracker*19.95,links:'Amazon Large, more expensive than XIAO'}],selectedChoice:1},{name:"Camera",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you already have a supported camera or sourced elsewhere."},{name:"130 Degree NO-IR",amount:()=>this.tracker,cost:5.41,costAll:()=>this.tracker*5.41,links:'AliExpress Select "Color: 75MM-130 Degree" Must manually remove IR filter'},{name:"160 Degree IR",amount:()=>this.tracker,cost:4.26,costAll:()=>this.tracker*4.26,links:'AliExpress Select "Color: 75MM-160 850nm"'}],selectedChoice:1},{name:"IR LEDs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:'IR LED Safety If you already have safe IR LED hardware and know what you are doing.'},{name:"Official V4 mini Solder-less Kit",amount:()=>1,cost:28,costAll:()=>this.tracker+28+3,links:'ETVR Store Length depending on HMD'},{name:"Official V4 mini Bring Your Own Wires Kit",amount:()=>1,cost:24,costAll:()=>this.tracker+24+3,links:'ETVR Store Must solder up your own wires'},{name:"Official V4 lite Assemble Yourself",amount:()=>1,cost:7,costAll:()=>this.tracker+7+3,links:'ETVR Store Must assemble yourself'}],selectedChoice:2},{name:"USB Hub",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you already have safe IR LED hardware and know what you are doing."},{name:"4 port USB 3.2 LDLrui (MTT Usually)",amount:()=>1,cost:17.99,costAll:()=>this.tracker+17.99,links:'Amazon Usually these are MTT, but sometimes not'},{name:"4 port USB 3.2 Sitecom CN-385 Hub (MTT)",amount:()=>1,cost:40.53,costAll:()=>this.tracker+17.99,links:'Amazon Known good MTT hub, but expensive'},{name:"4 port USB 2.0 Breakout (Not MTT)",amount:()=>1,cost:1.41,costAll:()=>this.tracker+1.41+1.99,links:'AliExpress Small but non MTT hub breakout'},{name:"3 port USB 3.0 Hub With Power Passthrough (MTT)",amount:()=>1,cost:17.99,costAll:()=>this.tracker+1.41,links:'Amazon Great for Quest due to power passthrough'}],selectedChoice:1},{name:"3D Printed Mounts",choices:[{name:"Print Yourself",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you have a 3d printer or have access to one somewhere."},{name:"JLCPCB Print Service, JLC3DP",amount:()=>this.tracker,cost:2,costAll:()=>this.tracker*2+5,links:'JLC3DP '}],selectedChoice:0}],total:0}},methods:{updatePrices(){let s=0;this.components.forEach(o=>{if(o.choices.length>1){const c=o.choices[o.selectedChoice];s+=c.costAll(this.tracker)}}),this.total=s},switchSelect(s,o){this.$set(o,"selectedChoice",s.target.value),this.updatePrices()}},mounted(){this.updatePrices()}},g=s=>(_("data-v-b5690fe3"),s=s(),C(),s),E=g(()=>e("thead",null,[e("tr",null,[e("th",null,"Component"),e("th",null,"Choice"),e("th",null,"Amount"),e("th",null,"Cost"),e("th",null,"Cost All"),e("th",null,"Links")])],-1)),v=["onUpdate:modelValue","onChange"],x=["value"],B={key:1},P=["innerHTML"];function T(s,o,c,S,n,u){return a(),r("div",null,[e("table",null,[E,e("tbody",null,[(a(!0),r(d,null,m(n.components,t=>(a(),r("tr",{key:t.name},[e("th",null,i(t.name),1),e("td",null,[t.choices.length>1?A((a(),r("select",{key:0,"onUpdate:modelValue":l=>t.selectedChoice=l,onChange:l=>u.switchSelect(l,t)},[(a(!0),r(d,null,m(t.choices,(l,h)=>(a(),r("option",{key:h,value:h},i(l.name),9,x))),128))],40,v)),[[f,t.selectedChoice]]):(a(),r("span",B,i(t.choices[0].name),1))]),e("td",null,i(t.selectedChoice?t.choices[t.selectedChoice].amount(n.tracker):0),1),e("td",null,i(t.selectedChoice?"$"+t.choices[t.selectedChoice].cost:0),1),e("td",null,i(t.selectedChoice?"~$"+t.choices[t.selectedChoice].costAll(n.tracker)*100/100:0),1),e("td",{innerHTML:t.selectedChoice?t.choices[t.selectedChoice].links:""},null,8,P)]))),128))])]),e("p",null,"Total: $"+i(n.total.toFixed(2)),1)])}const O=w(b,[["render",T],["__scopeId","data-v-b5690fe3"]]);const I={data(){return{tracker:2,components:[{name:"Type A USB Breakout",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:1.85,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"Type A USB Breakout Bare (AliExpress)",amount:()=>1,cost:1.18,costAll:()=>this.tracker+1.18,links:'AliExpress'},{name:"Type A USB Breakout Bare (Amazon)",amount:()=>1,cost:6.49,costAll:()=>this.tracker+5.49,links:'Amazon'},{name:"Type A USB Breakout With Cover (AliExpress)",amount:()=>1,cost:2.2,costAll:()=>this.tracker+1.2+1.99,links:'AliExpress'},{name:"Type A USB Breakout With Wire and Cover (Amazon)",amount:()=>1,cost:9.6,costAll:()=>this.tracker+8.6,links:'Amazon'}],selectedChoice:0},{name:"USB-C Breakout",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress Male & Female",amount:()=>1,cost:1.19,costAll:()=>this.tracker+1.19+1.37,links:'AliExpress Choose: "Color: 5Set".'},{name:"AliExpress Vertical Male",amount:()=>1,cost:2.37,costAll:()=>this.tracker+.37+1.99,links:'AliExpress'}],selectedChoice:0},{name:"Wire for ESPs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need wire or already have."},{name:"Silicone Wire Kit",amount:()=>1,cost:5.96,costAll:()=>this.tracker+5.96+.99,links:'AliExpress 30 AWG or lower'},{name:"Generic Wire",amount:()=>1,cost:.7,costAll:()=>this.tracker+.7+1.24,links:'AliExpress Select "Specification: 30 AWG or lower"'}],selectedChoice:0},{name:"Wire for LEDs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need wire or already have."},{name:"Silicone Wire Kit",amount:()=>1,cost:5.96,costAll:()=>this.tracker+5.96+.99,links:'AliExpress 30 AWG or higher'},{name:"Generic Wire",amount:()=>1,cost:.7,costAll:()=>this.tracker+.7+1.24,links:'AliExpress Select "Specification: 30 AWG or higher"'}],selectedChoice:0},{name:"Camera Extension Cables",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress 24pin 0.5mm Pitch",amount:()=>1,cost:1.33,costAll:()=>this.tracker+.33+1.99,links:'AliExpress Choose: "Insert Type: 24p 0.5mm pitch" and Type A. Length depends on HMD, usually 150mm or 200mm.'},{name:"Adafruit 24 pin 0.5mm pitch",amount:()=>this.tracker,cost:1.35,costAll:()=>this.tracker*1.35+6,links:'Adafruit 250mm'}],selectedChoice:0},{name:"Camera Extension Connectors",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress 24 pin",amount:()=>1,cost:1.32,costAll:()=>this.tracker+.32+1.99,links:'AliExpress Choose: "Pins: 24P".'},{name:"Adafruit 24 pin",amount:()=>this.tracker,cost:.86,costAll:()=>this.tracker*.865+6,links:'Adafruit'}],selectedChoice:0},{name:"External Antennas",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress Small",amount:()=>1,cost:.16,costAll:()=>this.tracker*.16+3.48,links:'AliExpress Choose: "Color: 2.4G Antenna".'},{name:"Amazon Large",amount:()=>1,cost:9.99,costAll:()=>this.tracker+7.99,links:'Amazon'}],selectedChoice:0},{name:"USB-C Cables",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"Short USB-C to USB-C Amazon",amount:()=>1,cost:6.29,costAll:()=>this.tracker+5.29,links:'Amazon'},{name:"Short USB-A to USB-C Amazon",amount:()=>1,cost:7.99,costAll:()=>this.tracker+5.99,links:'Amazon'}],selectedChoice:0},{name:"V4 LED Wire Extensions/Replacements",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"110mm Extension/Replacement",amount:()=>1,cost:1.5,costAll:()=>this.tracker+1.5+5,links:'ETVR Store'},{name:"200mm Extension/Replacement",amount:()=>1,cost:1.5,costAll:()=>this.tracker+1.5+5,links:'ETVR Store'}],selectedChoice:0}],total:0}},methods:{updatePrices(){let s=0;this.components.forEach(o=>{if(o.choices.length>1){const c=o.choices[o.selectedChoice];s+=c.costAll()}}),this.total=s}},mounted(){this.updatePrices()}},M=s=>(_("data-v-c404ea88"),s=s(),C(),s),D=M(()=>e("thead",null,[e("tr",null,[e("th",null,"Component"),e("th",null,"Choice"),e("th",null,"Amount"),e("th",null,"Cost"),e("th",null,"Cost All"),e("th",null,"Links")])],-1)),R=["onUpdate:modelValue"],W=["value"],V={key:1},U=["innerHTML"];function z(s,o,c,S,n,u){return a(),r("div",null,[e("table",null,[D,e("tbody",null,[(a(!0),r(d,null,m(n.components,t=>(a(),r("tr",{key:t.name},[e("th",null,i(t.name),1),e("td",null,[t.choices.length>1?A((a(),r("select",{key:0,"onUpdate:modelValue":l=>t.selectedChoice=l,onChange:o[0]||(o[0]=(...l)=>u.updatePrices&&u.updatePrices(...l))},[(a(!0),r(d,null,m(t.choices,(l,h)=>(a(),r("option",{key:h,value:h},i(l.name),9,W))),128))],40,R)),[[f,t.selectedChoice]]):(a(),r("span",V,i(t.choices[0].name),1))]),e("td",null,i(t.selectedChoice?t.choices[t.selectedChoice].amount(n.tracker):0),1),e("td",null,i(t.selectedChoice?"$"+t.choices[t.selectedChoice].cost:0),1),e("td",null,i(t.selectedChoice?"~$"+t.choices[t.selectedChoice].costAll(n.tracker)*100/100:0),1),e("td",{innerHTML:t.selectedChoice?t.choices[t.selectedChoice].links:""},null,8,U)]))),128))])]),e("p",null,"Total: $"+i(n.total.toFixed(2)),1)])}const L=w(I,[["render",z],["__scopeId","data-v-c404ea88"]]),q=e("p",null,"WIP new parts list. 3D printed parts will live on their own page.",-1),N=e("p",null,[p("Use the "),e("strong",null,"interactive"),p(" tables below to select parts!")],-1),F=e("h1",{id:"required-parts",tabindex:"-1"},[p("Required Parts: "),e("a",{class:"header-anchor",href:"#required-parts","aria-label":'Permalink to "Required Parts:"'},"​")],-1),$=e("h1",{id:"additional-parts",tabindex:"-1"},[p("Additional Parts: "),e("a",{class:"header-anchor",href:"#additional-parts","aria-label":'Permalink to "Additional Parts:"'},"​")],-1),Y=y("",19),K=JSON.parse('{"title":"Required Parts:","description":"","frontmatter":{},"headers":[],"relativePath":"how_to_build/part_list.md","filePath":"how_to_build/part_list.md","lastUpdated":1710897358000}'),H={name:"how_to_build/part_list.md"},Q=Object.assign(H,{setup(s){return(o,c)=>(a(),r("div",null,[q,N,F,k(O),$,k(L),Y]))}});export{K as __pageData,Q as default}; +import{_ as w,o as a,c as r,k as e,F as d,D as m,t as i,a1 as A,a2 as f,p as _,m as C,H as k,a as p,Q as y}from"./chunks/framework.0394bef4.js";const b={data(){return{tracker:2,components:[{name:"ESP Microcontroller",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:1.85,costAll:()=>this.tracker*0,links:"If you already have a supported camera capable ESP32 or sourced elsewhere."},{name:"Seeed Studio XIAO Sense ESP32-S3",amount:()=>this.tracker,cost:12.87,costAll:()=>this.tracker*12.87+3.18,links:'AliExpress XIAO Sense Recommended'},{name:"ESP32-CAM",amount:()=>this.tracker,cost:12.87,costAll:()=>this.tracker*4.69+3.18,links:'AliExpress ESP32 CAM Requires additional programmer'},{name:"FREENOVE ESP32-S3-WROOM",amount:()=>this.tracker,cost:19.95,costAll:()=>this.tracker*19.95,links:'Amazon Large, more expensive than XIAO'}],selectedChoice:1},{name:"Camera",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you already have a supported camera or sourced elsewhere."},{name:"130 Degree NO-IR",amount:()=>this.tracker,cost:5.41,costAll:()=>this.tracker*5.41,links:'AliExpress Select "Color: 75MM-130 Degree" Must manually remove IR filter'},{name:"160 Degree IR",amount:()=>this.tracker,cost:4.26,costAll:()=>this.tracker*4.26,links:'AliExpress Select "Color: 75MM-160 850nm"'}],selectedChoice:1},{name:"IR LEDs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:'IR LED Safety If you already have safe IR LED hardware and know what you are doing.'},{name:"Official V4 mini Solder-less Kit",amount:()=>1,cost:28,costAll:()=>this.tracker+28+3,links:'ETVR Store Length depending on HMD'},{name:"Official V4 mini Bring Your Own Wires Kit",amount:()=>1,cost:24,costAll:()=>this.tracker+24+3,links:'ETVR Store Must solder up your own wires'},{name:"Official V4 lite Assemble Yourself",amount:()=>1,cost:7,costAll:()=>this.tracker+7+3,links:'ETVR Store Must assemble yourself'}],selectedChoice:2},{name:"USB Hub",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you already have safe IR LED hardware and know what you are doing."},{name:"4 port USB 3.2 LDLrui (MTT Usually)",amount:()=>1,cost:17.99,costAll:()=>this.tracker+17.99,links:'Amazon Usually these are MTT, but sometimes not'},{name:"4 port USB 3.2 Sitecom CN-385 Hub (MTT)",amount:()=>1,cost:40.53,costAll:()=>this.tracker+17.99,links:'Amazon Known good MTT hub, but expensive'},{name:"4 port USB 2.0 Breakout (Not MTT)",amount:()=>1,cost:1.41,costAll:()=>this.tracker+1.41+1.99,links:'AliExpress Small but non MTT hub breakout'},{name:"3 port USB 3.0 Hub With Power Passthrough (MTT)",amount:()=>1,cost:17.99,costAll:()=>this.tracker+1.41,links:'Amazon Great for Quest due to power passthrough'}],selectedChoice:1},{name:"3D Printed Mounts",choices:[{name:"Print Yourself",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you have a 3d printer or have access to one somewhere."},{name:"JLCPCB Print Service, JLC3DP",amount:()=>this.tracker,cost:2,costAll:()=>this.tracker*2+5,links:'JLC3DP '}],selectedChoice:0}],total:0}},methods:{updatePrices(){let s=0;this.components.forEach(o=>{if(o.choices.length>1){const c=o.choices[o.selectedChoice];s+=c.costAll(this.tracker)}}),this.total=s},switchSelect(s,o){this.$set(o,"selectedChoice",s.target.value),this.updatePrices()}},mounted(){this.updatePrices()}},g=s=>(_("data-v-b5690fe3"),s=s(),C(),s),E=g(()=>e("thead",null,[e("tr",null,[e("th",null,"Component"),e("th",null,"Choice"),e("th",null,"Amount"),e("th",null,"Cost"),e("th",null,"Cost All"),e("th",null,"Links")])],-1)),v=["onUpdate:modelValue","onChange"],x=["value"],B={key:1},P=["innerHTML"];function T(s,o,c,S,n,u){return a(),r("div",null,[e("table",null,[E,e("tbody",null,[(a(!0),r(d,null,m(n.components,t=>(a(),r("tr",{key:t.name},[e("th",null,i(t.name),1),e("td",null,[t.choices.length>1?A((a(),r("select",{key:0,"onUpdate:modelValue":l=>t.selectedChoice=l,onChange:l=>u.switchSelect(l,t)},[(a(!0),r(d,null,m(t.choices,(l,h)=>(a(),r("option",{key:h,value:h},i(l.name),9,x))),128))],40,v)),[[f,t.selectedChoice]]):(a(),r("span",B,i(t.choices[0].name),1))]),e("td",null,i(t.selectedChoice?t.choices[t.selectedChoice].amount(n.tracker):0),1),e("td",null,i(t.selectedChoice?"$"+t.choices[t.selectedChoice].cost:0),1),e("td",null,i(t.selectedChoice?"~$"+t.choices[t.selectedChoice].costAll(n.tracker)*100/100:0),1),e("td",{innerHTML:t.selectedChoice?t.choices[t.selectedChoice].links:""},null,8,P)]))),128))])]),e("p",null,"Total: $"+i(n.total.toFixed(2)),1)])}const O=w(b,[["render",T],["__scopeId","data-v-b5690fe3"]]);const I={data(){return{tracker:2,components:[{name:"Type A USB Breakout",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:1.85,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"Type A USB Breakout Bare (AliExpress)",amount:()=>1,cost:1.18,costAll:()=>this.tracker+1.18,links:'AliExpress'},{name:"Type A USB Breakout Bare (Amazon)",amount:()=>1,cost:6.49,costAll:()=>this.tracker+5.49,links:'Amazon'},{name:"Type A USB Breakout With Cover (AliExpress)",amount:()=>1,cost:2.2,costAll:()=>this.tracker+1.2+1.99,links:'AliExpress'},{name:"Type A USB Breakout With Wire and Cover (Amazon)",amount:()=>1,cost:9.6,costAll:()=>this.tracker+8.6,links:'Amazon'}],selectedChoice:0},{name:"USB-C Breakout",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress Male & Female",amount:()=>1,cost:1.19,costAll:()=>this.tracker+1.19+1.37,links:'AliExpress Choose: "Color: 5Set".'},{name:"AliExpress Vertical Male",amount:()=>1,cost:2.37,costAll:()=>this.tracker+.37+1.99,links:'AliExpress'}],selectedChoice:0},{name:"Wire for ESPs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need wire or already have."},{name:"Silicone Wire Kit",amount:()=>1,cost:5.96,costAll:()=>this.tracker+5.96+.99,links:'AliExpress 30 AWG or lower'},{name:"Generic Wire",amount:()=>1,cost:.7,costAll:()=>this.tracker+.7+1.24,links:'AliExpress Select "Specification: 30 AWG or lower"'}],selectedChoice:0},{name:"Wire for LEDs",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need wire or already have."},{name:"Silicone Wire Kit",amount:()=>1,cost:5.96,costAll:()=>this.tracker+5.96+.99,links:'AliExpress 30 AWG or higher'},{name:"Generic Wire",amount:()=>1,cost:.7,costAll:()=>this.tracker+.7+1.24,links:'AliExpress Select "Specification: 30 AWG or higher"'}],selectedChoice:0},{name:"Camera Extension Cables",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress 24pin 0.5mm Pitch",amount:()=>1,cost:1.33,costAll:()=>this.tracker+.33+1.99,links:'AliExpress Choose: "Insert Type: 24p 0.5mm pitch" and Type A. Length depends on HMD, usually 150mm or 200mm.'},{name:"Adafruit 24 pin 0.5mm pitch",amount:()=>this.tracker,cost:1.35,costAll:()=>this.tracker*1.35+6,links:'Adafruit 250mm'}],selectedChoice:0},{name:"Camera Extension Connectors",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress 24 pin",amount:()=>1,cost:1.32,costAll:()=>this.tracker+.32+1.99,links:'AliExpress Choose: "Pins: 24P".'},{name:"Adafruit 24 pin",amount:()=>this.tracker,cost:.86,costAll:()=>this.tracker*.865+6,links:'Adafruit'}],selectedChoice:0},{name:"External Antennas",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"AliExpress Small",amount:()=>1,cost:.16,costAll:()=>this.tracker*.16+3.48,links:'AliExpress Choose: "Color: 2.4G Antenna".'},{name:"Amazon Large",amount:()=>1,cost:9.99,costAll:()=>this.tracker+7.99,links:'Amazon'}],selectedChoice:0},{name:"USB-C Cables",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"Short USB-C to USB-C Amazon",amount:()=>1,cost:6.29,costAll:()=>this.tracker+5.29,links:'Amazon'},{name:"Short USB-A to USB-C Amazon",amount:()=>1,cost:7.99,costAll:()=>this.tracker+5.99,links:'Amazon'}],selectedChoice:0},{name:"V4 LED Wire Extensions/Replacements",choices:[{name:"Bring Your Own",amount:()=>this.tracker,cost:0,costAll:()=>this.tracker*0,links:"If you do not need or already have."},{name:"110mm Extension/Replacement",amount:()=>1,cost:1.5,costAll:()=>this.tracker+1.5+5,links:'ETVR Store'},{name:"200mm Extension/Replacement",amount:()=>1,cost:1.5,costAll:()=>this.tracker+1.5+5,links:'ETVR Store'}],selectedChoice:0}],total:0}},methods:{updatePrices(){let s=0;this.components.forEach(o=>{if(o.choices.length>1){const c=o.choices[o.selectedChoice];s+=c.costAll()}}),this.total=s}},mounted(){this.updatePrices()}},M=s=>(_("data-v-9ca22bca"),s=s(),C(),s),D=M(()=>e("thead",null,[e("tr",null,[e("th",null,"Component"),e("th",null,"Choice"),e("th",null,"Amount"),e("th",null,"Cost"),e("th",null,"Cost All"),e("th",null,"Links")])],-1)),R=["onUpdate:modelValue"],W=["value"],V={key:1},U=["innerHTML"];function z(s,o,c,S,n,u){return a(),r("div",null,[e("table",null,[D,e("tbody",null,[(a(!0),r(d,null,m(n.components,t=>(a(),r("tr",{key:t.name},[e("th",null,i(t.name),1),e("td",null,[t.choices.length>1?A((a(),r("select",{key:0,"onUpdate:modelValue":l=>t.selectedChoice=l,onChange:o[0]||(o[0]=(...l)=>u.updatePrices&&u.updatePrices(...l))},[(a(!0),r(d,null,m(t.choices,(l,h)=>(a(),r("option",{key:h,value:h},i(l.name),9,W))),128))],40,R)),[[f,t.selectedChoice]]):(a(),r("span",V,i(t.choices[0].name),1))]),e("td",null,i(t.selectedChoice?t.choices[t.selectedChoice].amount(n.tracker):0),1),e("td",null,i(t.selectedChoice?"$"+t.choices[t.selectedChoice].cost.toFixed(2):0),1),e("td",null,i(t.selectedChoice?"~$"+t.choices[t.selectedChoice].costAll(n.tracker).toFixed(2):0),1),e("td",{innerHTML:t.selectedChoice?t.choices[t.selectedChoice].links:""},null,8,U)]))),128))])]),e("p",null,"Total: $"+i(n.total.toFixed(2)),1)])}const L=w(I,[["render",z],["__scopeId","data-v-9ca22bca"]]),q=e("p",null,"WIP new parts list. 3D printed parts will live on their own page.",-1),F=e("p",null,[p("Use the "),e("strong",null,"interactive"),p(" tables below to select parts!")],-1),N=e("h1",{id:"required-parts",tabindex:"-1"},[p("Required Parts: "),e("a",{class:"header-anchor",href:"#required-parts","aria-label":'Permalink to "Required Parts:"'},"​")],-1),$=e("h1",{id:"additional-parts",tabindex:"-1"},[p("Additional Parts: "),e("a",{class:"header-anchor",href:"#additional-parts","aria-label":'Permalink to "Additional Parts:"'},"​")],-1),Y=y("",19),K=JSON.parse('{"title":"Required Parts:","description":"","frontmatter":{},"headers":[],"relativePath":"how_to_build/part_list.md","filePath":"how_to_build/part_list.md","lastUpdated":1710897358000}'),H={name:"how_to_build/part_list.md"},Q=Object.assign(H,{setup(s){return(o,c)=>(a(),r("div",null,[q,F,N,k(O),$,k(L),Y]))}});export{K as __pageData,Q as default}; diff --git a/contact.html b/contact.html index 442eb29..65a6573 100644 --- a/contact.html +++ b/contact.html @@ -18,7 +18,7 @@
Skip to content

Contact Us


Please join our Discord for updates and any questions.

Released under the MIT License.

- + \ No newline at end of file diff --git a/dev_roadmap.html b/dev_roadmap.html index 3effdf6..9ac2588 100644 --- a/dev_roadmap.html +++ b/dev_roadmap.html @@ -19,7 +19,7 @@
Skip to content

Released under the MIT License.

- + \ No newline at end of file diff --git a/development/docs/dev_docs.html b/development/docs/dev_docs.html index 11794b9..01c0d07 100644 --- a/development/docs/dev_docs.html +++ b/development/docs/dev_docs.html @@ -18,7 +18,7 @@
Skip to content

Development Documentation for the EyeTrackVR Docs Site

This is the documentation for the EyeTrackVR Docs site. It is built using VitePress.

Getting Started

Prerequisites

  • Node.js (v14.15.4 or higher)
  • Yarn (v1.22.10 or higher)
  • Git (v2.30.1 or higher)
  • VSCode (v1.56.2 or higher)

Installation

  1. Clone the repo

    sh
    git clone https://github.com/EyeTrackVR/EyeTrackVR-Docs.git
  2. Navigate to the vitepress folder

    sh
    cd vitepress
  3. Install Yarn packages

    sh
     yarn
  4. Start the dev server

    sh
    yarn dev
  5. Open the site in your browser

Contributing

Project Structure

  1. Familiarize yourself with the VitePress documentation.
  2. Then, move on to our project specific documentation below.

Standards

  • All documentation should be written in Markdown or Vue components.
  • All file names are snake case and lowercase letters.
  • Do not make naming changes to the vitepress folder.
  • Do not make major changes to the vitepress folder structure without proir consultation of team members.
  • For Vue componentes, follow the Vue3 docs.

Released under the MIT License.

- + \ No newline at end of file diff --git a/development/docs/pages.html b/development/docs/pages.html index 201cf05..dad9cfa 100644 --- a/development/docs/pages.html +++ b/development/docs/pages.html @@ -26,7 +26,7 @@ { text: "My Page", link: "/my_folder/my_page" }, // Add this line - subdir then file ], },

Note

The link property does not require a file extension. Please do not add it.

Title Style

The title style is the style of the title that appears at the top of the page.

We like to keep this cohesive, so please use the following style:

md
# My Page {.text-[var(--font-accent)]}

This will give the title a nice orange colour.

The {} are required, and the .text-[#e67e22] is the colour using TailWindCSS classes. You can also use our built in CSS variables {.text-[var(--font-accent)]}. You will find these in the src/styles/theme.css file. You can change this to any colour you like, but please keep it consistent with the rest of the site.

Tip

This entire site supports TailWindCSS classes. You can find the documentation here.

All classes you wish to add, must be prefaced with a . when inside of the {}.

When using classes on HTML elements, you can use the class attribute. For example:

html
<h1 class="text-[#e67e22]">My Page</h1>

Editing a Page

To edit a page, you will need to edit the Markdown file in the vitepress/docs/src/pages folder.

- + \ No newline at end of file diff --git a/development/docs/standards.html b/development/docs/standards.html index 72d9d44..55f4daa 100644 --- a/development/docs/standards.html +++ b/development/docs/standards.html @@ -26,7 +26,7 @@ - added new thing # some detail about the new thing BREAKING CHANGE: this is a breaking change #this line is optionaland only used if needed - + \ No newline at end of file diff --git a/firmware_guide/configure_firmware.html b/firmware_guide/configure_firmware.html index a07f981..a9f47cb 100644 --- a/firmware_guide/configure_firmware.html +++ b/firmware_guide/configure_firmware.html @@ -20,7 +20,7 @@
Skip to content

Configuring the firmware

Once you have opened the project, you should see something on the left side like this

'img'

Open the ini/user_config.ini file

'img'

INFO

These settings are applicable only when using Wi-Fi for communication with your computer. If you are using USB, you can skip to reading about Environments.

Replace the placeholder text with your correct SSID (WiFi access point name), and password respectively.

INFO

Special characters such as ! and @ are not supported. If you have a special character in your password or ssid, you will need to change it.

Similarly, spaces are not supported in the SSID and password. If you have a space in either, you will need to change it.

The firmware supports AP mode, however it is not recommended. If you wish to use AP mode, you will need to set the enableadhoc to 1.

Then, you will need to set the ap_ssid to the name of your AP, and ap_password to the password of your AP.

You can choose to leave the ap_ssid and ap_password as defaults, but you will need to set the enableadhoc to 1.

Note: If you are enabling AP mode for both ESPs, you will need to set the ap_ssid and ap_password to different values for both ESPs. It is best to set AP mode only for one ESP, and leave the other ESP in STA mode. Connect the other ESP to the AP of the ESP in AP mode. Then connect your computer to the AP of the ESP in AP mode. This will allow you to connect to the ESP in AP mode, and the ESP in STA mode.

CAUTION

Make sure your WiFi router has a 2.4 GHz band. While most do, this is not always the case. Setting each band (5GHz, and 2.4GHz) to different SSIDs is recommended, though not required.

Double check that you have correctly entered your WiFi credentials and that said wifi network has a 2.4GHz band.

Additional configuration

mDNS

If you do not wish to manually keep track of the ESPs IP addresses and ports, you can enable the mDNS feature. This will allow you to connect to the ESPs using the following format: http://<some_name>.local. This feature only works when you are on the same network as the ESPs and have mDNS enabled on your computer. If you are using Windows, you can enable mDNS by following this guide.

OTA

The firmware supports OTA updates. This means that you can update the firmware without having to connect to the ESPs. To enable OTA updates, you will need to set the enableota to 1. Then, you will need to set the otapassword to the password you wish to use to update the firmware. You will need to use this password to update the firmware. If you do not wish to use a password, you can set the otapassword to nothing. This will allow you to update the firmware without a password. However, this is not recommended, as anyone on your network will be able to update the firmware.

You will also need to set the otaserverip to the IP address of the ESP you wish to update. This is the IP address of the ESP you wish to update. If you are using mDNS, you can use the mDNS name of the ESP you wish to update. For example, if you are updating the ESP with the dns set to http://esp32.local, you will need to set the otaserverip to http://esp32.local.

REST API

The firmware also supports a fully featured REST API. This means that you can control the ESPs using a REST API. This feature is enabled by defauly, and can not be turned off.

This feature is used more for advanced users, and is not required for basic operation.

The REST API was developed to be used by our new app (still in development). However, it can be used by any REST API client, you can not send POST requests to the ESPs using a browser though, so some REST API functionality can only be used by tools like Thunder Client or Postman.

The full REST API is documented here.

Environments

The firmware supports multiple environments. This means that we have full support for multiple types of ESPs. Each ESP is configured to be in a different environment. If you are using a different ESP, you will need to change the environment to the correct one.

Please reference the Firmware Enviroments Page for more information.

Now, move on to uploading the firmware

Released under the MIT License.

- + \ No newline at end of file diff --git a/firmware_guide/environments.html b/firmware_guide/environments.html index ec641dd..6bf78fd 100644 --- a/firmware_guide/environments.html +++ b/firmware_guide/environments.html @@ -19,7 +19,7 @@
Skip to content

Firmware Environments

What is it?

A firmware environment is a way to store the custom firmware config for a specific device. This is useful if you want to have multiple devices with different firmware configs.

We use environments to store the firmware config for each device, so that you can easily switch between them.

Environments are broken up into two distinct parts:

  • The build type (e.g. debug, release)
  • The board type (e.g. espaithinker, esp32cam)

Build Types

We now have a couple of options letting us decide how we want to build the firmware.

  • Debug - The debug environment is the default environment and does not need to be specified. It has a lot of logging so it is useful for getting everything setup for the first time and to see what is going on.

  • _release - Has a lot less debugging, may also be missing some things available only in debug for debug purposes, this should be flashed when everything is working.

Examples:
xiaosenses3 - This is the debug environment.
xiaosenses3_release - This is the release environment for daily use.

Tip

We recommend starting with a debug environment, and then switching to release once everything is working. A debug environnement should not be used permanently.

Board Types

We currently support for several different boards, and we are working on adding more.

Warning

It is important to note that the esp32AIThinker environment is the default environment. Only switch your environment if you have another board or an environment is not working.

Most esp32Cams from Aliexpress will work with the esp32AIThinker environment, but some may require the esp32cam environment. Test the default environment first, and if it does not work, try the esp32cam environment.

Currently supported boards:

  • esp32AIThinker - This is the default environment. This is for the ESP32-AI-THINKER and generic alibaba/aliexpress/amazon esp cam boards.
  • esp32Cam - This is for the special ESP32-CAM, it is unlikely that you will need to use this environment.
  • esp32M5Stack - This is for ESP32M5Stack.
  • esp32WRover - This is for the ESP32WRover.
  • esp-eye - This is for the ESP-EYE (not the S3 variant).
  • wrooms3 - For FREENOVE-ESP32-S3 (wireless mode)
  • wrooms3QIO - For FREENOVE-ESP32-S3 (wireless mode, for boards with octal flash)
  • wrooms3USB - For FREENOVE-ESP32-S3 (wired mode)
  • wrooms3QIOUSB - For FREENOVE-ESP32-S3 (wired mode, for boards with octal flash)
  • xiaosenses3 - For SeedStudio's XAIO ESP32-S3 Sense (wireless mode)
  • xiaosenses3_USB - For SeedStudio's XAIO ESP32-S3 Sense (wired mode)

You can change the board enviroment by changing the default_envs argument in platformio.ini to a supported board like shown:

GIF showing a switch of board environments.

Released under the MIT License.

- + \ No newline at end of file diff --git a/firmware_guide/firmware.html b/firmware_guide/firmware.html index f330767..cfaefdc 100644 --- a/firmware_guide/firmware.html +++ b/firmware_guide/firmware.html @@ -18,7 +18,7 @@
Skip to content

What is this?

Firmware is the second part of the equation to get your trackers going. It lives on the ESP32 chip, and is responsible for streaming video data from the tracker. We currently fully support wireless streaming over 2.4GHz, and are working on adding support for wired streaming to the main desktop App.

What should I download and where?

You can access the firmware, as well as flash your boards, using our new Firmware Flashing Tool.

Caution

This tool is currently in beta.

We are working on adding support for Over-The-Air (OTA) and configuring network settings. If you have any issues, please let us know by opening an issue on the repository.

This tool relies on our own solution called OpenIris, found here.

Note

You do not need to download OpenIris separately. The flashing tool will download it for you.

To check the status of the project, please visit the Development Road Map

I want to use VSCode - How would I do this?

Follow the steps described here

Released under the MIT License.

- + \ No newline at end of file diff --git a/firmware_guide/flashing_tool.html b/firmware_guide/flashing_tool.html index d489e46..7a7784c 100644 --- a/firmware_guide/flashing_tool.html +++ b/firmware_guide/flashing_tool.html @@ -19,7 +19,7 @@
Skip to content

Firmware Flashing Tool

What is this?

The Firmware Flashing Tool allows you to flash the firmware to your ESPs without requiring VScode. It is a GUI tool that is built using Tauri and SolidJS.

Features include:

  • download pre-built firmware binaries
  • configure firmware settings
  • flash firmware to ESPs
  • open a serial monitor to view the ESPs output for debugging

Note

This tool is currently in beta, and we are working on adding support for OTA and configuring network settings. If you have any issues, please let us know by opening an issue on the repository.

How To Use

Download the tool

You can download the tool from the releases page.

Flash the firmware

  1. Connect your ESP to your computer
  2. Open the tool
  3. Select the correct firmware for your board and setup.
  4. Download the firmware
  5. Connect to the Esp
  6. Flash the firmware

For the USB version, this is all you need to do! Well done.

Flashing Tool ui

WiFi Setup

Flashing Tool ui lower half

If you are using the WiFi version, you will need to configure the WiFi settings. After you have flashed the firmware you will need to connect to the ESPs WiFi network. The network name will be EyeTrackVR. The password will be 12345678. Once you have connected to the network, you can open the Firmware Flashing tool and configure the WiFi settings. You will need to enter the SSID and password for your WiFi network. Once you have done this, you can click the Save button to save the settings to the ESP. The ESP will then restart and connect to your WiFi network. You can then connect to the ESPs IP address to view the web interface.

To find the ESP's IP address you can either use the serial monitor or look at your routers list of connected devices.

To open the serial monitor, you will need to connect to the esp, just as you did for flashing. Once you have connected, you can click the Monitor button to open the serial monitor. You should then see the ESPs output in the serial monitor.

Environments

The firmware supports multiple environments. This means that we have full support for multiple types of ESPs. Each ESP is configured to be in a different environment. If you are using a different ESP, you will need to change the environment to the correct one.

Please reference the Firmware Environments Page for more information.

Released under the MIT License.

- + \ No newline at end of file diff --git a/firmware_guide/mdns.html b/firmware_guide/mdns.html index 69a84ed..a9188e1 100644 --- a/firmware_guide/mdns.html +++ b/firmware_guide/mdns.html @@ -18,7 +18,7 @@
Skip to content

MDNS

What is it?

mDNS is a protocol that allows you to connect to a device using a name instead of an IP address. This is useful if you do not know the IP address of the device, or if you do not want to keep track of the IP address of the device. This is also useful if you are using a device that does not have a static IP address.

In the mDNS protocol the IP address of the device can change, but the name of the device will always be the same. This means that you can connect to the device using the name of the device, even if the IP address of the device changes.

How to use it

Enable mDNS

The mDNS is enabled by default on the new firmware, and can not be disabled.

To use it, all you need to do is set the name of the device in the firmware config file.

This setting can be located under the [wifi] section of the ini/user_config.ini file.

ini
mdnsname = "openiristracker" # do not add .local

By default, the name of the device is openiristracker, however you can change it to whatever you want.

Change the name

Since you have two ESP32 devices, you need to make sure that the name of the device is different for each device. If you do not change the name of the device, you will not be able to connect to both devices at the same time.

Connect to the device

To connect to the device, you need to use the name of the device followed by .local. For example, if the name of the device is esp32, you can connect to the device using http://esp32.local.

Prerequisites Bonjour

Bonjour is required to use the mDNS protocol for windows and mac only. If you are using Windows, you can download Bonjour from here. If you are using macOS, Bonjour is already installed.

You can also get the fully tested Bonjour package from us here (for Windows only).

Troubleshooting

Can not connect to the device

If you can not connect to the device, make sure that the name of the device is correct. If the name of the device is correct, make sure that the device is connected to the network.

If the device is connected to the network, try to restart the device. If the device is still not connected, try to restart the router.

Released under the MIT License.

- + \ No newline at end of file diff --git a/firmware_guide/rest_api.html b/firmware_guide/rest_api.html index 42f8056..d682c96 100644 --- a/firmware_guide/rest_api.html +++ b/firmware_guide/rest_api.html @@ -44,7 +44,7 @@ WIFI_POWER_2dBm = 8,// 2dBm WIFI_POWER_MINUS_1dBm = -4// -1dBm } wifi_power_t;
ParamDescription
txPowerThe power level to set.

Camera Params

Coming Soon

We are currently working on this section of documentation.

- + \ No newline at end of file diff --git a/firmware_guide/setup_vscode.html b/firmware_guide/setup_vscode.html index 5bcee38..d219b19 100644 --- a/firmware_guide/setup_vscode.html +++ b/firmware_guide/setup_vscode.html @@ -19,7 +19,7 @@
Skip to content

Setting up the environment

This procedure will show how to prepare your system for uploading the firmware to your tracker.

1. Install Visual Studio Code

Download the latest Visual Studio Code and install it.

Download


'img'

Install


'img'

2. Install the drivers

In order to flash the firmware, you'll need some drivers, mainly the CH340 drivers, here's where to get them from:

https://learn.sparkfun.com/tutorials/how-to-install-ch340-drivers/all

3. Install PlatformIO IDE

Once Visual Studio Code is installed, open it and install PlatformIO IDE for VSCode, an extension that will allow you to connect to the tracker, build and upload the firmware.

'img'

4. Clone the firmware project

Make sure you close any current projects you have open or open a new window before moving forward with these steps.

  1. Go to https://github.com/EyeTrackVR/OpenIris and clone the latest version from the main branch.
    1. If you do not have git installed please install it from here.

    2. Open Git Bash.

'img'
  1. Change the directory to the directory that you want the firmware to be cloned. Ex: cd C:/
'img'
  1. Clone the repository by entering the command: git clone https://github.com/EyeTrackVR/OpenIris.git
'img'

For more info about cloning please refer to this documentation

Do not download as a zip - please only properly clone the project, take note of the path you run the clone command in, this is where the files will be downloaded. When we open it in PlatformIO later, this path will be needed.

  1. Open the firmware in VSCode by going to PlatformIO, selecting open, then navigating to OpenIris/ESP folder and opening it.
'img'

This is an adaptation from SlimeVR. Some Credit goes to the SlimeVR team adapted from here

Released under the MIT License.

- + \ No newline at end of file diff --git a/firmware_guide/update_platformio.html b/firmware_guide/update_platformio.html index e8a72f1..7de1c57 100644 --- a/firmware_guide/update_platformio.html +++ b/firmware_guide/update_platformio.html @@ -19,7 +19,7 @@
Skip to content

Updating Platformio

Sometimes, when building and uploading the firmware, you may run into bizarre, even-though the code is correct - platformio will refuse to build and instead will complain with some weird error.

It usually means that either PlatformIO, or ArduinoSDK got and update and that's the moment when this guide may come in handy.

Updating PlatformIO itself

There are two ways to update your platformio installation

Via CLI

You can update it easily by simply typing in one command into your terminal.

pio upgrade command in the terminal
  1. Open a terminal / command prompt
  2. Type pio upgrade and press enter
  3. Wait for it to finish
  4. Done

Via PlatformIO in Visual Studio Code

You can also update it using the platformio tab in your Visual Studio Code.

  1. Open VSC
  2. Click on that little and icon on the sidebar
Platformio logo button
  1. A side panel will open, there will be a couple of sections, one of them called Quick Access, open it.
Platformio logo Quick Access Section
  1. In Quick Access section, click on the Miscelleneous tab
Platformio miscellaneous section
  1. Then, click on the Upgrade PlatformIO Core
Platformio upgrade core button
  1. Wait for it to finnish and done!

Upgrading the SDK

You'll also need to upgrade the SDK from timem to do this

Upgrading the SDK via VSC

  1. Follow the guide above up until clicking on the Quick Access section.
  2. Instead, open the PIO Home and select Open
Platformio open home
  1. This will open a window for PlatformIO dashboard, in there, click on a Platforms button on the sidebar
Platformio platforms sidebar
  1. Once there, you should see a couple of tabs next to the side bard, things like Installed or Embedded. Click on Updates
Platformio platforms sections
  1. Locate a platform called Espressif 32 and click on Update to <version>
Platformio platforms update view
  1. Wait until it is done and that's it!

Released under the MIT License.

- + \ No newline at end of file diff --git a/firmware_guide/upload_and_update_firmware.html b/firmware_guide/upload_and_update_firmware.html index 086af15..86cc501 100644 --- a/firmware_guide/upload_and_update_firmware.html +++ b/firmware_guide/upload_and_update_firmware.html @@ -24,7 +24,7 @@ otaserverip = "openiristrackerL.local" # here we use a custom mDNS name otapassword = "12345678" otaserverport = 3232
  1. Change to OTA env

To do that, in visual studio code, locate the uplaod button, next to it will be listed a couple of buttons and your current environment.

For example, if you have a working esp32AIThinker environment, you would change your environment to esp32AIThinker_OTA.

Click on it.

'An example of how the popup list of envs looks like'

This will open a list of all available environments, select the one that matches your board and has a _OTA suffix

'An example of how the button for selecting env looks like'
  1. Restart the ESPs, they must be power cycled
  2. Press the upload button to upload the firmware.

    img
  3. Do not touch esps or move them during OTA upload
  4. Wait around 1 minute.
  5. Repeat for as many trackers as you need.

Finding the IP address of your tracker

Connect your tracker to your PC and then open a serial monitor in VSC by pressing the plug icon.

'platformio serial monitor button'

Now, press the restart button on the esp itself. watch the monitor for output like this:

'img of platformio serial monitor'

The text, highlighted in green for demonstration, is the stream address of the camera. Take note of this for input into the software.

Keep in mind while testing and getting set up, the ESP can only have one client, to use the camera in the app, make sure you close the browser tab you tested it in.

Updating the firmware to the newest version

To update the firmware you'll need to follow a couple of steps.

  1. Open a terminal and enter the directory you've cloned OpenIris into, for example cd C:/OpenIris/

  2. Save your current changes to the config using git stash

  3. Download the newest changes from the repo using git pull

  4. Apply your saved changes so that you don't have to retype your WI-FI credentials using git stash apply

CAUTION

Skip this step if the update message denotes that the config had changed. If it does so, retype your credentials in the updated files.

4.1. If anything went wrong, you can reset everything to the default state using git reset --hard and then retyping your credentials

  1. Upload your firmware following steps from the uploading section

Troubleshooting

If you encountered an issue while following these steps check the FAQ.

If you don't find an answer to your question there ask in #questions channel in the discord, we will be happy to help.

Adapted from the SlimeVR docs, Some Credit goes to the SlimeVR team here

- + \ No newline at end of file diff --git a/getting_started/intro.html b/getting_started/intro.html index 32b2751..fdcfe46 100644 --- a/getting_started/intro.html +++ b/getting_started/intro.html @@ -20,7 +20,7 @@
Skip to content

EyeTrackVR

Open source and affordable VR eye tracker platform for Social VR Games via OSC and UDP protocol.

Want to get started? Check out the getting started page and then the full build guide.

CAUTION

This project is in active development. However, it is working for most users.

About IR Emitter Safety

Please exercise caution when messing around with IR emitters.

IR can be dangerous to your eyes once at a certain power level. It is not recommended to use different emitters unless you know exactly what you are doing as it could result in harm to your eyes. If you doubt yourself, just do exactly what we do. Don't use different emitters, don't use different means of power, etc.

DANGER

It is important that you DO NOT BYPASS (OR NOT DO) ANY SAFETY FEATURES PUT IN PLACE. This can result in irreversible bodily harm.

The safety measures were put in place to REDUCE the potential failure risk. All further safety responsibilities are on the user. This includes visually checking with an IR camera that the brightness is correct and that you do not feel warmth or experience short-term effects after being exposed to the IR light (symptoms such as dark spots or dry/warm feeling eyes while actively using). While we strive to make EyeTrackVR as safe as possible, we do not hold any responsibility for damage done.

WARNING
Please pay attention

Make sure you are using non-focused emitters and no more than 5 mW/sr total power.

Want to see the safety data sheets?

Effect of infrared radiation on the lens

AN002_Details on photobiological safety of LED light sources

Training-library Nir Stds

ICNIRP: Guidelines of limits of exposure to broad-band incoherent optical radiation (0.38 to 3 µm)

Hardware

Please check out our parts list and hardware repo. for information regarding hardware.

Firmware

Our firmware called OpenIris is made by lorow found here.

Headset support

In theory, we are compatible with every VR headset. However, mounts may not have been made yet. Please take a look at our list of 3d printable mounts and see if your headset is on the list. If it is not listed, It is recommended that you try to make a mount, or wait for a skilled community member to create one.

Contact

Please join our discord for updates and any questions. We hope to see you there!

'discord banner'

Licenses

GitHub license

All software is under the MIT License. All documentation, including the Wiki, is under the Creative Commons CC-BY-SA-4.0 license.

Released under the MIT License.

- + \ No newline at end of file diff --git a/getting_started/led_safety.html b/getting_started/led_safety.html index 192e73b..d1b4572 100644 --- a/getting_started/led_safety.html +++ b/getting_started/led_safety.html @@ -19,7 +19,7 @@
Skip to content

About IR Emitter Safety

Please exercise caution when messing around with IR emitters.

IR can be dangerous to your eyes once at a certain power level. It is not recommended to use different emitters unless you know exactly what you are doing as it could result in harm to your eyes. If you doubt yourself or do not understand something, just do exactly what we do. Don't use different emitters, don't use different means of power, etc.

DANGER

It is important that you DO NOT BYPASS (OR NOT DO) ANY SAFETY FEATURES PUT IN PLACE. This can result in irreversible bodily harm.

The safety measures were put in place to REDUCE the potential failure risk. All further safety responsibilities are on the user. This includes visually checking with an IR camera that the brightness is correct and that you do not feel warmth, excessive eye-strain or experience short-term effects after being exposed to the IR light (symptoms such as dark spots or dry/warm feeling eyes while actively using). While we strive to make EyeTrackVR as safe as possible, we do not hold any responsibility for damage done.

What we care about:

We care about power exposure "W" to the cornea, which we can normalize over the exposed area to Irradiance "mW/cm^2" This number gives us the amount of IR radiation being released into the normalized area. We don't really care about "mA", or "V" alone, as by themselves these do not give us the exposure levels which we need to ensure safety.

Irradiance also needs to take into account distance of the light source (LED) as the further away you get from a source the weaker the intensity gets. (You can test this by looking at a light source from far away, and as you move closer, the brighter and more painful it is to look at) We do this by using Radiance "mW/cm2/sr" to normalize for the distance. The 'sr' stands for steradian, which can be thought of as a cone shape expanding as it moves away from the source.

The International Commission on Non-Ionizing Radiation Protection's Guidelines of limits of exposure to broad-band incoherent optical radiation (0.38 to 3 µm) states:

"To avoid thermal injury of the cornea and possible delayed effects on the lens of the eye (cataractogenesis), infrared radiation (780nm < > λ < > 3μm) should be limited to 100 W m⁻² (10 mW cm⁻²) for lengthy exposures (> 1000 s)"

So 10 mW/cm2 is the max recommended limit given by this source. In my opinion this is still quite high, you will definitely feel some warmth and likely eyestrain after a while.

It is known that when outside and not directly looking at the sun, your eyes get exposed to about 1 mW/cm2 or IR radiation. This is the target I set for hardware generally.

NOTE

This math is assuming the LED is directly in front of your pupil, and your pupil is not moving. In real world this is not the case. We have multiple LEDs around your eye, and your eye moves. When you look to the side, your pupil is not receiving all of the light from all LEDs and the distance grows as well. Properly calculating for this is hard and not worth the time. I chose to show that the "worst case scenario" is still well withing safety margins.

V3 Hardware Safety Outline and Exposure Numbers:

For all of this math we will assume the "worst" to ensure we are well within safety.

if powered with 5V, using 700 ohms of resistance, V3 Hardware will draw 0.00314... Amps. We will round up and convert this to 3.2mA.

(5V - 1.4V - 1.4V) / 700 ohm = 0.00314 ≈ 3.2mA

The LED datasheet lists the intensity at 20mA to be a minimum of 2 and max of 5. We will assume the worst and use 5mW/sr.

5 mW/sr * (3.2mA / 20mA) = 0.8 mW/sr

Now, we need to account for distance. My number is based on a worst case scenario of 1cm of distance. (typically is is higher on average.) We convert 1cm to 1cm2/sr

0.8 mW/sr / 1cm2/sr = 0.8 mW/cm2

Now, this is only for 1 LED, in the case of V3 we have 2 so we can:

0.8 mW/cm2 * 2 = 1.6 mW/cm2

This value is well below the limit, and close to normal sun exposure outside. If the LEDs were further than 1cm (which they typically are) the exposure would be even less.

V4 Hardware Safety Outline and Exposure Numbers:

For all of this math we will assume the "worst" to ensure we are well within safety.

V4 hardware is actively limited to ~2.4 mA

The LED datasheet lists the intensity at 20mA to be a minimum of 2 and max of 5. We will assume the worst and use 5mW/sr.

5 mW/sr * (2.4mA / 20mA) = 0.6 mW/sr

Now, we need to account for distance. My number is based on a worst case scenario of 1cm of distance. (typically is is higher on average.) We convert 1cm to 1cm2/sr

0.6 mW/sr / 1cm2/sr = 0.6 mW/cm2

Now, this is only for 1 LED, in the case of V4 we have 4 so we can:

0.6 mW/cm2 * 4 = 2.4 mW/cm2

This value is well below the limit, and not far from sun exposure. If the LEDs were further than 1cm (which they typically are) the exposure would be even less. And with typical eye movement they are less.

Released under the MIT License.

- + \ No newline at end of file diff --git a/getting_started/things_to_know.html b/getting_started/things_to_know.html index b166b27..56a9b92 100644 --- a/getting_started/things_to_know.html +++ b/getting_started/things_to_know.html @@ -18,7 +18,7 @@
Skip to content

Things To Know Before You Start

This page is an overview of things to know and understand before you start this project

Software is not final

Bugs can and will occur which may hinder the experience or usability at times. Do not expect 100% reliable and perfect function. Not all features are fully developed yet.

Firmware may have user difficulties

Our firmware has not been tested widely so issues may creep up.

IR emitters are dangerous

If handled wrong or precautions are ignored you can and will cause damage to your eyes. Please make sure to only buy linked ones or ones with specs that match exactly. We will not be responsible for damage caused if you go your own route.

Documentation may be incomplete

Important steps may be missing.

You will need to set up your avatar to use this

This will require basic knowledge of Unity and ownership of your own avatar. Note: The 2.0 beta version of our app uses VRC's Native eye tracking, which does NOT require a special avatar.

Once you have acknowledged the items above, move on to the Full Build Guide

Released under the MIT License.

- + \ No newline at end of file diff --git a/hashmap.json b/hashmap.json index f983cca..65787b9 100644 --- a/hashmap.json +++ b/hashmap.json @@ -1 +1 @@ -{"software_guide_eyetrackvr_app_guide.md":"3f31b218","misc_faq.md":"a49510e6","getting_started_led_safety.md":"ade89897","index.md":"cfc5f6ab","dev_roadmap.md":"50fd4b6d","development_docs_pages.md":"f7589aa7","about.md":"30a7c50c","misc_vrc_avatar_setup.md":"768638db","contact.md":"a709587f","development_docs_standards.md":"69f18768","firmware_guide_environments.md":"3bb1e0df","firmware_guide_firmware.md":"cf1c2843","software_guide_build_software.md":"81e9709c","firmware_guide_setup_vscode.md":"fb9f61fe","software_guide_osc_setup.md":"ad882430","how_to_build_creating_your_own_mount.md":"4711ab32","how_to_build_protecting_cameras.md":"1e32279e","archive_fox_ir_v2_build_instructions.md":"94c565cf","how_to_build_parts_list.md":"f01e3e77","how_to_build_full_build.md":"b34552ef","firmware_guide_update_platformio.md":"e1775e11","firmware_guide_rest_api.md":"a60ac287","how_to_build_preparing_xiao.md":"0ec08fee","firmware_guide_upload_and_update_firmware.md":"51771a4d","how_to_build_part_list.md":"3f326f04","firmware_guide_flashing_tool.md":"85c4676c","getting_started_intro.md":"40dd45b9","getting_started_things_to_know.md":"78f36f4c","development_docs_dev_docs.md":"2ae6adcc","firmware_guide_mdns.md":"644e0477","firmware_guide_configure_firmware.md":"95f83eef"} +{"about.md":"30a7c50c","firmware_guide_environments.md":"3bb1e0df","contact.md":"a709587f","development_docs_dev_docs.md":"2ae6adcc","firmware_guide_firmware.md":"cf1c2843","development_docs_standards.md":"69f18768","misc_faq.md":"a49510e6","how_to_build_protecting_cameras.md":"1e32279e","dev_roadmap.md":"50fd4b6d","development_docs_pages.md":"f7589aa7","getting_started_intro.md":"40dd45b9","firmware_guide_configure_firmware.md":"95f83eef","how_to_build_creating_your_own_mount.md":"4711ab32","getting_started_led_safety.md":"ade89897","archive_fox_ir_v2_build_instructions.md":"94c565cf","firmware_guide_update_platformio.md":"e1775e11","getting_started_things_to_know.md":"78f36f4c","firmware_guide_rest_api.md":"a60ac287","how_to_build_parts_list.md":"f01e3e77","how_to_build_full_build.md":"b34552ef","firmware_guide_mdns.md":"644e0477","firmware_guide_setup_vscode.md":"fb9f61fe","how_to_build_part_list.md":"a401e11d","software_guide_eyetrackvr_app_guide.md":"3f31b218","firmware_guide_upload_and_update_firmware.md":"51771a4d","firmware_guide_flashing_tool.md":"85c4676c","misc_vrc_avatar_setup.md":"768638db","software_guide_build_software.md":"81e9709c","how_to_build_preparing_xiao.md":"0ec08fee","software_guide_osc_setup.md":"ad882430","index.md":"cfc5f6ab"} diff --git a/how_to_build/creating_your_own_mount.html b/how_to_build/creating_your_own_mount.html index 4a85689..6841169 100644 --- a/how_to_build/creating_your_own_mount.html +++ b/how_to_build/creating_your_own_mount.html @@ -18,7 +18,7 @@
Skip to content

Creating Your Own Mount

This page will include a basic rundown on how to create your own camera mount for a headset that may not have any existing community mounts

So, you have a headset that does not have any mounts or none that work well for you. Here I will show some simple steps to get some form of a mount working.

Step 1: Find a way to mount to your headset's lens

The easiest way to get started is to find a lens protector for your headset. You can visit a website like Thingiverse or do a search for "3d printed lens protector for {your headset here}"

Example: Here is a lens protector for the Quest 1/2 and Rift S https://www.thingiverse.com/thing:3653631

Step 2: Find a camera mount

Now, you need a way to attach the camera. We have a basic design created by qdot, based on his mount on the hardware GitHub here

Alternatively, you can create your own mount if you have the skills.

Step 3: Place the camera mount where it will give a good camera angle

The "Ideal" location is a place that gives a good view of the pupil when looking to all extremes, the lower corners do a good job at getting there, or nearly there.

It is recommended to place the camera as close as possible to the headset's lens to maximize the view of the eye. I recommend looking at other headset mounts for inspiration.

Step 4: Mount your LEDs

You can either add parts to your mount for holding the LED boards or just glue them on. It's up to you and what works best for you, experiment!

Step 5: Test everything

It is unlikely you will get a perfect mount on the first try. Print, test, adjust, and repeat until you have a satisfactory mount. Good luck!

Step 6: Get your mounts listed

Send me the mount to be added to the docs here! You can upload it to Thingiverse or similar services, or just send me the .STLs via discord (Prohurtz#0001)

Released under the MIT License.

- + \ No newline at end of file diff --git a/how_to_build/full_build.html b/how_to_build/full_build.html index fe49bc0..d7d0d72 100644 --- a/how_to_build/full_build.html +++ b/how_to_build/full_build.html @@ -21,7 +21,7 @@
Skip to content

Build Guide

This page will contain a step-by-step assembly guide.

Updated documentation is still in progress and not updated here, please be patient.

This guide provides a walkthrough on the assembly of a wireless V3 eye tracking. V4 specific final docs are Work In Progress: V4 LED Solderless assemblly rough edit:

Sketch of V4 solderless wiring:

Sketch of V4 wiring

Credit: @balty via Discord

Sketch of solder assembly of V4:

Sketch of V4 wire

Nevertheless, it's worth noting that these instructions are also mostly applicable to those who are using wired or V4 trackers.

Step 1: Make sure your have read the Things to know before you start guide

This will give you a basic overview of the project's status and what to expect currently.

Step 2: Order all the parts listed on our Parts list

Please take note of the fact that hardware still may change, although with more developments it seems like we are going to stick with current hardware.

Step 3: Wait for things to arrive

Long shipping times from China are f u n. Please allow anywhere from 2 weeks to 2 months for everything to arrive.

Step 4: Gather up all of your hardware

Make sure you have at least the following:

'img of components'

'ESPs, cams, a programmer and a USB connector'

Step 5: Install external antennas or shield ESP antenna with an antistatic bag

Some ESP-CAM boards have issues with signal integrity, there are 2 things you can do to help/solve the issues.

The first option is to use an external antenna.

This is the best solution when it comes to the final result. If you have Vive/Tundra trackers, this is a REQUIRED step. The interference from the trackers will make your ESP stream unusable. An antistatic bag does not help in this case. Unfortunately, removing the antenna is not super easy, you have to either move a resistor or, remove it and bridge 2 solder pads. The attached image below shows the orientation of the pads that need to be connected, depending on the mode You can not bridge all connections and have both antennas active at the same time. The 0-ohm resistor does not need to be on the board, you can simply bridge the connections.

Below is an example of bridging the connections and attaching an antenna.

'img of external antenna resistors'

The second option is to cover the ESP's antenna with an antistatic bag. This can help aid problems, and can completely solve them in some cases. Best of all, it is completely free! However, it should be noted that it performs worse than an external antenna and in certain cases will not solve the issue like if you have Vive trackers.

Step 6: Attach cameras to ESPs

Look at your ESP and locate the camera ribbon cable connector as circled below.

'img of camera socket'

Flip the gray part up to allow the cameras to be connected. Do not force it, or shove objects into it to open, fingernails are fine.

'img of camera clip'

Now slide in a camera, please note that the pins are facing down, you should only see the black part.

'img of camera cable'

Once the camera has been slid in, press the gray part of the connector back down. There will be a small amount of force but still be gentle. Note the ammount of black coming out of the connector.

'img of camera cable'

Step 7: Connect ESP to the programmer to flash

Why flash before you have it assembled? It's simple, to make sure they actually work before you spend time soldering to them.

Slide your ESP into the programmer, and note the USB port goes away from the ESP's camera.

Step 8: Configure Visual Studio Code and prepare to flash the firmware

Check out our guide on Setting up VS Code

Once VS Code is set up, move on to the next step.

Step 9: Plug in your ESP and flash the firmware

Our guide, Building and uploading the firmware manually has steps on how to do this. After it has flashed, make sure you get a video stream in your browser, then power it down and flash your next ESP.

Step 10: Connect your power wires to a USB Type-A board

WARNING

Powering from the programmer board will not work correctly. This delivers a lower voltage which results in dim LEDs and video artifacts. These are highly likely to mess up tracking.

Get two pairs of wire, preferably two different colors, Cut them to length (56mm in my case) and twist together two for ground and two for 5V. Here I used speaker wire where the copper denotes positive and silver negative. Then, strip the wires to about 3mm of exposed wire.

Step 11: Cut wires for IR LEDs

To find the optimal length, take a piece of wire and a marker and mock up your wire route, and mark the wire, cut it, then make another at the same size for the other eye. You will need 3 different cuts of wire. 2 short ones for connecting the 2 PCBs per eye together, 2 Longer ones for power, or ground and 2 slightly longer ones for power or ground for the LED near the camera at the bottom.

Once cut, strip them to around 4mm of exposed wire.

Step 12: Twist the positive USB wire and positive IR LED wires together and tin them

Once twisted together add solder to keep them together. This makes the connection much easier.

Step 13: Solder the positive wire to ESP

Lay the wire on the outside of the 5V pin and apply solder.

Step 14: Solder the negative wire to ESP

Repeat Step 12 but with the negative wires.

INFO

As a user in our discord has learned, you can short the IO12 pin with the ground pin (GND) without issues.

In the below example I put it on the top of the pin, It will be a weak-ish joint but that's where glue comes in handy.

Step 15: Wire up the 2nd ESP

Repeat steps 12-14 with the 2nd ESP.

Step 16: Prepare to solder IR LED PCBs

Get your magnifying glass out, it's time to solder very smol things.

Gather 4 PCBs, 4 IR LEDs, and either 4 ~350ohm.


357ohm resistors and V3 PCBs

Here are the PCB pin-out labels:


V3

LED labels:


The green markings and notched corners mark the positive sides of the LEDs pictured above.

If you have different LEDs, please consult their datasheet.

Some terminology related to them:

5V: 5-volt power in.

GND: Ground or power out.

AR: After-Resistor this is to be used as the power in on the 2nd PCB in series as resistors are not needed on the 2nd PCB since they are on the 1st one.

SNG: Single resistor, use this as 5V in if you are using only 1 ~700ohm resistor on V3 boards (not recommended).

Negative: This marks the negative side of the LED.

Positive: This marks the positive side of the LED.

Step 18: Solder resistors on PCB V3

You only need 1 PCB to have resistors per eye.

Tin the resistor pads. Note: in this example, I use too much solder, it should only be enough to lightly cover the pad.

Next, grab a resistor and hold it on the pads.

While holding the resistor add solder to your soldering iron and apply it to the resistor.

I like to do this by having a piece of my solder stick up in the air and then put it on my iron that way.

Flip the PCB and solder the other end.

Now repeat for the other one.

Solder LEDs on PCB V3

Tin the LED pads.

Orientate the LED and hold it in place.

Solder one end.

Flip around and solder the other end.

Wire up the PCBs V3

WARNING

Pay attention to the direction of the LEDs on the PCBs.

If the green dot is facing inwards toward the text like in the picture below:

Use the following diagram:

If the green dot is facing away from the text like the picture below:

Use the following diagram:

Step 19: 3D print mounts

Head to the 3D printed parts section of the parts list here.

Find which parts are for your headset and print them. Some may work better or worse, it is recommended to test all of them if there are multiple, print one of each kind. If none work, try making an edit yourself if you have the skills. If you have made a mount make sure to ping me, Prohurtz#0001, so I can add them to the list.

Having trouble getting them to fit? Try resizing the mounts up, or down a little to ensure a good fit.

There are 2 different types of mounts, how to secure the camera to each type will be documented below.

Type 1

This uses a method of sliding in the camera. Generally, this is the recommended mounting method as it generally requires no glue.

Place the camera into the mount

Slowly apply pressure inwards until the camera snaps into place.

NOTE

There is a good chance of breaking the mount when putting in the camera. If this happens you may be able to save the mount depending on where the break was. A small dab of hot glue around the camera is likely all that is needed.

Type 2

This method involves gluing the camera in place.

Apply a bit of glue to the bottom of the camera mount.

Place the camera on the mount.

IR LED mounting

This again differs from mount to mount.

In some cases, there are designated spots for the LEDs to go.

In others there are no specified spots, you will have to mess around to find what works best. This image shows the optimal/near-optimal position for the LEDs. Hot glue is your friend with this.

TIP

Use rubbing alcohol to easily remove hot glue.

Released under the MIT License.

- + \ No newline at end of file diff --git a/how_to_build/part_list.html b/how_to_build/part_list.html index 2459a7d..8a9a78b 100644 --- a/how_to_build/part_list.html +++ b/how_to_build/part_list.html @@ -11,14 +11,14 @@ - + -
Skip to content

WIP new parts list. 3D printed parts will live on their own page.

Use the interactive tables below to select parts!

Required Parts:

ComponentChoiceAmountCostCost AllLinks
ESP Microcontroller2$12.87~$28.92AliExpress XIAO Sense Recommended
Camera2$5.41~$10.82AliExpress Select "Color: 75MM-130 Degree" Must manually remove IR filter
IR LEDs1$24~$29ETVR Store Must solder up your own wires
USB Hub1$17.99~$19.99Amazon Usually these are MTT, but sometimes not
3D Printed Mounts000

Total: $0.00

Additional Parts:

ComponentChoiceAmountCostCost AllLinks
Type A USB Breakout000
USB-C Breakout000
Wire for ESPs000
Wire for LEDs000
Camera Extension Cables000
Camera Extension Connectors000
External Antennas000
USB-C Cables000
V4 LED Wire Extensions/Replacements000

Total: $0.00

Table adjusted from the table on SlimeVR's Docs which was created by Carl

ESP setup options:

DANGER

There are two primary categories of trackers supported: wireless and wired. It's super important that you really look at all your options and consider your use case before making a decision.

Option 1: Wireless over WiFi 2.4 GHz

Wireless Capable ESPs:

  • Seeed Studio XIAO Sense
  • ESP32-CAM
  • FREENOVE ESP32-S3-WROOM CAM Board

This offers a good starting point as the ESP32 CAM boards are cheaper than wired capable trackers. However, they can be a bit more temperamental and if you are using a wired headset, they don't really make sense.

Pros:

  • Not as experimental
  • Less cables (power only)
  • No issues with USB hubs

Cons:

  • Requires two external antennas for optimal streaming quality
  • Requires WiFi 2.4 GHz router or access point in reasonable proximity
  • High risk of radio interference with FBT and other WiFi 2.4 GHz devices
  • ESP32-CAM uses more power and heats up due to radio power needs

Option 2: Wired over USB Serial (in beta)

Wired Capable ESPs:

  • Seeed Studio XIAO Sense
  • FREENOVE ESP32-S3-WROOM CAM Board

This is our latest setup recommended for users with wired headsets such as the Valve Index.

Pros:

  • Much better performance and higher framerate up to 70 FPS with lower latency
  • No conflicts with advanced FBT setups such as Vive or Tundra Trackers
  • Can be wireless or wired
  • Less soldering required

Cons:

  • Requires USB port i.e. on Valve Index and USB hub mounted on your headset
  • Can be slightly more costly
  • When in use with a Vive Facial Tracker, an MTT USB hub is required

Released under the MIT License.

- +
Skip to content

WIP new parts list. 3D printed parts will live on their own page.

Use the interactive tables below to select parts!

Required Parts:

ComponentChoiceAmountCostCost AllLinks
ESP Microcontroller2$12.87~$28.92AliExpress XIAO Sense Recommended
Camera2$5.41~$10.82AliExpress Select "Color: 75MM-130 Degree" Must manually remove IR filter
IR LEDs1$24~$29ETVR Store Must solder up your own wires
USB Hub1$17.99~$19.99Amazon Usually these are MTT, but sometimes not
3D Printed Mounts000

Total: $0.00

Additional Parts:

ComponentChoiceAmountCostCost AllLinks
Type A USB Breakout000
USB-C Breakout000
Wire for ESPs000
Wire for LEDs000
Camera Extension Cables000
Camera Extension Connectors000
External Antennas000
USB-C Cables000
V4 LED Wire Extensions/Replacements000

Total: $0.00

Table adjusted from the table on SlimeVR's Docs which was created by Carl

ESP setup options:

DANGER

There are two primary categories of trackers supported: wireless and wired. It's super important that you really look at all your options and consider your use case before making a decision.

Option 1: Wireless over WiFi 2.4 GHz

Wireless Capable ESPs:

  • Seeed Studio XIAO Sense
  • ESP32-CAM
  • FREENOVE ESP32-S3-WROOM CAM Board

This offers a good starting point as the ESP32 CAM boards are cheaper than wired capable trackers. However, they can be a bit more temperamental and if you are using a wired headset, they don't really make sense.

Pros:

  • Not as experimental
  • Less cables (power only)
  • No issues with USB hubs

Cons:

  • Requires two external antennas for optimal streaming quality
  • Requires WiFi 2.4 GHz router or access point in reasonable proximity
  • High risk of radio interference with FBT and other WiFi 2.4 GHz devices
  • ESP32-CAM uses more power and heats up due to radio power needs

Option 2: Wired over USB Serial (in beta)

Wired Capable ESPs:

  • Seeed Studio XIAO Sense
  • FREENOVE ESP32-S3-WROOM CAM Board

This is our latest setup recommended for users with wired headsets such as the Valve Index.

Pros:

  • Much better performance and higher framerate up to 70 FPS with lower latency
  • No conflicts with advanced FBT setups such as Vive or Tundra Trackers
  • Can be wireless or wired
  • Less soldering required

Cons:

  • Requires USB port i.e. on Valve Index and USB hub mounted on your headset
  • Can be slightly more costly
  • When in use with a Vive Facial Tracker, an MTT USB hub is required

Released under the MIT License.

+ \ No newline at end of file diff --git a/how_to_build/parts_list.html b/how_to_build/parts_list.html index 624e239..c8c786f 100644 --- a/how_to_build/parts_list.html +++ b/how_to_build/parts_list.html @@ -20,7 +20,7 @@
Skip to content

Parts List

CAUTION

Please note that no hardware has been fully set in stone, all purchases are at your own risk in case of hardware changes.

NOTE

It is good practice to buy more than needed in some cases, namely cameras,programmers and ESPs. This reduces the risk of a DOA (dead on arrival) causing a delay.

ESP setup options:

DANGER

There are two primary categories of trackers supported: wireless and wired. It's super important that you really look at all your options and consider your use case before making a decision.

Option 1: Wireless over WiFi 2.4 GHz

This offers a good starting point as the ESP boards are cheaper than wired capable trackers. However, they can be a bit more temperamental and if you are using a wired headset, they start to make less sense.

Pros:

  • Wider user adoption and greater support
  • Low weight, less cables, easier to manage

Cons:

  • Requires two external antennas for optimal streaming quality
  • Requires WiFi 2.4 GHz router or access point in reasonable proximity
  • Risk of radio interference with FBT and other WiFi 2.4 GHz devices
  • ESP32-CAM uses more power and heats up due to radio module power needs

Option 2: Wired over USB Serial (in beta)

This is our latest setup recommended for users with wired headsets such as the Valve Index.

Pros:

  • Much better performance and higher framerates up to 70 FPS with lower latency
  • No conflicts with advanced FBT setups such as Vive or Tundra Trackers
  • Can be wireless or wired
  • Less soldering required

Cons:

  • Requires USB port i.e. on Valve Index and USB hub mounted on your headset
  • Can be more costly

Required parts

With that in mind, here are the required parts for the setup.

Tracker boards:

    • 2x XIAO ESP32-S3 Sense Modules
      Very small size, wireless and wired support, does not require an additional programmer or separate antennas: SeedStudioAliExpress

    Alternatively:

    • 2x Freenove ESP 32-S3 WROOM
      Much larger, price may be higher than the XIAOs, supports wired and wireless as well, does not need a separate programmer, does not support a separate antenna. Amazon
  • A cheaper, wireless only alternative:

    • 2x ESPCAM32 Modules - They are cheaper, requires a separate programmer board, supports only wireless streaming and may require some soldering for attaching separate antennas: AliExpress
      This board also requires a special programmer board in order to flash the firmware. You'll need only one: AliExpress for just programmers or Amazon for 3 ESP32-Cams and programmers without the proper cameras

    • 2x External antennas for ESPs Required if you're running vive/tundra full body tracking or having issues with streaming. See the full build guide on how to configure the ESP board for antenna use.

Cameras

Camera modules:

The cameras that come with the boards will not work, they have an IR filter inside.

The filter can be removed, but doing so may break your cameras. Here's how to do it: https://www.youtube.com/watch?v=QYH-FWvDbDc

DANGER

If you decide to remove the filter, wear eye protection while doing so, the removal of the filter will shatter it.

  • 2x OV2640 160° FOV IR / Night vers 75mm (850nm)

(select 75MM-160 850nm) AliExpress

Amazon alternative (note that you will have to manually remove the IR filter)

Things worth noting:

  • There is an experimental option to purchase OV2640 130° FOV cameras and manually remove the IR filters. This can result in a clearer view of the eye and is smaller so it allows for HMDs like the Bigscreen Beyond, but it's not a default recommendation just yet. Checkout the listing "75MM-130 Degree" AliEXpress

  • If the cameras are Dead on Arrival (DOA), keep in mind that you can swap the lenses with the ones that come with the stock cameras that were included with the ESP32 boards, though they do require extension cables. I recommend just buying more (3-4 instead of just 2).

  • Optional Ribbon extensions:

Certain mounts may require a cable extension (ex: MUTE's frunk mod) To use a mount like that you will need a cable and a connector for each camera. Headsets like the Quest 2 do not require extensions if the camera boards are mounted at the bottom of the headset, near the facial interface.

Extensions (select 0.5mm, A-Forward Direction, 24P) AliExpress (200mm for MUTE's)

Connectors (select 24P) Aliexpress

USB Hubs - for if you are building the wired version

  • 1x USB 3.0+ hub The hub needs to support MTT if you wish to use a vive face tracker with the ESPs. Here is a hub that supports MTT and is not expensive Amazon

Ensure that it is of good quality, lightweight, compact in size, and I suggest a minimum of four ports - one for the face tracker, one for the LED kit, and two for ESP32-S3 boards. Ensure that you acquire appropriate USB-A to USB-C adapters wherever required. For example the Valve Index only has one USB-A port. Be wary that "mini" adapters with the short ends may not work properly. Ensure the adapter has a long end. Such adapter Amazon.

  • 2x USB C cables (as short as possible) to connect both ESPs (select 0.05m/5cm) AliExpress or AliExpress USB C to USB A As the ESP32-S3 has USB-C connectors, you may require some USB-C to USB-A cables depending on your USB hub. It's worth noting that the HTC Face Tracker requires a USB-C port, so you may need to consider this requirement as well. You may also make custom cables using USB breakout boards of your choice and wire.

Wires and adapters

If you are soldering and using custom cables:

IR emitters

We recommend getting the official kits:

Alternatively you can source the parts for V3 yourself:

DANGER

If they look like something you would find in a TV remote, do NOT use them. Even if you think you can alter them THEY WILL NOT WORK AND PUT YOU AT RISK. If you aren't exactly sure what you are doing, buy them from the LCSC or Digikey link.

DO NOT BUY FOCUSED ONES!

  • 4x Unfocused SMD IR emitters

    NOTE

    The smaller ones can not be soldered at temps above 245C or they will burn. Low temp solder is recommended.

  • 4x IR emitter PCBs (highly recommended) Gerber files and schematics located here.

  • 4x 350ohm 1206 SMD resistors for IR emitters (If you are not using PCBs for the emitters then buying regular through-hole resistors is acceptable)

  • 357 ohm Digikey here

  • 348 ohm LCSC here

This ensures you get the correct IR emitter parts. If you are a Patreon please check out discount codes available to you, and also check out unit pricing.

3D Printed Mounts

Mounts with a next to them are the recommended mounts for the respected hmd. This is based on user feedback on what works best for most people.

NOTE

You'll need both - a mount for the IR emitters and a mount for the camera boards, some files include both, some don't.

Misc parts/tools

AliExpress (Generic)
Amazon (Generic)

  • 2x-4x Heatsinks (Optional) - for the ESP32-CAM AliExpress (14mm for ESP, 8mm for voltage regulator)

Other Headsets

If you own another headset not listed above, that means there are no mounts designed for them yet. If you have basic skills in modeling or think up a solution to mount cams and emitters, please try to make a mount and then let us in the discord know so it can be added here. Any headset that can fit the camera is potentially compatible. If you are willing, give it a shot to design a mount for the rest of the community.

Check out our basic guide on making your own mount here.

TIP

If you have a headset mount that is not listed above, please let us know in the discord so it can be added here.

Released under the MIT License.

- + \ No newline at end of file diff --git a/how_to_build/preparing_xiao.html b/how_to_build/preparing_xiao.html index 813f790..5014206 100644 --- a/how_to_build/preparing_xiao.html +++ b/how_to_build/preparing_xiao.html @@ -19,7 +19,7 @@
Skip to content

How to prepare a Seeed Studio XIAO Sense ESP32

What's in the box

Your XIAO should come with the following components:

  • ESP32-S3 Main Board
  • Camera Hat With Low FOV Camera
  • External Antenna
'img of xiao esp'

Seeed Studio XIAO Sense ESP32 Contents

Wired vs Wireless

The only difference in hardware config between wireless and wired XIAOs is if the antenna is connected or not.

Wireless Configuration

If you are making a wireless setup, you will need to connect the antenna.

Line up the antenna connector to the one on the board,

'img of xiao esp'

then press firmly until it snaps on.

'img of xiao esp'

Once connected it should be flat like this:

'img of xiao esp'

Wired Configuration

If you are making a wired setup, you do not need to attach the antenna. Set it aside and continue to the next step.

Connecting the Camera Hat

First, locate the connector on the camera hat, and the corresponding one on the XIAO main board circled below.

'img of xiao esp'

Press down carefully until it snaps on.

'img of xiao esp'
'img of xiao esp'

Once connected remember to be careful, it is known that these connectors can break semi-easily so avoid ripping them apart too many times or twisting on them weirdly.

Removing the Camera

First we need to remove the existing camera from the XIAO and replace it with a higher FOV longer ribbon camera.

Begin by lifting up the grey part of the camera connector gently until it raises up.

'img of xiao esp'
'img of xiao esp'

Now grab the camera and gently wiggle it out of the connector.

'img of xiao esp'
'img of xiao esp'

Connecting the camera

The camera should have the pins facing downward, you should only see the black end.

Line up the camera with the pins on the connector like below.

'img of xiao esp'

Push the camera in by using a finger on each side of the connector, slowly pushing straight in until it stops. Be gentle so you do not damage the ribbon cable.

'img of xiao esp'

The cable should go about half way in like this image:

'img of xiao esp'

Now, close the camera connector by flipping the grey part down.

'img of xiao esp'
'img of xiao esp'

Conclusion

You should now have your XIAO Sense ESP32 ready for firmware flashing!

Released under the MIT License.

- + \ No newline at end of file diff --git a/how_to_build/protecting_cameras.html b/how_to_build/protecting_cameras.html index b9b77f8..aaa55ae 100644 --- a/how_to_build/protecting_cameras.html +++ b/how_to_build/protecting_cameras.html @@ -19,7 +19,7 @@
Skip to content

Protecting a Camera Ribbon Cable

The ribbon cables that these cameras use are notoriously prone to damage rendering them useless.

By wrapping them in tape such as electrical tape and following best practices covered in the guide, you can significantly reduce the risk of killing a camera.

It is recommended to do this before building your setup so you are less likely to kill a camera in the process of building a setup.

Wrapping the Camera Ribbon

First get a roll of electrical tape to wrap the camera ribbon. It does not strictly need to be electrical tape, but that is what I have found to work good, (and look good too).

Place the camera on the tape so that the entire bottom area including the sensor are covered and that one side of the camera ribbon has slightly more tape (helps make it look good).

Cut the tape from the roll, here I used flat cutters. Be careful to not cut the camera connector in the process.

With the tape cut from the roll, lay it down and get out a X-ACTO knife.

Begin to cut around the camera connector so the tape can be peeled off.

When each side has been cut, begin to peel off the part that covered the connections.

Now, carefully cut around the camera sensor part to remove its "skirt" leaving tape on the back of it.

Gently pull off this outline of tape from the camera.

Begin to wrap the tape along the ribbon cable by first folding in the slightly shorter side.

Fold over the other side.

And you are done!

Best Practices When Handling Cameras

  • Do not pull or jerk on the ribbon
  • Do not fold tightly or bend the ribbon cable sharper than ~45 degrees if possible
  • Do not expose to sharp objects or crevices
  • The less wear while handling or putting on/off a headset the better

Conclusion

You have successfully wrapped your camera to be protected and learned the best practices with handling cameras!

Released under the MIT License.

- + \ No newline at end of file diff --git a/index.html b/index.html index f2295aa..1367d4a 100644 --- a/index.html +++ b/index.html @@ -19,7 +19,7 @@
Skip to content

EyeTrackVR Docs

Open-source and affordable VR eye tracking.

For Social VR Games via OSC and UDP protocol.

ETVR logo

Released under the MIT License.

- + \ No newline at end of file diff --git a/misc/faq.html b/misc/faq.html index 2b8d75d..e4b1e7b 100644 --- a/misc/faq.html +++ b/misc/faq.html @@ -19,7 +19,7 @@
Skip to content

Frequently Asked Questions



Released under the MIT License.

- + \ No newline at end of file diff --git a/misc/vrc_avatar_setup.html b/misc/vrc_avatar_setup.html index fdf429c..6bf0abc 100644 --- a/misc/vrc_avatar_setup.html +++ b/misc/vrc_avatar_setup.html @@ -19,7 +19,7 @@
Skip to content

How to set up your avatar for eye tracking:

Here is an avatar setup video created by a contributor:

Another good resource is the VRC Face Tracking Wiki and their Discord.

We currently use the following paramaters

LeftEyeX

RightEyeX

EyesY

LeftEyeLidExpandedSqueeze

RightEyeLidExpandedSqueeze

NOTE

We currently only support float parameters, please adjust your setup accordingly.

Released under the MIT License.

- + \ No newline at end of file diff --git a/software_guide/build_software.html b/software_guide/build_software.html index 9171b98..6756354 100644 --- a/software_guide/build_software.html +++ b/software_guide/build_software.html @@ -20,7 +20,7 @@
Skip to content

Build the app from source

This guide will show how to build the app from source

NOTE

This is NOT a required step, you do not need to build the app from source.

Requirements

Install Python

EyeTrackVR is currently using Python 3.11.0 Before you continue, please install it.

Installing Poetry

Starting with version 0.1.7, EyeTrackVR uses Poetry to manage app dependencies. To build the app, you must first install Poetry to fetch the required dependencies.

To install Poetry open Windows Powershell and run the following command (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

Poetry Documentation

Install the required Python modules

After cloning the project and installing Poetry, open a command prompt in the EyeTrackApp folder. Then run the command: poetry install

This should install all of the required modules.

Build the app

Now, you should be ready to build the app. With a command prompt open in the EyeTrackApp folder, run the command poetry run pyinstaller eyetrackapp.spec

Give it time to build the app. Once done, the app should be under dist/eyetrackapp

Released under the MIT License.

- + \ No newline at end of file diff --git a/software_guide/eyetrackvr_app_guide.html b/software_guide/eyetrackvr_app_guide.html index 974d8ed..8049532 100644 --- a/software_guide/eyetrackvr_app_guide.html +++ b/software_guide/eyetrackvr_app_guide.html @@ -20,7 +20,7 @@
Skip to content

How to install, run and adjust the EyeTrackVR app.

Step 1: Download the EyeTrackVR Installer and install the EyeTrackVR app

Go to the latest GitHub release here and download the Setup.exe file.

Follow the prompts and the app should be installed.

Step 2: Run the EyeTrackVR app

If the Create Desktop Shortcut option was checked you should see an icon on your desktop, double click it to run.

You then should be greeted with a GUI that looks like this:

'img'

Step 3: Getting familiar with settings and terminology

Let's go over some basic terminology you will find in the app.

Starting from the top:

Right eye

Shows the right eye feed and settings only.

Left eye

Shows the left eye feed and settings only.

Both eyes

Shows both eyes' feed and settings.

Camera Address

This is where you enter the IP address of your camera. Alternatively, it can be used to put the cam number for wired cameras or pass in a video file.

Tracking Mode

This changes the GUI to the tracking mode where it outputs values.

Cropping Mode

This is where you will crop out your eye.

Threshold

This is used to cut out things that aren't dark like your pupil.

Rotation

For our method to work best, you want your eye to be level. Use this slider to adjust it to where that is the case.

Restart Calibration

This will start a calibration mode for your eye where you look to all extremes.

Recenter Eye

This will recenter your eye to whatever point you are looking at.

Step 4: Adding your cameras to the software and configuring them

Wireless configuration

Power your ESPs and find what the IP address is for your right eye. This can be done by opening both Cameras in a browser and then holding your finger over your right eye camera.

Copy that IP address and then close the browser tab with it open.

Enter that IP address into the app's Camera Address field.

Press the Save and Restart Tracking button.

Wired configuration (experimental)

Note this is a Beta app feature only. Please use the latest Open Beta in the Discord.

Find your ESPs in Device Manager and figure out their COM port numbers, e.g. COM4.

Enter that COM port number into the app's Camera Address field.

Press the Save and Restart Tracking button.

Setting up ROI

Don't see your camera feed? That's because an ROI hasn't been set yet.

'img'

See the Awaiting Eye Cropping Settings text?

Now press the Cropping Mode button. You should see a feed of your camera.

Put your headset on and use an application to see your desktop. (Virtual desktop, SteamVR desktop, etc.)

You should see something like this:

'img'

:O It's my eye!

Now, draw a rectangle that selects your eye.

A good example of an ROI

'img'

Head back over to the Tracking mode.

We will now adjust our rotation by moving the Rotation slider.

From this:

'img'

It's crooked!

To this:

'img'

Much better!

Now we will adjust our threshold.

Continuing with your headset on, move the slider all the way up. start slowly backing it off until mainly only your pupil is being visualized in the threshold viewer.

Example of a threshold being too low:

'img'

Much better!

Example of too high of a threshold:

'img'

Much better!

Example of a good threshold:

'img'

Much better!

Repeat everything in this step for your left eye.

Step 5: Calibrating your eyes

Once your eye is trackable by the software we need to calibrate it.

Press the Restart Calibration button and look around. The important part is that you look to all extremes, all the way up, left, etc. Once you have done so, wait for the Mode to say Tracking

The next step is to center your eye.

Look straight forward and press the Recenter Eye button.

Your eye is now fully calibrated.

Repeat for your other eye.

NOTE

To best center both eyes, look at one spot and hit the 'Recenter Eye' button for each eye without moving your eyes.

See anything outdated on this guide? Let me know! Prohurtz#0001

Released under the MIT License.

- + \ No newline at end of file diff --git a/software_guide/osc_setup.html b/software_guide/osc_setup.html index 3e69317..6583b69 100644 --- a/software_guide/osc_setup.html +++ b/software_guide/osc_setup.html @@ -20,7 +20,7 @@
Skip to content

Setting up recalibration and recentering from VRChat.

ETVR has a mechanism that allows you to recalibrate and recenter your tracking without the need to interact with the app directly, here's how to set up your avatar to make use of OSC to trigger this from within VRC itself.

NOTE

Note, while this page explains how to do it from the point of view of vrchat, it can be done in Neos and CVR too, all the app listens to are two OSC messages.

Setting up your parameters

Adding parameters

You'll need to add two parameters to your Parameters config, those being:

  • etvr_recalibrate: Bool
  • etvr_recenter: Bool

Both of them do not have to be synced, meaning they won't increase your total memory count.

To do this, in Unity, select your avatar on the scene and find Avatar Descriptor in the inspector. In it, find the section named "expressions", expand it and click on the file assigned to the "parameters" field, that's your Parameters config.

Screenshot showing expressions section of vrc avatar descriptor

Clicking on it will highlight the associated asset in the asset browser. Click on the highlighted file to get its content to show in the inspector panel. Now, in the inspector, click on the Add button to add the parameters mentioned above. Both of them need to be of type Bool, but they don't need to be synced nor saved.

Screenshot showing adding parameters to parameter menu
Screenshot showing the params that need to be added

That's it for the parameters.

Adding buttons to the menu

Now, you will need to add actual buttons for them in your gesture menu.

The expressions section mentioned above also contains the menu, you can use that to either add the buttons there directly or create a small submenu to make it less cluttered, here we will add them directly.

Screenshot showing expressions section of vrc avatar descriptor

Once you have the menu file opened in the inspector, click on the "add control" button. This will add an empty action slot, expand it.

Screenshot showing the the empty controls field

You'll see a bunch of fields, like name, icon, type and parameter. Firstly, let's give it a friendly name like "recalibrate eyes" or "recenter tracking" depending on the action you want to assign to them.

Leave the type as is - as a button, it's more convenient as it bounces back into the off state by itself.

Now, in the parameter section, click on the [None] and select one of the parameters you have created in the previous section.

Screenshot showing the the controls setup

Repeat the steps for the other one.

Once done simply build and upload the updated version of your avatar.

And that's it, you now should be able to recenter and recalibrate your tracking form inside of VRC!

Resetting the OSC config in case the parameters don't work

Sometimes VRChat won't regenerate the config files that it uses to communicate the changes to anyone that's listening. To fix this, it's enough to simply delete the auto generated configuration files and let VRC remake them.

They are stored under

C:\Users\<user>\AppData\LocalLow\VRChat\VRChat\OSC\<your user uuid>\Avatars\

Deleting the contents of the Avatars directory will resolve the issue.

Other platforms

Like mentioned in the note, this functionality is not limited to VRC.

The app itself listens to OSC messages sent on port 9001 to two addresses:

  • /avatar/parameters/etvr_recenter
  • /avatar/parameters/etvr_recalibrate

It only needs to receive a Bool value of True to trigger the recenter and calibration.

The port and the addresses can be changed in the app settings, if need be.

Released under the MIT License.

- + \ No newline at end of file