Skip to content

Commit 4783b14

Browse files
committed
Title changed
1 parent 1bf483a commit 4783b14

File tree

1 file changed

+13
-13
lines changed
  • content/hardware/07.opta/opta-family/opta/tutorials/05.getting-started-with-aws-iot-core

1 file changed

+13
-13
lines changed

content/hardware/07.opta/opta-family/opta/tutorials/05.getting-started-with-aws-iot-core/content.md

+13-13
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: 'Getting Started with AWS IoT Core'
2+
title: 'Connect Arduino OPTA to AWS IoT Core'
33
description: "Learn how to connect your Opta™ device to the AWS IoT Core."
44

55
difficulty: intermediate
@@ -71,7 +71,7 @@ This tutorial will need the latest version of the Arduino IDE; you can download
7171

7272
![Installing the Opta™ core in the Arduino IDE](assets/aws-iot_001.png)
7373

74-
This tutorial also requires the latest version of the `NTPClient`, `Arduino_JSON `, `ArduinoECCX08`, `ArduinoBearSSL`, `ArduinoMqttClient`, `Arduino_ConnectionHandler` and `Arduino Cloud Provider Examples` libraries installed on the Arduino IDE. You can do this by navigating to **Tools > Manage Libraries** or clicking the Library Manager icon in the left tab of the IDE. In the Library Manager tab, search for `NTPClient`, `Arduino_JSON `, `ArduinoECCX08`, `ArduinoBearSSL`, `ArduinoMqttClient`, `Arduino_ConnectionHandler` and `Arduino Cloud Provider Examples` and install the latest version.
74+
This tutorial also requires the latest version of the `NTPClient`, `Arduino_JSON`, `ArduinoECCX08`, `ArduinoBearSSL`, `ArduinoMqttClient`, `Arduino_ConnectionHandler` and `Arduino Cloud Provider Examples` libraries installed on the Arduino IDE. You can do this by navigating to **Tools > Manage Libraries** or clicking the Library Manager icon in the left tab of the IDE. In the Library Manager tab, search for `NTPClient`, `Arduino_JSON`, `ArduinoECCX08`, `ArduinoBearSSL`, `ArduinoMqttClient`, `Arduino_ConnectionHandler` and `Arduino Cloud Provider Examples` and install the latest version.
7575

7676
![Installing libraries in the Arduino IDE](assets/aws-iot_002.png)
7777

