Skip to content

Commit 8964f05

Browse files
authored
Merge pull request #469 from arduino/martab1994-patch-3
Portenta CatM1 Shield: Fix getting started typos
2 parents 840a9c4 + 1a6c42c commit 8964f05

File tree

1 file changed

+12
-12
lines changed
  • content/hardware/04.pro/shields/portenta-cat-m1-nb-iot-gnss-shield/tutorials/getting-started

1 file changed

+12
-12
lines changed

content/hardware/04.pro/shields/portenta-cat-m1-nb-iot-gnss-shield/tutorials/getting-started/getting-started.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -21,16 +21,16 @@ software:
2121

2222
## Introduction
2323

24-
This tutorial will show how to connect the Arduino® Portenta Cat. M1/NB IoT GNSS shield to the Arduino® Portenta H7, connect to a website using NBIoT or Cat-M1 technology and print the website's HTML content in the serial monitor. This will help you quickly find out if the setup successfully connects to mobile networks.
24+
This tutorial will show how to connect the Arduino® Portenta Cat. M1/NB IoT GNSS shield to the Arduino® Portenta H7, connect to a website using NB IoT or Cat. M1 technology and print the website's HTML content in the Serial Monitor. This will help you quickly find out if the setup successfully connects to mobile networks.
2525

26-
***Note: This tutorial was created in Sweden, and as a result, the available networks are only Swedish network operators. The results will vary depending on what location you are in.***
26+
***Note: This tutorial was created in Sweden, and, as a result, the available networks are only Swedish network operators. Results may vary depending on what location you are in.***
2727

2828
## Goals
2929

3030
The goals of this project are:
3131

3232
- Learn how to connect the board and the shield.
33-
- Connect to the GSM network with Cat-M1 or NBIoT.
33+
- Connect to the GSM network with Cat. M1 or NB IoT.
3434
- Print HTML content in the Serial Monitor.
3535

3636
## Hardware & Software Needed
@@ -48,35 +48,35 @@ First insert the SIM card into the SIM card slot at the bottom of the Portenta C
4848

4949
![Connect the antenna to the Portenta Cat. M1 shield](assets/Antenna_Cat_M1.svg)
5050

51-
Now connect the shield to the Portenta H7. Do this by attaching it to the HD connectors at the bottom of the Portenta H7 board. Like the image shows below, the top and bottom high density connectors on the shield are connected to the corresponding ones on the underside of the H7 board. Press firmly to let it snap in. Once attached, plug the Portenta H7 into your computer using a USB C cable.
51+
Now connect the shield to the Portenta H7. Do this by attaching it to the HD connectors at the bottom of the Portenta H7 board. Like the image shows below, the top and bottom high density connectors on the shield are connected to the corresponding ones on the lower side of the H7 board. Press firmly to let it snap in. Once attached, plug the Portenta H7 into your computer using a USB-C cable.
5252

5353
![Connect the Portenta Cat. M1 shield with the Portenta H7](assets/Connect_Cat_M1_to_Portenta_H7.svg)
5454

5555
### Arduino IDE
5656

57-
Make sure that you have the latest **Arduino Mbed OS Portenta core** installed. You can install it with the board manager under **Tools > Board > Board Manager...**. With the core installed and the board selected, navigate to **File > Examples > GSM > GSMClient**. This is the example sketch we will use to test out the Cat-M1 or NBIoT connection.
57+
Make sure that you have the latest **Arduino Mbed OS Portenta core** installed. You can install it with the board manager under **Tools > Board > Board Manager...**. With the core installed and the board selected, navigate to **File > Examples > GSM > GSMClient**. This is the example sketch we will use to test out the Cat. M1 or NB IoT connection.
5858

5959
### Programming the Board
6060

61-
Go to the **arduino_secrets.h** tab that opens with the example and enter the PIN of the SIM card you are using into the `SECRET_PIN` variable. Check your SIM card provider's mobile APN, e.g "online.provider.com" save it inside `SECRET_APN`.
61+
Go to the **arduino_secrets.h** tab that opens with the example and enter the PIN of the SIM card you are using into the `SECRET_PIN` variable. Check your SIM card provider's mobile APN, e.g "online.provider.com" and save it inside `SECRET_APN`.
6262

