Troubleshooting
Installation
Q: SDK installation fails?
- Confirm Python version ≥ 3.10
- Update pip with
pip install --upgrade pip - If you encounter compilation errors, try installing the pre-built wheel package
Runtime Errors
Q: SDK script throws exception during execution?
| Exception Message | Cause | Resolution |
|---|---|---|
DeviceNotFound | Device not discovered | Check physical connection and network |
Disconnected | Connection interrupted | Check cables, reconnect |
ConnectionTimeout | Connection timed out | Check network connection or increase timeout_ms parameter |
OperationTimeout | Operation timed out | Increase timeout_ms parameter or check device status |
StreamClosed | Subscription stream closed | Device 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