Moonlink Overview

Troubleshooting Moonlink Issues

---

If you're experiencing issues with Moonlink, follow these steps to diagnose and resolve them:

---

1️⃣ First-Time Login

• 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.'

---

2️⃣ Moonlink Not Working After Login

Check Folder Structure

• Ensure there is only one Moonlink folder on your 2nd PC.

  • Multiple folders can cause conflicts.

Verify Firmware Upload

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.

---

3️⃣ Device-Specific Checks

For Arduino Leonardo Users

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

1. Open Device Manager on the 2nd PC.

2. Locate CP2102 under Ports (COM & LPT).

3. Right-click CP2102 → Select Properties.

4. Go to the Power Management tab.

5. Uncheck "Allow the computer to turn off this device to save power."

6. Click OK.

Try Different USB Ports & Restart PCs

• Test with different USB ports on both PCs.

• Restart both PCs if needed.

For Arduino Due Users

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

  • Download link

---

5️⃣ Final Steps for Both Arduino Leonardo & Due

1. Open Command Prompt (CMD) (Do not run as administrator).

2. Drag the Moonlink.exe file into the command window.

3. Press Enter and check for any error messages.

---

6️⃣ If All Else Fails

• Check the .log file in the Moonlink folder and upload it in the support channel.

---

Following these steps should help resolve most common issues!