Skip to main content

Software Usage

tip

This section details how to use the TeleXperience VR APP, the motion capture suit, and guides you through the built-in demo for teleoperation and data collection.

Please read and watch all tutorials in this section before your first use.

Once familiar, refer to the CheatSheet for quick reference.

IO TeleXperience APP Overview

Watch the following video to get familiar with the VR TeleXperience APP interface and interactions.

Step-by-step Guide
  • APP Interface & Interactions

    • Click the Wi-Fi icon in the bottom right in VR to enter network settings and connect to the TeleSuit Wi-Fi.

      Wi-Fi icon in VR Network settings Connect to TeleSuit Wi-Fi

    • Click the library icon in the bottom left, select IO TeleXperience APP to enter the app.

      Library icon IO TeleXperience APP icon Enter IO TeleXperience APP

    • Carefully read the "Teleoperation System Safety Notice", check "I have read and agree", then click to continue to the main interface.

      Safety Notice Main interface

    • Adjust window layouts under "Camera Window".

      Layout options Adjusted layout

    • Click "immersion" for immersive mode, adjust window distance, click "Exit" to leave.

      Immersion mode Adjust distance

    • Adjust main view window size under "Camera Distance".

      Adjust slider Main view size

    • Main function buttons:

      Main function buttons

      ButtonDescriptionFunction
      START SYNC / STOP SYNCStart/Stop SYNCSynchronization
      START MOCAP / STOP MOCAPStart/Stop MOCAPMotion capture control
      START TELEOP / STOP TELEOPStart/Stop TELEOPTeleoperation control
      START RECORD / STOP RECORDStart/Stop RECORDVideo recording
      LOWER_BODYSync/Unsync lower bodySync lower body mocap data
      GLOVESync/Unsync glovesSync glove data
      PLAYBACK ROBOT TRAJECTORYPlaybackPlayback recorded data
    • Click "Refresh" to update button status.

      Refresh button Refreshed status

    • Click "Settings" to open the robot selection page, browse and select robots, adjust model size with "Resize".

      Settings Robot selection Rotate robot Resize robot

    • Click "Theme" to select and apply a new theme.

      Theme selection Theme effect

    • Click "Other" for low power warning settings, enable/disable as needed, exit from the top right.

      Other settings Low power warning

    • Right-side view panel in VR:

      Right-side panel

    • To exit, press the index trigger, confirm in the popup.

      Exit prompt


Motion Capture Suit Calibration & Usage

Motion capture is optional for running the demo, but enables advanced features like redundancy optimization for 7-DOF arms.

If your robot arm has 6 or fewer DOF, you may skip this section.

Start Motion Capture

In VR, click START MOCAP. The blue avatar on the right should move if started correctly.

Step-by-step Guide
  • Click START MOCAP to sync the avatar. If the avatar moves, mocap is active.

    START MOCAP button Avatar moving


Suit Calibration

If the avatar's movement does not match your body, calibrate the suit.

Before calibration, turn on VR headset audio for voice prompts.

Standard CalibrationPro Calibration

On the left panel, ensure LOWER BODY and GLOVE are unchecked. Click START MOCAP, then AUTO CALIB.

Standard AUTO CALIB

Follow the voice prompts and demo actions:

On the left panel, ensure LOWER BODY and GLOVE are checked. Click START MOCAP, then AUTO CALIB.

Pro AUTO CALIB

If not wearing the lower suit, you may leave LOWER BODY unchecked.

Pro LOWER BODY option

Follow the voice prompts and demo actions:

