Added STM32 code, and fixes in Readme.MD (#43)

* added STM32 code Added STM32 code Moved some files to different folders, to make the GitHub more userfriendly. * Removed a file Removed a file, becuase the info has been added to the main README.md * Update README.md * Update README.md * Update README.md * Fixed link Fixed the link for the face foam. * Fixed typo Fixed a typo of the Biconvex lenses * Update README.md * Fixed typo's Fixed a few more typo's in the Readme.MD * Create PULL_REQUEST_TEMPLATE.md * Added info Vang1 design Added the amount of screws needed to make the Vang1 VR headset. * Added images Added extra images, to help people build the headset. * Create README.md * Update README.md * Update README.md * Update README.md
relativty · Apr 22, 2019 · 5e4482e · 5e4482e
1 parent aa05bfc
commit 5e4482e
Show file tree

Hide file tree

Showing 96 changed files with 20,217 additions and 19 deletions.
diff --git a/TheYXXY 3D models/Part_1_Eyepiece.stl → ...els/TheYXXY 3D models/Part_1_Eyepiece.stl b/TheYXXY 3D models/Part_1_Eyepiece.stl → ...els/TheYXXY 3D models/Part_1_Eyepiece.stl
diff --git a/TheYXXY 3D models/Part_2a.stl → 3D models/TheYXXY 3D models/Part_2a.stl b/TheYXXY 3D models/Part_2a.stl → 3D models/TheYXXY 3D models/Part_2a.stl
diff --git a/TheYXXY 3D models/Part_2b.stl → 3D models/TheYXXY 3D models/Part_2b.stl b/TheYXXY 3D models/Part_2b.stl → 3D models/TheYXXY 3D models/Part_2b.stl
diff --git a/TheYXXY 3D models/Part_2c_Lens_Mount.stl → .../TheYXXY 3D models/Part_2c_Lens_Mount.stl b/TheYXXY 3D models/Part_2c_Lens_Mount.stl → .../TheYXXY 3D models/Part_2c_Lens_Mount.stl
diff --git a/TheYXXY 3D models/Part_2d_Lens_Fastener.stl → ...eYXXY 3D models/Part_2d_Lens_Fastener.stl b/TheYXXY 3D models/Part_2d_Lens_Fastener.stl → ...eYXXY 3D models/Part_2d_Lens_Fastener.stl
diff --git a/TheYXXY 3D models/Part_3_Connector.stl → ...ls/TheYXXY 3D models/Part_3_Connector.stl b/TheYXXY 3D models/Part_3_Connector.stl → ...ls/TheYXXY 3D models/Part_3_Connector.stl
diff --git a/TheYXXY 3D models/Part_3a.stl → 3D models/TheYXXY 3D models/Part_3a.stl b/TheYXXY 3D models/Part_3a.stl → 3D models/TheYXXY 3D models/Part_3a.stl
diff --git a/TheYXXY 3D models/Part_3b.stl → 3D models/TheYXXY 3D models/Part_3b.stl b/TheYXXY 3D models/Part_3b.stl → 3D models/TheYXXY 3D models/Part_3b.stl
diff --git a/TheYXXY 3D models/Part_4a_Cover.stl → ...odels/TheYXXY 3D models/Part_4a_Cover.stl b/TheYXXY 3D models/Part_4a_Cover.stl → ...odels/TheYXXY 3D models/Part_4a_Cover.stl
diff --git a/TheYXXY 3D models/Part_4b_Soft_Mount.stl → .../TheYXXY 3D models/Part_4b_Soft_Mount.stl b/TheYXXY 3D models/Part_4b_Soft_Mount.stl → .../TheYXXY 3D models/Part_4b_Soft_Mount.stl
diff --git a/...3D models/Part_4c_Reinforcement_Plate.stl → ...3D models/Part_4c_Reinforcement_Plate.stl b/...3D models/Part_4c_Reinforcement_Plate.stl → ...3D models/Part_4c_Reinforcement_Plate.stl
diff --git a/TheYXXY 3D models/Part_5.stl → 3D models/TheYXXY 3D models/Part_5.stl b/TheYXXY 3D models/Part_5.stl → 3D models/TheYXXY 3D models/Part_5.stl
diff --git a/TheYXXY 3D models/Part_6_190mm.stl → 3D models/TheYXXY 3D models/Part_6_190mm.stl b/TheYXXY 3D models/Part_6_190mm.stl → 3D models/TheYXXY 3D models/Part_6_190mm.stl
diff --git a/TheYXXY 3D models/Part_6_250mm.stl → 3D models/TheYXXY 3D models/Part_6_250mm.stl b/TheYXXY 3D models/Part_6_250mm.stl → 3D models/TheYXXY 3D models/Part_6_250mm.stl
diff --git a/TheYXXY 3D models/Part_7_190mm.stl → 3D models/TheYXXY 3D models/Part_7_190mm.stl b/TheYXXY 3D models/Part_7_190mm.stl → 3D models/TheYXXY 3D models/Part_7_190mm.stl
diff --git a/TheYXXY 3D models/Part_7_250mm.stl → 3D models/TheYXXY 3D models/Part_7_250mm.stl b/TheYXXY 3D models/Part_7_250mm.stl → 3D models/TheYXXY 3D models/Part_7_250mm.stl
diff --git a/TheYXXY 3D models/Part_8.stl → 3D models/TheYXXY 3D models/Part_8.stl b/TheYXXY 3D models/Part_8.stl → 3D models/TheYXXY 3D models/Part_8.stl
diff --git a/TheYXXY 3D models/Part_9_extension.stl → ...ls/TheYXXY 3D models/Part_9_extension.stl b/TheYXXY 3D models/Part_9_extension.stl → ...ls/TheYXXY 3D models/Part_9_extension.stl
diff --git a/3D models/Vang1 3D models/Images (for Documentation)/M3x20 screws 2.jpg b/3D models/Vang1 3D models/Images (for Documentation)/M3x20 screws 2.jpg
diff --git a/3D models/Vang1 3D models/Images (for Documentation)/M3x20 screws.jpg b/3D models/Vang1 3D models/Images (for Documentation)/M3x20 screws.jpg
diff --git a/3D models/Vang1 3D models/Images (for Documentation)/mounting STM32.png b/3D models/Vang1 3D models/Images (for Documentation)/mounting STM32.png
diff --git a/...D models/Part010_-_Lens_Adjuster_LEFT.stl → ...D models/Part010_-_Lens_Adjuster_LEFT.stl b/...D models/Part010_-_Lens_Adjuster_LEFT.stl → ...D models/Part010_-_Lens_Adjuster_LEFT.stl
diff --git a/Vang1 3D models/Part011_-_Lens_mount.stl → .../Vang1 3D models/Part011_-_Lens_mount.stl b/Vang1 3D models/Part011_-_Lens_mount.stl → .../Vang1 3D models/Part011_-_Lens_mount.stl
diff --git a/...models/Part012_-_Lens_Adjuster_button.stl → ...models/Part012_-_Lens_Adjuster_button.stl b/...models/Part012_-_Lens_Adjuster_button.stl → ...models/Part012_-_Lens_Adjuster_button.stl
diff --git a/Vang1 3D models/Part013_-_Lens_Fastner.stl → ...ang1 3D models/Part013_-_Lens_Fastner.stl b/Vang1 3D models/Part013_-_Lens_Fastner.stl → ...ang1 3D models/Part013_-_Lens_Fastner.stl
diff --git a/...1 3D models/Part01_-_HDMI_Board_plate.stl → ...1 3D models/Part01_-_HDMI_Board_plate.stl b/...1 3D models/Part01_-_HDMI_Board_plate.stl → ...1 3D models/Part01_-_HDMI_Board_plate.stl
diff --git a/...1 3D models/Part02_-_Logo_front_cover.stl → ...1 3D models/Part02_-_Logo_front_cover.stl b/...1 3D models/Part02_-_Logo_front_cover.stl → ...1 3D models/Part02_-_Logo_front_cover.stl
diff --git a/Vang1 3D models/Part02_-_NO_LOGO.stl → ...dels/Vang1 3D models/Part02_-_NO_LOGO.stl b/Vang1 3D models/Part02_-_NO_LOGO.stl → ...dels/Vang1 3D models/Part02_-_NO_LOGO.stl
diff --git a/Vang1 3D models/Part03_-_Screen_frame.stl → ...Vang1 3D models/Part03_-_Screen_frame.stl b/Vang1 3D models/Part03_-_Screen_frame.stl → ...Vang1 3D models/Part03_-_Screen_frame.stl
diff --git a/Vang1 3D models/Part04_-_Eye_piece_B.stl → .../Vang1 3D models/Part04_-_Eye_piece_B.stl b/Vang1 3D models/Part04_-_Eye_piece_B.stl → .../Vang1 3D models/Part04_-_Eye_piece_B.stl
diff --git a/Vang1 3D models/Part05_-_Eye_Piece_A.stl → .../Vang1 3D models/Part05_-_Eye_Piece_A.stl b/Vang1 3D models/Part05_-_Eye_Piece_A.stl → .../Vang1 3D models/Part05_-_Eye_Piece_A.stl
diff --git a/Vang1 3D models/Part06_-_Hardware_box.stl → ...Vang1 3D models/Part06_-_Hardware_box.stl b/Vang1 3D models/Part06_-_Hardware_box.stl → ...Vang1 3D models/Part06_-_Hardware_box.stl
diff --git a/...els/Part06_-_Hardware_box_ARDUINO_DUE.stl → ...els/Part06_-_Hardware_box_ARDUINO_DUE.stl b/...els/Part06_-_Hardware_box_ARDUINO_DUE.stl → ...els/Part06_-_Hardware_box_ARDUINO_DUE.stl
diff --git a/...3D models/Part06_-_Hardware_box_STM32.stl → ...3D models/Part06_-_Hardware_box_STM32.stl b/...3D models/Part06_-_Hardware_box_STM32.stl → ...3D models/Part06_-_Hardware_box_STM32.stl
diff --git a/Vang1 3D models/Part07_-_Connector_A.stl → .../Vang1 3D models/Part07_-_Connector_A.stl b/Vang1 3D models/Part07_-_Connector_A.stl → .../Vang1 3D models/Part07_-_Connector_A.stl
diff --git a/Vang1 3D models/Part08_-_Connector_B.stl → .../Vang1 3D models/Part08_-_Connector_B.stl b/Vang1 3D models/Part08_-_Connector_B.stl → .../Vang1 3D models/Part08_-_Connector_B.stl
diff --git a/...D models/Part09_-_Lens_Adjuster_RIGHT.stl → ...D models/Part09_-_Lens_Adjuster_RIGHT.stl b/...D models/Part09_-_Lens_Adjuster_RIGHT.stl → ...D models/Part09_-_Lens_Adjuster_RIGHT.stl
diff --git a/Arduino Due/README.md b/Arduino Due/README.md
@@ -0,0 +1 @@
+**PLEASE NOTE**; We highly recommend that you use the STM32 tracker because it has proved to be more stable than the Due based one. The Due code has recently been reported to throw compiler errors, and the Due trackers have exhibited stability issues. Because of this, we will be phasing out support for the Arduino DUE code in the next couple of months. *(NOTE added on Apr 17, 2019)*
diff --git a/src/libraries/I2Cdev/I2Cdev.cpp → Arduino Due/src/libraries/I2Cdev/I2Cdev.cpp b/src/libraries/I2Cdev/I2Cdev.cpp → Arduino Due/src/libraries/I2Cdev/I2Cdev.cpp
diff --git a/src/libraries/I2Cdev/I2Cdev.h → Arduino Due/src/libraries/I2Cdev/I2Cdev.h b/src/libraries/I2Cdev/I2Cdev.h → Arduino Due/src/libraries/I2Cdev/I2Cdev.h
diff --git a/src/libraries/I2Cdev/keywords.txt → ...ino Due/src/libraries/I2Cdev/keywords.txt b/src/libraries/I2Cdev/keywords.txt → ...ino Due/src/libraries/I2Cdev/keywords.txt
diff --git a/src/libraries/I2Cdev/library.json → ...ino Due/src/libraries/I2Cdev/library.json b/src/libraries/I2Cdev/library.json → ...ino Due/src/libraries/I2Cdev/library.json
diff --git a/src/libraries/MPU6050/MPU6050.cpp → ...ino Due/src/libraries/MPU6050/MPU6050.cpp b/src/libraries/MPU6050/MPU6050.cpp → ...ino Due/src/libraries/MPU6050/MPU6050.cpp
diff --git a/src/libraries/MPU6050/MPU6050.h → Arduino Due/src/libraries/MPU6050/MPU6050.h b/src/libraries/MPU6050/MPU6050.h → Arduino Due/src/libraries/MPU6050/MPU6050.h
diff --git a/...ries/MPU6050/MPU6050_6Axis_MotionApps20.h → ...ries/MPU6050/MPU6050_6Axis_MotionApps20.h b/...ries/MPU6050/MPU6050_6Axis_MotionApps20.h → ...ries/MPU6050/MPU6050_6Axis_MotionApps20.h
diff --git a/...ries/MPU6050/MPU6050_9Axis_MotionApps41.h → ...ries/MPU6050/MPU6050_9Axis_MotionApps41.h b/...ries/MPU6050/MPU6050_9Axis_MotionApps41.h → ...ries/MPU6050/MPU6050_9Axis_MotionApps41.h
diff --git a/...es/MPU6050/examples/IMU_Zero/IMU_Zero.ino → ...es/MPU6050/examples/IMU_Zero/IMU_Zero.ino b/...es/MPU6050/examples/IMU_Zero/IMU_Zero.ino → ...es/MPU6050/examples/IMU_Zero/IMU_Zero.ino
diff --git a/...50/examples/MPU6050_DMP6/MPU6050_DMP6.ino → ...50/examples/MPU6050_DMP6/MPU6050_DMP6.ino b/...50/examples/MPU6050_DMP6/MPU6050_DMP6.ino → ...50/examples/MPU6050_DMP6/MPU6050_DMP6.ino
diff --git a/...0_DMP6/Processing/MPUTeapot/MPUTeapot.pde → ...0_DMP6/Processing/MPUTeapot/MPUTeapot.pde b/...0_DMP6/Processing/MPUTeapot/MPUTeapot.pde → ...0_DMP6/Processing/MPUTeapot/MPUTeapot.pde
diff --git a/...050_DMP6_ESPWiFi/MPU6050_DMP6_ESPWiFi.ino → ...050_DMP6_ESPWiFi/MPU6050_DMP6_ESPWiFi.ino b/...050_DMP6_ESPWiFi/MPU6050_DMP6_ESPWiFi.ino → ...050_DMP6_ESPWiFi/MPU6050_DMP6_ESPWiFi.ino
diff --git a/.../Processing/MPUOSCTeapot/MPUOSCTeapot.pde → .../Processing/MPUOSCTeapot/MPUOSCTeapot.pde b/.../Processing/MPUOSCTeapot/MPUOSCTeapot.pde → .../Processing/MPUOSCTeapot/MPUOSCTeapot.pde
diff --git a/...0_DMP6_Ethernet/MPU6050_DMP6_Ethernet.ino → ...0_DMP6_Ethernet/MPU6050_DMP6_Ethernet.ino b/...0_DMP6_Ethernet/MPU6050_DMP6_Ethernet.ino → ...0_DMP6_Ethernet/MPU6050_DMP6_Ethernet.ino
diff --git a/...6050/examples/MPU6050_raw/MPU6050_raw.ino → ...6050/examples/MPU6050_raw/MPU6050_raw.ino b/...6050/examples/MPU6050_raw/MPU6050_raw.ino → ...6050/examples/MPU6050_raw/MPU6050_raw.ino
diff --git a/src/libraries/MPU6050/helper_3dmath.h → ...Due/src/libraries/MPU6050/helper_3dmath.h b/src/libraries/MPU6050/helper_3dmath.h → ...Due/src/libraries/MPU6050/helper_3dmath.h
diff --git a/src/libraries/MPU6050/library.json → ...no Due/src/libraries/MPU6050/library.json b/src/libraries/MPU6050/library.json → ...no Due/src/libraries/MPU6050/library.json
diff --git a/src/libraries/Relativ/KEYWORDS.txt → ...no Due/src/libraries/Relativ/KEYWORDS.txt b/src/libraries/Relativ/KEYWORDS.txt → ...no Due/src/libraries/Relativ/KEYWORDS.txt
diff --git a/src/libraries/Relativ/Relativ.cpp → ...ino Due/src/libraries/Relativ/Relativ.cpp b/src/libraries/Relativ/Relativ.cpp → ...ino Due/src/libraries/Relativ/Relativ.cpp
diff --git a/src/libraries/Relativ/Relativ.h → Arduino Due/src/libraries/Relativ/Relativ.h b/src/libraries/Relativ/Relativ.h → Arduino Due/src/libraries/Relativ/Relativ.h
diff --git a/src/libraries/Relativ/library.json → ...no Due/src/libraries/Relativ/library.json b/src/libraries/Relativ/library.json → ...no Due/src/libraries/Relativ/library.json
diff --git a/src/libraries/readme.txt → Arduino Due/src/libraries/readme.txt b/src/libraries/readme.txt → Arduino Due/src/libraries/readme.txt
diff --git a/src/main/main.ino → Arduino Due/src/main/main.ino b/src/main/main.ino → Arduino Due/src/main/main.ino
diff --git a/PULL_REQUEST_TEMPLATE.md b/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,29 @@
+Hi, thanks for your contribution! Take a minute to tell us more about your changes:
+<!--- Provide a general summary of your changes in the Title above -->
+
+## Description
+<!--- Describe your changes in detail -->
+
+## Motivation and Context
+<!--- Why is this change required? What problem does it solve? -->
+<!--- If it fixes an open issue, please link to the issue here. -->
+
+## How Has This Been Tested?
+<!--- Please describe in detail how you tested your changes. -->
+<!--- Include details of your testing environment, tests ran to see how -->
+<!--- your change affects other areas of the code, etc. -->
+
+## Screenshots (if appropriate):
+
+## Types of changes
+<!--- What types of changes does your code introduce? Put an `x` in all the boxes that apply: -->
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+
+## Checklist:
+<!--- Go over all the following points, and put an `x` in all the boxes that apply. -->
+<!--- If you're unsure about any of these, don't hesitate to ask. We're here to help! -->
+- [ ] My code follows the code style of this project.
+- [ ] My change requires a change to the documentation.
+- [ ] I have updated the documentation accordingly.
diff --git a/README.md b/README.md
@@ -47,33 +47,34 @@ build your VR headset too. </p>
 
 # Getting Started ⚡️
 
-Relativ is based on <a href="https://github.com/relativty/wrmhl">WRMHL</a> and <a href="https://github.com/relativty/fastVR-sdk">FastVR</a>.
+**PLEASE NOTE**; We highly recommend that you use the STM32 tracker because it has proved to be more stable than the Due based one. The Due code has recently been reported to throw compiler errors, and the Due trackers have exhibited stability issues. Because of this, we will be phasing out support for the Arduino DUE code in the next couple of months. *(NOTE added on Apr 17, 2019)*
 
 ## What you'll need
 
 ### What components ?
 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
+* STM32, $3,50 [recommended](https://robotdyn.com/stm32-arm-arduino-mini-system-dev-board-blue-pill-with-arduino-bootloader.html "recommended")
+* ST-link V2 USB ~$3,00 [recommended](https://www.amazon.com/ "recommended") ⚠️ Price may vary a lot
 * 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")
+* 5.5 inch 25601440 2K LCD Screen with an HDMI to MIPI board, between €65 and €95 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 (10mm wide), about $4, see [here](https://www.ebay.com/sch/i.html?_from=R40&_trksid=m570.l1313&_nkw=face+foam+vr+headset+10mm&_sacat=0 "here")
 
 ###### Extra needed for the TheYXXY design:
-* Biconvex lens, Focal length 37mm, 45mm diameter <a href="https://www.ebay.com/">recommended</a>
+* 2 Biconvex lenses, Focal length 45mm, 37mm 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.
 
 ###### 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)
+* 2 Biconvex lenses, Focal length 45mm, 37mm 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 slight 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!!)
+* M3 screws (7x M3x20 and 6x M3x10)
 
 ###### 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>)
+* 2 Fresnel lenses 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%">
 
@@ -85,22 +86,18 @@ You can either install it using [Git](https://git-scm.com/) or direct [Download]
 # Clone this repository
 $ git clone https://github.com/relativty/Relativ
 ```
-Copy all folders in **Relativ/src/libraries** and past them in your Arduino Libraries folder: **Documents\Arduino\libraries**. You're now ready to build the headset!
 
-# Building the hardware
+# Building the headset
 
-**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.
+Detailed instructions and parts lists can be found in the Relativ Wiki at:
 
-⚠️ PAY EXTRA ATTENTION TO THE SCREEN, IT'S VERY FRAGILE ⚠️
+https://wiki.relativty.net/index.php/STM32
 
-# Building the software
-Make sure you have all the libraries needed installed and upload the following program to the Arduino:
+Basically, copy the contents of **"library"** folder into your Arduino libraries folder, then copy the main STM32-Tracker folder (which contains the **STM32_BlackPill** and **STM32_BluePill** folders) into your main Arduino folder. However, all the critical information that you need to build this tracker is in the Wiki, so you really do need to read it before you start this build.
 
-Path: Relativ/src/main/main.ino
+Because we had to edit some of the main library files so that they would compile on an STM32 board, we have included them in each sketch folder (so that the changes don't mess up any other sketches that use those particular libraries). However, bacause other parts of the code rely on the un-patched libraries, we have to make the original libraries available in the main arduino libraries folder as well.
 
-Our documentation can be found on our <a href="https://wiki.relativty.net/index.php/Main_Page">wiki<a/>.
+These really should work straignt out of the box - however, if they don't then please raise a GitHub issue or message us on the Relativ Discord.
 
 # Play some demos or use SteamVR