MurlokVR

A Stupid Simple Custom "DIY" VR Headset. Built With Rust 🦀 and C++ (OpenVR Driver) ⚙️

Notice

If You Want To Clone This Repository, Use the --recursive Flag To Clone the Submodules As Well.

Overview Architecture

The MurlokVR Headset Follows a Simple Pipeline Approach Which Is Drawn as a Diagram Below:

---

Overview Components

Components:

• Microcontroller:
  • Waveshare ESP32-C6-(N16) (16 MB Flash Memory)
• Displays:
  • Wisecoco 2.9-Inch, 1440 × 1440, 90 Hz, Dual Displays Including Display Driver Board
• IMU Sensor:
  • TENSTAR BNO085
• Lenses:
  • 2x Stacked Fresnel Lenses (2x FL 30 & 2x FL 40)
    • Eye <-> FL 40 Lens (Flat Side) <-> FL 30 Lens (Flat Side) <-> Displays
• LEDs:
  • 1x White LED
  • 1x RGB LED
• Resistors:
  • 4x 220 Ω THT
• Miscellaneous:
  • HDMI-Cable, USB-Cables, Jumper Wires, ...

Headset Design

---

Quick Progress Overview

Foundation

• Basic Project Structure

Core Software

• Firmware Implementation in Rust
• Driver Implementation in C++
• Runtime Implementation in Rust
• Driver / Runtime Integration

Hardware

• Hardware Design

Testing & Documentation

• Testing
• Documentation

More Milestones To Be Added As the Project Evolves...

Known Issues

• Rework Optics System for Easier Assembly ;( and Wider Field of View.

Known Bugs

• Fix the Timeout Issue When the Script Didn't Properly Clean Up.
• Fix the Rotation Issue When the Headset (Firmware) Is Starting in a Different Position Than Intended.

Useful Documentation

- Rust – Espressif HAL (Hardware Abstraction Layer):
    - https://github.com/esp-rs/esp-hal
    - https://docs.espressif.com/projects/rust/

- BNO08X Data Sheet:
    - https://www.ceva-ip.com/wp-content/uploads/BNO080_085-Datasheet.pdf

- SH-2 Reference Manual:
    - https://www.ceva-ip.com/wp-content/uploads/SH-2-Reference-Manual.pdf

- Valve Software OpenVR SDK:
    - https://github.com/ValveSoftware/openvr

License

MurlokVR Is Licensed Under Either of the Following Licenses, at Your Option:

• MIT License
• Apache License 2.0