From 0e1d2ab8e6c93234e3478824d4ea03b41dbbb012 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?BenjaminDanneg=C3=A5rd?= Date: Wed, 23 Jul 2025 11:39:48 +0200 Subject: [PATCH 1/7] Updated information about network credentials --- .../arduino-cloud/01.guides/00.overview/overview.md | 4 +++- .../arduino-cloud/01.guides/02.arduino-c/arduino-c.md | 4 ++-- content/arduino-cloud/01.guides/03.esp32/esp32.md | 2 +- .../01.guides/07.node-red/nodered-intro.md | 2 +- .../arduino-cloud/02.hardware/01.devices/devices.md | 2 +- .../03.cloud-interface/00.sketches/sketches.md | 2 +- .../03.cloud-interface/01.things/things.md | 11 +++++------ .../06.features/02.cloud-scheduler/cloud-scheduler.md | 2 +- .../06.features/11.webhooks/iot-cloud-webhooks.md | 2 +- .../07.getting-started/arduino-cloud-cli.md | 2 +- .../cloud-relay-control/cloud-relay-control.md | 2 +- content/arduino-cloud/arduino-cloud/hardware/devices | 0 12 files changed, 18 insertions(+), 17 deletions(-) create mode 100644 content/arduino-cloud/arduino-cloud/hardware/devices diff --git a/content/arduino-cloud/01.guides/00.overview/overview.md b/content/arduino-cloud/01.guides/00.overview/overview.md index f15070a120..6ae570069c 100644 --- a/content/arduino-cloud/01.guides/00.overview/overview.md +++ b/content/arduino-cloud/01.guides/00.overview/overview.md @@ -92,10 +92,12 @@ The configurations varies between boards, but everything is covered in the insta ### 3. Create a Thing -After configuring a device, we can create a Thing, which is the **virtual twin** of your board. Here we configure network details, select device we want to associate and create the variables that we want to synchronize. +After configuring a device, we can create a Thing, which is the **virtual twin** of your board. Here we can select the device to associate and create the variables that we want to synchronize with. ![Things in the Arduino Cloud.](assets/thing.png) +To configure network details go to the [devices page](https://app.arduino.cc/devices), select your device and set the network credentials. + Variables we create will be used in the sketch, and will keep synchronizing as long as the board is connected to the Cloud. When working with your IoT projects, consider this the "main space" for configurations, as you can access your sketches from here as well. diff --git a/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md b/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md index ab0d5c718f..a89aa61c9f 100644 --- a/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md +++ b/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md @@ -12,7 +12,7 @@ The default option for programming your board to connect to the Arduino Cloud is Whenever you create a [Thing](/arduino-cloud/cloud-interface/things) in the Arduino Cloud, you automatically start generating a set of files that will handle the configurations, credentials & connection: - `.ino` - your main sketch file, - `thingProperties.h` - your main configuration file, -- `arduino_secrets.h` - your credentials file (for API key, Wi-Fi network etc.) +- `arduino_secrets.h` - your credentials file (for API key, Wi-Fi network etc.), if the board is using provisioning version 1.0. If the board is using version 2.0 the credentials are stored on the board. To find out more about this read [here](https://docs.arduino.cc/arduino-cloud/hardware/device-provisioning/). ***If you want to find out more about what the Arduino Cloud service can do, go to the [overview](/arduino-cloud/guides/overview) section.*** @@ -48,7 +48,7 @@ A "Thing" is a virtual twin of your hardware, and it is here that we create vari 1. First, let's attach the device we want to use, by clicking the **"Select Device"** button in the **"Associated Devices"** section to the right. 2. let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission. -3. finally, configure your network in the **Network** section. Here you will enter your Wi-Fi® credentials, and if you are using an ESP32 based board, you need to enter the secret key here. +3. finally, configure your network in the **Network** section on the device page. Here you will enter your Wi-Fi® credentials, and if you are using an ESP32 based board, you need to enter the secret key here. ![Enter network credentials.](assets/esp32-only.png) diff --git a/content/arduino-cloud/01.guides/03.esp32/esp32.md b/content/arduino-cloud/01.guides/03.esp32/esp32.md index 44a432fe9c..9fd47af10f 100644 --- a/content/arduino-cloud/01.guides/03.esp32/esp32.md +++ b/content/arduino-cloud/01.guides/03.esp32/esp32.md @@ -48,7 +48,7 @@ A "Thing" is a virtual twin of your hardware, and it is here that we create vari 1. First, let's attach the device we want to use, by clicking the **"Select Device"** button in the **"Associated Devices"** section to the right. 2. let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission. -3. finally, configure your network in the **Network** section. Here you will enter your Wi-Fi® credentials, and your **Secret Key**, obtained when configuring your device. +3. finally, configure your network in the **Network** section on the device page. Here you will enter your Wi-Fi® credentials, and your **Secret Key**, obtained when configuring your device. ![Enter network credentials.](assets/esp32-only.png) diff --git a/content/arduino-cloud/01.guides/07.node-red/nodered-intro.md b/content/arduino-cloud/01.guides/07.node-red/nodered-intro.md index f2b433be31..c5a538e21e 100644 --- a/content/arduino-cloud/01.guides/07.node-red/nodered-intro.md +++ b/content/arduino-cloud/01.guides/07.node-red/nodered-intro.md @@ -130,7 +130,7 @@ The Thing we will create for this example is quite simple. It is a sketch to rea Follow the steps below to set up the Thing: - Go to the Arduino Cloud -> Thing -> Create a Thing -- Add your Device and your Network credentials +- Add your Device and your Network credentials, which can be changed on the device page - Add an integer Variable, with the name humidity, and set permissions to Read Only - Go to the **"Sketch"** tab and replace the code with the code below: diff --git a/content/arduino-cloud/02.hardware/01.devices/devices.md b/content/arduino-cloud/02.hardware/01.devices/devices.md index 2503b7d606..e7df263186 100644 --- a/content/arduino-cloud/02.hardware/01.devices/devices.md +++ b/content/arduino-cloud/02.hardware/01.devices/devices.md @@ -46,7 +46,7 @@ Wi-Fi® devices connect to the Arduino Cloud via a local network and are suitabl Most Wi-Fi® supported Arduino boards have a crypto chip that enables secure communication. This chip is configured during setup and enables secure communication for the board without having to enter any API keys in the code. -Wi-Fi devices require you to enter valid credentials for the Wi-Fi network you attempt to connect to. This is done in the Thing configuration. +Wi-Fi devices require you to enter valid credentials for the Wi-Fi network you attempt to connect to. This is done in the Device configuration. ***Read more and see the list of all compatible Wi-Fi® boards in the [Arduino Cloud Wi-Fi documentation](/arduino-cloud/hardware/wifi).*** diff --git a/content/arduino-cloud/03.cloud-interface/00.sketches/sketches.md b/content/arduino-cloud/03.cloud-interface/00.sketches/sketches.md index fdafb2f983..8456caff4e 100644 --- a/content/arduino-cloud/03.cloud-interface/00.sketches/sketches.md +++ b/content/arduino-cloud/03.cloud-interface/00.sketches/sketches.md @@ -125,7 +125,7 @@ The file cannot be edited in the Arduino Cloud as it is in sync with the platfor ### Secret File -The "Secret" File contains your secret credentials, such as Wi-Fi® network SSID/PASS or device secret key. +The "Secret" File contains your secret credentials, such as Wi-Fi® network SSID/PASS or device secret key, if the board is using provisioning version 1.0. If the board is using version 2.0 the credentials are stored on the board. To find out more about this read [here](https://docs.arduino.cc/arduino-cloud/hardware/device-provisioning/). This file will be visible as a "Secret" tab in the Cloud Editor and is named `arduino_secrets.h`, which is not visible on the Cloud platform. diff --git a/content/arduino-cloud/03.cloud-interface/01.things/things.md b/content/arduino-cloud/03.cloud-interface/01.things/things.md index e8e9d3abb0..74cb597aad 100644 --- a/content/arduino-cloud/03.cloud-interface/01.things/things.md +++ b/content/arduino-cloud/03.cloud-interface/01.things/things.md @@ -9,8 +9,7 @@ The communication between IoT devices and the Arduino Cloud is handled through s In the Thing interface you can: - Create Cloud variables that can be synced across devices, -- select the main device you want to associate with, -- enter network credentials (such as Wi-Fi network/password), +- select the main device you want to associate with - edit & upload sketches to your board, - set webhooks that trigger whenever data changes, - edit the timezone. @@ -23,7 +22,7 @@ The Thing interface is designed for ease-of-use and only has a few sections, whi - **1. Cloud Variables** - create variables that synchronize between a device and the Arduino Cloud. - **2. Devices** - configure a device that will be associated with your Thing. -- **3. Network** - network credentials, e.g. Wi-Fi® network/password. +- **3. Network** - This section has been moved to the Device page. - **4. Setup** - the main configuration space tab. - **5. Sketch** - access the sketch associated with your Thing. - **6. Metadata** - metadata such as tags, timezone and Thing ID. @@ -68,12 +67,12 @@ The status of your device is also displayed in this section (online/offline). ## Network +***This option has been moved to the [Devices](/arduino-cloud/hardware/devices) section on the specific device page.*** + In the network section, you configure the credentials for your network, such as your Wi-Fi® network, secret key (for ESP32 boards) and other credentials e.g. LoRa®-based networks & cellular. The network details are securely stored. ![Network configuration.](assets/network-creds.png) -The credentials entered are automatically included in your sketch (see [automatic sketch generation](#automatic-sketch-generation)). - ## Sketch The sketch tab will open the Cloud Editor where you can edit, compile and upload sketches to your devices. @@ -128,7 +127,7 @@ For example: - Associating a Wi-Fi board will automatically update the connection method. - Creating a variable will add it to your `thingProperties.h` file. - Creating a variable with **read/write** permission will also add a callback function at the bottom of your sketch. This will trigger any time the value changes. -- Changing your network credentials will update the `arduino_secrets.h` file. +- Changing your network credentials will update the `arduino_secrets.h` file, if you are using provisioning version 1.0, for more information read [here](https://docs.arduino.cc/arduino-cloud/hardware/device-provisioning/). This is implemented so that the connection and synchronization between the board and Cloud is handled automatically, meaning you do not need to do any networking code when using the Arduino / C++ language. diff --git a/content/arduino-cloud/06.features/02.cloud-scheduler/cloud-scheduler.md b/content/arduino-cloud/06.features/02.cloud-scheduler/cloud-scheduler.md index 40edbca2f5..c4cd7b6b21 100644 --- a/content/arduino-cloud/06.features/02.cloud-scheduler/cloud-scheduler.md +++ b/content/arduino-cloud/06.features/02.cloud-scheduler/cloud-scheduler.md @@ -186,7 +186,7 @@ In order for our job to go off at the right time, we need to set the **time zone ### Network Credentials -To connect your device to the Arduino Cloud, you need to enter your network credentials in the "network" section. +To connect your device to the Arduino Cloud, you need to enter your network credentials in the "network" section on the device page. ***Note that this only applies to Wi-Fi enabled boards.*** diff --git a/content/arduino-cloud/06.features/11.webhooks/iot-cloud-webhooks.md b/content/arduino-cloud/06.features/11.webhooks/iot-cloud-webhooks.md index cdcd677cca..6ac45a6907 100644 --- a/content/arduino-cloud/06.features/11.webhooks/iot-cloud-webhooks.md +++ b/content/arduino-cloud/06.features/11.webhooks/iot-cloud-webhooks.md @@ -75,7 +75,7 @@ Linking a webhook to a Thing is a quite simple process, follow the steps below t ![Create Variable](./assets/webhooks-01.png) -**4.** Add your **Device**, and configure your **Network** from the right side menu. +**4.** Add your **Device**, and configure your **Network**. **5.** In the same menu to the right, click "**Configure**" under the "**Data Forwarding (Webhook)**" menu. diff --git a/content/arduino-cloud/08.arduino-cloud-cli/07.getting-started/arduino-cloud-cli.md b/content/arduino-cloud/08.arduino-cloud-cli/07.getting-started/arduino-cloud-cli.md index ac74bcbcdd..306918c9f6 100644 --- a/content/arduino-cloud/08.arduino-cloud-cli/07.getting-started/arduino-cloud-cli.md +++ b/content/arduino-cloud/08.arduino-cloud-cli/07.getting-started/arduino-cloud-cli.md @@ -211,7 +211,7 @@ arduino-cloud-cli device delete-tags --id --keys , - `arduino-cloud-cli things` -**Things** in the Arduino Cloud is the virtual twin of your hardware device. In a Thing, you create variables, attach device and add network credentials. +**Things** in the Arduino Cloud is the virtual twin of your hardware device. In a Thing, you create variables and attach a device. With `arduino-cloud-cli` you can: diff --git a/content/arduino-cloud/11.application-notes/cloud-relay-control/cloud-relay-control.md b/content/arduino-cloud/11.application-notes/cloud-relay-control/cloud-relay-control.md index 9765c6d0dd..90f268485d 100644 --- a/content/arduino-cloud/11.application-notes/cloud-relay-control/cloud-relay-control.md +++ b/content/arduino-cloud/11.application-notes/cloud-relay-control/cloud-relay-control.md @@ -52,7 +52,7 @@ To configure a device, navigate to the [app.arduino.cc/devices](https://app.ardu 1. Create a new Thing, by clicking on the **"Create Thing"** button. 2. Click on the **"Select Device"** in the **"Associated Devices"** section of your Thing. Your previously configured device will appear from the list. -3. In the network section, enter your network credentials. +3. If you want to change the network credentials go to the [device page](https://app.arduino.cc/devices). ***Learn more about Things in the [Things documentation](/arduino-cloud/cloud-interface/things).*** diff --git a/content/arduino-cloud/arduino-cloud/hardware/devices b/content/arduino-cloud/arduino-cloud/hardware/devices new file mode 100644 index 0000000000..e69de29bb2 From aaeac5b696b11bc09aea088aea06890622c23624 Mon Sep 17 00:00:00 2001 From: BenjaminDannegard Date: Thu, 24 Jul 2025 13:48:31 +0200 Subject: [PATCH 2/7] Update content/arduino-cloud/03.cloud-interface/01.things/things.md Co-authored-by: Gaia Castronovo <53472903+g-castronovo@users.noreply.github.com> --- content/arduino-cloud/03.cloud-interface/01.things/things.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/arduino-cloud/03.cloud-interface/01.things/things.md b/content/arduino-cloud/03.cloud-interface/01.things/things.md index 74cb597aad..8523565374 100644 --- a/content/arduino-cloud/03.cloud-interface/01.things/things.md +++ b/content/arduino-cloud/03.cloud-interface/01.things/things.md @@ -8,7 +8,7 @@ author: Karl Söderby The communication between IoT devices and the Arduino Cloud is handled through something called **Things**. Things are a virtual twin of your hardware/setup, where you perform a lot of the configurations for your projects. In the Thing interface you can: -- Create Cloud variables that can be synced across devices, +- create Cloud variables that can be synced across devices, - select the main device you want to associate with - edit & upload sketches to your board, - set webhooks that trigger whenever data changes, From 59f2e9a367eb02afa3c29b5183772ba8fb938730 Mon Sep 17 00:00:00 2001 From: BenjaminDannegard Date: Thu, 24 Jul 2025 13:48:55 +0200 Subject: [PATCH 3/7] Update content/arduino-cloud/03.cloud-interface/01.things/things.md Co-authored-by: Gaia Castronovo <53472903+g-castronovo@users.noreply.github.com> --- content/arduino-cloud/03.cloud-interface/01.things/things.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/arduino-cloud/03.cloud-interface/01.things/things.md b/content/arduino-cloud/03.cloud-interface/01.things/things.md index 8523565374..b6cef41acf 100644 --- a/content/arduino-cloud/03.cloud-interface/01.things/things.md +++ b/content/arduino-cloud/03.cloud-interface/01.things/things.md @@ -22,7 +22,7 @@ The Thing interface is designed for ease-of-use and only has a few sections, whi - **1. Cloud Variables** - create variables that synchronize between a device and the Arduino Cloud. - **2. Devices** - configure a device that will be associated with your Thing. -- **3. Network** - This section has been moved to the Device page. +- **3. Network** - to add your Wi-Fi® network/password go to Device page. - **4. Setup** - the main configuration space tab. - **5. Sketch** - access the sketch associated with your Thing. - **6. Metadata** - metadata such as tags, timezone and Thing ID. From 1e63f85d826b1114dbd57dfc0e9142f0d3c1fa6f Mon Sep 17 00:00:00 2001 From: BenjaminDannegard Date: Thu, 24 Jul 2025 13:49:12 +0200 Subject: [PATCH 4/7] Update content/arduino-cloud/01.guides/03.esp32/esp32.md Co-authored-by: Gaia Castronovo <53472903+g-castronovo@users.noreply.github.com> --- content/arduino-cloud/01.guides/03.esp32/esp32.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/arduino-cloud/01.guides/03.esp32/esp32.md b/content/arduino-cloud/01.guides/03.esp32/esp32.md index 9fd47af10f..e5f3cafd6e 100644 --- a/content/arduino-cloud/01.guides/03.esp32/esp32.md +++ b/content/arduino-cloud/01.guides/03.esp32/esp32.md @@ -47,7 +47,8 @@ Next, navigate to the **Things** tab. Here you will see a list of your Things, a A "Thing" is a virtual twin of your hardware, and it is here that we create variables that we want to synchronize between the Cloud and board. Any changes we make here will be reflected in an [automatically generated sketch](/arduino-cloud/cloud-interface/sketches#iot-sketches). 1. First, let's attach the device we want to use, by clicking the **"Select Device"** button in the **"Associated Devices"** section to the right. -2. let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission. +2. Let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission. + 3. finally, configure your network in the **Network** section on the device page. Here you will enter your Wi-Fi® credentials, and your **Secret Key**, obtained when configuring your device. ![Enter network credentials.](assets/esp32-only.png) From 1c1fc8ecc7770bb313dfed28670911b6d2e58f83 Mon Sep 17 00:00:00 2001 From: BenjaminDannegard Date: Thu, 24 Jul 2025 13:49:25 +0200 Subject: [PATCH 5/7] Update content/arduino-cloud/01.guides/03.esp32/esp32.md Co-authored-by: Gaia Castronovo <53472903+g-castronovo@users.noreply.github.com> --- content/arduino-cloud/01.guides/03.esp32/esp32.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/arduino-cloud/01.guides/03.esp32/esp32.md b/content/arduino-cloud/01.guides/03.esp32/esp32.md index e5f3cafd6e..8f03d13a36 100644 --- a/content/arduino-cloud/01.guides/03.esp32/esp32.md +++ b/content/arduino-cloud/01.guides/03.esp32/esp32.md @@ -49,7 +49,8 @@ A "Thing" is a virtual twin of your hardware, and it is here that we create vari 1. First, let's attach the device we want to use, by clicking the **"Select Device"** button in the **"Associated Devices"** section to the right. 2. Let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission. -3. finally, configure your network in the **Network** section on the device page. Here you will enter your Wi-Fi® credentials, and your **Secret Key**, obtained when configuring your device. +3. Finally, configure your network in the **Network** section on the device page. Here you will enter your Wi-Fi® credentials, and your **Secret Key**, obtained when configuring your device. + ![Enter network credentials.](assets/esp32-only.png) From fcd56462ed3114fb7956ec7dfd9d823c53665099 Mon Sep 17 00:00:00 2001 From: BenjaminDannegard Date: Thu, 24 Jul 2025 13:49:33 +0200 Subject: [PATCH 6/7] Update content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md Co-authored-by: Gaia Castronovo <53472903+g-castronovo@users.noreply.github.com> --- content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md b/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md index a89aa61c9f..f1225b6545 100644 --- a/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md +++ b/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md @@ -47,7 +47,8 @@ Next, navigate to the **Things** tab. Here you will see a list of your Things, a A "Thing" is a virtual twin of your hardware, and it is here that we create variables that we want to synchronize between the Cloud and board. Any changes we make here will be reflected in an [automatically generated sketch](/arduino-cloud/cloud-interface/sketches#iot-sketches). 1. First, let's attach the device we want to use, by clicking the **"Select Device"** button in the **"Associated Devices"** section to the right. -2. let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission. +2. Let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission. + 3. finally, configure your network in the **Network** section on the device page. Here you will enter your Wi-Fi® credentials, and if you are using an ESP32 based board, you need to enter the secret key here. ![Enter network credentials.](assets/esp32-only.png) From 632a0f6d904926601dbdb276c8e3cec7398a74d8 Mon Sep 17 00:00:00 2001 From: BenjaminDannegard Date: Thu, 24 Jul 2025 13:49:44 +0200 Subject: [PATCH 7/7] Update content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md Co-authored-by: Gaia Castronovo <53472903+g-castronovo@users.noreply.github.com> --- content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md b/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md index f1225b6545..03bb6f70d2 100644 --- a/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md +++ b/content/arduino-cloud/01.guides/02.arduino-c/arduino-c.md @@ -49,7 +49,8 @@ A "Thing" is a virtual twin of your hardware, and it is here that we create vari 1. First, let's attach the device we want to use, by clicking the **"Select Device"** button in the **"Associated Devices"** section to the right. 2. Let's create a new variable, call it `test`, and select it to be a `boolean` type and with a **read/write** permission. -3. finally, configure your network in the **Network** section on the device page. Here you will enter your Wi-Fi® credentials, and if you are using an ESP32 based board, you need to enter the secret key here. +3. Finally, configure your network in the **Network** section on the device page. Here you will enter your Wi-Fi® credentials, and if you are using an ESP32 based board, you need to enter the secret key here. + ![Enter network credentials.](assets/esp32-only.png)