跳到主要内容

故障排查

提示

本章用于排查遥操作过程中常见的供电、连接、网络和软件问题。文中未明确列出的操作,请不要自行尝试;请勿自行拆机、修改系统配置或执行来源不明的命令;需要操作设备内部服务、ROS 配置或系统权限的内容,已放入「需技术人员操作」折叠块,请交由具备维护权限的技术人员或售后执行。

如果本章内容无法解决您的问题,请参考日志收集章节完成相关操作,并联系技术支持进行反馈。界面中出现英文报错时,可先在错误消息参考手册中检索。

快速跳转​

内容跳转
快速排查出现问题,先做这三步
使用前检查使用前检查
常见问题供电与设备连接 · 网络与通信 · 标定与动作捕捉 · VR 应用 · 遥操作与数据
日常使用日常使用注意事项 · 设备关机
联系售后联系售后时请提供

出现问题,先做这三步​

建议按顺序检查。在哪一步发现异常,就先处理该项,不必急着继续往后查。

第一步:看设备是否正常​

  • TeleSuit、TeleBox、VR 头显是否都已开机
  • 电源适配器和设备指示灯是否正常
  • 网线、航空插头和手套线束是否插紧,有无松动或破损
  • 设备是否异常发烫、有异响或焦糊味

发现焦糊味、冒烟或异常发烫时,立即断电并联系售后,不要继续排查。

第二步:看设备之间是否连通​

  • TeleSuit 和 TeleBox 是否属于同一套设备,编号(SN)是否对应
  • 各设备是否连接到正确的网络
  • 使用有线连接时,网口是否接对
  • 电脑同时连接 Wi-Fi 和网线时,是否因网络路径问题无法访问设备

可以先断开无关网络,再重新测试连接。多套设备同时使用时,还要确认没有交叉连接。

第三步:看页面和数据是否正常​

  • 前端页面 http://设备IP:7876 是否可以打开
  • Mocap 是否能收到双手数据
  • VR 是否能收到数据并正常投屏
  • TeleSuit 和 TeleBox 的软件版本是否匹配
  • 操作过程中是否出现卡顿、延迟或明确报错

如果前两步正常,但页面打不开、收不到数据或持续报错,请记录报错内容、设备编号和软件版本,再按下方对应问题继续排查。

使用前检查​

以下检查项能在开始操作前排除大部分问题。完整的场地、人员与设备要求请见安全须知和规范使用。

检查设备和线缆​

  • 电源适配器工作正常,指示灯状态无异常
  • 网线、航空插头和手套线束连接牢固,没有破损或松动
  • TeleSuit 和 TeleBox 为同一套设备,编号(SN)对应
  • 多套设备同时使用时,各套设备没有交叉连接
  • 设备周围通风,接口和散热口没有被遮挡

插拔线缆前应先确认接口方向,不要强行插入。航空插头松动、有异响或无法锁紧时,请停止使用并联系售后。

检查网络​

  1. 根据 TeleSuit 标签确认需要连接的 Wi-Fi,不要连接到其他设备的热点。
  2. 使用有线连接时,确认设备口连接 TeleSuit,交互口连接电脑或工控机。网口定义与连接拓扑请见现场网络速查。
  3. TeleSuit、TeleBox 和需要参与操作的终端应处于正确的网络中,并能互相通信。
  4. 如果电脑同时连接 Wi-Fi 和网线后无法访问设备,可暂时关闭无关网络,再重新测试。

复杂网络环境中,同时启用多个网络接口可能导致访问流量走错路径,但不一定都是 IP 冲突。如果调整后仍无法连接,请保留当前网络配置并联系售后。

如果启用了路由器的无线中继,但没有连接上级路由,VR 可能提示 Wi-Fi 断开。不需要无线中继时,可登录路由器管理页面将其关闭;不熟悉路由器设置时,请联系现场网络管理员或售后。

检查软件版本​

记录 TeleSuit 端和 TeleBox 端的软件版本,确认两端版本相互匹配。需要升级时请参考软件升级,并先联系售后确认版本与操作时间。

供电与设备连接​

1. 动捕服无法连接,电源盒跳红灯​

现象:电源盒中间指示灯持续闪烁或变红,VR 中提示无数据。

解决方法:

  1. 检查电源盒供电和线缆连接。
  2. 关闭动捕服电源,等待 10 秒后重新开机。
  3. 确认 TeleSuit 与 TeleBox 使用正确的网络,且未与其他套设备混接。
  4. 记录 TeleSuit 和 TeleBox 的软件版本。