BeforeAfter
BeforeAfter
Step-by-step Guide
  • Standard Version
    • On the left panel, ensure "LOWER BODY" and "GLOVE" are unchecked. Click "START MOCAP", then "AUTO CALIB".

      Standard calibration settings

    • Follow the voice prompts and demo actions: Standard Steps:
      Voice PromptAction
      Please stand at attentionStand straight, arms at sides
      Begin vertical calibrationStart standing calibration
      End vertical calibrationEnd standing calibration
      Begin arm calibrationStart arm calibration
      Please raise your handRaise arms ~45°, then relax
      End arm calibrationEnd arm calibration
      Begin Body calibrationStart body calibration
      Please bend overBend forward ~30°, then relax
      End body calibrationEnd body calibration
      CalculatingCalculating results
      CalibratedCalibration complete

      Standard calculating Standard done

  • Pro Version
    • On the left panel, ensure "LOWER BODY" and "GLOVE" are checked. Click "START MOCAP", then "AUTO CALIB". If not wearing lower suit, leave "LOWER BODY" unchecked.

      Pro calibration settings Pro LOWER BODY checked

    • Follow the voice prompts and demo actions: Pro Steps:
      Voice PromptAction
      Please stand at attentionStand straight, arms at sides
      Begin vertical calibrationStart standing calibration
      End vertical calibrationEnd standing calibration
      Begin arm calibrationStart arm calibration
      Please raise your handRaise arms ~45°, then relax
      End arm calibrationEnd arm calibration
      Begin Body calibrationStart body calibration
      Please bend overBend forward ~30°, then relax
      End body calibrationEnd body calibration
      Begin left leg calibrationStart left leg calibration
      Please kick with your left legKick left leg forward ~30°
      End left leg calibrationEnd left leg calibration
      Begin right leg calibrationStart right leg calibration
      Please kick with your right legKick right leg forward ~30°
      End right leg calibrationEnd right leg calibration
      Please put your hands together and holdHold hands together at chest
      Begin hand calibrationStart hand calibration
      End hand calibrationEnd hand calibration
      CalculatingCalculating results
      CalibratedCalibration complete

      Pro calculating Pro done


VR Headset & Controller Joint Calibration (Optional)

info

Joint calibration of VR headset/controllers and mocap suit is optional. It improves visualization and is needed only for advanced development.

Headset CalibrationController Calibration

After starting mocap, click CALIB VR HEAD.

After starting mocap, click CALIB VR CONTROLLER.

BeforeAfter
BeforeAfter
Step-by-step Guide

Headset Calibration

  • Point controller at "START MOCAP", press trigger to start mocap, then click "CALIB VR HEAD".

    Select START MOCAP CALIB VR HEAD button

Steps:

Voice PromptAction
Please bend down and turn aroundBend forward in three directions: front, right, left (~30°)
Begin VR head calibrationStart calibration
End VR head calibrationEnd calibration

Head calibration process Head calibration done

Controller Calibration

  • After starting mocap, click "CALIB VR CONTROLLER". Steps:
    Voice PromptAction
    Please hold the controller and move your handHold VR controllers, move arms freely for ~10s
    Begin VR controller calibrationStart calibration
    End VR controller calibrationEnd calibration

    Controller calibration process Controller calibration done


Out-of-the-box Demo: OpenLoongVuer

To let you experience teleoperation without a real robot, we provide a demo environment in Vuer with the OpenLoong robot.

Start Vuer

Prepare a laptop to open the Vuer web page. Any OS is fine as long as it can connect to Wi-Fi and open a browser.

  1. Connect the laptop to the device Wi-Fi.
  2. Open browser and go to http://10.42.0.3:8012
Step-by-step Guide

Connect Wi-Fi Enter URL Vuer start page




info

If Vuer lags, use a laptop with a better GPU.

Control the Robot

You can now control the OpenLoong robot in Vuer:

StandardPro
Step-by-step Guide

Standard:

  • Connect to TeleSuit Wi-Fi, enter IO TeleXperience APP.

    Connect TeleSuit Wi-Fi Enter APP

  • Point controller at "START MOCAP", press trigger to start mocap. Check robot model movement.

    Select START MOCAP Check robot movement

  • Enable teleoperation. When button shows "STOP TELEOP", teleoperation is active. Before syncing, hold the home button to center VR view.

    Enable teleop Center VR view

  • Press right controller A to start sync. Robot follows your movement. To recalibrate view, stop sync first.

    Press A to sync Trigger for hand control

  • Hold left trigger to lock end-effector orientation; hold right trigger to lock position; hold both to lock both; release to unlock.

    Lock orientation Lock position Lock both Unlock

  • Use left joystick: forward/back/left/right to move robot; move your head to control robot head.

    Move forward Turn left Turn right Head sync

  • Press B to stop sync, A to resume.

    Stop sync Resume sync

  • After "START SYNC", move only elbows to feel redundancy optimization.

    Elbow movement Redundancy optimization

  • After "STOP SYNC", reset robot by pushing both joysticks outward for ~2s.

    Reset robot Joystick outward

