Quick Start¶

Getting started guide for Mesiontech products. Choose the section that matches your product type.

Optical Vision Module¶

For MD_FT68, MD_FT63, MD_FT62, MD_FT66, MD_FT70 series modules and Mesiontech AR Glasses.

SDK Download¶

SDK packages and docs for all platforms, see SDK & Algorithm. Current version: v3.4.16 (2026-09-18).

Ubuntu (x84_64)¶

The following setups apply to Ubuntu22.04. For Ubuntu20.04, Replace Carina_VIO_Console-x86_64-ubuntu22.AppImage to Carina_VIO_Console-x86_64-ubuntu20.AppImage

1. Download AppImage¶

2. Install Dependencies¶

sudo apt update && sudo apt install libfuse2
sudo apt install libxcb-cursor0 libxcb1 libxcb-keysyms1 libxcb-shape0 \
  libxcb-xfixes0 libxcb-xkb1 libxkbcommon0 libxkbcommon-x11-0 \
  libfontconfig1 libfreetype6 libglib2.0-0 libgl1 libegl1

3. Software Permission Setup¶

chmod +x Carina_VIO_Console-x86_64-ubuntu22.AppImage

4. System USB Permission Setup¶

sudo ./Carina_VIO_Console-x86_64-ubuntu22.AppImage --install-rules

Without this step, you'll need root privileges (sudo) for subsequent operations.

5. Launch Application¶

./Carina_VIO_Console-x86_64-ubuntu22.AppImage

Displays left/right camera images, pose and trajectory in real time.

Ubuntu (aarch64)¶

1. Permission Setup¶

Copy cpld.rules to /etc/udev/rules.d/ and reboot:

sudo cp cpld.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules

Without this step, you'll need root privileges (sudo) for subsequent operations.

2. Run Demo¶

export LD_LIBRARY_PATH=./lib
./bin/run_a1088_demo ./custom_config.yaml ./database.bin 0

Outputs SLAM pose (translation) in real time.

Press q to quit.

Android¶

Install carina_console.apk
Open app, grant all permissions
Shows binocular camera + SLAM pose output

Windows¶

Download Carina_VIO_Console-x64-windows.exe
Install application and USB driver under instruction
Double click Carina Console on Desktop to launch

Mac¶

Download the macOS package. Naming rule: Carina_VIO_Console-<version>-<arch>-macOS<major>[_debug].dmg
<version>: e.g. 3.4.16 (-dev indicates a dev build)
<arch>: arm64
macOS<major>: the build machine's macOS major version (e.g. macOS26), not a fixed value
[_debug]: present in Debug builds only Example: Carina_VIO_Console-3.4.16-dev-arm64-macOS26.dmg
Double click app to launch

Web Console (new in v3.4.16)¶

Since v3.4.16 a Web Console is available: use part of the Console app features directly in a browser, without installing the desktop app.

# Desktop / board: opens the default browser automatically
./carina_web_console                          # Windows: carina_web_console.exe
./carina_web_console --port 8080 --no-browser

Local: http://127.0.0.1:8080
LAN: http://:8080

⚠ The current version has no authentication (no token/password). Anyone on the same network can access and operate it (change config, download datasets), so use it only on trusted networks.

See SDK & Algorithm for all options and supported features.

See 📄 Carina Console Instruction for details.

Notes¶

⚠ The module/chip Type-C connector is directional. If it doesn't work, try reversing the connection.

AR Glasses¶

For monocular/binocular AR glasses with compute box (XR2/RK3588).

First Use¶

Connect AR glasses to compute box via Type-C
Power on, wait for YYSS Launcher
Launch apps, mirror screen, or adjust settings

Video: Compute Box First Steps

PC Wireless Mirroring¶

PC and box on same network
Download tool (Baidu Pan, code: g2s9)
Follow tool instructions

Video: PC Wireless Mirroring

SteamVR Streaming¶

Download driver pack (Baidu Pan, code: k177)
Copy PVRServer to SteamVR/drivers/
Install yyss_steam_vr-release.apk on box
Same network, open yyss_steam on box, launch SteamVR on PC

Video: SteamVR Streaming

ALVR Streaming¶

PC and box on same WiFi
Open "ALVR YYSS" on glasses, note IP
Run ALVR Dashboard YYSS.exe on PC, add IP, Launch Steam VR

Requires: Win11 + Steam + SteamVR, box firmware ≥ SW_YYSS_V1.01.115 ⚠ Path must not contain Chinese characters

OTA System Update¶

Download update.zip (Baidu Pan, code: 9y4j) to sdcard root
Settings → System Update → Local Upgrade → Reboot

Video: System Update Guide

6-Axis IMU Calibration¶

adb shell am start -n com.yyss.arcore/com.yyss.arcore.phonecontroller.Controller_Calib

Further reading: SDK & Algorithm, FAQ, Resources & Tools