部分旧版本可能出现类似问题,是否需要升级请由售后根据当前版本判断。重启后仍持续跳红灯时,不要拆机,直接联系售后。

2. VR 通过有线连接 TeleSuit 无法获取 IP​

现象:通过网线直连 TeleSuit 时,偶尔无法获取 IP。

解决方法:

  1. 检查网线与接口是否插紧,网口定义请见现场网络速查。
  2. 关闭 VR 头显并正常重启相关设备,重启后重新连接。

如果问题反复出现,请记录连接方式、接口指示灯状态,以及 VR 是否能通过无线网络正常连接,并联系售后。

3. TeleBox 网口未获取 IP​

现象:TeleBox 交互口的网口未获取到 IP。

解决方法:

  1. 检查 TeleBox 网口指示灯是否正常亮起。
  2. 指示灯不亮时,检查网线两端是否插紧,并尝试更换已确认正常的网线或交换机端口。
  3. 指示灯正常但仍无 IP 时,访问 http://10.42.0.3:7876 重新应用配置。

前端地址以当前设备实际 IP 为准。如果无法进入前端,或应用配置后仍无 IP,请记录网口指示灯状态并联系售后。

4. TeleBox 从远程模式切换到采集模式后无法连接 TeleSuit​

现象:TeleBox 从远程模式切换到采集模式后,通过网线无法连接 TeleSuit。

解决方法:退出 VR 中的远程账号后,即可正常连接。

5. 首次配对无线模块时 PC 连接 5G WiFi 导致模块无法连接 TeleSuit​

现象:首次为无线模块配对时,PC 连接 5G WiFi,会导致无线模块无法连接 TeleSuit。

解决方法:配对无线模块时,PC 需连接路由器的 2.4G WiFi。

排查 Wi-Fi 信号强度

遇到无线模块网络连接不稳定时,可在运行动捕软件的 PC(Ubuntu)终端执行以下命令,查看当前环境下的 Wi-Fi 网络及其信号强度:

nmcli device wifi list

结合输出中的信号强度(SIGNAL)判断是否存在干扰或距离过远,并尝试靠近路由器或重新配网。

网络与通信​

6. WiFi 和有线连接 TeleSuit 分配的 IP 不在同一网段​

现象:WiFi 和有线连接 TeleSuit 时,分配的 IP 不在同一网段。

解决方法:

  1. 检查是否有其他 DHCP 服务正在运行。
  2. 检查是否有设备通过有线连接 TeleSuit 并启动了其他 DHCP 服务。

如果以上检查无法定位,可以先修改 WiFi 密码后重新连接,逐步排查启动了 DHCP 服务的设备。

需技术人员操作:逐步定位 DHCP 冲突
  • 依次断开通过有线连接 TeleSuit 的设备,每断开一台后重新连接 WiFi,观察分配的 IP 是否回到同一网段。
  • 定位到具体设备后,关闭该设备上的 DHCP 服务,或调整其网段配置。
  • 排查期间请保留原有网络配置,不要修改 TeleSuit 或 TeleBox 的固定 IP。

7. TeleBox 切换上传模式后无法联网​

现象:TeleBox 切换上传模式后再次接入网线时,网络不可用。

解决方法:访问 http://10.42.0.3:7876 网页,重新应用配置使网络生效。

8. 8686 网页前端无法正常刷新​

现象:访问 http://10.42.0.2:8686 网页时,前端无法正常刷新。

解决方法:

  1. 清除浏览器缓存后重新打开网页。
  2. 使用 Chrome 无痕窗口重新访问,或更换浏览器重试。

如果仍无法刷新,请记录访问地址、浏览器报错和设备指示灯状态,并联系售后。重启前端服务属于技术维护操作,请不要自行执行。

9. 无线中继导致的 WiFi 断连告警​

现象:无线中继打开但未连接上级路由时,VR 会检测到 WiFi 断连并触发告警。

解决方法:连接设备的 WiFi,进入路由器管理页面,不使用时关闭无线中继。不熟悉路由器设置时,请联系现场网络管理员或售后。

10. TeleSuit 与 TeleBox 无法通信,收不到 TeleBox 的 topic​

现象:TeleSuit 与 TeleBox 之间无法通信,收不到 TeleBox 的 topic,遥操作无法开始。

