Merge pull request #568 from arduino/Hannes7eicher/Hardware-Deivces-Section-Review

[MKC-1295] Cloud Re-Work Hardware & Devices Review

Author: Hannes7eicher

content/arduino-cloud/02.hardware/01.devices/devices.md

@@ -5,7 +5,7 @@ tags: [Arduino Cloud, Devices]
 author: Karl Söderby
 ---
 
-The Arduino Cloud supports a range of official and third party boards which are handled in the **"Devices"** tab. Devices are considered the "virtual twin" of your physical boards.
+The Arduino Cloud supports a range of official and third-party boards which are handled in the **"Devices"** tab. Devices are considered the "virtual twin" of your physical boards.
 
 Currently, the following device types are supported:
 - Wi-Fi® with encryption through on-board crypto chip
@@ -17,7 +17,7 @@ Currently, the following device types are supported:
 
 ## Configure a Device
 
-Configuring a device in the Arduino Cloud is done through a wizard. There are three main options available:
+Configuring a device in the Arduino Cloud is done through an installation wizard. There are three main options available:
 - Wi-Fi® board with crypto chip (automatic configuration of API key)
 - ESP32/ESP8266 (manual configuration of API key)
 - Python, MicroPython, JavaScript (manual configuration of API key)
@@ -32,21 +32,21 @@ Depending on what type of device you choose, the installation wizard will differ
 
 ### Official Wi-Fi® Boards
 
-Wi-Fi® devices connect to the Arduino Cloud via a local network, and is suitable for short-range connectivity projects.
+Wi-Fi® devices connect to the Arduino Cloud via a local network and are suitable for short-range connectivity projects.
 
 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 requires 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 Thing configuration. 
 
-***Read more and see list of all compatible Wi-Fi® boards in the [Arduino Cloud Wi-Fi documentation](/arduino-cloud/hardware/wifi).***
+***Read more and see the list of all compatible Wi-Fi® boards in the [Arduino Cloud Wi-Fi documentation](/arduino-cloud/hardware/wifi).***
 
 ### Official LoRaWAN® Boards
 
-LoRaWAN® boards also have crypto chip on board, but connects to the Arduino Cloud through nearby LoRaWAN® gateways. LoRaWAN® devices are designed to use minimal power and transmit over longer ranges, hence the name:
-- **LoRa®** - long range technology used for transmission of data using minimal amount of power for long distances.
+LoRaWAN® boards also have a crypto chip on board but connect to the Arduino Cloud through nearby LoRaWAN® gateways. LoRaWAN® devices are designed to use minimal power and transmit over longer ranges, hence the name:
+- **LoRa®** - long-range technology used for transmission of data using minimal amounts of power for long distances.
 - **LoRaWAN®** - a network of gateways connected to the Internet that can receive and send data to LoRa® devices.
 
-***Read more and see list of all compatible LoRa® boards in the [Arduino Cloud LoRaWAN® documentation](/arduino-cloud/hardware/lora).***
+***Read more and see the list of all compatible LoRa® boards in the [Arduino Cloud LoRaWAN® documentation](/arduino-cloud/hardware/lora).***
 
 ### ESP32 / ESP8266 (Wi-Fi®)
 
