Support
We're here to help you get the most out of QuickPort.
Common Troubleshooting
🔌 Dongle Not Detected
Symptoms: App shows "Disconnected" even when dongle is plugged in.
Solutions:
- Unplug and re-plug the dongle into your iPhone
- Force-quit the QuickPort Terminal app and relaunch it
- Try a different USB-C cable or port (if using a hub)
- Restart your iPhone
- Check for iOS updates in Settings
- If using a hub, try direct connection to iPhone
Note: "Disconnected" is normal when no dongle is attached. Only troubleshoot if the status doesn't change after plugging in.
📡 No Data Received from Target
Symptoms: Terminal is connected but you don't see any data from your device.
Solutions:
- Verify TX and RX pins are swapped: Dongle RX → Target TX, Dongle TX → Target RX
- Check that baud rate, parity, and stop bits match your target device
- Confirm your target device is powered on and transmitting
- Verify voltage levels are compatible (3.3V logic)
- Try a loopback test: connect dongle TX to RX — you should see characters echo back
- Check ground connection between dongle and target
⚡ Voltage Level Issues
Symptoms: Garbled data, intermittent connection, or no communication.
Solutions:
- Confirm your target device uses 3.3V logic
- If your device uses 5V (e.g., classic Arduino), use a bi-directional level shifter
- Check voltage with a multimeter if uncertain
- Consult your target device's datasheet
Warning: Connecting 5V signals directly to the dongle may damage it. Always verify voltage compatibility.
🔄 Firmware Update Issues
Symptoms: Firmware update fails or gets stuck.
Solutions:
- Ensure iPhone is connected to Wi-Fi and has battery > 50%
- Keep the dongle plugged in during the update
- Do not close the app or lock the screen during update
- If update fails, restart iPhone and try again
- Contact support if update fails repeatedly
📱 App Crashes or Freezes
Symptoms: App becomes unresponsive or crashes.
Solutions:
- Force-quit the app and relaunch
- Restart your iPhone
- Check for app updates in the App Store
- Free up storage space if device is nearly full
- Reinstall the app if problems persist
Knowledge Base
Getting Started Guide
Learn how QuickPort works and how to set up your first connection.
Technical Specifications
Complete electrical specs, pinouts, and compatibility information.
App Features & Usage
Detailed guide to QuickPort Terminal app features and settings.
Frequently Asked Questions
Quick answers to common questions about QuickPort.
Still Need Help?
We typically respond within 24 hours during business days.