Minor spelling fixes

sebromero · sebromero · commit f92f4a0f43db · 2022-05-10T11:39:03.000+02:00
diff --git a/content/hardware/04.pro/carriers/portenta-max-carrier/tutorials/mc-ard-lora/content.md b/content/hardware/04.pro/carriers/portenta-max-carrier/tutorials/mc-ard-lora/content.md
@@ -3,8 +3,8 @@ title: Connecting the Portenta Max Carrier to The Things Network
 description: This tutorial explains how to connect your Portenta Max Carrier to the Things Network(TTN) using its onboard LoRaWAN® module.
 difficulty: intermediate
 tags:
-  - iot
-  - LoRa®
+  - IoT
+  - LoRaWAN®
 author: Taddy Chung, José Bagur
 libraries:
   - name: MKRWAN
@@ -17,7 +17,7 @@ software:
 
 ## Overview
 
-This tutorial explains how to connect your Arduino® Max Carrier, with an [Arduino® Portena H7](https://store.arduino.cc/products/portenta-h7), to The Things Network (TTN) using its onboard LoRaWAN® module. The article will focus on achieving communication between the Max Carrier and an application on TTN.
+This tutorial explains how to connect your [Arduino® Max Carrier](http://store.arduino.cc/portenta-max-carrier), with an [Arduino® Portena H7](https://store.arduino.cc/products/portenta-h7) to The Things Network (TTN) using its onboard LoRaWAN® module. The article will focus on achieving communication between the Max Carrier and an application on TTN.
 
 ## Goals
 
@@ -28,10 +28,10 @@ This tutorial explains how to connect your Arduino® Max Carrier, with an [Ardui
 ### Required Hardware and Software
 
 - [Arduino® Portena H7](https://store.arduino.cc/products/portenta-h7).
-- Arduino® Portenta Max Carrier.
+- [Arduino® Portenta Max Carrier](http://store.arduino.cc/portenta-max-carrier).
 - 868-915 MHz antenna with SMA connector.
 - USB-C cable (either USB-A to USB-C or USB-C to USB-C).
-- [Arduino IDE 2.0](https://www.arduino.cc/en/software). 
+- Arduino IDE ([online](https://create.arduino.cc/) or [offline](https://www.arduino.cc/en/main/software)).
 - [Arduino MKRWAN library](https://github.com/arduino-libraries/MKRWAN).  
 - An active account in [TTN](https://www.thethingsnetwork.org/).
 
@@ -41,7 +41,7 @@ The Arduino® Portenta Max Carrier provides you with an unlimited range of appli
 
 ![CMWX1ZZABZ-078 LoRaWAN® module in the Portenta Max Carrier.](assets/mc_ard_ttn_module.png)
 
-***For more in-depth information about LoRa® and LoRaWAN®, please read [The Arduino Guide to LoRa® and LoRaWAN®](https://docs.arduino.cc/learn/communication/lorawan-101).***
+***For more in-depth information about LoRa® and LoRaWAN®, please read [The Arduino Guide to LoRa® and LoRaWAN®](/learn/communication/lorawan-101).***
 
 ## Connecting to TTN
 
@@ -65,25 +65,25 @@ Begin by attaching the Arduino® Portenta H7 board to the high-density connector
 
 ![CMWX1ZZABZ-078 LoRaWAN® module in the Portenta Max Carrier.](assets/mc_ard_hd_ttn_connectors.png)
 
-To power the CMWX1ZZABZ-078 LoRaWAN® module of the Portenta Max Carrier, you can use the **DC power jack** (with a 4.5V to 36V external DC power supply) of the Portenta Max Carrier or a **18650 3.7V Li-Ion battery**, connected to the Portenta Max Carrier battery clips; you can power the module also directly from the USB-C connector of the Portenta H7 board. **Also, do not forget to attach an 868-915 MHz antenna to the SMA connector (J9) in the Max Carrier**.
+To power the CMWX1ZZABZ-078 LoRaWAN® module of the Portenta Max Carrier, you can use the **DC power jack** (with a 4.5V to 36V external DC power supply) of the Portenta Max Carrier or a **18650 3.7V Li-Ion battery**, connected to the Portenta Max Carrier battery clips; you can power the module also directly from the USB-C connector of the Portenta H7 board. **Also, do not forget to attach an 868-915 MHz antenna to the SMA connector (J9) on the Max Carrier**.
 
 ![Power sources and LoRa® antenna connector in the Portenta Max Carrier.](assets/mc_ard_ttn_power.png)
 
 ***Using the LoRaWAN® module of the Portenta Max Carrier without an antenna may damage it. Please, do not forget to connect a suitable antenna to the dedicated SMA connector (J9) on the Portenta Max Carrier.***
 
-Now you can connect the Portenta H7 board to your computer using a USB-C cable. **Don't forget to change the position of the BOOT DIP switch** (SW1), **from BOOT SEL to BOOT**; otherwise, you will not be able to program your Portenta H7 board when attached to the Portenta Max Carrier.
+Now you can connect the Portenta H7 board to your computer using a USB-C cable. **Don't forget to change the position of the BOOT DIP switch (SW1) to OFF** ; otherwise, you will not be able to program your Portenta H7 board when attached to the Portenta Max Carrier.
 
 ![Power sources and LoRa® antenna connector in the Portenta Max Carrier.](assets/mc_ard_ttn_boot_sel.png)
 
 ### 2. Setting up the Software
 
-You can use several Arduino libraries with the CMWX1ZZABZ-078 LoRaWAN® module from Murata®; we recommend the [MKRWAN library](https://github.com/arduino-libraries/MKRWAN), developed by the Arduino Team. The MKRWAN library provides you the APIs to communicate with LoRa® and LoRaWAN® networks using the CMWX1ZZABZ-078 module. You can use this library in the Arduino IDE, both [online](https://create.arduino.cc/editor) and [offline](https://www.arduino.cc/en/software). 
+You can use several Arduino libraries with the CMWX1ZZABZ-078 LoRaWAN® module from Murata®; we recommend the [MKRWAN library](https://github.com/arduino-libraries/MKRWAN), developed by the Arduino Team. The MKRWAN library provides you with the APIs to communicate with LoRa® and LoRaWAN® networks using the CMWX1ZZABZ-078 module. You can use this library in the Arduino IDE, both [online](https://create.arduino.cc/editor) and [offline](https://www.arduino.cc/en/software). 
 
- If you are using the online IDE, you don't need to do anything; the library is already installed and ready to be used. If you are using the offline IDE, you must install the library **manually**. Installing the library can be done quickly by navigating to **Tools > Manage Libraries...** and then in the **Library Manager** search for **MKRWAN** library by Arduino; remember to install the latest version of the libraries. You can also access the Library Manager using the left toolbar of the IDE, as shown in the image below:
+If you are using the online IDE, you don't need to do anything; the library is already installed and ready to be used. If you are using the offline IDE, you must install the library **manually**. Installing the library can be done quickly by navigating to **Tools > Manage Libraries...** and then in the **Library Manager** search for **MKRWAN** library by Arduino; remember to install the latest version of the libraries. You can also access the Library Manager using the left toolbar of the IDE, as shown in the image below:
 
 ![Library Manager in the Arduino IDE 2.](assets/mc_ard_ttn_library.png)
 
-***Currently, there are two versions of the MKRWAN library. We recommend using the MKRWAN_v1 library since MKRWAN_v2 library is still in beta.***
+***Currently, there are two versions of the MKRWAN library. We recommend using the MKRWAN_v1 library since MKRWAN_v2 library is still in beta phase.***
 
 To use the MKRWAN library with the Portenta Max Carrier, you must define `PORTENTA_CARRIER` before the library inclusion, as shown below:
 
@@ -94,24 +94,24 @@ To use the MKRWAN library with the Portenta Max Carrier, you must define `PORTEN
 
 #### 2.1 Updating the LoRaWAN® Module Firmware
 
-The LoRaWAN® module firmware of the Portenta Max Carrier **must be updated** before its first use. This can be done using the example sketch `MKRWANFWUpdate_standalone` of the MKRWAN library. You can open this example by navigating to **Files > Examples MKRWAN**; before uploading the sketch into the Portenta H7 board, open the `MKRWANFWUpdate_standalone.ino` file and define `PORTENTA_CARRIER` before the library inclusion, as shown in the image below:
+The LoRaWAN® module firmware of the Portenta Max Carrier **must be updated** before its first use. This can be done using the example sketch `MKRWANFWUpdate_standalone` of the MKRWAN library. You can open this example by navigating to **File > Examples > MKRWAN**. Before uploading the sketch to the Portenta H7 board, open the `MKRWANFWUpdate_standalone.ino` file and define `PORTENTA_CARRIER` before the library inclusion, as shown in the image below:
 
 ![Library Manager in the Arduino IDE 2.](assets/mc_ard_ttn_firmware_1.png)
 
-Upload the sketch, open the Serial Monitor and wait for the firmware update to finish. You should see a confirmation message when the process is done as shown in the image below: 
+Upload the sketch, open the Serial Monitor and wait for the firmware update to finish. You should see a confirmation message when the process is done.
 
 
 ### 3. Provisioning the Arduino® Portenta Max Carrier
 
-Device provisioning is a process comparable to bank card numbering. Let's think about bank cards; bank cards numbers start with a six-digit vendor ID number that indicates who allocated and controls the card's security; the remaining digits are unique numbers associated with a specific card. Devices with LoRa® and LoRaWAN® capabilities have a similar system; the Join Server Unique Identifier (usually referred to as `JoinEUI`) is a number that manages the security and authorizes the device in a network, while the **Device Unique Identifier** (usually referred to as `DevEUI`) is a unique number that identifies the device. The `JoinEUI` and `DevEUI` numbers, are required to send information to TTN; the `JoinEUI` number is provided by the network (in this case TTN) while the `DevEUI` is provided by the manufacturer of the device's LoRa® module. 
+Device provisioning is a process comparable to bank card numbering. Let's think about bank cards; bank cards numbers start with a six-digit vendor ID number that indicates who allocated and controls the card's security; the remaining digits are unique numbers associated with a specific card. Devices with LoRa® and LoRaWAN® capabilities have a similar system; the **Join Server Unique Identifier** (usually referred to as `JoinEUI`) is a number that manages the security and authorizes the device in a network, while the **Device Unique Identifier** (usually referred to as `DevEUI`) is a unique number that identifies the device. The `JoinEUI` and `DevEUI` are required to send information to TTN; the `JoinEUI` number is provided by the network (in this case TTN) while the `DevEUI` is provided by the manufacturer of the device's LoRa® module. 
 
 The following sketch let's you find out what is the `DevEUI` of your Portenta Max Carrier: 
 
 ```arduino
 #define PORTENTA_CARRIER
 #include <MKRWAN.h>
 
-_lora_band region = US915;
+auto region = US915;
 
 LoRaModem modem(Serial1);
 
@@ -124,21 +124,20 @@ void setup() {
     while(1) {}
   }
 
-  Serial.print("Your Portenta Max Carrier DevEUI is: ");V
+  Serial.print("Your Portenta Max Carrier DevEUI is: ");
   Serial.println(modem.deviceEUI());  
 }
 
-void loop() {
-}
+void loop() {}
 ```
 
 The only line you may need to change before uploading the code is the one that sets the frequency:
 
 ```arduino
-_lora_band region = US915;
+auto region = US915;
 ```
 
-Set the frequency designator according to your country if needed. You can find more information about frequency plans definitions used in TTN [here](https://www.thethingsnetwork.org/docs/lorawan/frequency-plans/). After you upload the sketch into your Portenta H7 board, you should see the Portenta Max Carrier `DevEUI` in the Arduino IDE Serial Monitor as shown below:
+Set the frequency designator according to your country. You can find more information about frequency plans definitions used in TTN [here](https://www.thethingsnetwork.org/docs/lorawan/frequency-plans/). After you upload the sketch to your Portenta H7 board, you should see the Portenta Max Carrier `DevEUI` in the Arduino IDE Serial Monitor as shown below:
 
 ```arduino
 Your Portenta Max Carrier DevEUI is: a861XXXXXXXXXXXX
@@ -152,7 +151,7 @@ To send information to TTN, first we need to **create an application and registe
 
 ![TTN console welcome page.](assets/mc_ard_ttn_console_1.png)
 
-Now click in **Create an application**. You will need to add the following information:
+Now click on **Create an application**. You will need to add the following information:
 
 * **Owner**: the person or organization that owns the application.
 * **Application ID**: a unique identifier for your application (must be lowercase and without spaces).
@@ -182,7 +181,7 @@ Leave the **Cluster settings** option unchecked. Then continue with the followin
 * **DevEUI**: fill it with the `DevEUI` number of your Portenta Max Carrier you found [before](#3-provisioning-the-arduino-portenta-max-carrier).
 * **AppEUI**: fill it with zeros or enter your own.
 * **AppKey**: generate one or enter your own.
-* **Device ID**: must be lowercase and without spaces. 
+* **Device ID**: A custom identifier for your board, must be lowercase and without spaces. 
 
 Click on **Register end device**; this will take you to a **Device Overview** page where you will see all the information related to the device. Now, you will use some of this information with your Portenta Max Carrier to send data to TTN. 
 
@@ -197,7 +196,7 @@ Now, let's start sending information to TTN. The following sketch enables you to
 #include <MKRWAN.h>
 #include "arduino_secrets.h"
 
-_lora_band region = US915;
+auto region = US915;
 
 LoRaModem modem(Serial1);
 
@@ -234,12 +233,11 @@ void setup() {
 
   delay(5000);
 
-  int err;
   modem.setPort(3);
   modem.beginPacket();
   modem.print("HelLoRa World!");
-  err = modem.endPacket(true);
-  if (err > 0) {
+  int errorCode = modem.endPacket(true);
+  if (errorCode > 0) {
     Serial.println("Data sent correctly!");
   } else {
     Serial.println("Error sending data...");
@@ -254,16 +252,16 @@ void loop() {
 }
 ```
 
-The `arduino_secrets.h` file which contains AppEUI and AppKey numbers for the TTN applications can be defined as following code. AppEUI and AppKey information is found on the End device page of the Application of TTN. 
+The `arduino_secrets.h` file which contains AppEUI and AppKey numbers for the TTN applications can be defined as following code. AppEUI and AppKey information is found on the End device page of the TTN Application. 
 
 ```arduino
 String appEui = "xxxxxxxxxxxxxxxx";
 String appKey = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
 ```
 
-If data was sent correctly to TTN, you should see the following messages in the Arduino IDE Serial Monitor:
+If data was sent correctly to TTN, you should see the following messages in the Arduino IDE Serial Monitor: `Data sent correctly!`
 
-In your device overview dashboard in TTN, you should see changes in data activity every time a new message is sent: 
+In your device overview dashboard on TTN, you should see changes in data activity every time a new message is sent.
 
 ## Conclusion
 
@@ -278,5 +276,5 @@ You have now successfully configured and used the onboard LoRaWAN® module of yo
 While working on the sketch or when tried to upload the sketch, the Arduino IDE might show some errors preventing to proceed on the development. You can try the following troubleshooting tips to solve the commonly known issues:
 
 * If the sketch upload process fails, check if your Portenta H7 is in bootloader mode. To put the Portenta H7 into Bootloader mode, double-press its RESET button and verify that the green LED is waving. After this, you can try re-uploading the sketch.
-* Check the position of the BOOT DIP switch of the Portenta Max Carrier. If the Portenta H7 gets into bootloader mode immediately after power-on, including when connected via USB-C, change the position of the BOOT DIP switch from BOOT SEL to BOOT.
-* If the Arduino IDE fails to compile the sketch, check if you have defined `PORTENTA_CARRIER` before MKRWAN library inclusion.
+* Check the position of the BOOT DIP switch of the Portenta Max Carrier. If the Portenta H7 gets into bootloader mode immediately after power-on, including when connected via USB-C, change the position of the BOOT DIP switch to OFF.
+* If the Arduino IDE fails to compile the sketch, check if you have defined `PORTENTA_CARRIER` before the MKRWAN library inclusion.