@@ -56,17 +56,17 @@ There are currently two official ESP32 based Arduino boards:
 - [Arduino UNO R4 WiFi](https://store.arduino.cc/products/uno-r4-wifi)
 - [Arduino Nano ESP32](https://store.arduino.cc/products/nano-esp32)
 
-You can also configure a wide range of third party ESP32/ESP8266 boards.
+You can also configure a wide range of third-party ESP32/ESP8266 boards.
 
-***Read more and see list of all compatible ESP32/ESP8266 boards in the [Arduino Cloud ESP32/ESP8266 documentation](/arduino-cloud/hardware/wifi#configure-esp-boards).***
+***Read more and see the list of all compatible ESP32/ESP8266 boards in the [Arduino Cloud ESP32/ESP8266 documentation](/arduino-cloud/hardware/wifi#configure-esp-boards).***
 
 ### Manual Devices
 
-Manual devices are designed for interfacing with JavaScript, Python & MicroPython, and can for example run on an Raspberry Pi, but also on any . Creating a manual device generates a **[secret key](#secret-key--device-id)** that can together with the **device ID** be used to securely connect to the Arduino Cloud.
+Manual devices are designed for interfacing with JavaScript, Python & MicroPython, and can for example run on a Raspberry Pi, but also on any. Creating a manual device generates a **[secret key](#secret-key--device-id)** that can together with the **device ID** be used to securely connect to the Arduino Cloud.
 
 ***Note that manual devices do not have a sketch associated.***
 
-Check the guides below for getting started with each of the programming languages:
+Check the guides below to get started with each of the programming languages:
 
 - [Connect to Arduino Cloud (JavaScript)](/arduino-cloud/guides/javascript)
 - [Connect to Arduino Cloud (Python)](/arduino-cloud/guides/python)
@@ -80,6 +80,8 @@ When configuring ESP32/ESP8266 and Manual Devices, you generate a **Device ID**
 
 Make sure to download or store this information somewhere, as you cannot retrieve the Secret Key after this step.
 
+***If you lose your Secret Key or forget to download and store your information you will need to remove and set up the device again.***
+
 ## Device Information
 
 A device's information can be accessed directly in the Arduino Cloud under **"Devices"**. Depending on the type, the information will differ.
@@ -90,14 +92,13 @@ A device's information can be accessed directly in the Arduino Cloud under **"De
 - **FQBN** - fully qualified board name, used for compilation for a specific board, e.g. `arduino:samd:mkrwifi1010`.
 - **Serial Number** - when configuring an official board, the serial number will be registered.
 - **Connectivity Module Firmware** - for Wi-Fi® boards only, the current firmware on the board's radio module.
-- **Thing** - Thing associated with device.
+- **Thing** - Thing associated with a device.
 - **Status** - status of the device, online/offline.
-- **Last Activity** - timestamp of last synchronisation.
+- **Last Activity** - timestamp of the last synchronization.
 - **Added** - timestamp of date device was added to the Arduino Cloud.
 
 ## Connection Handler
 
-All hardware devices connecting to the Arduino Cloud uses the following libraries:
+All hardware devices connecting to the Arduino Cloud use the following libraries:
 - [ArduinoIoTCloud](https://github.com/arduino-libraries/ArduinoIoTCloud) - main library for Arduino Cloud, including methods for sending and receiving data, handling callbacks etc. Either via TCP/IP or LPWAN.
 - [Arduino_ConnectionHandler](https://github.com/arduino-libraries/Arduino_ConnectionHandler) - library for handling connection methods to the Arduino Cloud (Wi-Fi®, LoRaWAN®, Ethernet, NB-IoT, GSM).
-

content/arduino-cloud/02.hardware/02.wifi/wifi.md

@@ -5,13 +5,13 @@ tags: [Arduino Cloud, Wi-Fi, ESP32]
 author: Karl Söderby
 ---
 
-A number of official Arduino boards supports connection to the Arduino Cloud via Wi-Fi®. Some boards also have an onboard crypto chip that stores the credentials automatically when configuring the device.
+A number of official Arduino boards support a connection to the Arduino Cloud via Wi-Fi®. Some boards also have an onboard crypto chip that stores the credentials automatically when configuring the device.
 
 There are currently two ways of configuring a Wi-Fi® board:
-- By configuring an onboard crypto chip (available for a number of official Arduino boards only),
-- through a Secret Key / API key (ESP32/ESP8266 based boards\*)
+- By configuring an onboard crypto chip (available for a number of official Arduino boards only).
+- Through a Secret Key / API key (ESP32/ESP8266 based boards\*).
 
-***\*Note that the [UNO R4 WiFi](https://store.arduino.cc/products/uno-r4-wifi) and [Nano ESP32](https://store.arduino.cc/products/nano-esp32) boards uses this method.***
+***\*Note that the [UNO R4 WiFi](https://store.arduino.cc/products/uno-r4-wifi) and [Nano ESP32](https://store.arduino.cc/products/nano-esp32) boards use this method.***
 
 ## Supported Boards
 
@@ -31,33 +31,33 @@ The following boards connect to the Arduino Cloud via Wi-Fi®, using the onboard
 - [Portenta H7 Lite Connected](https://store.arduino.cc/products/portenta-h7-lite-connected)
 - [Portenta Machine Control](https://store.arduino.cc/products/arduino-portenta-machine-control)
 - [Nicla Vision](https://store.arduino.cc/products/nicla-vision)
-- [Opta](https://docs.arduino.cc/hardware/opta).
+- [Opta](https://store.arduino.cc/products/opta-wifi)
 
 ### Setup a Wi-Fi® Board
 
 To configure a Wi-Fi® board in the Arduino Cloud, follow the steps below:
 
 **1.** Connect your board to your computer.
 
-**2.** Go to [Arduino Cloud](app.arduino.cc), and navigate to the **"Devices"** section. Click on the **"Add Device"** button and then select the **"Arduino Board"**. After a while, your board will be visible, and you can click on the **"Configure"** button.
+**2.** Go to [Arduino Cloud](https://app.arduino.cc), and navigate to the **"Devices"** section. Click on the **"Add Device"** button and then select the **"Arduino Board"**. After a while, your board will be visible, and you can click on the **"Configure"** button.
 
 ![Board show up.](assets/wifi.png)
 
-**3.** Allow some time for the configuration, as a sketch is being uploaded to your board as well as a configuration of your crypto chip is ongoing. 
+**3.** Allow some time for the configuration, as a sketch is being uploaded to your board and your crypto chip is configured.
 
-Your board is now configured and ready to be used in the Arduino Cloud. 
+Once done, your board is configured and ready to be used in the Arduino Cloud.
 
 After setting up a device, you can check out the official [Getting Started (Arduino / C++)](/arduino-cloud/guides/arduino-c) guide. This will guide you to successfully send data between your board and Arduino Cloud.
 
 ## Configure ESP Boards
 
 ESP32 / ESP8266 based boards connect to the Arduino Cloud via a **secret key**, generated during device configuration.
 
-There is a large number of ESP32/ESP8266 supported boards, which you select from a drop down menu.
+There is a large number of ESP32/ESP8266 supported boards, which you select from a drop-down menu.
 
 ![Range of ESP32 boards.](assets/esp32-supported-boards.png)
 
-***If you do not find your board in the list, you can select also select the ESP32 model (e.g. `ESP32S3 Dev Module`).***
+***If you don't find your board in the list, just select the ESP32 model (e.g. `ESP32S3 Dev Module`).***
 
 The following official boards have an ESP32 as main/co-processor and connect using a secret key as well.
 
@@ -70,11 +70,13 @@ To configure an ESP32 board in the Arduino Cloud, follow the steps below:
 
 **1.** Connect your board to your computer.
 
-**2.** Go to [Arduino Cloud](app.arduino.cc), and navigate to the **"Devices"** section. Click on the **"Add Device"** button and then select the **"Third Party Board"**.
+**2.** Go to [Arduino Cloud](https://app.arduino.cc), and navigate to the **"Devices"** section. Click on the **"Add Device"** button and then select the **"Third Party Board"**.
 
 ![Select "Third Party Device"](assets/esp32.png)
 
-**3.** Select your board type, and give your board a name. When finished, you will generate a **secrey key** and **device ID**. You can download or manually store your credentials somewhere, but the secret key can **not be retrieved** after you close the window.
+**3.** Select your board type, and give your board a name. When finished, you will generate a **secret key** and **device ID**. You can download or manually store your credentials somewhere, but the secret key can **not be retrieved** after you close the window.
+
+***If you lose your Secret Key or forget to download and store your information you will need to remove and set up the device again.***
 
 ![Secret / Device Key.](assets/device-key.png)
 
@@ -101,4 +103,4 @@ The following ESP32 boards have been tested and verified to support OTA:
 
 ## Supported Frequencies
 
-All official Arduino boards currently only supports the 2.4GHz frequency band for transmitting data.
+All official Arduino boards currently only support the 2.4GHz frequency band for transmitting data.