Troubleshooting & Error Codes
A comprehensive reference for resolving common toolchain and runtime errors.
Error Code Table
| Code | Meaning | Resolution |
|---|---|---|
1002 | Device Not Found | Check USB connection. Ensure user has dialout/usb group permissions. |
2005 | Model Load Failed | File path is incorrect or the `.nef` file is corrupted. Re-compile. |
3001 | Unsupported Operator | The ONNX model contains an op not in the support list. Use kneron optimize or implement a custom op. |
4004 | Memory Overflow | The model is too large for the NPU SRAM. Reduce input size or use model splitting. |
Common Scenarios
This is often a power supply issue.
- Ensure you are using a USB 3.0 port (Blue).
- If using a hub, ensure it is powered.
- Try a shorter, high-quality USB-C cable.
Check your pre-processing pipeline.
- Normalization: Did you divide by 255? Did you subtract mean?
- Color Space: Is the model trained on RGB or BGR? OpenCV loads BGR by default.
- Layout: NCHW vs NHWC.