Skip to content
Permalink
Browse files

Changes Readme, and added Vang1 3D models (#39)

* Vang1 | 3D models

Added the 3D models of Vang1, so people can choose between the models from Vang1, and TheYXXY.

* Changed folder name

Changed the Folder name "3D models" to "TheYXXY 3D models"

* Changed reamde

Added some changes for Vang1's 3D models.

* Added info about Vang1's 3D models

Added more info about what you need to make the Vang1 3D models.

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md
  • Loading branch information...
AdmiraalHugo authored and maxime-coutte committed Apr 14, 2019
1 parent 450bf6d commit bbff11f0ca92edd74f7f935af90f3948108065e6
Showing with 175,037 additions and 35 deletions.
  1. +35 βˆ’35 README.md
  2. BIN {3D-Models β†’ TheYXXY 3D models}/Part_1_Eyepiece.stl
  3. 0 {3D-Models β†’ TheYXXY 3D models}/Part_2a.stl
  4. 0 {3D-Models β†’ TheYXXY 3D models}/Part_2b.stl
  5. 0 {3D-Models β†’ TheYXXY 3D models}/Part_2c_Lens_Mount.stl
  6. 0 {3D-Models β†’ TheYXXY 3D models}/Part_2d_Lens_Fastener.stl
  7. BIN {3D-Models β†’ TheYXXY 3D models}/Part_3_Connector.stl
  8. 0 {3D-Models β†’ TheYXXY 3D models}/Part_3a.stl
  9. 0 {3D-Models β†’ TheYXXY 3D models}/Part_3b.stl
  10. BIN {3D-Models β†’ TheYXXY 3D models}/Part_4a_Cover.stl
  11. BIN {3D-Models β†’ TheYXXY 3D models}/Part_4b_Soft_Mount.stl
  12. BIN {3D-Models β†’ TheYXXY 3D models}/Part_4c_Reinforcement_Plate.stl
  13. 0 {3D-Models β†’ TheYXXY 3D models}/Part_5.stl
  14. 0 {3D-Models β†’ TheYXXY 3D models}/Part_6_190mm.stl
  15. 0 {3D-Models β†’ TheYXXY 3D models}/Part_6_250mm.stl
  16. 0 {3D-Models β†’ TheYXXY 3D models}/Part_7_190mm.stl
  17. 0 {3D-Models β†’ TheYXXY 3D models}/Part_7_250mm.stl
  18. 0 {3D-Models β†’ TheYXXY 3D models}/Part_8.stl
  19. 0 {3D-Models β†’ TheYXXY 3D models}/Part_9_extension.stl
  20. BIN Vang1 3D models/Part010_-_Lens_Adjuster_LEFT.stl
  21. BIN Vang1 3D models/Part011_-_Lens_mount.stl
  22. BIN Vang1 3D models/Part012_-_Lens_Adjuster_button.stl
  23. BIN Vang1 3D models/Part013_-_Lens_Fastner.stl
  24. BIN Vang1 3D models/Part01_-_HDMI_Board_plate.stl
  25. BIN Vang1 3D models/Part02_-_Logo_front_cover.stl
  26. BIN Vang1 3D models/Part02_-_NO_LOGO.stl
  27. BIN Vang1 3D models/Part03_-_Screen_frame.stl
  28. BIN Vang1 3D models/Part04_-_Eye_piece_B.stl
  29. BIN Vang1 3D models/Part05_-_Eye_Piece_A.stl
  30. +175,002 βˆ’0 Vang1 3D models/Part06_-_Hardware_box.stl
  31. BIN Vang1 3D models/Part06_-_Hardware_box_ARDUINO_DUE.stl
  32. BIN Vang1 3D models/Part06_-_Hardware_box_STM32.stl
  33. BIN Vang1 3D models/Part07_-_Connector_A.stl
  34. BIN Vang1 3D models/Part08_-_Connector_B.stl
  35. BIN Vang1 3D models/Part09_-_Lens_Adjuster_RIGHT.stl
@@ -1,8 +1,3 @@
<h1 align="center">
<br>
<a href="https://github.com/relativty/Relativ"><img src="https://avatars0.githubusercontent.com/u/31791204?s=200&v=4" width="180"></a>
</h1>

<h4 align="center">We couldn't afford an Oculus so we built one
</h4>

@@ -29,21 +24,26 @@ build your VR headset too. </p>

# Meet the team ❀️

<p align="center"> <img src="/img/gabriel.png" width="370"> </p>
<p align="center"> <strong> Gabriel: </strong>I work on optics for <a href="https://github.com/relativty/fastVR-sdk">FastVR</a>, 3D conception with Maxime and cheap tracking for the next big update. </p>

<p align="center"> <img src="/img/maxime.png" width="370"> </p>
<p align="center"> <strong> Maxime: </strong> I created <a href="https://github.com/relativty/wrmhl">WRMHL</a> and with Gabriel we created <a href="https://github.com/relativty/fastVR-sdk">FastVR</a>. I'm also behind the code for the hardware. </p>
<p align="center"> <img src="/img/jonas.png" width="370"> </p>
<p align="center"> <strong> Jonas: </strong> I convinced a Chinese factory to sell us premium components at low prices and I'm working on a Master Guide for Relativ. </p>
<p align="center"> <img src="/img/sensei.png" width="370"> </p>
<p align="center"> <strong> Sensei: </strong> I'm the theoretician of the team. I teach them math and I help them to solve algorithm issues. </p>
<img align="right" width="100" height="100" src="https://github.com/relativty/Relativ/blob/master/img/gabriel.png"> </p>
<p align="left"> <strong> Gabriel: </strong>I work on optics for <a href="https://github.com/relativty/fastVR-sdk">FastVR</a>, 3D conception with Maxime and cheap tracking for the next big update. </p>
<br>
<br>
<img align="right" width="100" height="100" src="https://github.com/relativty/Relativ/blob/master/img/maxime.png"> </p>
<p align="left"> <strong> Maxime: </strong> I created <a href="https://github.com/relativty/wrmhl">WRMHL</a> and with Gabriel we created <a href="https://github.com/relativty/fastVR-sdk">FastVR</a>. I'm also behind the code for the hardware. </p>
<br>
<br>
<img align="right" width="100" height="100" src="https://github.com/relativty/Relativ/blob/master/img/jonas.png"> </p>
<p align="left"> <strong> Jonas: </strong> I convinced a Chinese factory to sell us premium components at low prices and I'm working on a Master Guide for Relativ. </p>
<br>
<br>
<img align="right" width="100" height="100" src="https://github.com/relativty/Relativ/blob/master/img/sensei.png"> </p>
<p align="left"> <strong> Sensei: </strong> I'm the theoretician of the team. I teach them math and I help them to solve algorithm issues. </p>

# Open-Source it FTW

<p> Thanks to this project I’ve had the incredible fortune to meet amazing people, including the chief architect at Oculus, Atman Binstock. He gave me a precious piece of advice: "open source it". I deleted all the code I had, and started rewriting it all from scratch, better. And I convinced my two friends and our math teacher to open source the project </p>

<img src="/img/headset.JPG" width="100%">
<img src="/img/headset.JPG" width="70%">

# Getting Started ⚑️

@@ -52,20 +52,27 @@ Relativ is based on <a href="https://github.com/relativty/wrmhl">WRMHL</a> and <
## What you'll need

### What components ?
There are now two variants of Relativ. The original design by the founders **(deprecated)** and new version by TheYxxy based on a on a model from <a href="http://horizonlab.co/2017/05/28/vr-headset-fully-3d-printed/">Horizon Lab</a>. Shoutout to them for making this possible and allowing their design to be modified! </p>
##### For both designs:
There are a few variants of Relativ. The original design by the founders **(deprecated)** and two new version by TheYXXY and Vang1 based on a on a model from <a href="http://horizonlab.co/2017/05/28/vr-headset-fully-3d-printed/">Horizon Lab</a>. Shoutout to them for making this possible and allowing their design to be modified! </p>

##### Parts needed for all the designs:
* Arduino Due, $34 for the official one or $10 for a Chinese clone
* GY-521 MPU-6050, $1
* 5.5 inch 2560*1440 2K LCD Screen HDMI to MIPI, up to 100€ on AliExpress (<a href="https://www.aliexpress.com/item/5-5-inch-1440x2560-2K-IPS-LCD-screen-display-with-HDMI-top-MIPI-controller-board-for/32817672501.html">recommended</a>) ⚠️ Price may vary a lot
* Face foam, about $4, see [here](https://www.ebay.com/itm/Face-Foam-Replacement-Eye-Masks-Pads-Cover-Fit-For-HTC-Vive-VR-Goggles-Headphone/152798949280?_mwBanner=1&_rdt=1 "here")

###### For the current design:
###### Extra needed for the TheYXXY design:
* Biconvex lens, Focal length 37mm, 45mm diameter <a href="https://www.ebay.com/">recommended</a>
* 4 M3 Screws and 2 M2 screws, both with nuts, $3 - alternatively you can use hot glue if M2 screws are not available
* TPU 95 filament is recommended in addition to the normal PLA, and a printer which supports printing it
* A screen which has a cable with a 90 degree bend just like the <a href="https://www.aliexpress.com/item/5-5-inch-1440x2560-2K-IPS-LCD-screen-display-with-HDMI-top-MIPI-controller-board-for/32817672501.html">recommended</a> one. For the direction: it should go up behind the screen when the small non-screen part is on the right while looking at the screen.

###### For the old (deprecated) design:
###### Extra needed for the Vang1 design:
* Biconvex lens, Focal length 37mm, 45mm diameter <a href="https://www.ebay.com/">recommended</a>
* Headstrap <a href="https://www.ebay.com/itm/SJCAM-SJ4000-SJ5000-Xiaomi-Yi-Head-Strap-Mount-Elastic-Adjustable-Head-Band/272024772003?ssPageName=STRK%3AMEBIDX%3AIT&_trksid=p2060353.m2749.l2649">recommended</a> (needs a bit modification)
* ABS or PETG filament with 20% infill is recommended, but PLA also works fine. All the parts can be printed without infill.
* M3 screws (More info will be added soon!!)
###### Extra needed for the old (deprecated) design:
* Fresnel lens Focal Length 80mm, $3 (<a href="https://www.ebay.com/itm/2Pcs-Fresnel-lens-Focal-Length-40-50-55-60-70-80mm-for-Google-Cardboard-3D-VR/201984369021">recommended</a>)
<img src="/img/component.JPG" width="100%">
@@ -82,27 +89,20 @@ Copy all folders in **Relativ/src/libraries** and past them in your Arduino Libr
# Building the hardware
Now what you need to do is 3D-print the hardware; if needed you can change any models with provided Source Files.
You will need to print the following :
**A detailed documentation can be found on our <a href="https://wiki.relativty.net/index.php/Main_Page">wiki<a/>!**
Now what you need to do is 3D-print the hardware; if needed you can change any models with provided Source Files.
* (1x): Part 1, Part 2a, Part 2b, Part 3, Part 3a, Part 4, Part 5
* (2x): Part 2c, Part 2d, Part 3b
* (1x) Part 6: Use of Flexible filament with 10% to 50% infill density
* (3x) Part 7: Use of Flexible filament with 10% to 50% infill density
* (1x) Part 8: Use of Flexible filament with 5% infill density (it makes it like a sponge)
* If you uses the the short straps (190mm, because the large ones don't fit in your printer for example), there are extensions (part 9) that should be printed aswell (2x).

⚠️ **PAY EXTRA ATTENTION TO THE SCREEN, IT'S VERY FRAGILE** ⚠️

Additional build information can be found in the build manuals in the 3D-Models folders.
⚠️ PAY EXTRA ATTENTION TO THE SCREEN, IT'S VERY FRAGILE ⚠️
# Building the software

Make sure you have all the libraries needed installed and upload the following program to the Arduino:
#### Path: Relativ/src/main/main.ino
<img src="/img/arduino-upload.gif">
# Play some demos
Path: Relativ/src/main/main.ino
Our documentation can be found on our <a href="https://wiki.relativty.net/index.php/Main_Page">wiki<a/>.
# Play some demos or use SteamVR
<p> You can now play with your headset by downloading some cool demos by <a href="https://github.com/relativty/Relativ/releases/download/v0.1-beta/Unity_build.zip">clicking here<a/>. Or build your own game in a minute using the Relativty sdk, learn more by <a href="https://github.com/relativty/fastVR-sdk"> clicking here </a>. </p>
<p> I would love to hear about what you’ve experienced building the headset or help if you have any questions. Ping me at maxime@relativty.com or <a href="https://twitter.com/maximecoutte">@maximecoutte</a>. </p>
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Diff not rendered.
Diff not rendered.
Diff not rendered.
Oops, something went wrong.

0 comments on commit bbff11f

Please sign in to comment.
You can’t perform that action at this time.