[PXCT-1060] Added device provisioning documentation #2556

BenjaminDannegard · 2025-06-27T08:08:04Z

What This PR Changes

Added new device provisioning documentation

Contribution Guidelines

I confirm that I have read the contribution guidelines and comply with them.

jhansson-ard

Some updates on sentences and formatting 🙏🏼

content/arduino-cloud/02.hardware/06.device-provisioning/content.md

github-actions · 2025-06-27T08:36:24Z

Preview Deployment

🚀 Preview this PR: https://68c29c4df203cd14611f11cd--docs-content.netlify.app
📍 Commit SHA: 487f8d4

content/arduino-cloud/02.hardware/06.device-provisioning/assets/creating-new-device.png

…nt.md Co-authored-by: Josefine Herlin <[email protected]>

jhansson-ard

Added some comments @BenjaminDannegard 🙏🏼

content/arduino-cloud/02.hardware/06.device-provisioning/content.md

fabik111 · 2025-09-08T14:09:30Z

content/arduino-cloud/02.hardware/06.device-provisioning/content.md

+
+Now you have to decide how you want to set up your board with the Cloud, either via Bluetooth® or USB cable (you can check if your board is compatible with the Bluetooth method below). These two options have different processes, pick the method that suits your needs best and follow the section for your chosen method.
+
+***NOTE: If you want to use the Bluetooth method and you have an older board you need to first connect the board to the Cloud in order to update it to the newer provisioning version. Please follow the instructions [here]((#migrating-from-version-10-to-20)) first.***


This sentence is misleading compared to what actually happens. Written this way, it seems like it's possible to update the board via FE and then complete the provisioning via BLE. Actually when the user connects with the cable the board to the Web UI, the board, compatible with the Prov 2.0, is not only updated, but the migration flow completes the provisioning, so at the end it's not needed the provisioning via BLE.

The only way that the user has for seeing if the board is enabled and ready for the provisioning via BLE is checking if the led is pulsing as written in the info box of the screenshot assets/connect-with-bluetooth.png.

Being a BLE method compatible board it's not a sufficient condition to the user for having the provisioning 2.0 via BLE because the board may not execute the sketch that enables and handles it, even if the board is new and comes directly from our warehouse.

Removed the confusing sentance, let me know if it is easier to understand now

fabik111 · 2025-09-08T14:22:05Z

content/arduino-cloud/02.hardware/06.device-provisioning/content.md

+## Migrating from version 1.0 to 2.0
+
+If you have a board that is compatible with version 2.0 but have provisioned it previously with version 1.0 you will need to follow these steps to upgrade it.
+


If the user has a board that wants to migrate that he had provisioned previously, he must delete the old the one from the Devices page before starting the procedure.

Tips: the user reading this guide might wonder why he should do the migration. Maybe you can recall the user that with the Provisioning 2.0 the network credentials are moved to the board storage and that the user can update it via BLE.

Added this information

ok this LGTM

fabik111

Throughout the document we always talk about wifi credentials, but with provisioning 2.0 all network types are supported if the board compatible with provisioning 2.0 supports them.

For example with the Portenta H7 are supported also the Ethernet, CAT-M1 and Cellular connectivities. Opta supports both WiFi and Ethernet.
So, via BLE is possible to configure all these connectivity types

fabik111 · 2025-09-11T13:52:36Z

content/arduino-cloud/02.hardware/06.device-provisioning/content.md

+
+Here are the boards that are compatible with Bluetooth provisioning via a Bluetooth connection:
+
+- [Arduino UNO R4 WiFi](https://docs.arduino.cc/hardware/uno-r4-wifi/) (Wi-Fi firmware version 0.6.0 or later required)


Is the Arduino Uno R4 the only listed because it's the only currently produced from factory with the new Provisioning sketch 2.0 installed?

Keep in mind that in the future also the other boards (Opta, Portenta H7, Giga, Nicla Vision....) will be produced in this way.

At that point what will differentiate a board that can be provisioned via BLE or not is whether there is a pulsating LED after the boot.
So the user can easily recognize if he can (or not) have the provisioning via BLE by the pulsing LED.
The pulsing LED can be

blue led if the board has an RGB led

the LED_BUILTIN in case the board doesn't have an RGB led

fabik111 · 2025-09-11T13:58:00Z

content/arduino-cloud/02.hardware/06.device-provisioning/content.md

+
+![Board connected to the cloud](assets/succesfull-connection-with-usb.png)
+
+You will now be taken to the device page. Here you can see the details of the board, change the name, attach it to a thing and change the network configuration.


No! After the click on "continue" the user will be asked to insert the network credentials as using BLE. It's the same flow as via BLE.

Added device provisioning documentation

88cd7a4

BenjaminDannegard added the preview label Jun 27, 2025

Small spelling fixes

a06ef02

jhansson-ard requested changes Jun 27, 2025

View reviewed changes

jhansson-ard reviewed Jun 27, 2025

View reviewed changes

content/arduino-cloud/02.hardware/06.device-provisioning/assets/creating-new-device.png Outdated Show resolved Hide resolved

BenjaminDannegard and others added 14 commits June 27, 2025 11:23

Update content/arduino-cloud/02.hardware/06.device-provisioning/conte…

5de0df7

…nt.md Co-authored-by: Josefine Herlin <[email protected]>

Update content/arduino-cloud/02.hardware/06.device-provisioning/conte…

b54a65e

…nt.md Co-authored-by: Josefine Herlin <[email protected]>

Update content/arduino-cloud/02.hardware/06.device-provisioning/conte…

6d979cd

…nt.md Co-authored-by: Josefine Herlin <[email protected]>

Update content/arduino-cloud/02.hardware/06.device-provisioning/conte…

c152005

…nt.md Co-authored-by: Josefine Herlin <[email protected]>

Update content/arduino-cloud/02.hardware/06.device-provisioning/conte…

75ac8e8

…nt.md Co-authored-by: Josefine Herlin <[email protected]>

Update content/arduino-cloud/02.hardware/06.device-provisioning/conte…

e49bf51

…nt.md Co-authored-by: Josefine Herlin <[email protected]>

Added note about provis update

11478b5

updated images

4992faf

Small fix

916976a

Fixed the note

5f9c8f7

Added compatible boards list

1071520

Fixed table

d7110f4

Updated list and added section

c8e360d

Added migration documentation

0b4ee41

jhansson-ard reviewed Jul 28, 2025

View reviewed changes

jhansson-ard and others added 2 commits July 28, 2025 16:55

Apply suggestions from code review

88c5f8c

Updated compatible devices

f70f34c

fabik111 suggested changes Sep 8, 2025

View reviewed changes

BenjaminDannegard added 2 commits September 11, 2025 11:34

Added new section and missing image

37c9551

spelling fix

9b8b732

fabik111 suggested changes Sep 11, 2025

View reviewed changes


		Now you have to decide how you want to set up your board with the Cloud, either via Bluetooth® or USB cable (you can check if your board is compatible with the Bluetooth method below). These two options have different processes, pick the method that suits your needs best and follow the section for your chosen method.

		*NOTE: If you want to use the Bluetooth method and you have an older board you need to first connect the board to the Cloud in order to update it to the newer provisioning version. Please follow the instructions [here]((#migrating-from-version-10-to-20)) first.*

		## Migrating from version 1.0 to 2.0

		If you have a board that is compatible with version 2.0 but have provisioned it previously with version 1.0 you will need to follow these steps to upgrade it.


		Here are the boards that are compatible with Bluetooth provisioning via a Bluetooth connection:

		- [Arduino UNO R4 WiFi](https://docs.arduino.cc/hardware/uno-r4-wifi/) (Wi-Fi firmware version 0.6.0 or later required)


		![Board connected to the cloud](assets/succesfull-connection-with-usb.png)

		You will now be taken to the device page. Here you can see the details of the board, change the name, attach it to a thing and change the network configuration.

Uh oh!

[PXCT-1060] Added device provisioning documentation #2556

Are you sure you want to change the base?

[PXCT-1060] Added device provisioning documentation #2556

Uh oh!

Conversation

BenjaminDannegard commented Jun 27, 2025

What This PR Changes

Contribution Guidelines

Uh oh!

jhansson-ard left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Jun 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Preview Deployment

Uh oh!

Uh oh!

jhansson-ard left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fabik111 Sep 8, 2025

Choose a reason for hiding this comment

Uh oh!

BenjaminDannegard Sep 11, 2025

Choose a reason for hiding this comment

Uh oh!

fabik111 Sep 11, 2025

Choose a reason for hiding this comment

Uh oh!

fabik111 Sep 8, 2025

Choose a reason for hiding this comment

Uh oh!

BenjaminDannegard Sep 11, 2025

Choose a reason for hiding this comment

Uh oh!

fabik111 Sep 11, 2025

Choose a reason for hiding this comment

Uh oh!

fabik111 left a comment

Choose a reason for hiding this comment

Uh oh!

fabik111 Sep 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fabik111 Sep 11, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions bot commented Jun 27, 2025 •

edited

Loading

fabik111 Sep 11, 2025 •

edited

Loading