解决方法:

  1. 确认 TeleSuit 与 TeleBox 已连接到正确的网络。网口定义与连接拓扑请见现场网络速查。
  2. 检查两端是否能互相通信。
  3. 确认 TeleSuit 和 TeleBox 没有与其他套设备混接。
  4. 记录两端软件版本,确认版本是否匹配。
  5. 正常重启 TeleSuit 和 TeleBox 后再次测试。
需技术人员操作:data_proxy 服务与 ROS 域配置

如果上述检查后仍无法通信,需要检查 data_proxy 服务状态和 ROS 域(domain id)配置。这些项目应由具备维护权限的技术人员或售后处理,普通用户不要自行修改。

11. ROS2 无法通信进行遥操作​

现象:机器人使用 ROS2 时无法与 TeleBox 通信,导致遥操作异常。

解决方法:为连接 TeleBox 的设备配置指向 box_ip:11811 的发现服务器地址,确保可以获取 ROS2 数据。

box_ip 应替换为当前 TeleBox 的实际 IP。本项属于机器人集成配置,请由集成人员执行,普通用户不要自行修改 ROS2 配置,如有需要请联系售后。

12. 遥操作卡顿或延迟​

现象:机器人动作不同步、joint states 掉频,或出现数秒延迟。

解决方法:

  1. 确认当前使用的是有线还是无线网络,条件允许时优先使用稳定的有线连接。
  2. 检查网络中是否存在下载、投屏或视频传输等大流量任务,关闭后再次测试。
  3. 确认 TeleSuit、TeleBox 和工控机的软件版本是否匹配。
  4. 确认工控机没有同时运行不必要的高负载程序。
  5. 长时间运行后才出现卡顿时,保存当前工作后正常重启设备。

如果问题可以稳定复现,请记录发生时间、延迟表现和当时的网络连接方式,并联系售后。资源占用和服务状态的检查应由技术人员完成。

标定与动作捕捉​

13. 标定过程中没有语音播报​

现象:标定过程中没有语音播报。

解决方法:

  1. 检查动捕服和手套的接线。
  2. 关闭 Mocap。
  3. 根据界面提示处理并清除已有告警。Mocap 打开时出现报错会导致语音播报中断。
  4. 等待约 5 秒后重新打开 Mocap,再开始标定。

如果告警无法清除,请截取告警页面并联系售后。

14. 动捕标定不准或标定动画卡顿​

现象:标定结果不稳定,出现膝盖内扣、姿态异常,或标定动画卡顿。

解决方法:

  1. 标定时按界面提示完成动作,保证动作幅度和姿势到位;环境尽量宽敞、避免遮挡,并远离可能造成磁场干扰的设备。
  2. 检查动捕服和传感器是否穿戴到位。
  3. 检查网络是否稳定。
  4. 退出当前标定流程,确认设备状态正常后重新标定一次。

不要连续反复标定。多次出现相同问题时,请保留异常画面或录像并联系售后。

15. 全自动标定时引导小人不在画框内​

现象:点击全自动标定时,动捕引导小人不在画框内。

解决方法:打开全局定位功能后重新进入全自动标定,确认引导画面是否恢复正常。

如果界面中找不到全局定位选项,或开启后仍然异常,请记录软件版本并联系售后。

16. Mocap 打开后动捕小人不动​

现象:Mocap 打开后,动捕小人不动。

解决方法:

  1. 关闭 Mocap,等待数秒后重新打开。
  2. 如果仍未恢复,退出 VR APP 后重新进入。
  3. 检查界面是否同时显示其他错误告警。

反复重启后仍没有动作数据时,请不要继续标定,按「VR 提示 No data available」一节检查连接。

17. 打开 Mocap 后只有一只手有数据​

现象:打开 Mocap 后,只有一侧手部有数据。

解决方法:

  1. 检查无数据一侧的手套连接线是否松动或破损。
  2. 关闭相关设备后,重新插紧该侧连接线。
  3. 重新启动 Mocap,检查数据是否恢复。

重新连接后仍只有单侧数据时,通常需要进一步检查线材或手套硬件,请联系售后。

18. Mocap 或 Teleop 异常问题​

现象:Mocap 或 Teleop 打开时重启 TeleSuit,有一定概率导致无法正常再次开启。

解决方法:访问 http://10.42.0.3:7876 网页,重新应用配置后退出 VR 并重新进入 APP 恢复。

VR 应用​

19. VR 提示 No data available​

现象:VR 中提示 No data available。

