Published August 17, 2021 © LGPL

Wio Terminal Publishing MQTT Messages To AWS

Simple Arduino IDE sketch to send Wio Terminal data to Amazon Web Services.

IntermediateFull instructions provided2 hours775

Things used in this project

Hardware components

Seeed Studio Wio Terminal

Software apps and online services

Arduino IDE

ezgif.com

Story

This is a tutorial for people with AWS account and familiar with Arduino IDE. Both are free.

Got an email from Seeed offering a free Wio Terminal to play with. Couple of weeks later I received the device, and it is amazing! Started looking for ideas to publish as a project here and found plenty of tutorials on:

https://wiki.seeedstudio.com/Wio-Terminal-Getting-Started/

The one tutorial I didn't find was how to connect to AWS IoT Core, and I thought that would be my opportunity to shine.

If you try to skip the bla bla and jump straight to the code like I did you may run into an issue. To avoid that issue head over to https://wiki.seeedstudio.com/Wio-Terminal-Network-Overview/ and follow two steps to "Update the Wireless Core Firmware". Go ahead, I'll wait here.

https://i.gifer.com/DB.gif

That was easy, wasn't it?

In this tutorial we will publish some numbers every 30 seconds, but the code can be easily modified to publish something more useful such as temperature or output from light sensor. The code I used to publish MQTT messages to AWS can be found at the end of this tutorial. Few things will need to be saved in secrets.h and they will be covered during working with AWS in the following steps.

Expand Secure and click Policies then create a new Policy.

This policy will allow all actions on all resources so it will be used for testing only. Scroll down and click Create.

Next, expand Manage and click Things

Click Create things.

We're creating one thing only, so click Next.

Give this thing a name which will be used later in the Arduino sketch.

Scroll down then click Next.

Click Next to auto generate certificate.

Attach the policy we just created then click Create thing.

We will need to download Device Certificate (AWS_CERT_CRT), Device Private Key (AWS_CERT_PRIVATE), and Amazon Root CA 1 (AWS_CERT_CA) to use them in secrets.h. We will also need to download Public key file just to close this dialog box.

Scroll down and click Done.

Click Settings in the left side of the screen.

We will need to use this Endpoint.

Uncollapse the left menu then click MQTT test client.

Subscribe to # to see all topics.

Leave this window open to watch messages come in from Wio Terminal.

We can now go to secrets.h and fill out all the missing information. The code is now ready to be uploaded to Wio Terminal.

Success!

I really enjoyed working with Wio Terminal and look foreword to use it in future projects.

Code

#include "rpcWiFi.h"
#include <WiFiClientSecure.h>
#include <MQTTClient.h>
#include "secrets.h"

WiFiClientSecure net;
MQTTClient mqtt;

void setup() {
  WiFi.mode(WIFI_STA);
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) yield();
  net.setCACert(AWS_CERT_CA);
  net.setCertificate(AWS_CERT_CRT);
  net.setPrivateKey(AWS_CERT_PRIVATE);
  mqtt.begin(AWS_IOT_ENDPOINT, 8883, net);
}

void loop() {
  while (!mqtt.connect(THINGNAME)) yield();
  mqtt.publish(topic, payload);
  delay(30000);
}

#define THINGNAME "WioTerminal"
#define topic "PubTopic"
#define payload "{\"millis\": " + String(millis()) + "}"
#define ssid "..."
#define password  "..."
#define AWS_IOT_ENDPOINT "..."

// Amazon Root CA 1
static const char AWS_CERT_CA[] PROGMEM = R"EOF(
-----BEGIN CERTIFICATE-----
.
.
.
-----END CERTIFICATE-----
)EOF";

// Device Certificate
static const char AWS_CERT_CRT[] PROGMEM = R"KEY(
-----BEGIN CERTIFICATE-----
.
.
.
-----END CERTIFICATE-----
)KEY";

// Device Private Key
static const char AWS_CERT_PRIVATE[] PROGMEM = R"KEY(
-----BEGIN RSA PRIVATE KEY-----
.
.
.
-----END RSA PRIVATE KEY-----
)KEY";

; PlatformIO Project Configuration File
;
;   Build options: build flags, source filter
;   Upload options: custom upload port, speed and extra flags
;   Library options: dependencies, extra library storages
;   Advanced options: extra scripting
;
; Please visit documentation for the other options and examples
; https://docs.platformio.org/page/projectconf.html

[env:seeed_wio_terminal]
platform = atmelsam
board = seeed_wio_terminal
framework = arduino
lib_deps = 
	seeed-studio/Seeed Arduino rpcWiFi@^1.0.5
	seeed-studio/Seeed Arduino rpcUnified@^2.1.3
	seeed-studio/Seeed Arduino FS@^2.1.1
	seeed-studio/Seeed_Arduino_mbedtls@^3.0.1
	256dpi/MQTT@^2.5.0

Credits

Majed Abouhatab, P.E.

54 projects • 40 followers

Electronics Professional Engineer, Pilot, Skydiver, Runner, and World Traveler.

Wio Terminal Publishing MQTT Messages To AWS

Things used in this project

Hardware components

Software apps and online services

Story

Schematics

Wiring

Code

WioTerminalAWS.ino

secrets.h

platformio.ini

Credits

Majed Abouhatab, P.E.

Comments

Embed the widget on your own site

Wio Terminal Publishing MQTT Messages To AWS

Wio Terminal Publishing MQTT Messages To AWS

Things used in this project

Hardware components

Software apps and online services

Story

Schematics

Wiring

Code

WioTerminalAWS.ino

secrets.h

platformio.ini

Credits

Majed Abouhatab, P.E.

Comments

Related channels and tags