Merge branch 'main' into mcmchris/portenta-h7/secure-boot-revamp

Author: mcmchris

content/_dev-test/product.md

@@ -7,7 +7,6 @@ primary_button_title: Test
 secondary_button_url: /test/
 secondary_button_title: Test
 core: ""
-certifications: []
 sku: []
 essentials_title: "test"
 ---

content/arduino-cloud/01.guides/00.overview/overview.md

@@ -76,7 +76,7 @@ Setting up a project in the Arduino Cloud is easy, and can be done through a few
 
 To use the Arduino Cloud, you will need an Arduino account, which you can register [here](https://login.arduino.cc/login).
 
-By default, you will have a **free plan**, which can be upgraded to a number of affordable plans starting at 1.99$ a month.
+By default, you will have a **free plan**, which can be upgraded to a number of affordable plans.
 
 ***Read more about [Arduino Cloud plans](https://cloud.arduino.cc/plans)***
 
@@ -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. 

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:
 - `<sketchname>.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.*** 
 
@@ -47,8 +47,10 @@ 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.
-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.
+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)
 

content/arduino-cloud/01.guides/03.esp32/esp32.md

@@ -47,8 +47,10 @@ 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.
-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.
+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)
 

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:  
 

content/arduino-cloud/01.guides/08.alexa/alexa.md

@@ -167,6 +167,6 @@ One great way of knowing if data is coming through from the Alexa app is by chec
 
 Did you know that the Arduino Cloud supports over the air uploads? When you've uploaded a sketch to your board once, it will become available for you to upload a new sketch to the board without connecting it to your computer!
 
-***Over the Air uploads require an Entry plan to the Arduino Cloud***
+***Over the Air uploads require a Arduino Cloud subscription plan***
 
 To use this feature, make sure the board has power. If your board is already connected to the Arduino Cloud, you will be able to upload to it over the air. Navigate to the Things sketch tab in the Arduino Cloud interface, and you should see it being discovered just as if it was connected via USB.

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).***
 

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.
 

content/arduino-cloud/03.cloud-interface/01.things/things.md

@@ -8,9 +8,8 @@ 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,
-- select the main device you want to associate with,
-- enter network credentials (such as Wi-Fi network/password),
+- 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,
 - 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** - 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.
@@ -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.
 

content/arduino-cloud/03.cloud-interface/02.variables/variables.md

@@ -265,8 +265,10 @@ To read the location values, we can use the following method `Location coordinat
 
 | Property  | Type    | Read value        | Set value                   |
 | --------- | ------- | ----------------- | --------------------------- |
-| Latitude  | `float` | `coordinates.lat` | This variable is ready only |
-| Longitude | `float` | `coordinates.lon` | This variable is ready only |
+| Latitude  | `float` | `coordinates.lat` | See information below |
+| Longitude | `float` | `coordinates.lon` | See information below |
+
+The value of a `CloudLocation` variable is set using a `Location` object. The coordinate values are passed as arguments to the `Location` constructor: `x = Location(latitude, longitude);`.
 
 ***The format of the `lat` and `lon` is in Decimal Degrees (DD), for example `41.40338`, `2.17403`.***