跳转到主要内容
This page gives diagnostic steps by symptom. For device stop behavior, emergency stop, the fault-clearing flow, and maintenance requirements, see Maintenance. For SDK installation, connection, and subscription problems, see Wuji SDK troubleshooting.

​
Device Discovery Failure

  1. Confirm the device has power and the status light reached white breathing.
  2. Confirm the network cable runs between the device port and the computer port with no loose connector.
  3. Confirm the computer adapter sits on the same subnet with subnet mask 255.255.255.0.
  4. Run ping 192.168.1.110 for the left hand or ping 192.168.1.111 for the right hand.
  5. Run wuji devices again.

​
Connection Fails or IPs Collide

Two devices of the same handedness on one subnet ship with the same IP, which collides. Connect one at a time, change the IP of one following ip (SET/GET), reboot it, then connect both.

​
The Status Light Shows a Warning or Fault

Match the light against Back-of-Hand Status Light in Product Introduction, then subscribe to joint_diagnostics to read the exact error code and work through Clear Faults and Reset Safely.

​
Joints Offline (Fewer Than 20 Online)

  1. Read the actual count with hand.online_joints_count().get().
  2. Subscribe to joint_diagnostics and locate the missing joint by each entry’s nid.
  3. Check whether that joint is jammed or its cable is under tension.
  4. Power-cycle and check again. If a joint stays missing, export logs and contact technical support.

​
Enable Fails

  1. Confirm no error code is active, and clear faults first if one is.
  2. Confirm the finger workspace is clear with no external constraint.
  3. Call hand.enable() again and wait for the status word to reach Enabled.
  4. After repeated failures, power-cycle and retry.

​
A Parameter Write Is Rejected

effort_limit and mit_params reject NaN, Inf, and negative values, and effort_limit also rejects values above the device ceiling. A rejected write leaves the value in effect unchanged, so read the current value back and retry within the ceiling. See Parameter Safety Limits.

​
Export Logs and Contact Support

When contacting [email protected], include the device serial number, firmware version, SDK version, reproduction steps, and logs. For SDK-side log locations and levels, see Wuji SDK troubleshooting.