Why Relativ? ?
Meet the team ❤️
Open-Source it FTW
Getting Started ⚡️
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 Horizon Lab. Shoutout to them for making this possible and allowing their design to be modified!
3D models
All our 3D models can be found on our Thingiverse account; https://www.thingiverse.com/Relativty/designs. We have decided to move our 3D models to Thingiverse, because of the amount of different designs, and remakes. This to keep the GitHub file zise low, and people don't have to downlaod all the 3D models with the code together. Some 3D designs require additional parts, they can be found on the Thingiverse page itself.
Parts needed for all the designs:
- STM32, $3,50 recommended
- ST-link V2 USB ~$3,00 recommended ⚠️ Price may vary a lot
- GY-521 MPU-6050, $1
- 5.5 inch 25601440 2K LCD Screen with an HDMI to MIPI board, between €65 and €95 on AliExpress (recommended) ⚠️ Price may vary a lot
- Face foam (10mm wide), about $4, see here
How to Install?
You can either install it using Git or direct Download. Or from the command line:
# Clone this repository
$ git clone https://github.com/relativty/Relativ
Building the headset
Detailed instructions and parts lists can be found in the Relativ Wiki at:
https://wiki.relativty.net/index.php/STM32
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.
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.
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.