> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

<Info>
  For visualization issues (heatmap all black or misaligned), see [handling faults in Wuji CLI visualization](/en/docs/wuji-cli/visualization/#handle-faults). For SDK issues, see [Wuji SDK troubleshooting](/en/docs/wuji-sdk/troubleshooting).
</Info>

## Unable to connect to the glove

1. Check physical connections
   * Is the USB-C cable firmly plugged in with consistent orientation markings?
   * Is the Ethernet cable connected and adapter indicator light on?
   * Is power supply normal (the glove LED should light up and transition to a breathing pattern. Use a USB-A to USB-C cable, since USB-C to USB-C cables cannot power the glove)?

2. Confirm the glove IP
   * Factory default IP: `192.168.1.100` (left hand), `192.168.1.101` (right hand)
   * If the glove IP has been changed via Wuji CLI or the SDK, replace `192.168.1.100/101` below with the actual configured IP

3. Check network configuration
   * Is the computer IP on the same subnet as the glove (default `192.168.1.x`, or the subnet of the configured IP if it's been changed)?
   * Is the subnet mask set to 255.255.255.0?
   * Does the computer IP conflict with the glove (avoid the IP the glove actually uses)?
   * Try `ping <glove IP>` to verify reachability (with factory defaults, that's `ping 192.168.1.100` or `ping 192.168.1.101`)

## Ping replies but can't connect to the glove

A ping reply doesn't guarantee a client (Wuji CLI or an SDK script) can reach the glove. Rule out [network-layer](#network-layer) interference first, then look at [software-layer](#software-layer) causes.

<a id="network-layer" />

### Network Layer: Ping Does Not Reach the Glove

In multi-NIC environments, ping traffic may be routed to the wrong device:

* **Imposter device:** another NIC sits on the glove's subnet with an unrelated device occupying the glove IP and answering the ping.
* **IP conflict:** two NICs on the same machine are both assigned to the glove's subnet. The OS usually reports a conflict. Even when it doesn't, ping traffic is routed at random between the NICs, producing intermittent replies.

If the NIC actually connected to the glove isn't on the glove's subnet, the client still can't reach the glove.

To resolve (examples below use the factory default `192.168.1.100`, replace with the actual glove IP if you've changed it):

1. **Unplug the glove and ping the glove IP again:**
   * Ping still gets a reply → another device holds that IP. Remove it from this machine's network (unplug its cable, power it off, or drop it from the routing table) so the NIC can no longer reach it.
   * Ping replies are intermittent, or the OS reports an IP conflict → multi-NIC IP conflict. Keep only the NIC connected to the glove on the glove's subnet, and move the other NICs off that subnet or disable them.
2. **Plug the glove back in and ping again.** If ping still gets no reply, check the IP of the NIC the glove is attached to—it should be on the same subnet as the glove. If not, set it to that subnet (for the default glove IP `192.168.1.100`, use something like `192.168.1.50/24`).

Helper commands (the `192.168.1.100` below uses the factory default, replace with the actual glove IP if you've changed it):

```bash theme={null}
ip addr show                # List each NIC's IP
ip route get 192.168.1.100  # Check which NIC ping uses
ip neigh show 192.168.1.100 # Compare the responder's MAC with the glove's
```

<a id="software-layer" />

### Software layer: ping reaches the glove but the client still can't connect

* Make sure no other client (Wuji CLI or an SDK script) is already connected to the device

* If ufw is enabled on Ubuntu, allow the UDP ports the device uses (`50000` for discovery, `50001` for data, with the data port configurable in device settings):

  ```bash theme={null}
  sudo ufw status
  sudo ufw allow 50000/udp
  sudo ufw allow 50001/udp
  ```

* Try restarting the glove (power cycle)

## Two gloves of the same handedness can't connect at once

Two same-handed gloves on one subnet ship with the same default IP, so the addresses collide:

1. Connect one glove first
2. Change its IP as described in [Device Operations](/en/docs/wuji-glove/sdk-data-reference/device-operations#parameter-persistence), then reboot the device
3. Put both gloves on the network and connect by serial number (`sn`) — see [Device Connection](/en/docs/wuji-sdk/device-connection/#connect-by-sn)

## Tactile data is all 0 or -1

Values of -1 mark invalid points, which is normal. If values stay at 0 even when you press the sensor surface:

1. Confirm the `tactile` data stream is subscribed
2. Run `wuji calib tactile` for [tactile calibration](/en/docs/wuji-cli/tactile-calibration/)
3. If still unchanged after calibration, inspect the sensor area for physical damage

## Tactile data is inaccurate or shows abnormal values

* Make sure the sensor area is flat and not folded before wearing
* Keep fingers slightly bent and relaxed when connecting
* Check if calibration has been performed
* Values of -1 indicate invalid points, which is normal behavior

## Tactile data flickering or jumping

* Check if the glove is worn too loosely, causing unstable sensor contact
* Avoid applying excessive pressure that may saturate the sensors
* Verify that the glove wiring is not damaged

## EMF positioning is inaccurate or drifting

1. Check `confidence` values—below 0.8 indicates significant environmental interference
2. Move away from metal objects and electronic devices
3. Keep the hand within 30 cm of the transmitter coil
4. Ensure no large metal objects block the path between the transmitter coil and hand
5. Perform EMF calibration

## EMF confidence is consistently low

* Check if the hand is too far from the transmitter coil (recommended within 30 cm)
* Confirm the transmitter coil power supply is normal
* Inspect receiver coils for physical damage

## IMU orientation data is drifting

* Wait 2–3 seconds after power-on for the IMU to stabilize
* Avoid using near strong magnetic fields (e.g., near large motors)
* Wear the glove securely to avoid looseness

## Get technical support

Contact [support@wuji.tech](mailto:support@wuji.tech) with the following information:

* Glove serial number (SN)
* Firmware version
* SDK and CLI versions
* Operating system and version
* Steps to reproduce the issue


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.