@@ -83,19 +83,19 @@ If you do not have an existing AWS account and user, refer to the online AWS doc
8383
- [Create an administrative user](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#create-an-admin)
8484
- [Open the AWS IoT console](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#iot-console-signin)
8585

86-
### Generating a Certificate Signing Request
86+
### Generating a Certificate Signing Request
8787

8888
As mentioned, AWS IoT Core requires devices that connect to it using the MQTT protocol to use X.509 certificates for authentication. We'll use an example sketch from the `ArduinoECCX08` library to generate a Certificate Signing Request (CSR) from an Opta™ device and then upload this CSR in the AWS console to create an X.509 certificate.
8989

9090
Open the `ECCX08CSR` example sketch by navigating to **File > Examples > ArduinoECCX08 > Tools**. To upload the code to your Opta™ device, click the **Verify** button to compile the sketch and check for errors; then click the **Upload** button to program the device with the sketch.
9191

9292
![Verify and Upload buttons of the Arduino IDE](assets/aws-iot_003.png)
9393

94-
When finished, open the IDE's Serial Monitor. Ensure the line ending configuration is set to **Both NL & CR**, as shown in the image below.
94+
When finished, open the IDE's Serial Monitor. Ensure the line ending configuration is set to **Both NL & CR**, as shown in the image below.
9595

9696
![Verify and Upload buttons of the Arduino IDE](assets/aws-iot_004.png)
9797

98-
Provide the information requested by the example sketch to generate a new CSR for your Opta™ device. Copy the generated CSR from the IDE's Serial Monitor, including `-----BEGIN CERTIFICATE REQUEST-----` and `-----END CERTIFICATE REQUEST-----` and save it to a new `.txt` file or `.csr` file using your favorite text editor. You will upload this file to the AWS console next.
98+
Provide the information requested by the example sketch to generate a new CSR for your Opta™ device. Copy the generated CSR from the IDE's Serial Monitor, including `-----BEGIN CERTIFICATE REQUEST-----` and `-----END CERTIFICATE REQUEST-----` and save it to a new `.txt` file or `.csr` file using your favorite text editor. You will upload this file to the AWS console next.
9999

100100
![Generating a CSR with the Arduino ecosystem tools](assets/aws-iot_005.png)
101101

@@ -129,11 +129,11 @@ After selecting the Next button, you will be transferred to a page where you can
129129

130130
![Things properties page](assets/aws-iot_009.png)
131131

132-
After selecting the Next button, you will be transferred to a page where you can upload the generated CSR. Choose the CSR file, then select the **Next** button.
132+
After selecting the Next button, you will be transferred to a page where you can upload the generated CSR. Choose the CSR file, then select the **Next** button.
133133

134134
![Device certificate page](assets/aws-iot_010.png)
135135

136-
After selecting the Next Button, you will be transferred to a page where you can choose the **policies** you want to attach to your Thing, and then select the **Create thing** button.
136+
After selecting the Next Button, you will be transferred to a page where you can choose the **policies** you want to attach to your Thing, and then select the **Create thing** button.
137137

138138
![Device certificate page](assets/aws-iot_011.png)
139139

@@ -155,7 +155,7 @@ Once in the Certificate area, select the **Actions** dropdown menu and choose **
155155

156156
The first step to connect your Opta™ device is getting the **device data endpoint** from your AWS account. In your AWS account, navigate to the menu on the left side and choose **Settings**; copy the provided endpoint.
157157

158-
The next step depends on the variant of your Opta™ device you have.
158+
The next step depends on the variant of your Opta™ device you have.
159159

160160
- **For Opta™ Lite (SKU: AFX00003)**: Open the AWS IoT Ethernet example sketch in the Arduino IDE using the File > Examples > Arduino Cloud Provider Examples > AWSIoT > AWS_IoT_Opta > **AWS_IoT_Opta_ethernet.ino**
161161

@@ -167,7 +167,7 @@ In the `arduino_secrets.h` tab update the Wi-Fi® Setting with the SSID and pass
167167

168168
![Example sketch](assets/aws-iot_015.png)
169169

170-
Within the `setup()`, the lines `sslClient.setEccSlot(0, certificate)` and the `mqttClient.setId(“clientID”)` are important. The `setECCSlot` function sets the slot you used before for the CSR; the `setId` function sets the name you gave to your Thing in the AWS IoT Core.
170+
Within the `setup()`, the lines `sslClient.setEccSlot(0, certificate)` and the `mqttClient.setId(“clientID”)` are important. The `setECCSlot` function sets the slot you used before for the CSR; the `setId` function sets the name you gave to your Thing in the AWS IoT Core.
171171

172172
![Example sketch](assets/aws-iot_016.png)
173173

@@ -183,15 +183,15 @@ The example sketch automatically connects to an Ethernet or a Wi-Fi® network an
183183

184184
### Testing the Example Sketch
185185

186-
As soon as your Opta™ device is connected to the AWS IoT broker, it publishes automatically a simple message to the `arduino/outgoing` topic every five seconds. On the AWS IoT Core console, open the **MQTT test client** and add a subscription for the `arduino/outgoing` topic; choose the JSON formatting as display option.
186+
As soon as your Opta™ device is connected to the AWS IoT broker, it publishes automatically a simple message to the `arduino/outgoing` topic every five seconds. On the AWS IoT Core console, open the **MQTT test client** and add a subscription for the `arduino/outgoing` topic; choose the JSON formatting as the display option.
187187

188188
![MQTT test client in AWS](assets/aws-iot_019.png)
189189

190190
See messages arriving from your Opta™ device every five seconds.
191191

192192
![MQTT test client in AWS](assets/aws-iot_020.png)
193193

194-
On the AWS IoT Core console, open the MQTT test client and select the "Publish to a topic" tab. Add `arduino/incoming` as Topic name and click the "Publish" button to send data to Opta™. Data in the "Message payload" text area shows on the Serial Monitor of the Arduino IDE.
194+
On the AWS IoT Core console, open the MQTT test client and select the "Publish to a topic" tab. Add `arduino/incoming` as Topic name and click the "Publish" button to send data to Opta™. Data in the "Message payload" text area shows on the Serial Monitor of the Arduino IDE.
195195

196196
![Receiving data in your Opta™ device](assets/aws-iot_021.png)
197197

@@ -205,9 +205,9 @@ Please note the example sketch can parse only JSON messages in the form:
205205

206206
The message can be modified as you like, remember to adapt the example sketch accordingly.
207207

208-
## Troubleshooting
208+
## Troubleshooting
209209

210-
For more information with AWS, refer to the AWS online documentation on [Troubleshooting AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot_troubleshooting.html). For more details on Opta™ devices, refer to Opta™'s online documentation on [Arduino Docs](https://docs.arduino.cc/hardware/opta).
210+
For more information on AWS, refer to the AWS online documentation on [Troubleshooting AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot_troubleshooting.html). For more details on Opta™ devices, refer to Opta™'s online documentation on [Arduino Docs](https://docs.arduino.cc/hardware/opta).
211211

212212
If your Opta™ device fails to connect to AWS IoT Core, check the following:
213213

0 commit comments

Comments
 (0)