Pro:

  • Connect TeleSuit Wi-Fi, enter IO TeleXperience APP.

    Pro connect Wi-Fi Pro enter APP

  • Point controller at "START MOCAP", press trigger to start mocap.

    Pro select START MOCAP Pro mocap active

  • Observe robot model on right side for correct movement.

    Pro robot observation Pro sync check

  • Point controller at "START TELEOP" to enable teleoperation. When button shows "STOP TELEOP", teleoperation is active.

    Pro START TELEOP Pro teleop active

  • Before syncing, hold right "home" button to center VR view. After syncing, recalibration is not allowed unless you stop sync first.

    Pro home button

  • After enabling teleoperation, right foot eversion resumes, robot arm syncs with your arm.

    Pro right foot eversion Pro arm sync

  • After syncing:
      1. Both feet eversion and hold
      2. Both feet inversion and hold

    Pro both feet eversion Pro both feet inversion

  • With VR headset on, robot head and dexterous hand follow your head and fingers.

    Pro head sync Pro robot head sync Pro dexterous hand Pro finger control

  • Lift left heel to move forward.

    Pro left heel forward Pro move forward

  • Rotate left foot left/right to turn.

    Pro left turn Pro left turn effect Pro right turn Pro right turn effect

  • Lift left toe to move backward.

    Pro left toe back Pro move back

  • After enabling teleoperation, right foot inversion/eversion resumes.

    Pro right foot inversion Pro right foot eversion

  • After "START SYNC", move only elbows to feel redundancy optimization.

    Pro elbow movement Pro redundancy optimization

  • Rotate both feet outward for 1s to reset robot to initial pose.

    Pro reset pose Pro reset effect


Data Collection

StandardPro
Step-by-step Guide

Standard:

  • Press X on left controller to start recording. Timer increases. Press Y to stop and save. Hold Y for 2s to cancel and delete.

    Press X to record Recording timer Press Y to stop

Pro:

  • After syncing, invert left foot to start recording. Timer increases.

    Pro invert left foot to record Pro recording timer

  • After syncing, evert left foot to stop and save. Hold eversion for 2s to cancel and delete.

    Pro evert left foot to stop Pro save data


Trajectory Playback

You can playback recorded robot trajectories. Note: playback does not sync robot in VR; view in Vuer web.

Step-by-step Guide
  • Connect laptop to device Wi-Fi, open browser to http://10.42.0.2:8686 for IO-Teleop main page.

    Connect Wi-Fi, IO-Teleop page IO-Teleop main page

  • Open another browser to http://10.42.0.3:8012 for Vuer.

    Open Vuer

  • On IO-Teleop page, click "PLAYBACK ROBOT TRAJECTORY", select a folder, then "OK".

    Click PLAYBACK Select folder Confirm selection

  • View playback in Vuer web.

    Vuer playback


CheatSheet

CommandStandardPro
Start MocapPress START MOCAP in VR
Enable TeleopPress START TELEOP in VR
VR View Calibration

Hold calibration button

Note: After syncing, recalibration is not allowed. Stop sync first, then recalibrate.

Start SyncAfter enabling teleop, short press right AAfter enabling teleop, right foot eversion
Stop SyncAfter enabling teleop, short press right BAfter enabling teleop, right foot inversion
Control ArmAfter sync, robot arm follows VR controllerAfter sync, robot arm follows your hand
For redundancy optimization, start mocap and match arm pose before syncing.
Lock End-effector OrientationAfter sync, hold left triggerAfter sync, both feet eversion and hold
Lock End-effector PositionAfter sync, hold right triggerAfter sync, both feet inversion and hold
Control End-effectorAfter sync, hold controller gripAfter sync, dexterous hand follows your fingers
Control ChassisAfter sync, use left joystick

After sync,

Left heel up: forward

Left toe up: backward

Left rotate left: turn left

Left rotate right: turn right

Control TorsoAfter sync, use right joystick

After sync,

Right toe up: up

Right heel up: down

Control HeadAfter sync, robot head follows your head
Reset RobotBoth joysticks outward for 1sBoth feet outward for 1s
Start RecordingAfter sync, short press left XAfter sync, left foot inversion
Stop & Save RecordingAfter sync, short press left YAfter sync, left foot eversion
Cancel & Delete RecordingAfter sync, hold left Y for 2sAfter sync, hold left foot eversion for 2s
Switch to Transparent ModePress both joysticks