跳转至

快速入门

耀宇视芯产品快速上手指南。根据产品类型选择对应章节。


光学视觉模组

适用于 MD_FT68、MD_FT63、MD_FT62、MD_FT66、MD_FT70 系列模组及耀宇AR眼镜。

SDK 下载

SDK 各平台安装包及文档,请访问 SDK与算法 页面获取。

Ubuntu 平台 (x86_64)

以Ubuntu22.04为例,Ubuntu20.04将Carina_VIO_Console-x86_64-ubuntu22.AppImage替换为Carina_VIO_Console-x86_64-ubuntu20.AppImage即可

1. 下载AppImage

2. 安装依赖

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. 软件权限设置

chmod +x Carina_VIO_Console-x86_64-ubuntu22.AppImage

4. 系统USB权限设置

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

如不进行此步,后续操作需以 root 权限(sudo)执行。

5. 正常启动

./Carina_VIO_Console-x86_64-ubuntu22.AppImage

运行成功后会实时显示左右目图像,位姿以及轨迹。

Ubuntu 平台 (aarch64)

1. 权限设置

cpld.rules 文件放到 /etc/udev/rules.d/ 目录下,重启电脑使权限生效。

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

如不进行此步,后续操作需以 root 权限(sudo)执行。

2. 运行 Demo

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

运行成功后会在终端实时输出 SLAM 位姿(平移部分)。

退出程序:在终端输入 q 即可。

Android 平台

  1. 在安卓设备上安装 carina_console.apk
  2. 打开应用,授予各项权限
  3. 成功运行后画面显示双目图像和 SLAM 位姿

Windows 平台

  1. 下载Carina_VIO_Console-x64-windows.exe
  2. 根据指引安装demo,安装支持自定义路径,按照指引完成安装后安装USB驱动
  3. 双击桌面生成的Carina Console即可正常启动

Mac 平台

  1. 下载Carina_VIO_Console-2.9.8-dev-arm64-macOS26.dmg(2.9.8为版本号)
  2. 双击运行即可

详细说明见📄 Carina Console使用说明

注意事项

⚠ 连接模组/芯片的 Type-C 接口分正反面,如果运行不成功,可尝试换一面测试。


耀宇 AR 眼镜

适用于单目/双目 AR 眼镜 + 计算盒设备。

首次使用

  1. 将 AR 眼镜通过 Type-C 连接至计算盒(XR2/RK3588 平台)
  2. 计算盒开机,等待 YYSS Launcher 启动完成
  3. Launcher 主界面可选择应用、投屏或系统设置

视频教程计算盒到手后的基本操作

PC 无线投屏

  1. PC 和计算盒连接同一局域网
  2. 下载投屏工具(百度网盘,提取码:g2s9)
  3. 按工具提示完成连接

视频教程PC无线投屏

SteamVR 无线串流

  1. 下载驱动包(百度网盘,提取码:k177)
  2. PVRServer 放入 SteamVR 的 drivers 目录:
    C:\Program Files (x86)\Steam\steamapps\common\SteamVR\drivers
  3. yyss_steam_vr-release.apk 安装到计算盒
  4. 盒子和 PC 同网络,盒子开 yyss_steam,PC 开 SteamVR

视频教程SteamVR串流

ALVR 串流

  • PC 和盒子同一 WiFi
  • 眼镜端开 "ALVR YYSS" 记录 IP
  • PC 运行 ALVR Dashboard YYSS.exe,添加 IP,Launch Steam VR

要求:Win11 + Steam + SteamVR,盒子系统 ≥ SW_YYSS_V1.01.115 ⚠ ALVR Dashboard YYSS.exe 路径不能有中文

OTA 系统更新

  1. 下载 update.zip(百度网盘,提取码:9y4j)放入 sdcard 根目录
  2. 设置 → 系统更新 → 本地升级 → 重启

视频教程系统更新指导

控制盒 6 面校准

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

更多信息:详细 SDK 与算法文档见 SDK与算法,常见问题见 FAQ,资源下载见 资源与工具