Troubleshooting

Installation

Q: SDK installation fails?

  1. Confirm Python version ≥ 3.10
  2. Update pip with pip install --upgrade pip
  3. If you encounter compilation errors, try installing the pre-built wheel package

Runtime Errors

Q: SDK script throws exception during execution?

Exception MessageCauseResolution
DeviceNotFoundDevice not discoveredCheck physical connection and network
DisconnectedConnection interruptedCheck cables, reconnect
ConnectionTimeoutConnection timed outCheck network connection or increase timeout_ms parameter
OperationTimeoutOperation timed outIncrease timeout_ms parameter or check device status
StreamClosedSubscription stream closedDevice may have disconnected, reconnect

Q: SDK data subscription has latency or frame drops?

  • Check network bandwidth and latency (wired connection preferred over WiFi)
  • Reduce the number of simultaneously subscribed data streams
  • Ensure callback functions don't contain blocking operations

Compatibility

Q: SDK version incompatible with firmware?

  • Check the SDK release notes for version compatibility
  • Keep SDK and firmware on the same minor version (e.g., both 0.6.x)

Support

Q: How do I get technical support?

Contact support@wuji.tech with the following information:

  • Device serial number (SN)
  • Firmware version
  • SDK/Studio version
  • Operating system and version
  • Steps to reproduce the issue