故障排查

无法连接手套

1. 检查物理连接

   • USB-C 线缆是否插紧，正反面标识是否一致
   • 网线是否插好，适配器指示灯是否亮起
   • 电源是否正常供电（手套 LED 是否亮起，并正常转变至呼吸灯状态。必须使用 USB-A to USB-C 线缆，USB-C to USB-C 线缆无法为手套供电）

2. 确认手套 IP

   • 出厂默认 IP：左手 192.168.1.100，右手 192.168.1.101
   • 若曾通过 Studio 或 SDK 修改过手套 IP，下文出现的 192.168.1.100/101 请替换为实际配置的 IP

3. 检查网络配置

   • 电脑 IP 是否与手套同网段（默认 192.168.1.x，已修改 IP 时为实际 IP 所在网段）
   • 子网掩码是否为 255.255.255.0
   • 电脑 IP 是否与手套冲突（避开手套实际占用的 IP）
   • 尝试 ping <手套 IP> 验证可达性（出厂默认即 ping 192.168.1.100 或 ping 192.168.1.101）

ping 有响应但连不上手套

ping 有响应不代表客户端（Studio 或 SDK 脚本）能连上手套。先排除网络层干扰，再排查软件层。

网络层：ping 实际未到达手套

多网卡环境下，ping 流量可能被错误路由到其他设备：

• 冒名设备：另一张网卡所在网段下挂有其他设备，恰好占用了手套 IP 并响应 ping。
• IP 冲突：电脑上有两张网卡都被分配到与手套相同的网段（如 .1 和 .3）。操作系统通常会报冲突，即便不报错，ping 流量也会在两张网卡间随机走，表现为响应时有时无。

而连接手套的网卡若不在手套所在网段，客户端依然连不上手套。

处理步骤（下文以出厂默认 IP 192.168.1.100 为例，已修改 IP 请替换为实际手套 IP）：

1. 拔掉手套后，重新 ping 手套 IP：
   • 仍能收到 ping 响应 → 网段下有冒名设备。从这台电脑的网络中断开它（拔线、关闭对端，或从路由表中剔除），使对应网卡不再能访问到它。
   • ping 响应时有时无，或系统提示 IP 冲突 → 多网卡 IP 冲突。仅保留连接手套的那张网卡处于手套所在网段，将其他同网段网卡移出该网段或临时禁用。
2. 重新插上手套再 ping。若仍无响应，检查手套所连网卡的 IP 是否与手套同网段。不在则将其改为同网段（如手套为默认 192.168.1.100，可将网卡设为 192.168.1.50/24）。

辅助排查命令（命令中的 192.168.1.100 同样以默认 IP 为例，已修改请替换为实际手套 IP）：

ip addr show                # 查看每张网卡的 IP
ip route get 192.168.1.100  # 查看 ping 流量走的是哪张网卡
ip neigh show 192.168.1.100 # 查看响应方的 MAC，与手套实际 MAC 对比

软件层：ping 已到达手套但客户端连不上

• 确认无其他客户端（Studio 或 SDK 脚本）同时占用设备连接

• 若 Ubuntu 已启用 ufw，请确认已放行设备所需的 UDP 端口（50000 用于设备发现，50001 用于数据通信，可在设备配置中修改）：

  sudo ufw status
  sudo ufw allow 50000/udp
  sudo ufw allow 50001/udp

• 尝试重启手套（断电后重新上电）

获取技术支持

请联系 support@wuji.tech，并附上以下信息：

• 手套序列号（SN）
• 固件版本
• SDK/Studio 版本
• 操作系统和版本
• 问题复现步骤