解决方法:该提示表示 VR 当前没有收到数据,不一定是 VR 本身故障。请依次检查:

  1. TeleSuit 是否正常开机,指示灯有无异常。
  2. TeleSuit 与 TeleBox 是否连接到正确的网络。
  3. TeleSuit 和 TeleBox 是否属于同一套设备。
  4. TeleBox 与 VR 之间的通信是否正常。

如果以上均正常,请参考错误消息参考手册检索界面中的具体报错。

20. VR APP 安装失败​

现象:VR 中安装 APP 时出现安装失败(偶发)。

解决方法:

  1. 先卸载 APP 后重新安装。
  2. 确认 VR 头显存储空间充足,重启头显后再次尝试。
需技术人员操作:使用 ADB 卸载后重装

若仍安装失败,可由技术人员通过 ADB 卸载后重装:

adb uninstall com.ioai.TeleXperiencebeta

21. VR 登录失败或提示网络错误​

现象:VR 中登录失败,或提示网络错误。

解决方法:国行设备与海外账号对网络和账号区域的要求可能不同。先确认 VR 头显可以正常访问网络,再核对账号区域和登录环境。如果登录时提示网络错误,可先连接其他可用网络完成账号登录,再切回 TeleSuit 的 Wi-Fi 使用。

不要因为登录失败直接判断为设备故障。

22. VR 投屏失败​

现象:无法将 VR 画面投屏到电脑。

解决方法:投屏前确认 VR 头显与接收投屏的电脑处于同一网络。部分投屏方式不支持当前的有线连接方案,需要改用可互通的无线网络。

如果仍无法投屏,请分别确认:

  1. VR 头显是否已经联网。
  2. 电脑是否能访问同一网络中的其他设备。
  3. VR 头显和电脑是否连接了不同的热点。
  4. 当前投屏方式是否支持所用网络。

23. 录屏时进入 APP 场景异常​

现象:录屏时进入 APP,并按 A 键进入安全须知后,整个场景会跟随头部移动。

解决方法:进入 APP 时不要立即录屏。退出应用并停止录屏后重新进入,进入 APP 并完成初始页面操作后,再打开录屏功能。

24. 修改相机分辨率后 VR 中视角变化​

现象:修改相机分辨率后,VR 中相机视角发生变化。

解决方法:

  1. 修改相机设置后,重启遥操作设备。
  2. 如果不便重启,访问 http://10.42.0.3:7876 网页重新应用配置。

应用配置前请先保存正在进行的任务。

遥操作与数据​

25. TeleBox 断电重启后 Teleop 服务报错​

现象:TeleBox 断电重启后,第一次启动 Teleop 同步时按 A 键出现服务报错。

解决方法:重新关闭并开启 Teleop。

预防:严禁直接断电,长期直接断电可能导致存储卡或文件系统异常。请按 TeleBox 关机的步骤完成设备关机后再断电。

26. VR 视频花屏​

现象:VR 端视频花屏(偶发)。适用于 ROS1 的 OpenLongVuer。

已尝试无效的操作:重启 VR APP、VR 网线直连、重新应用配置。

其他情况:

  1. 打开 H264 显示工具时,视频正常显示。
  2. 切换到 ROS2(domain id 非 0)后,花屏消失;切回 ROS1 后,花屏未再出现。切换 ROS1 的 domain id 为 0 后,花屏也未再出现。

临时解决方法:切换到 ROS2,然后再切回 ROS1。

该问题的根因仍在分析中,如需彻底解决请联系技术支持。

日常使用注意事项​

  • 设备不用时按设备关机的步骤关机后再断电,不要长期通电闲置。
  • 长时间运行后出现异常,可先保存当前工作,再正常重启设备。

通风、线材插拔、存放等使用与维护要求,以及设备关机步骤,请见规范使用。

联系售后时请提供​

为了更快定位问题,联系技术支持时请提供以下信息:

  • TeleSuit 端和 TeleBox 端的软件版本
  • TeleSuit、TeleBox 及相关配件的设备编号(SN)
  • 故障现象、发生时间和操作步骤
  • 指示灯颜色及闪烁状态
  • 当前网络连接方式和设备连接关系
  • 已经尝试过的排查步骤
  • 日常关机方式(是否按设备关机步骤关机、是否经常直接断电),便于判断问题是否与长期直接断电有关
  • 报错截图、异常录像或日志(如有)

界面中出现英文报错时,请保留完整消息内容,可先在错误消息参考手册中检索。日志由具备维护权限的人员按项目流程收集。