Troubleshooting

🆘 Troubleshooting

🌐 Language / Idioma: English | Español

Common Windows Errors (Client)

"No server found"

Possible causes:
1. USB/IP server not running
2. Firewall blocking port 3240
3. Not on the same subnet

Solutions:

# On the Linux server, verify usbipd is running:
sudo systemctl status usbipd

# Verify firewall:
sudo ufw status
sudo ufw allow 3240/tcp

---

"Error connecting device"

Possible causes:
1. Drivers not installed on Windows
2. Device not "bound" on server
3. Not running as Administrator

Solutions:
1. Check bottom bar: Drivers: ✅ Installed
2. On server: sudo usbip bind -b X-X
3. Right-click SnakeUSBIP.exe → "Run as administrator"

---

"Device connected but not working"

Possible causes:
1. Missing device-specific driver on Windows
2. Incompatible USB 3.0 device
3. Defective USB port

Solutions:
1. Open Device Manager → look for device with ⚠️
2. Try connecting USB to a USB 2.0 port on the server
3. Try a different USB cable

---

Linux Errors (Server)

"usbip: command not found"

sudo apt install linux-tools-$(uname -r)
# If that doesn't work:
sudo apt install linux-tools-generic

---

"Cannot find device"

# See all connected USB
lsusb
# See details with usbip
sudo usbip list -l

---

"Device busy"

# If storage, unmount first:
sudo umount /dev/sdX
# Then bind:
sudo usbip bind -b 1-1.4

---

"Connection refused" from Windows

# Verify daemon is running
sudo systemctl status usbipd
# If not running:
sudo usbipd -D
# Verify listening on port 3240:
sudo netstat -tlnp | grep 3240

---

📋 Diagnostic Checklist

On Server (Linux/Raspberry Pi):

• sudo usbipd is running
• USB device physically connected (lsusb)
• Device "bound" (sudo usbip list -l shows attached)
• Port 3240 open (sudo ufw allow 3240/tcp)
• Correct IP (ip addr)

On Client (Windows):

• SnakeUSBIP running as Administrator
• Drivers installed (green bottom bar)
• Same subnet as server
• No VPN or firewall blocking

---

🔧 Useful Commands

Windows (PowerShell as Admin)

# See connected USB/IP devices
.\usbipw.exe port

# Manually disconnect device
.\usbipw.exe detach -p 00

Linux

# See all USB devices
lsusb -t

# See shared devices
sudo usbip list -l

# See active connections
sudo usbip port

# Real-time logs
journalctl -u usbipd -f

---

📞 Need more help?

• 🐛 Report bug on GitHub
• 📺 Watch video tutorial