Troubleshooting
Solutions to common issues you might encounter.
Serial Connection
Port not appearing in list
- • Check if the device is properly connected via USB
- • Open Device Manager and look for COM ports under "Ports"
- • Install drivers for your USB-to-serial adapter (FTDI, CH340, CP210x)
- • Try a different USB port or cable
Garbled or corrupted output
- • Baud rate mismatch — try 9600, 115200, or check device docs
- • Wrong data format — most devices use 8N1 (8 data bits, no parity, 1 stop bit)
- • Electrical interference — use shorter or shielded cables
Access denied error
- • Another app has the port open (Arduino IDE, PuTTY, etc.)
- • Close other serial applications and try again
- • Unplug and replug the device
Device resets when connecting
- • Normal for Arduino boards (DTR triggers auto-reset)
- • Disable DTR in connection settings if unwanted
SSH Connection
Connection refused
- • Check if SSH server is running on target:
systemctl status sshd - • Verify port number (default 22)
- • Check firewall rules on target machine
Authentication failed
- • Verify username and password
- • For key auth: ensure private key file is correct format (OpenSSH)
- • Check key permissions and passphrase
Host key verification failed
- • Server fingerprint changed (reinstall, IP reuse)
- • Remove old entry from known hosts and reconnect
- • Verify you're connecting to the correct server
AI / Magic Input
Connection to Ollama failed
- • Check Ollama is running (look for llama icon in system tray)
- • Run
ollama servemanually in terminal - • Verify endpoint in settings:
http://localhost:11434
Model not found
- • Pull the model first:
ollama pull llama3.2 - • Check model name matches exactly in settings
- • Run
ollama listto see available models
Very slow responses
- • Use a smaller model:
qwen2.5:1.5borllama3.2:1b - • Close other GPU-intensive applications
- • If using CPU only, expect slower responses
Poor command suggestions
- • Be more specific in your request
- • Import relevant datasheets to RAG for context
- • Try a more capable model like
llama3.2ormistral
Performance
Terminal feels laggy
- • Check GPU acceleration is enabled in settings
- • Reduce scrollback buffer size if very large
- • Update graphics drivers
High memory usage
- • Large scrollback buffers consume memory
- • Clear terminal history periodically
- • Close unused connection tabs