"Sjør" is a framework for Microsoft HoloLens 2 developed by Abel van Beek at the University of Bergen.
- Turn on your HoloLens 2 and navigate to
Settings>Updates>For Developers - Enable
Use Developer Featuresin order to deploy applications from Visual Studio - I recommend to enable
Windows Device Portalin this menu too (https://docs.microsoft.com/en-us/windows/mixed-reality/develop/advanced-concepts/using-the-windows-device-portal)
- Navigate to
Settings>Updates and Security>For Developers - Enable
Developer Modeand clickYesto accept the change
- Download Sjør_v1.0.2.0_ARM64.zip from the
Compiled/directory - Unpack to your local machine
- Open
Windows Device Portal > Views > Apps > Local Storage > Browse > Navigate to unpacked folder > ar-coastal-sailing_1.0.2.0_ARM64.appx
-
Unity 2020.3.17f1
-
Mixed Reality Toolkit 2.7.2 (included in the project)
-
Visual Studio 2019 (16.3)
Include in installation
- Desktop development with C++
- Universal Windows Platform (UWP) development
- Windows 10 SDK version 10.0.19041.0 or 10.0.18362.0
- USB Device Connectivity (required to deploy/debug to HoloLens over USB)
- C++ (v142) Universal Windows Platform tools (required when using Unity)
-
Git (to download the project)
- Clone the project in a directory using
git clone https://github.com/Imable/sjoer.git - Go to https://www.barentswatch.no/minside/
- Create an account
- Create a client below "Mine klienter"
- Create a file in
Assets/Resources/Config/namedbarentswatch_conf.jsonwith the following content, where you replace...with the credentials provided by Barentswatch
{
"token_url": "https://id.barentswatch.no/connect/token",
"ais_url": "https://www.barentswatch.no/bwapi/v2/geodata/ais/openpositions?Xmin={0}&Xmax={1}&Ymin={2}&Ymax={3}",
"auth_format": "client_id={0}&scope=api&client_secret={1}&grant_type=client_credentials",
"client_id": "...",
"client_secret": "..."
}- Open the project in Unity
- Go to
File > Build Settings - Make sure the settings match the ones below
Target Device: HoloLens
Architecture: ARM64
Build Type: D3D Project
Target SDK Version: Latest Installed
Minimum Platform Version: 10.0.10240.0
Visual Studio Version: Latest Installed
Build and Run on: USB Device
Build Configuration: Release
The remaining checkboxes should be deselected when creating a release build
- Click
Build - Select a folder where the project should be built to
- Go into the export folder and open the Visual Studio project by double-clicking
ar-coastal-sailing.sln - Now connect the HoloLens 2 to your PC using USB and wait until Windows recognizes it
- In Visual Studio, switch
DebugtoRelease,ARMtoARM64andRemote DevicetoDevice(by clicking the small arrow on the right side ofARM) - Then click the
Debugtab on top of Visual Studio and selectStart without debugging
The project is now being build and compiled for HoloLens. This will take around 5-10 minutes, depending on your system. Leave the HoloLens plugged into your PC until it makes a sound and the project is opened automatically
- Download the NetGPS Android app (https://play.google.com/store/apps/details?id=com.meowsbox.netgps&hl=en&gl=US)
- Disconnect your phone from WiFi and create a hotspot with your phone and connect the HoloLens to it
Note that this will use mobile data (but it should not be a crazy amount)
- In NetGPS, open the second tab and create and enable a server with type: TCP, port: 6000
- Then click the arrow on top to show your IP address
- Insert the IP address from the app at
wlan0into the config file in the Unity project atAssets/Resources/Config/conf.json(at the bottom of the file) - If we now run the application on the HoloLens, it should connect to the phone