Beyond-SLAM is een project dat de Bigscreen Beyond VR-headset in staat stelt om zichzelf te tracken met behulp van een Xvisio XR50 SLAM-camera. Hierdoor zijn de traditionele Lighthouse-basistations niet langer nodig.
Belangrijkste punten:
- Hardware: Naast de headset en camera is een specifieke USB-C naar Micro-USB kabel en een 3D-geprinte mount vereist.
- Software: Het project wordt geleverd met een SteamVR-driver en een desktop-applicatie voor configuratie en updates.
- Installatie: Gebruikers kunnen via een setup-bestand en de 'Beyond-SLAM Control' app de installatie eenvoudig voltooien.
- Ontwikkelaars: De broncode is beschikbaar voor wie de driver of installer zelf wil bouwen, waarbij Python 3.11+, Visual Studio 2022 en de Xvisio SDK nodig zijn.
- Licentie: Het project is open source en valt onder de MIT-licentie.
Beyond-SLAM: Maak de Bigscreen Beyond SLAM-tracked
Benodigdheden
Om Beyond-SLAM te gebruiken, heb je het volgende nodig:
- Een Bigscreen Beyond.
- Een Xvisio XR50 (verkrijgbaar bij Mouser of Electromaker, dat laatste is aanbevolen voor internationale bestellingen).
- Een USB-C naar Micro-USB kabel (aanbevolen, alternatief). Let op: 0,65 ft is de kortste lengte die werkt; 0,6 ft is te kort.
- Een Windows 10/11 64-bit PC met SteamVR.
- De onderstaande mount (of een eigen ontwerp).
De Mount
De mount is een behuizing die de XR50 op de Beyond bevestigt.
- Download
mount/bsb-slam-shell.step.
- Print dit bestand met een 3D-printer.
- Bevestig de XR50 in de behuizing.
Geen 3D-printer? Je kunt het STEP-bestand uploaden naar JLCPCB 3D printing en het onderdeel bestellen in MJF (Multi Jet Fusion) nylon.
De app bevat een bijpassend mount-profiel, zodat je de offsets met één klik kunt toepassen. Indien je een eigen mount ontwerpt, kun je de offsets handmatig invoeren op de pagina 'Mount'.
Aan de slag
- Installeer SteamVR, open het programma één keer en sluit het vervolgens af.
- Download
Beyond-SLAM-Setup.exe vanuit de 'Releases' en voer dit bestand uit.
- Sluit de Beyond en de XR50 aan en open Beyond-SLAM Control.
- Volg de stappen op de startpagina ('Home').
De applicatie controleert automatisch GitHub op updates en installeert deze voor je.
Terugkeren naar basistations
Wanneer je weer gebruik wilt maken van basistations:
- Sluit SteamVR.
- Ga naar
Tools → Troubleshooting → Use base stations.
- Start SteamVR opnieuw op.
Probleemoplossing
- Herstart SteamVR: De meeste wijzigingen in de instellingen worden pas toegepast na een nieuwe start.
- App-instructies: Indien de applicatie een probleem detecteert, krijg je direct instructies over de volgende stap.
- Diagnostiek: Mocht het probleem aanhouden, gebruik dan
Settings → Diagnostics → Copy diagnostics en plak het resultaat in een GitHub-issue.
Voor ontwikkelaars
Voor het draaien van de app vanuit de broncode is 64-bit Python 3.11+ met Tcl/Tk vereist.
De app uitvoeren vanuit broncode
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe app.py
Let op: Je hebt geen SDK of hardware nodig om de app te openen.
De driver bouwen
Je hebt Visual Studio 2022 met C++ en de Xvisio SDK 3.2.0 nodig. Voer daarna het volgende uit:
.\build.bat
De installer bouwen
Naast de bovenstaande vereisten heb je CMake 3.21+ en Inno Setup nodig. Voer daarna het volgende uit:
.\build_bundle.bat
Dit proces bouwt de driver, voert alle tests uit en genereert dist\Beyond-SLAM-Setup.exe.
Overige commando's
python -m unittest discover -s tests
- Verhoog de
VERSION in release_version.py.
- Commit de wijzigingen en voer
build_bundle.bat uit.
- Voer uit:
.\.venv\Scripts\python.exe scripts\release-files.py publish
Ondersteuning
Als Beyond-SLAM nuttig voor je is, wordt het gewaardeerd als je de repository een ster (⭐) geeft. Dit helpt anderen om het project gemakkelijker te vinden.
Licentie en credits
Beyond-SLAM is uitgebracht onder de MIT-licentie.
- Dank aan OpenVR (BSD 3-Clause, headers opgenomen in
Driver/openvr-master) en het Sun Valley ttk-thema.
- De Xvisio SDK wordt niet herdistribueerd. Je installeert deze zelf onder de voorwaarden van Xvisio; de app helpt je bij dit proces.
- Dit project is niet gelieerd aan Bigscreen, Xvisio of Valve.
Beyond-SLAM: Maak de Bigscreen Beyond SLAM-tracked
Benodigdheden
Om Beyond-SLAM te gebruiken, heb je het volgende nodig:
- Een Bigscreen Beyond.
- Een Xvisio XR50 (verkrijgbaar bij Mouser of Electromaker, dat laatste is aanbevolen voor internationale bestellingen).
- Een USB-C naar Micro-USB kabel (aanbevolen, alternatief). Let op: 0,65 ft is de kortste lengte die werkt; 0,6 ft is te kort.
- Een Windows 10/11 64-bit PC met SteamVR.
- De onderstaande mount (of een eigen ontwerp).
De Mount
De mount is een behuizing die de XR50 op de Beyond bevestigt.
- Download
mount/bsb-slam-shell.step.
- Print dit bestand met een 3D-printer.
- Bevestig de XR50 in de behuizing.
Geen 3D-printer? Je kunt het STEP-bestand uploaden naar JLCPCB 3D printing en het onderdeel bestellen in MJF (Multi Jet Fusion) nylon.
De app bevat een bijpassend mount-profiel, zodat je de offsets met één klik kunt toepassen. Indien je een eigen mount ontwerpt, kun je de offsets handmatig invoeren op de pagina 'Mount'.
Aan de slag
- Installeer SteamVR, open het programma één keer en sluit het vervolgens af.
- Download
Beyond-SLAM-Setup.exe vanuit de 'Releases' en voer dit bestand uit.
- Sluit de Beyond en de XR50 aan en open Beyond-SLAM Control.
- Volg de stappen op de startpagina ('Home').
De applicatie controleert automatisch GitHub op updates en installeert deze voor je.
Terugkeren naar basistations
Wanneer je weer gebruik wilt maken van basistations:
- Sluit SteamVR.
- Ga naar
Tools → Troubleshooting → Use base stations.
- Start SteamVR opnieuw op.
Probleemoplossing
- Herstart SteamVR: De meeste wijzigingen in de instellingen worden pas toegepast na een nieuwe start.
- App-instructies: Indien de applicatie een probleem detecteert, krijg je direct instructies over de volgende stap.
- Diagnostiek: Mocht het probleem aanhouden, gebruik dan
Settings → Diagnostics → Copy diagnostics en plak het resultaat in een GitHub-issue.
Voor ontwikkelaars
Voor het draaien van de app vanuit de broncode is 64-bit Python 3.11+ met Tcl/Tk vereist.
De app uitvoeren vanuit broncode
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe app.py
Let op: Je hebt geen SDK of hardware nodig om de app te openen.
De driver bouwen
Je hebt Visual Studio 2022 met C++ en de Xvisio SDK 3.2.0 nodig. Voer daarna het volgende uit:
.\build.bat
De installer bouwen
Naast de bovenstaande vereisten heb je CMake 3.21+ en Inno Setup nodig. Voer daarna het volgende uit:
.\build_bundle.bat
Dit proces bouwt de driver, voert alle tests uit en genereert dist\Beyond-SLAM-Setup.exe.
Overige commando's
python -m unittest discover -s tests
- Verhoog de
VERSION in release_version.py.
- Commit de wijzigingen en voer
build_bundle.bat uit.
- Voer uit:
.\.venv\Scripts\python.exe scripts\release-files.py publish
Ondersteuning
Als Beyond-SLAM nuttig voor je is, wordt het gewaardeerd als je de repository een ster (⭐) geeft. Dit helpt anderen om het project gemakkelijker te vinden.
Licentie en credits
Beyond-SLAM is uitgebracht onder de MIT-licentie.
- Dank aan OpenVR (BSD 3-Clause, headers opgenomen in
Driver/openvr-master) en het Sun Valley ttk-thema.
- De Xvisio SDK wordt niet herdistribueerd. Je installeert deze zelf onder de voorwaarden van Xvisio; de app helpt je bij dit proces.
- Dit project is niet gelieerd aan Bigscreen, Xvisio of Valve.
Groetjes,