Skip to content

Commit

Permalink
Changes Readme, and added Vang1 3D models (#39)
Browse files Browse the repository at this point in the history
* 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
hugogarrix authored and maxim-perumal committed Apr 14, 2019
1 parent 450bf6d commit bbff11f
Show file tree
Hide file tree
Showing 35 changed files with 175,037 additions and 35 deletions.
70 changes: 35 additions & 35 deletions README.md
Original file line number Diff line number Diff line change
@@ -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>

Expand All @@ -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 ⚡️

Expand All @@ -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%">
Expand All @@ -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>
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
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 added Vang1 3D models/Part010_-_Lens_Adjuster_LEFT.stl
Binary file not shown.
Binary file added Vang1 3D models/Part011_-_Lens_mount.stl
Binary file not shown.
Binary file not shown.
Binary file added Vang1 3D models/Part013_-_Lens_Fastner.stl
Binary file not shown.
Binary file added Vang1 3D models/Part01_-_HDMI_Board_plate.stl
Binary file not shown.
Binary file added Vang1 3D models/Part02_-_Logo_front_cover.stl
Binary file not shown.
Binary file added Vang1 3D models/Part02_-_NO_LOGO.stl
Binary file not shown.
Binary file added Vang1 3D models/Part03_-_Screen_frame.stl
Diff not rendered.
Binary file added Vang1 3D models/Part04_-_Eye_piece_B.stl
Diff not rendered.
Binary file added Vang1 3D models/Part05_-_Eye_Piece_A.stl
Diff not rendered.
Loading

0 comments on commit bbff11f

Please sign in to comment.