Vision & Runtime
Camera feed
Q: The "objects" box in the upper-right corner is black
The Pico-G1 has a built-in SC465SL camera (MIPI CSI).
| Possible cause | Solution |
|---|---|
| shimeta-svp/xmm not started | Click "Run" in the Vision Tab |
| Camera not connected | Check the ribbon cable |
| Service failed to start | Check that shimeta-svp/xmm is installed on the board |
Q: How do I plug in the camera ribbon cable?
See Supported hardware.
The Pico-G1 camera connector is a dedicated MIPI CSI; other models are not compatible for now.
Q: Choppy feed / low FPS?
| Possible cause | Fix |
|---|---|
| NPU temperature too high (>85°C) | Improve cooling |
| Input resolution too large | Use a smaller model |
| Insufficient network bandwidth | Use a wired network |
shimeta-svp
Q: What is SVP?
Nine pre-compiled scene detection tools built into the board — no training needed to start them.
Q: What are the 9 scenes?
See Vision — SVP.
Q: A scene doesn't respond when started
| Possible cause | Troubleshooting |
|---|---|
| Camera not connected | Check the ribbon cable |
| Service failed to start | Start shimeta-svp <scene> via terminal SSH to see the error |
| Port conflict with shimeta-xmm | Stop one of them first |
Q: Can I run multiple scenes at once?
No. Only one scene can run at a time.
Q: My parameter changes didn't take effect
After tuning, shimeta-svp must be restarted for changes to apply. Click "Run" on the scene card to restart it.
shimeta-xmm
Q: The panel says "no models"?
The board's /mnt/models/xmm/ directory is empty. Deploy a model first:
- Switch to the Models Tab
- Pick a model → Deploy to board
- Switch back to the Vision Tab
Q: "Run" is unresponsive
| Possible cause | Troubleshooting |
|---|---|
| Model file corrupted | Deploy again |
| Port conflict | shimeta-svp still running; stop it first |
| NPU incompatible | Re-export from AIHub |
Q: All detection confidences are below 5%?
The model doesn't match the NPU. Re-export the .xmm from AIHub.
shimeta-py IDE
Q: What is shimeta-py?
The board's Python runtime (v1.0.4). Code edited in the IDE is executed by shimeta-py.
See shimeta-py IDE.
Q: "Run" does nothing
| Possible cause | Troubleshooting |
|---|---|
| Board not connected | Check DEVICE TREE |
| shimeta-py missing on the board | Firmware issue; contact technical support |
Q: Output says "No space left on device"
The board's disk is full. SSH in and clean up old files:
ssh shimetad@192.168.49.10
df -h
rm -rf /mnt/old_models/Q: Can Python code access the board's hardware?
Yes. shimeta-py runs on the board, so it can use the NPU / GPIO / I2C, etc.:
import subprocess
result = subprocess.run(['uname', '-a'], capture_output=True, text=True)
print(result.stdout)Terminal
Q: The terminal is unresponsive after starting
The board is not connected. Go back to Device management.
Q: Can I SSH to the root user?
Yes:
ssh root@192.168.49.10
# password: 123456Q: A command produces no output?
Check the command; or press Ctrl+C to interrupt.
Agent
Q: The Agent says "connect a board first"
Check the connection status in DEVICE TREE. The Agent cannot operate the board while it is disconnected.
Q: A natural-language instruction gets no response
- Restart the IDE
- Or start a new session
- Simplify the instruction (specific beats vague)
Q: The Agent fails to run an SSH command?
This is a shimetad user permission issue. Verify it in the Terminal Tab.
Performance issues
Q: The IDE starts very slowly?
| Possible cause | Solution |
|---|---|
| Board not connected (repeated reconnection at startup) | Connect the board first |
| Too many project files | Clean up the workspace |
| Low system resources | Close other programs |
Q: The IDE uses too much CPU?
Possible causes:
- MJPEG decoding of the camera preview
- Multiple Agent sessions running at once
- Heartbeats for multiple boards
Port conflicts
Q: Port 8080 conflict?
shimeta-svp and shimeta-xmm both use port 8080 and cannot start at the same time.
To switch:
- Stop the current service
- Start the new one
Camera
Q: Can I swap in another camera?
Only the SC465SL is supported right now. Other models are not compatible yet.
Q: Can I use a USB camera?
Not yet — only the MIPI CSI SC465SL.
Quick troubleshooting
| Symptom | Solution |
|---|---|
| Black feed | Check the camera cable + service start |
| Very low FPS | Check NPU temperature |
| Model not showing | Deploy again |
| Agent unresponsive | Restart the IDE |
| Terminal frozen | Ctrl+C to interrupt; reconnect |