Moonlink Overview
Last updated
Last updated
If you're experiencing issues with Moonlink, follow these steps to diagnose and resolve them:
Register an Account:
Enter your username and password.
Input 1 of the following: Color, AI, or Moonlink key.
Ensure there are no extra spaces in the key field before clicking 'Register.'
Ensure there is only one Moonlink folder on your 2nd PC.
Multiple folders can cause conflicts.
Make sure the correct firmware is uploaded to your Arduino:
For Arduino Leonardo: Upload the .ino.hex
file.
For Arduino Due: Upload the .bin
file.
Check CP2102 Connection
CP2102 should be plugged into the 2nd PC.
Arduino Leonardo should be plugged into the Main PC.
Ensure all jumpers are properly connected.
Disable Power Management for CP2102
Open Device Manager on the 2nd PC.
Locate CP2102 under Ports (COM & LPT).
Right-click CP2102 → Select Properties.
Go to the Power Management tab.
Uncheck "Allow the computer to turn off this device to save power."
Click OK.
Try Different USB Ports & Restart PCs
Test with different USB ports on both PCs.
Restart both PCs if needed.
Check Both Micro USB Cables
Use high-quality cables that support both data and power (avoid charging-only cables).
Swap out cables to test if one is faulty.
Try Different USB Ports & Restart PCs
Test different USB ports on both PCs.
Restart both PCs if needed.
4️⃣ Check for Windows OS Related Issues
If you try to open the exe and you get a cv2 recursion error, it never opens, force closes, or something else, you may need to follow these steps.
Check for Windows updates
Windows search bar --> settings --> Windows Update --> Check for updates
Sync your clock
Windows search bar --> Time & Language --> Date & Time
Windows 10
Windows 11
Install Visual C++ Redistributable Runtimes All-in-One
Open Command Prompt (CMD) (Do not run as administrator).
Drag the Moonlink.exe file into the command window.
Press Enter and check for any error messages.
Open a ticket in the Moonlink Discord server.
Click the Upload Logs button at the bottom of the sidebar.
This will send your current config and log file so we can assist you with troubleshooting.
Following these steps should help resolve most common issues!