Scribd
Upload
44 views16 pages

UM017004E AWS IoT UserManual Eng

This document provides instructions for using AWS IoT with EasyBuilder Pro to create Things and Shadows. It outlines how to host an MQTT server on AWS, configure settings in EasyBuilder Pro, and set up Things and Shadows on the AWS IoT platform. Key steps include creating policies and certificates on AWS, importing credentials into EasyBuilder Pro, and defining Thing names, statuses, and settings to enable bi-directional communication between devices and AWS IoT.

Uploaded by

Tomer W
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
44 views16 pages

UM017004E AWS IoT UserManual Eng

This document provides instructions for using AWS IoT with EasyBuilder Pro to create Things and Shadows. It outlines how to host an MQTT server on AWS, configure settings in EasyBuilder Pro, and set up Things and Shadows on the AWS IoT platform. Key steps include creating policies and certificates on AWS, importing credentials into EasyBuilder Pro, and defining Thing names, statuses, and settings to enable bi-directional communication between devices and AWS IoT.

Uploaded by

Tomer W
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 16

User Manual

AWS IoT

This guide walks through the steps to use AWS IoT and create Thing and Shadow in
EasyBuilder Pro.

20220823
Table of Contents
1. Overview of AWS IoT .............................................................................................. 1
2. Hosting MQTT Server .............................................................................................. 1
3. EasyBuilder Pro Settings ......................................................................................... 6
4. Thing and Shadow .................................................................................................. 9
5. References ............................................................................................................ 14
AWS IoT

1. Overview of AWS IoT


AWS (Amazon Web Service) is a cloud platform now widely used on the market, and
AWS IoT (Internet of Things) supports MQTT protocol. Observing the market trend,
from EasyBuilder Pro V6.00.01, Weintek has adopted AWS IoT service and integrated
it with the MQTT feature released earlier. Apart from using AWS IoT as a broker in
the publish-subscribe mode, users can also create Thing and Shadow offered by AWS
IoT to make the most of MQTT.

This manual walks you through the steps to host MQTT server, configure EasyBuilder
Pro, and create Things.

2. Hosting MQTT Server


AWS is a cloud platform; therefore, the settings are all configured on the web, please
sign up in Amazon website before hosting an MQTT server.

1. Visit Amazon Web Service website at https://aws.amazon.com


2. Sign up. (left: individual account, right: business account)

3. After sign in, browse for IoT Core.

1
AWS IoT

4. On the AWS IoT page, Policy and Certificate can be created

5. Open [Manage] » [Security] » [Policies] and then click [Create policy].

6. This page is for defining actions that can be performed by a resource. You
may use the settings in the screenshot below or set your own. Click [Create]
when finish.

2
AWS IoT

7. Click [Security] » [Certificates] and then click [Add certificate] » [Create


certificate].

8. Select [Auto-generate new certificate (recommended)], set Certificate


Status to [Active], and then click [Create].

3
AWS IoT

9. Download and save these files: Device Certificate, Public Key File, Private
Key File, and RSA 2048 bit key: Amazon Root CA 1.

10. Click the certificate created previously and click [Attach policies] under
Policies. In the window that follows, select the Policy created previously
and then click [Attach policies].

4
AWS IoT

11. Security setting is done successfully when the following box shows.

12. Click [Settings], the URL marked in red frame below is the domain name of
AWS IoT server, and will be used when setting MQTT in EasyBuilder Pro,
please remember it.
AWS is gradually replacing servers using Symantec CA with Amazon Trust
Service. As a result, please check whether the domain name contains “-ats”,
for example: a2xxxxxxx-ats.iot.xxxxxx.amazon.aws.com.
Amazon Root CA 1 certificate created in step 9 works only when the
endpoint is in this format.

5
AWS IoT

3. EasyBuilder Pro Settings


After hosting an MQTT server, launch EasyBuilder Pro.
1. Click [IIoT/Energy] » [MQTT] to open MQTT settings window.

2. In General tab, select [Normal] as cloud service to use publish-subscribe


mode, or select [AWS IoT] to use Thing mode, and the rest will be
introduced later. Use the URL obtained in Chapter 2 as domain name, and
use port 8883.

3. In Address tab configure addresses.

6
AWS IoT

4. In TLS/SSL tab, import the file generated when creating the certificate.
Server verification, CA certificate: Import a .pem file. (Amazon Root CA 1)
Client verification, Certificate: Import a .crt file. (certificate.pem.crt)
Client verification, Private key: Import a .key file (private.pem.key)

5. System topic includes Topic List and Connection State that HMI will
automatically send once it connects to server.

7
AWS IoT

6. Restrictions of using AWS IoT as MQTT server:


a. Only QoS 0 and QoS 1 are available.
b. Retain message is not supported.
c. The maximum number of layers is 8.
7. Please see EasyBuilder Pro user manual for more information about publish
/ subscribe settings.

8
AWS IoT

4. Thing and Shadow


With AWS IoT, Publisher->Broker-> Subscribe is no longer the only path that data is
accessed over MQTT. By introducing Thing Shadow service, a Thing (a device,
app…etc) can interact with cloud applications and other devices connected to AWS
IoT. A Shadow can be maintained for each Thing connected to AWS IoT. The Shadow
can be used to get/set the state of a Thing over MQTT, regardless of whether the
Thing is connected to the Internet.

This chapter explains configuration of AWS IoT and EasyBuilder Pro.

AWS IoT
1. Click [Manage] » [All devices] » [Things] » [Create things].

2. Select [Create single thing] and then click [Next].

3. Enter the Thing name.

9
AWS IoT

4. Create a certificate.

5. Select the corresponding Policy and then click [Create thing].

10
AWS IoT

EasyBuilder Pro
1. Select AWS IoT as cloud service in MQTT Server settings window, and
follow the settings in Chapter 3 in this manual.

2. Click new to add a device.

11
AWS IoT

3. Enter Thing name and set minimal time between messages. Only Qos 0 and
Qos 1 are available.

4. Go to Address tab and set the addresses for reported status (LB-0) and
desired setting (LB-1). ->, <-> stands for the direction in which data is
transmitted.

12
AWS IoT

5. In Advanced Mode settings window, Status (reported) and Setting (desired)


can use different addresses, and data is transmitted to/from AWS
IoT/device.

13
AWS IoT

5. References
EasyBuilder Pro User Manual Chapter 42 IIoT
How does AWS IoT platform work:
https://aws.amazon.com/tw/iot-platform/how-it-works/

14

You might also like