63-
***Note: A standard pre-paid SIM card typically have 0000 or 1234 as a pin code. This varies from operator to operator, it is important to find out this before uploading the code. Otherwise, too many unsuccessful attempts may block the SIM card.***
63+
***Note: A standard pre-paid SIM card typically have 0000 or 1234 as a pin code. This varies from operator to operator, it is important to find out your pin before uploading the code. Otherwise, too many unsuccessful attempts may block the SIM card.***
6464

65-
Using `GSM.begin()` will start the GSM module using the pin and APN entered in **arduino_secrets.h**. To decide whether to use NBIoT or Cat-M1 technology we need to change the last argument. Use either `CATNB` for NBIoT or `CATM1` for Cat-M1. If you are unsure what technology to use, check with your SIM card provider to see what technology they support.
65+
Using `GSM.begin()` will make the GSM module to start with the pin and APN entered in **arduino_secrets.h**. To decide whether to use NB IoT or Cat. M1 technology, you need to change the last argument. Use either `CATNB` for NB IoT or `CATM1` for Cat. M1. If you are unsure what technology to use, check with your SIM card provider what technology they support.
6666

6767
```arduino
6868
GSM.begin(pin, apn, username, pass, CATNB);
6969
```
7070

71-
When the GSM module is started we can then proceed to connect to a remote server using the server url defined in the example. The port to connect to is also defined. It is set to `80` as default.
71+
When the GSM module starts, you can connect to a remote server using the server url defined in the example. The port to connect to is also defined: it is set to `80` as default.
7272

7373
```arduino
7474
client.connect(server,port)
7575
```
7676

7777
### Result of Sketch
7878

79-
After finishing this setup, compile and upload the program. You should see the HTML content of the server printed in the serial monitor. As default the server is set as `example.com`. Feel free to change this and take a look at how it prints different web pages. Below you can see what will print in the serial monitor, when connecting to `example.com`.
79+
After finishing this setup, compile and upload the program. You should see the HTML content of the server printed in the Serial Monitor. The server is set as `example.com` as default. Feel free to change this and take a look at how it prints different webpages. Below you can see what will be printed in the Serial Monitor when connecting to `example.com`.
8080

8181
![Result in the serial monitor](assets/Cat-M1-serial-monitor.png)
8282

@@ -90,8 +90,8 @@ If the code is not working, there are some common issues we can troubleshoot:
9090

9191
## Next Step
9292

93-
This is a basic example of what the Portenta Cat. M1/NB IoT GNSS Shield is capable of. A good next step could be to try out the GNSS functionality. To use the GNSS functionality you will need a different antenna from the one used in this tutorial (see product page). If you would rather use the same set up as in this tutorial, but with more advanced functionality, try to send an SMS to a cellphone using the GSM connection.
93+
This is a basic example showing what the Portenta Cat. M1/NB IoT GNSS Shield is capable of. A good next step could be to try out the GNSS functionality. To use the GNSS functionality you will need a different antenna from the one used in this tutorial (e.g. ECHO19/0.1M/UFL/S/S/17). If you would rather use the same set up as in this tutorial, but with more advanced functionality, try to send an SMS to a cellphone using the GSM connection.
9494

9595
## Conclusion
9696

97-
This tutorial showed how to attach the Portenta Cat. M1/NB IoT GNSS Shield to the Portenta H7. It also showed how to upload an example sketch that helps to confirm that the set up works. The website to connect to can easily be changed in the sketch. Make sure to take a look at our other tutorials for this product.
97+
This tutorial showed how to connect the Portenta Cat. M1/NB IoT GNSS Shield to the Portenta H7. It also showed how to upload an example sketch that helps to confirm the set up is properly working. The website to connect to can easily be changed in the sketch. Make sure to take a look at our other tutorials for this product.

0 commit comments

Comments
 (0)