Skip to content

Commit fe5eea7

Browse files
authored
Trobleshooting guide for provisioning 2.0 [HC-1651] (#516)
* Updated and improved for Provisioning 2.0 * Update content/Arduino Cloud/Arduino IoT Cloud/If-your-device-cant-be-added-to-Arduino-Cloud.md * lint fixes
1 parent 2651675 commit fe5eea7

File tree

1 file changed

+63
-43
lines changed

1 file changed

+63
-43
lines changed

content/Arduino Cloud/Arduino IoT Cloud/If-your-device-cant-be-added-to-Arduino-Cloud.md

Lines changed: 63 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -3,82 +3,102 @@ title: "If your device can't be added to Arduino Cloud"
33
id: 360019355679
44
---
55

6-
Learn how to resolve problems [adding and connecting devices to Arduino Cloud](https://support.arduino.cc/hc/en-us/articles/360016495559).
6+
Learn what to do if there's a problem adding your device to Arduino Cloud.
77

88
---
99

10-
## If you don't know the DevEUI for your Arduino board
10+
## Try these steps in order
1111

12-
Make sure to set up your Arduino board as an Arduino device.
13-
14-
![Setup prompt, "Set up an Arduino device" is highlighted](img/setup-device-menu-highlighted.png)
15-
16-
The DevEUI will be automatically added to the device.
12+
1. [Quick checks](#1-quick-checks)
13+
1. [Check your USB cable and peripherals](#2-check-your-usb-cable-and-peripherals)
14+
1. [Rule out hardware issues](#3-rule-out-hardware-issues)
15+
1. [Reset the sketch](#4-reset-the-sketch)
16+
1. [Stop applications that may be using the device](#5-stop-applications-that-may-be-using-the-device)
17+
1. [Manually partition your memory Arduino device for Arduino Cloud](#6-manually-partition-your-memory-arduino-device-for-arduino-cloud)
1718

1819
---
1920

20-
## If you don't know the secret key for your device
21+
## 1. Quick checks
2122

22-
Secret keys cannot be recovered if lost. Make sure to save any Device ID and Secret key that's provided when adding an Arduino UNO R4 WiFi, Arduino Nano ESP32, or a 3rd party device (ESP32 and ESP8266). If you've lost your secret key, you can generate a new key by [deleting the device](https://support.arduino.cc/hc/en-us/articles/360018324700-How-to-delete-a-device-from-Arduino-IoT-cloud), then adding it again.
23+
* Try disconnecting and reconnecting your device from your computer or power source.
24+
* Confirm that the device is powered by checking that the power LED is lit.
25+
* _Exception:_ The Arduino Opta does not have a power LED. The device can be powered even if no LEDs are lit.
26+
* If prompted, allow the device to connect to your computer.
27+
* If Arduino IDE is running, ensure that the serial monitor is closed, or simply close Arduino IDE.
2328

24-
---
29+
## 2. Check your USB cable and peripherals
2530

26-
## If you get an error when adding the device
31+
* Ensure you're using a working USB cable that supports data transfer. If possible, try using a different cable.
32+
* Ensure that any USB hubs or docks are powered and working. If possible, try connecting the device directly to your computer.
2733

28-
### "We could not find any Arduino device"
34+
## 3. Rule out hardware issues
2935

30-
1. Make sure you're using a [compatible device](https://support.arduino.cc/hc/en-us/articles/360016077320-What-devices-can-be-used-with-Arduino-IoT-Cloud-).
36+
* Detach the device from any shield/carrier or external circuitry.
3137

32-
2. [Check if the Arduino Cloud Agent is installed and running](https://support.arduino.cc/hc/en-us/articles/4980687506844), then click **Try again**.
38+
## 4. Reset the sketch
3339

34-
> [!NOTE]
35-
> If you're using a **Chromebook** and [Arduino Cloud for Chromebook](https://support.arduino.cc/hc/en-us/articles/360016495639-Use-Arduino-with-Chromebook), there's no need to install the Arduino Cloud Agent.
40+
A bad sketch or a non-working Cloud configuration can prevent your computer from programming the board.
3641

37-
3. Double-press the reset button on the board to put the board in [bootloader mode](https://support.arduino.cc/hc/en-us/articles/5779192727068-Reset-your-board#bootloader-mode), then click **Try Again**.
42+
### If you're configuring the device over serial (USB)
3843

39-
4. Try uploading an Example sketch (such as _Examples > Built in > 01.Basics > Blink_) in the [Cloud Editor](https://support.arduino.cc/hc/en-us/articles/13809101080732-Open-the-Cloud-Editor).
44+
Try a **double-press** reset:
4045

41-
* If your board isn't detected by the Cloud Editor, see [If your board does not appear in the port menu](https://support.arduino.cc/hc/en-us/articles/4412955149586-If-your-board-does-not-appear-in-the-port-menu).
46+
1. Find the reset button on the device (typically labeled **RESET** or **RST**).
47+
2. Press the reset button twice and confirm that the on-board LED pulses. Adjust the timing if needed.
48+
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.
4249

43-
* If you get an error message when uploading, see [If your sketch doesn't upload](https://support.arduino.cc/hc/en-us/articles/4403365313810-If-your-sketch-doesn-t-upload).
50+
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](https://app.oniudra.cc/sketches/examples?nav=Examples&eid=01.Basics%2FBareMinimum) or [Blink](https://app.oniudra.cc/sketches/examples?nav=Examples&eid=01.Basics%2FBlink) example), then try adding the device to Arduino Cloud again.
4451

45-
### "We were not able to configure your device<br>Something went wrong!"
52+
### If you're configuring the device over Bluetooth
4653

47-
1. Close any instances of Arduino IDE and other applications that may be using the port.
54+
* 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).
55+
* If your board is running the provisioning sketch but still isn't detected, try resetting the Cloud configuration:
4856

49-
2. [Check if the Arduino Cloud Agent is installed and running](https://support.arduino.cc/hc/en-us/articles/4980687506844). If you're using [Arduino Cloud for Chromebook](https://support.arduino.cc/hc/en-us/articles/360016495639-Use-Arduino-with-Chromebook), you can skip this step.
57+
* **Arduino Opta:** Press and hold the user button (BTN_USER) until the LED (LED_USER) turns off.
58+
* **UNO R4 WiFi:** Connect Pin 2 to GND until the LED turns off.
5059

51-
3. Reconnect the device to the computer and make sure the power LED lights up.
60+
## 5. Stop applications that may be using the device
5261

53-
### "We were not able to configure..." during device set-up
62+
When configuring your device over serial (USB), other applications can prevent Arduino Cloud from communicating with the device.
5463

55-
When adding your device, you may see one of these messages:
64+
When this happens Arduino Cloud will:
5665

57-
* `Couldn't get the firmware info: Start command: exec: "{runtime.tools.fwupdater.path}/FirmwareUploader": file does not exist`
58-
* `Reset before upload: 1200bps Touch: Open port COMB: Serial port not found`
59-
* `Can't update firmware: Executing command: exit status 1`
66+
* Display the **"We could not find any Arduino device"** error page.
67+
* Display a temporary notification: _"Failed to open serial port. Is the device already in use?"_
6068

61-
These errors can occur if the wireless connectivity module on your board is using an old version[^nina] of the WiFiNINA firmware, that cannot be automatically updated by Arduino Cloud.
69+
Try this:
6270

63-
[^nina]: 1.4.1 or earlier. To find out which version is on your board, see [Check the WiFiNINA firmware version](https://support.arduino.cc/hc/en-us/articles/9398559561244-Check-the-WiFiNINA-firmware-version).
71+
* If Arduino IDE is running, make sure that the Serial Monitor is closed.
72+
* Close any other applications you think may be using the port.
73+
* Restart the Arduino Cloud Agent.
74+
* Restart your computer.
6475

65-
Solve the issue by updating to the latest firmware version using the **Firmware Updater** in Arduino IDE:
76+
If you still encounter the issue, follow the steps in [Find and stop process blocking a port](https://support.arduino.cc/hc/en-us/articles/4407830972050-Find-and-stop-process-blocking-a-port) to identify and stop the application that's using the port.
6677

67-
<a class="link-chevron-right" href="https://support.arduino.cc/hc/en-us/articles/360013896579-Use-the-Firmware-Updater-in-Arduino-IDE">Update the firmware in Arduino IDE</a>
78+
<!-- The Serial Monitor in the Cloud Editor will automatically be closed -->
6879

69-
### "Arduino Cloud Agent not found"
80+
---
7081

71-
> [!NOTE]
72-
> If you're using a **Chromebook** and [Arduino Cloud for Chromebook](https://support.arduino.cc/hc/en-us/articles/360016495639-Use-Arduino-with-Chromebook), you can skip this step.
82+
## 6. Manually partition your memory Arduino device for Arduino Cloud
7383

74-
1. If you haven't done so already, [install the agent](https://create.arduino.cc/getting-started/plugin/welcome).
75-
2. If you have installed the agent but still encounter this warning, see [If Arduino Cloud Agent isn't detected](https://support.arduino.cc/hc/en-us/articles/360016466600-Warning-To-upload-a-sketch-via-USB-port-make-sure-the-Agent-is-installed-and-running-on-this-computer).
84+
The following Arduino Cloud devices have QSPI memory:
7685

77-
---
86+
* Arduino GIGA R1 WiFi
87+
* Arduino Opta Lite
88+
* Arduino Opta RS485
89+
* Arduino Opta WiFi
90+
* Arduino Portenta H7
91+
* Arduino Portenta H7 Lite
92+
* Arduino Portenta H7 Lite Connected
93+
* Arduino Portenta Machine Control
94+
95+
If your device has a corrupted or outdated partition scheme, you may encounter one of these issues:
7896

79-
## Still need help?
97+
* A red LED on the device is blinking.
98+
* Arduino Cloud does not detect the device.
99+
* A “Storage partition failed!” error is displayed when you attempt to add the device on Arduino Cloud.
100+
* A “Storage Initialization Fail!” error is displayed when you attempt to add the device on Arduino Cloud.
80101

81-
Please [contact us](https://www.arduino.cc/en/contact-us/).
102+
You can resolve these issues by [repartitioning the memory with a supported partition scheme](https://support.arduino.cc/hc/en-us/articles/16206977438748-Reset-the-flash-memory-on-STM32H747-based-devices).
82103

83-
<!-- markdownlint-disable-file HC001 -->
84-
<!-- markdownlint-disable-file MD026 -->
104+
<!-- markdownlint-disable-file HC001 -->

0 commit comments

Comments
 (0)