Learn what to do if there’s a problem adding your device to Arduino Cloud.

---

Try these steps in order

1. Quick checks
2. Check your USB cable and peripherals
3. Disconnect shields, carriers and external circuitry
4. Reset the sketch
5. Install drivers and configuration files
6. Stop applications that may be using the device
7. Manually partition your memory Arduino device for Arduino Cloud

---

1. Quick checks

Try this first to solve common issues:

1. Disconnect and reconnect your device to the computer.
2. If prompted, allow the device to connect.
3. Verify that the device is powered by checking the power LED.
   • Exception: The Arduino Opta has no power LED, so it may be powered even if no LEDs are lit.
4. Close Arduino IDE or any other application that may be using the device.
5. Try adding your device in Arduino Cloud again.

2. Check your USB cable and peripherals

Connection issues can be caused by faulty or incompatible cables or USB accessories:

• Ensure you’re using a working USB cable that supports data transfer. If possible, try using a different cable.
• Ensure that any USB hubs or docks are powered and working. If possible, try connecting the device directly to your computer.

3. Disconnect shields, carriers and external circuitry

External hardware can interfere with power, reset, or serial communication, preventing uploads:

• Detach the device from any shield or carrier.
• Disconnect jumper cables and external circuitry.

4. Reset the sketch

A bad sketch or a non-working Cloud configuration can prevent your computer from programming the board.

If you’re configuring the device over serial (USB)

Try a double-press reset:

1. Find the reset button on the device (typically labeled RESET or RST).
2. Press the reset button twice and confirm that the on-board LED pulses. Adjust the timing if needed.
3. Continue with device configuration. You may find that the configuration is initially able to proceed, but encounters another error. In that case, simply repeat the double-press reset, and attempt to continue. Eventually, Arduino Cloud will overwrite any sketch on the board, solving the issue.

If you still can’t add the device, use Arduino IDE to the Cloud Editor to program the board with a safe sketch (such as the BareMinimum or Blink example), then try adding the device to Arduino Cloud again.

If you’re configuring the device over Bluetooth

• Understand that Bluetooth setup requires the board to be running the Arduino Cloud provisioning sketch. When the board is running this sketch, the on-board LED will flash with a “heartbeat” pulse that turns solid when connecting to Arduino Cloud. If your board is not running this sketch, you first need to configure it using USB (Serial).

• If your board is running the provisioning sketch but still isn’t detected, try resetting the Cloud configuration:

  • Arduino Opta: Press and hold the user button (BTN_USER) until the LED (LED_USER) turns off.
  • UNO R4 WiFi: Connect Pin 2 to GND until the LED turns off.

5. Install drivers and configuration files

Missing drivers or configuration files can cause a device to not be detected, or to fail during sketch upload. The Arduino Cloud Agent may not currently install all required drivers or configuration files for every device. The issue can be fixed by using Arduino IDE to install the required board package at least once.

If your board is not detected in Arduino Cloud, first install its board package using Arduino IDE or Arduino CLI to ensure that all drivers and rules are properly configured.

Follow these steps:

1. Install Arduino IDE.
2. Use Arduino IDE to install the board package for your device.
3. If prompted, allow the installation of the required drivers (Windows only).
4. Try uploading a basic sketch like Blink.ino (File > Examples 01.Basics > Blink).

If you are able to upload a sketch using Arduino IDE, the required drivers and configuration files are installed.

6. Stop applications that may be using the device

When configuring your device over serial (USB), other applications can prevent Arduino Cloud from communicating with the device.

When this happens Arduino Cloud will:

• Display the “We could not find any Arduino device” error page.
• Display a temporary notification: “Failed to open serial port. Is the device already in use?”

Try this:

• If Arduino IDE is running, make sure that the Serial Monitor is closed.
• Close any other applications you think may be using the port.
• Restart the Arduino Cloud Agent.
• Restart your computer.

If you still encounter the issue, follow the steps in Find and stop process blocking a port to identify and stop the application that’s using the port.

7. Manually partition your memory Arduino device for Arduino Cloud

The following Arduino Cloud devices have QSPI memory:

• Arduino GIGA R1 WiFi
• Arduino Opta Lite
• Arduino Opta RS485
• Arduino Opta WiFi
• Arduino Portenta H7
• Arduino Portenta H7 Lite
• Arduino Portenta H7 Lite Connected
• Arduino Portenta Machine Control

If your device has a corrupted or outdated partition scheme, you may encounter one of these issues:

• A red LED on the device is blinking.
• Arduino Cloud does not detect the device.
• A “Storage partition failed!” error is displayed when you attempt to add the device on Arduino Cloud.
• A “Storage Initialization Fail!” error is displayed when you attempt to add the device on Arduino Cloud.

You can resolve these issues by repartitioning the memory with a supported partition scheme.