You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/arduino-cloud/02.hardware/06.device-provisioning/content.md
+88-5Lines changed: 88 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -65,6 +65,8 @@ Here are the boards that are compatible with Bluetooth provisioning via a Blueto
65
65
66
66
-[Arduino UNO R4 WiFi](https://docs.arduino.cc/hardware/uno-r4-wifi/) (Wi-Fi firmware version 0.6.0 or later required)
67
67
68
+
A board that is ready for Bluetooth provisioning has a specific provisioning sketch installed and displays a pulsing LED or a Bluetooth icon on the LED matrix. Newer boards are shipped boards are delivered with this specific sketch already installed. If the pulsing LED is not visible, please use the USB provisioning method.
69
+
68
70
### Setting up Your Device With Bluetooth
69
71
70
72
After selecting the Bluetooth option you will see a page telling you how to connect your board. Follow the steps to connect your board via Bluetooth.
@@ -79,6 +81,8 @@ After completing these steps your device will connect to your Wi-Fi and you will
79
81
80
82

81
83
84
+
The BLE interface is automatically turned off at the end of the procedure, and it remains off until board reset (see dedicated document section)
85
+
82
86
Now you are ready to start using your board with the Arduino Cloud!
83
87
84
88
## USB Provisioning
@@ -125,11 +129,92 @@ Now your board will be updated to version 2.0, wait for the process to finish.
125
129
126
130
When this is done you can continue setting up the network connection for your board and it will now be using the latest provisioning method with the Arduino Cloud!
127
131
128
-
### Removing Saved Network Configuration
132
+
## How to update the Stored Network Configuration
133
+
134
+
To proceed with the next steps, the cloud-generated sketch must be uploaded to the board. If you want to update the stored network configuration, there are two ways:
135
+
136
+
### Update Using the BLE Interface
137
+
138
+
Ensure that the cloud sketch has enabled the "BLEAgent" in the cloud sketch, via "thingProperties.h". Check [this document](https://docs.arduino.cc/arduino-cloud/cloud-interface/sketches) for enabling it.
139
+
140
+
You can update the Network settings from the detail page of the device in the Arduino Cloud Web UI or the mobile app.
141
+
142
+
During this process you will be asked to wipe out the current network configuration to restart the board's BLE interface.
143
+
144
+
- Turn on the board.
145
+
146
+
- Open the devices page of the Mobile App or the Arduino Cloud Web UI.
147
+
148
+
- Click on the device you want to update the network settings for.
149
+
150
+
- Click on the "change" button by the network section.
151
+
152
+
- If you are using the Arduino Cloud Web UI, select the BLE method.
153
+
154
+
- Reset the board using the procedure of your board. In this article, the default reset pin is used. If you have chosen a different pin, please use that. Review the section of the document about the default board reset pin [here](#How to set up the Reconfiguration Procedure).
155
+
156
+
- The board will reboot, and you will see the LED pulsing.
157
+
158
+
- Connect to the board.
159
+
160
+
- Input the new network configuration.
161
+
162
+
- The board will validate it, and if correct, it will close the connection.
163
+
164
+
### Update Using the Serial Interface
165
+
166
+
Ensure that the "SerialAgent" is enabled in the cloud sketch, via "thingProperties.h".
167
+
168
+
Check [this document](https://docs.arduino.cc/arduino-cloud/cloud-interface/sketches) for enabling it.
169
+
170
+
You can run this procedure only with the Arduino Cloud Web UI
171
+
172
+
- You can update the network settings from the detail page of the board of the Web UI.
129
173
130
-
This section will explain how to remove the stored network credentials and force the restart of the BLE interface of a board that has been provisioned with version 2.0. This can be useful to either reset the board or to update the network credentials via BLE.
174
+
- The Serial interface, if enabled, is always ready to receive a new configuration.
131
175
132
-
If you want to remove the stored network credentials and force the restart of the BLE interface, so that the network credentials can be updated via BLE. Please follow these instructions depending on your board:
176
+
- Turn on the board and connect to your PC using the USB cable.
177
+
178
+
- Open the devices page on the Arduino Cloud Web UI.
179
+
180
+
- Click on the board you want to update the network settings for.
181
+
182
+
- Click on the "change" button by the network section.
183
+
184
+
- Connect to the board.
185
+
186
+
- Inputs the new configuration.
187
+
188
+
- The board will validate it, and if correct, it will close the connection.
189
+
190
+
191
+
## How to delete a stored network configuration
192
+
193
+
If you want to delete the stored network configuration without updating it, there are two possible methods to do so.
194
+
195
+
### Board Reset procedure
196
+
197
+
To proceed with the next steps, the cloud-generated sketch must be uploaded to the board.
198
+
199
+
Reset the board using the procedure of your board.
200
+
201
+
In this article, the default reset pin is used. If you had chosen a different pin, please use yours.
202
+
203
+
Review the section of the document about the default board reset pin here.
204
+
205
+
### Using the DeleteConfiguration sketch
206
+
207
+
Upload this sketch to delete your configuration.
208
+
209
+
Please confirm the choice for starting the procedure
210
+
211
+
### How to set up the Reconfiguration Procedure
212
+
213
+
As the Provisioning 2.0 ends, the BLE interface is turned off.
214
+
215
+
To restart the BLE interface to update the network settings, the [**Arduino_NetworkConfigurator**](https://github.com/arduino-libraries/Arduino_NetworkConfigurator?tab=readme-ov-file) library provides a procedure called "Reconfiguration Procedure". This procedure is based on the shorting of two pins of the board.
216
+
217
+
The library provides a default implementation according to the board type. (The user can change the default pin, checking the following document section)
133
218
134
219
-`Arduino Opta`: Press and hold the user button (BTN_USER) until the led (LED_USER) turns off
135
220
-`Arduino MKR WiFi 1010`: Short pin 7 to GND until the led turns off
@@ -140,6 +225,4 @@ If you want to remove the stored network credentials and force the restart of th
140
225
-`Other boards`: Short pin 2 to GND until the led turns off
141
226
-`Portenta Machine Control`: Currently the reset procedure is not available
142
227
143
-
If you would like to remove the network credentials from the board, you can use the [**Arduino_NetworkConfigurator**](https://github.com/arduino-libraries/Arduino_NetworkConfigurator?tab=readme-ov-file) library.
144
-
145
228
Open Arduino IDE and on the left side open the **library manager**. Search for **Arduino_NetworkConfigurator** and download it. Once it is downloaded go to **File > Examples > Arduino_NetworkConfigurator > Utility > DeleteConfiguration**, this will open a new example sketch. Select your board and port then upload this example sketch to your board. When the sketch has been uploaded you can look at the serial monitor to monitor the progress and troubleshoot if needed.
0 commit comments