MRx User Guide

v1.2.0

  1. Windows 10 laptop/PC with admin access.
  2. Microsoft HoloLens 2 headset(s).
  3. Wireless network router (for local networking).
  4. Wifi internet connectivity and Microsoft account (for remote sessions only).

NETWORK REQUIREMENTS.

 

Local Sessions

Ports: 7779, 7780, 7781

 

Remote Sessions

Ports: 7779, 7780, 7781, 443, 3478; 50000+

MRx is currently in closed beta, please contact us if you are interested in participating.

 

MRx consist of the following:

  • MRx APP.
    This is installed to your HoloLens devices from the Microsoft Store or MRx Console (Beta users only).

  • MRx CONSOLE APP.
    This is installed on your Win10 laptop/PC to manage your assets and simulations and to launch sessions.

  • SESSION MANAGER.
    This is launched from MRx Console for each session and is used to manage sessions from your laptop/PC.

  1. Install MRx Console from the Microsoft Store to your Win10 laptop/PC. For Beta users, a download link will be provided.
  2. Ensure Developer Mode and Device Portal in your HoloLens settings is set to ON. This step is required only if you are registering devices.
  3. Register your HoloLens devices (Beta users only). This step is optional.
  4. Install MRx to your HoloLens from the Microsoft Store or from the MRx Console (Beta users only). To install from the MRx Console, click ‘Devices’ on the left panel and click the ‘Device Fleet’ tab.  Click ‘Install’ next to the registered device.

CREATE SIMULATION

Content iconLaunch MRx Console on your Win10 laptop/PC:

  1. Upload assets you want in your simulation.
  2. Launch a session.

Content iconLaunch MRx on your HoloLens:

  1. Join the session.
  2. Use ‘gaze and drop’ to create simulation.

RUN SESSION

Content iconLaunch MRx Console on your Win10 laptop/PC:

  1. Select the simulation to launch local sessions or share it for remote sessions.
  2. Host or join sessions.

Content iconLaunch MRx on your HoloLens:

  1. Join the session.
  2. Collaborate on the simulation.

Ensure your HoloLens is on the same network SSID as your laptop / PC.

 

We recommend assigning static IP address for your devices.

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Devices’ on the left panel.
  3. Click the ‘Register Devices’ tab.
  4. If your device is detected, it will show on the Register Discovered Devices list. Click on the ‘Register’ icon Content icon and enter the device portal access credentials.
  5. If your device is not shown on the list, click on the ‘Discover’ icon Content icon to manually list your device. You will need the device IPv4 address.

Content icon

Win 10 MRx App – Register Device page

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Assets’ on the left panel.
  3. Enter a name for your asset group and click ‘Create Asset Group’.
  4. Click ‘Add Asset’ to upload assets into the asset group.

SUPPORTED FILE FORMATS.

 

3D models: fbx

2D images: jpg, png

Video: mp4

Content icon

Win 10 MRx App – Create Asset Group page

  1. Units are in meters.
  2. One material per mesh.
  3. One texture per mesh.
  4. One normal map per mesh.
  5. Transparency is supported.
  6. Pack resources into fbx.

MODEL OPTIMIZATION.

  1. Triangulate.
  2. Use per –vertex normal.
  3. Use per-vertex UV.
  4. Use binary FBX.

COORDINATE SYSTEM.

 

Content icon

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Simulations’ on the left panel.
  3. Click ‘Create Simulation’.
  4. Enter simulation information and select the asset groups you want to use in your simulation. Click ‘Next’.
  5. Click ‘Launch Session’. This launches the Session Manager window.
  6. On Session Manager, click ‘Step Planner’ to pre-organize your simulation or ‘Skip’.

    Note: Step Planner use is optional. If you skip Step Planner the first time, it will not be available when editing the simulation in the future.

  7. Launch MRx on the HoloLens to join the session
  8. Select new or last saved space on the Session Manager.
  9. Place the anchor on the ground, air tap to lock in place.

Content icon

Session Manager – Step Planner screen

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Simulations’ on the left panel.
  3. Click the ‘Launch Local Session’ for the desired simulation.
  4. Click ‘Launch Session’. This launches the Session Manager window.
  5. Launch MRx on the HoloLens and join the session.
  6. Select new or last saved space on the Session Manager.
  7. Place the anchor on the ground, air tap to lock in place.
  8. Launch MRx on other HoloLens to join the session.
  9. When all participants are in the lobby, click ‘Start’ on the Session Manager.

Content icon

Win 10 MRx App – Simulations page

A Microsoft account will be required.

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Simulations’ on the left panel.
  3. Select the simulation to upload and click the ‘Upload’ icon Content icon .
  4. Click the ‘Uploaded Simulations’ tab. Log in panel may appear if you are not signed in.
  5. Click the ‘Share’ icon Content icon for the desired simulation.
  6. Input participant emails to send download link.

    Invited participants will receive an email with a link to download the simulation.

Content icon

Win 10 MRx App – Share Simulations page

A Microsoft account will be required.

  1. Launch MRx Console on your laptop/PC.
  2. Click ‘Simulations’ on the left panel.
  3. Click the ‘Uploaded Simulations’ tab. Log in panel may appear if you are not signed in.
  4. Click the ‘Host Remote Session’ for the desired simulation.
  5. Click ‘Launch Session’. This launches the Session Manager window.
  6. Launch MRx on the HoloLens and join the session.
  7. Select new or last saved space on the Session Manager.
  8. Place the anchor on the ground, air tap to lock in place.
  9. Launch MRx on other HoloLens to join the session.
  10. When all participants are in the lobby, click ‘Start’ on the Session Manager.

    Remote participants will join the session at the lobby and appear as avatars.

Content icon

Win 10 MRx App – Uploaded Simulations page

A Microsoft account will be required.

MRx is installed on laptop/PC and HoloLens.

  1. Click on the link in the invitation email and click ‘Download Simulation’ on the webpage.
  2. Launch MRx Console on your laptop/PC.
  3. Click ‘Join Sessions’ on the left panel.
  4. Click the ‘Join Remote Session’ for the desired simulation.
  5. Click ‘Launch Session’. This launches the Session Manager window.
  6. Launch MRx on the HoloLens and join the session.
  7. Select new space on the Session Manager.
  8. Place the anchor on the ground, air tap to lock it in place.
  9. Launch MRx on other HoloLens to join the session.
  10. When all participants are in the lobby, click ‘Start’ on the Session Manager.

    Remote participants will join the session at the lobby and appear as avatars.

Content icon

Win 10 MRx App – Join Remote Sessions page