Step#1
Step#2
Step#3
Step#4
Step#5
Step#6
Step#7
Step#8
Step#9
Step#10
Step#11
Step#12
Step#13

Published August 21, 2022 © Apache-2.0

Wio Terminal & AWS IoT Core

In this project you will learn how to send message from Wio Terminal to AWS IoT Core using Secure MQTT Protocol.

IntermediateProtip6 hours736

Things used in this project

Hardware components

Seeed Studio Wio Terminal

Software apps and online services

Arduino IDE

Amazon Web Services AWS IoT

Story

Hello Everyone,

In this project I am going to demonstrate how we can send data to AWS IoT Core using Wio Terminal as Google Cloud has update that they are going to close their IoT Core service till 2023 and it's great time to get started with AWS IoT Core.

Why I choose the Wio Terminal instead of ESP32? well soon I will share the Article for ESP32 with AWS IoT so let's come to point, actually I am using Wio terminal as it's an awesome product by SeeedStudio which contains alot of built in sensors such as Mic, Light, Infrared, Accelerometer and awesome built-in display as well as WiFI & BLE Connectivity and have 2 Grove Connector to extend it's functionality as well as 40 GPIO pins which are Raspberry pi compatible in reasonable pricing.

I am assuming that you have Wio terminal if not then please buy 1 from seeedstudio and setup the board in Arduino IDE by following that link https://wiki.seeedstudio.com/Wio-Terminal-Getting-Started/

after installing SeeedStudio board and relevant libraries now we are moving towards AWS IoT Core.

Step#1

Navigate to aws.amazon.com/

and type IoT Core in Search bar and click on IoT Core.

Step#2

Click on the All Devices->Things and then Click on Create things

Step#3

Select "Create Single Thing" and Click on "Next" button.

Step#4

Type the thing name "Wio Terminal" or any thing that you want and leave the Additional Configuration. Select "No Shadow" and click on "Next" button

Step#5

Select 'Auto-generate a new Certificate(recommended)" and click on "Next" button

Step#6

In AWS every resource have access policy so here we also need to create a policy regarding access so click on 'Create Policy" and you will be on next page where you can select the permissions for your device.

Step#7

Below is the policy page type the Policy name I am giving it "Wio_Policy" but you can what ever you want, and below Select "Allow" under Policy effect and select different policy opitons like iot:Connect, iot:Publish, iot:Receive, iot:Subscribe" under Policy Actions and put * under Policy resource.

After adding these policies just switch back to your previous tab and refresh the page so you can get the policy.

Step#8

Hurry our policy is there just select and click on 'Create thing' button

Step#9

Congrats your device has been setup and now just download the 3 Certificates which are Device Certificate, Private Key File and Amazon trust services end Point.

Now our cloud setup has been completed and from onward we are moving back to arduino IDE for Coding.

Step#10

Download the AWS_IoT library for Wio Terminal from github https://github.com/Seeed-Studio/Seeed_Arduino_rpcAWS

and Install the Library in Arduino IDE by Navigating Sketch ->Include Library -> Add.Zip Library..

Copy the code from code section there are 2 files one is main.ino and other is.h file.

Step#11

In the secrets.h just update your Wi-Fi SSID, Password, HOST Address (you can get the host information from your AWS IoT Portal by click on Settings.

Later just Open the Amazon trust services end Point,Device Certificate, Private Key File and paste the keys into code according to red marking area.

Step#12

Change the topic in wio_aws_iot_core file or use the topics that I placed in the code. finally upload the code to Wio Terminal.

Step#13

after uploading the code to Wio Terminal now hit back to AWS IoT Core dasboard and click on Test -> MQTT Test Client. and type the Pub Topic which is "Wioterminal/pub" and click on Subscribe button and below you will see the data packets in real time which has been sent by device.

After practicing that simple project I hope you will get some happiness, if you face any issue during your practice please leave a comment and I will try my best to help you. I will try my best to make new article soon in which I will share how to store the thing/device data on AWS Cloud for further process.

if you want to learn more about MQTT and want to host your own MQTT Broker then here is my Course at Udemy look it here.

#include <AWS_IOT.h> //https://github.com/Seeed-Studio/Seeed_Arduino_rpcAWS
#include <rpcWiFi.h>
#include "SPI.h"
#include "secrets.h" // include your personal WiFi and AWS configuration. 

AWS_IOT hornbill;


static auto constexpr TOPIC_NAME = "wioterminal/pub";
static auto constexpr TOPIC_NAME_SUB = "wioterminal/sub";

int status = WL_IDLE_STATUS;
int tick=0,msgCount=0,msgReceived = 0;
char payload[512];
char rcvdPayload[512];

void mySubCallBackHandler (char *topicName, int payloadLen, char *payLoad)
{
    strncpy(rcvdPayload,payLoad,payloadLen);
    rcvdPayload[payloadLen] = 0;
    msgReceived = 1;
}


void setup() {
    Serial.begin(9600);

    while (status != WL_CONNECTED)
    {
        Serial.print("Attempting to connect to SSID: ");
        Serial.println(WIFI_SSID);
        status = WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
        delay(5000);
    }

    Serial.println("Connected to wifi");

    if(hornbill.connect(HOST_ADDRESS, CLIENT_ID,
                AWS_CERT_CA, AWS_CERT_CRT, AWS_CERT_PRIVATE)== 0)
    {
        Serial.println("Connected to AWS");
        delay(1000);

        if(0 == hornbill.subscribe(TOPIC_NAME_SUB,mySubCallBackHandler))
        {
            Serial.println("Subscribe Successfull");
        }
        else
        {
            Serial.println("Subscribe Failed, Check the Thing Name and Certificates. RESET.");
            while(1);
        }
    }
    else
    {
        Serial.println("AWS connection failed, Check the HOST Address. RESET.");
        while(1);
    }

    delay(2000);

}

void loop() {

    if(msgReceived == 1)
    {
        msgReceived = 0;
        Serial.print("Received Message:");
        Serial.println(rcvdPayload);
    }
    if(tick >= 5)   // publish to topic every 5seconds
    {
        tick=0;
        sprintf(payload,"Hello from Wio Terminal : %d",msgCount++);
        if(hornbill.publish(TOPIC_NAME,payload) == 0)
        {        
            Serial.print("Publish Message:");
            Serial.println(payload);
        }
        else
        {
            Serial.println("Publish failed");
        }
    }  
    vTaskDelay(1000 / portTICK_RATE_MS); 
    tick++;
}

// WiFi and MQTT configuration 
static auto constexpr WIFI_SSID = "-----WIFI-SSID";
static auto constexpr WIFI_PASSWORD = "-----WIFI-Password------";
static auto constexpr CLIENT_ID = "WioTerminal";

// hostname of your MQTT ATS endpoint 
static auto constexpr HOST_ADDRESS = "-------Region-------------;



// 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";

Credits

Muhammad Afzal

25 projects • 117 followers

I am Software Eng having 13+ Years of experience. Hackster.io & Cayenne Mydevices Ambassador in Pakistan.

Wio Terminal & AWS IoT Core