Last additions to content

Author: BenjaminDannegard

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

@@ -142,23 +142,14 @@ You can update the network settings from the detail page of the device on the Ar
 During this process you will be asked to wipe out the current network configuration to restart the board's BLE interface. 
 
 - Power on the board.
-
 - Reset the board using the method of your board. Have a look at the [How to set up the Reconfiguration Procedure](#How-to-set-up-the Reconfiguration-Procedure) section of this article to find the default board reset pin. If you have changed the reset pin from the default one, please use that.
-
 - Open the devices page of the Mobile App or the Arduino Cloud webpage.
-
 - Click on the device you want to update the network settings for.
-
 - Click on the "change" button by the network section.
-
 - If you are using the Arduino Cloud webpage, select the BLE method.
-
 - The board will reboot, and you will see the LED pulsing.
-
 - Connect to the board.
-
 - Input the new network configuration.
-
 - The board will validate it, and if correct, it will close the connection.
 
 ### Update Using the Serial Interface
@@ -168,28 +159,23 @@ Ensure that the "SerialAgent" is enabled in the cloud sketch, via "thingProperti
 This method only works with the Arduino Cloud website. You can update the network settings from the detail page of the board on the webpage. The Serial interface, if enabled, is always ready to receive a new configuration.
 
 - Turn on the board and connect it to your PC using a USB cable.
-
 - Open the devices page on the Arduino Cloud webpage.
-
 - Click on the board you want to update the network settings for.
-
 - Click on the "change" button by the network section.
-
 - Input the new network configuration.
-
 - The board will validate it, and if correct, it will close the connection.
 
 ## How to delete a stored network configuration
 
 If you want to delete the stored network configuration without updating it, there are two possible methods to do so.
 
-### Board Reset procedure
+### Board Reset Procedure
 
 To proceed with the next steps, the cloud-generated sketch must be uploaded to the board.
 
 Reset the board using the method of your board. Have a look at the [How to set up the Reconfiguration Procedure](#How-to-set-up-the Reconfiguration-Procedure) section of this article to find the default board reset pin. If you have changed the reset pin from the default one, please use that.
 
-### Using the DeleteConfiguration sketch
+### Using the DeleteConfiguration Sketch
 
 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.
 

content/arduino-cloud/03.cloud-interface/00.sketches/sketches.md

@@ -131,61 +131,48 @@ This file will be visible as a "Secret" tab in the Cloud Editor and is named `ar
 
 Note that if you are using the offline IDE / Arduino CLI, you will need to manually create this file. More information is in the **Offline Sketches section**.
 
-
-
 ## thingsProperties.h and the NetworkConfigurator
 
 The thingProperties.h file plays a key role in managing credential capabilities, including the NetworkConfigurator, which enables two main features:
 
 - Credentials stored on NVS: Boards can now securely store network settings in Non-Volatile Storage (NVS), removing them from the sketch (secrets.h).
+- Over-the-Air (OTA) communication: Enables the possibility to provide network configuration settings via Bluetooth (BLE).
 
-- Over-the-Air (OTA) communication: Enables the possibility to provide network settings configuration via Bluetooth (BLE)
-
-The thingProperties.h will be generated accordingly to the provisioning mechanism, so if the board has been registered using the provisioning 2.0, automatically the thingProperties.h file will have the NetworkConfigurator component enabled.
-
-A board registered with Provisioning 2.0 includes Arduino_NetworkConfigurator.h in the generated thingProperties.h.
+The `thingProperties.h` will be generated accordingly to the provisioning mechanism, so if the board has been registered using the provisioning 2.0, the `thingProperties.h` file will automatically have the NetworkConfigurator component enabled. A board registered with Provisioning 2.0 includes `Arduino_NetworkConfigurator.h` in the generated `thingProperties.h` file.
 
 ### How the NetworkConfigurator works
 
 To work, the NetworkConfigurator needs:
 
-- One or more Configurator Agents: Objects that handle the communication between the board and the user device (PC, laptop, or Mobile phone). The NetworkConfigurator library out-of-the-box provides two Agents:
+- One or more Configurator Agents: Objects that handle the communication between the board and the user device (PC, laptop, or Mobile phone).
+- A Key-Value Storage library: the NetworkConfigurator needs an external storage library that implements the KVStoreInterface. Arduino provides the `Arduino_KVStore` library for handling the storage and saving the NetworkConfigurator configurations.
+- A ConnectionHandler: the object responsible for the board's Internet connection management.
 
-- BLEAgent for handling the BLE communication 
+The `NetworkConfigurator` library out-of-the-box provides two Agents:
 
+- BLEAgent for handling the BLE communication.
 - SerialAgents for the Serial communication.
 
-- A Key-Value Storage library: the NetworkConfigurator needs an external storage library that implements the KVStoreInterface. Arduino provides the Arduino_KVStore library for handling the storage and saving the NetworkConfigurator configurations.
-
-- A ConnectionHandler: the object responsible for the board’s Internet connection management
+## thingsProperties.h Default Setup
 
-### thingsProperties.h
-Here is how the thingsProperties.h file changes to set up the NetworkConfigurator.
+Here is how the `thingsProperties.h` file changes to set up the NetworkConfigurator. This setup is automatically generated if the board has been registered with Provisioning 2.0.
 
-### Default setup
-This setup is automatically generated if the board has been registered with Provisioning 2.0.
+*** Do not follow these steps if the board has not been registered with the Provisioning 2.0 ***
 
-Do not try if the board has not been registered with the Provisioning 2.0
+### Libraries and object declarations
 
-Automatically, both the SeralAgent and the BLEAgent are enabled
-
-Libraries and object declarations
 The following libraries are automatically included:
 
-Arduino_NetworkConfigurator library
-
-BLEAgent.h and SerialAgent.h
-
-The objects declared:
-
-kvStore: for handling the NVM operations
-
-BLEAgent for handling the BLE interface
+- Arduino_NetworkConfigurator library
+- BLEAgent.h
+- SerialAgent.h
 
-SerialAgent: for handling the Serial Interface
-
-NetworkConfigurator: the networkConfigurator instance
+These objects are declared in `thingsProperties.h`:
 
+- `kvStore`: handles the NVM operations
+- `BLEAgent`: handles the BLE interface
+- `SerialAgent`: handles the Serial Interface
+- `NetworkConfigurator`: the networkConfigurator instance
 
 ```arduino
 #include <ArduinoIoTCloud.h>
@@ -203,15 +190,13 @@ NetworkConfiguratorClass NetworkConfigurator(ArduinoIoTPreferredConnection);
 ```
 
 ### initProperties()
-In the initProperties function, the following instructions are added:
-
-NetworkConfigurator.addAgent(BLEAgent); For enabling the BLEAgent
 
-NetworkConfigurator.addAgent(SerialAgent); For enabling the SerialAgent
-
-NetworkConfigurator.setStorage(kvStore); For setting the KVStore
+In the initProperties function, the following instructions are added:
 
-ArduinoCloud.setConfigurator(NetworkConfigurator); For embedding the NetworkConfigurator in the ArduinoCloud
+- `NetworkConfigurator.addAgent(BLEAgent);` For enabling the BLEAgent.
+- `NetworkConfigurator.addAgent(SerialAgent);` For enabling the SerialAgent.
+- `NetworkConfigurator.setStorage(kvStore);` For setting the KVStore.
+- `ArduinoCloud.setConfigurator(NetworkConfigurator);` For embedding the NetworkConfigurator in the ArduinoCloud.
 
 ```arduino
 NetworkConfigurator.addAgent(BLEAgent);
@@ -220,7 +205,7 @@ NetworkConfigurator.setStorage(kvStore);
 ArduinoCloud.setConfigurator(NetworkConfigurator);
 ```
 
-The final thingProperties.h file:
+The final `thingProperties.h` file:
 
 ```arduino
 #include <ArduinoIoTCloud.h>
@@ -248,13 +233,9 @@ void initProperties(){
 
 ### Disable the BLEAgent
 
-To save board storage and memory, after the provisioning, the BLEAgent can be removed. ~30KB of storage and ~ 2KB of memory are saved for BSS and Data.
+To save board storage and memory, after the provisioning, the `BLEAgent` can be removed. ~30KB of storage and ~ 2KB of memory are saved for BSS and Data. The network credentials provided in the provisioning phase can no longer be changed via Bluetooth if this is disabled.
 
-The network credentials provided in the provisioning phase can no longer be changed via Bluetooth
-
-To disable the BLEAgent, just comment out or remove the lines of code that include, declare, and enable it.
-
-The final result should be the following:
+To disable the `BLEAgent`, just comment out or remove the lines of code that include, declare, and enable it. The final result should be the following:
 
 ```arduino
 #include <ArduinoIoTCloud.h>
@@ -282,13 +263,9 @@ void initProperties(){
 
 ### Disable the SerialAgent
 
-To save board storage and memory, after the provisioning, the SerialAgent can be removed. ~1KB of storage is saved for BSS and Data
-
-The network credentials provided in the provisioning phase can no longer be changed via USB 
+To save board storage and memory, after the provisioning, the SerialAgent can be removed. ~1KB of storage is saved for BSS and Data. The network credentials provided in the provisioning phase can no longer be changed via USB if this is disabled.
 
-To disable the SerialAgent, just comment out or remove the lines of code that include, declare, and enable it.
-
-The final result should be the following:
+To disable the `SerialAgent`, just comment out or remove the lines of code that include, declare, and enable it. The final result should be the following:
 
 ```arduino
 #include <ArduinoIoTCloud.h>
@@ -318,11 +295,9 @@ void initProperties(){
 
 To save board storage and memory, after the provisioning, the NetworkConfigurator can be removed. ~40KB of storage and ~ 2,9KB of memory are saved for BSS and Data.
 
-In this setup, the only way to handle network settings is to return to using the secrets declared in secrets.h file. This can be done manually by adding the secrets.h file with the defines needed.
-
-In order to change the network settings, you must flash your sketch with the updated network settings in the secrets.h file. The network settings can no longer be updated using the Arduino Cloud WebUI or the mobile app.
+In this setup, the only way to handle network settings is to return to using the secrets declared in `secrets.h` file. This can be done manually by adding the `secrets.h` file with the defines needed.
 
-The final result should be the following (thingProperties.h file):
+In order to change the network settings, you must flash your sketch with the updated network settings in the `secrets.h` file. The network settings can no longer be updated using the Arduino Cloud Webpage or the mobile app. The final result should be the following (`thingProperties.h` file):
 
 ```arduino
 #include <ArduinoIoTCloud.h>