Murata Type1LD User manual

Type1LD AWS IoT Core Quick Start Guide
Page 1
Document Number: N1-5284
Version: 1.0
Release Date: 2020/6/1
Murata Manufacturing Co., Ltd.
Type1LD AWS IoT Core
Quick Start Guide
Document No. N1-5284

Type1LD AWS IoT Core Quick Start Guide
Page 2
Revision History
Revision Number
Release Date
Comments
Revision 1.0
2020/6/1
Initial

Type1LD AWS IoT Core Quick Start Guide
Page 3
Contents
Contents........................................................................................................................................... 3
1. About this Document .......................................................................................................... 4
1.1. Purpose and Scope ............................................................................................................ 4
1.2. Prerequisites ..................................................................................................................... 4
2. Evaluation Board................................................................................................................ 4
3. Setting up AWS IoT Core.................................................................................................... 5
4. Setting up Certificate Files for WICED............................................................................. 9
5. Checking Your AWS Endpoint............................................................................................ 9
6. Running Applications ....................................................................................................... 10
6.1. Running Publisher Application ...................................................................................... 10
6.2. Running Subscriber Application .................................................................................... 13
6.3. Running AWS Shadow Application ................................................................................ 16

Type1LD AWS IoT Core Quick Start Guide
Page 4
1. About this Document
1.1. Purpose and Scope
This document provides instructions to communicate with AWS IoT Core on Murata Type1LD EVB.
1.2. Prerequisites
In this guide, it is assumed that you are familiar with WICED SDK. You do not need to be a WICED master, but
if you do not know these things, please check Type1LD Evaluation Board Quick Start Guide before moving
forward.
•How to create new MakeTarget on WICED SDK
•How to run snip.scan example application on Type1LD EVB
•How to see UART output from snip.scan example application onTera Term, Putty, etc.
It is also assumed that you have AWS account and you can access AWS IoT Console.
2. Evaluation Board
Verify pin setting for correct operation as below.
External Flash
External
32k xtal
Reset Switch

Type1LD AWS IoT Core Quick Start Guide
Page 5
3. Setting up AWS IoT Core
A. Visit AWS IoT Core Console and select Manage - Things from the left menu, then click Register a thing
button.
B. Click Create a single thing button.
C. Type “testThing” in the Name filed, then scroll down and click Next button.

Type1LD AWS IoT Core Quick Start Guide
Page 6
D. Click Create certificate button
E. Download all of files and save them in a safe place. Make sure that you download private key and
public key as they cannot be retrieved after you close this page.
F. Regarding root CA for AWS IoT, download RSA 2048 bit key: Amazon Root CA 1.

Type1LD AWS IoT Core Quick Start Guide
Page 7
G. After making sure you have downloaded private key and public key (and certificate and Amazon root
CA), scroll down and click Activate button, then click Done button.
H. Select Secure - Policies from left menu and click Create policy button.

Type1LD AWS IoT Core Quick Start Guide
Page 8
I. Type “iot:*” in the Action filed, “*” in the Resource ARN field, check Allow and click Create button.
J. Click Secure - Certificates from left menu then click three dots menu on your certificate, and then
click Attach policy.
K. Check testPolicy you just created and click Attach button.

Type1LD AWS IoT Core Quick Start Guide
Page 9
4. Setting up Certificate Files for WICED
You have module certificate and Amazon certificate in previous section “3. Setting up AWS IoT Core”.
Rename these files to fit with WICED configuration and place them in the appropriate folder as below.
*You must have unique characters for xxxxxxxxxx.
File
Rename to
Location
AmazonRootCA1.pem
rootca.cer
•43xxx_Wi-Fi\resources\apps\aws\iot
xxxxxxxxxx-private.pem.key
privkey.cer
•43xxx_Wi-Fi\resources\apps\aws\iot\publisher
•43xxx_Wi-Fi\resources\apps\aws\iot\subscriber
xxxxxxxxxx-certificate.pem.crt
client.cer
•43xxx_Wi-Fi\resources\apps\aws\iot\publisher
•43xxx_Wi-Fi\resources\apps\aws\iot\subscriber
Note: WICED folder is at “C:\Users\<user name>\Documents\WICED-Studio-<VERSION>” with default
installation.
5. Checking Your AWS Endpoint
Visit AWS IoT Core Console and select Settings from the left menu, then copy the Endpoint. You need this in
later sections.

Type1LD AWS IoT Core Quick Start Guide
Page 10
6. Running Applications
6.1. Running Publisher Application
This is Wirelss Wall Switch example which publishes messages as “WICED_BULB” topic when you push SW1.
A) Open WICED IDE
B) Open 43xxx_Wi-Fi\apps\demo\aws\iot\pub_sub\publisher\publisher.c and update the endpoint with
yours. If you do not know your endpoint, please check “5. Checking Your AWS Endpoint”.
C) Open 43xxx_Wi-Fi\apps\demo\aws\iot\pub_sub\publisher\wifi_config_dct.h and update
CLIENT_AP_SSID, CLIENT_AP_PASSPHRASE and CLIENT_AP_SECURITY to match with your access point
you will use.
D) Open 43xxx_Wi-Fi\apps\demo\aws\iot\pub_sub\publisher\publisher.mk and add MurataType1LD as a
VALID_PLATFORMS.

Type1LD AWS IoT Core Quick Start Guide
Page 11
E) Click New Make Target button and create new Make Target as below
demo.aws.iot.pub_sub.publisher-MurataType1LD download download_apps run
F) Double click “clean” from the Make Target to make sure you will have the latest files included.
G) Double click the Make Target you just created.
H) While you are waiting the build to complete, open your appropriate COM port with terminal tool such
as TeraTerm and set baud rate as 115200bps
I) Wait for a while to complete the build, then you will see Connection Successful message as below.

Type1LD AWS IoT Core Quick Start Guide
Page 12
J) Visit AWS IoT Core Console and select Test from the left menu, then type “WICED_BULB” in the
Subscripton topic field, then click Subscribe to topic button.
K) Push SW1 on 1LD EVB.
L) You will see “LIGHT ON”/”LIGHT OFF” messages on your browser.
SW1

Type1LD AWS IoT Core Quick Start Guide
Page 13
6.2. Running Subscriber Application
This is Wirelss Light Buld example which subscribes “WICED_BULB” topic and turn on/off LED1.
A) Open WICED IDE
Open 43xxx_Wi-Fi\apps\demo\aws\iot\pub_sub\subscriber\subscriber.c and update the endpoint
with yours. If you do not know your endpoint, please check “5. Checking Your AWS Endpoint”.
B) Open 43xxx_Wi-Fi\apps\demo\aws\iot\pub_sub\subscriber\wifi_config_dct.h and update
CLIENT_AP_SSID, CLIENT_AP_PASSPHRASE and CLIENT_AP_SECURITY to match with your access point
you will use.
C) Open 43xxx_Wi-Fi\apps\demo\aws\iot\pub_sub\subscriber\subscriber.mk and add MurataType1LD as
a VALID_PLATFORMS.

Type1LD AWS IoT Core Quick Start Guide
Page 14
D) Click New Make Target button and create new Make Target as below
demo.aws.iot.pub_sub.subscriber-MurataType1LD download download_apps run
E) Double click “clean” from the Make Target to make sure you will have the latest files included.
F) Double click the Make Target you just created.
G) While you are waiting the build to complete, open your appropriate COM port with terminal tool such
as TeraTerm and set baud rate as 115200bps
H) Wait for a while to complete the build, then you will see Connection Successful message as below.

Type1LD AWS IoT Core Quick Start Guide
Page 15
I) Visit AWS IoT Core Console and select Test from the left menu, then click Publish to a topic.
J) Type “WICED_BULB” in the topic field and “LIGHT ON” in the message field, then click Publish to topic
button.
K) You will see “light on” on your Tera Term and LED1 on EVB turned on. You can send “LIGHT OFF”
message to turn of the LED.
LED1

Type1LD AWS IoT Core Quick Start Guide
Page 16
6.3. Running AWS Shadow Application
This is Wirelss Light Buld example which has Shadow on AWS IoT and turn on/off LED1 with WiFi initialization
steps as SoftAP.
A) Open WICED IDE
B) Open 43xxx_Wi-Fi\apps\demo\aws\iot\shadow\thing_shadow\shadow.c and update the endpoint
with yours. If you do not know your endpoint, please check “5. Checking Your AWS Endpoint”.
C) Open 43xxx_Wi-Fi\apps\demo\aws\iot\shadow\thing_shadow\thing_shadow.mk and add
MurataType1LD as a VALID_PLATFORMS.

Type1LD AWS IoT Core Quick Start Guide
Page 17
D) Click New Make Target button and create new Make Target as below
demo.aws.iot.shadow.thing_shadow-MurataType1LD download download_apps run
M) Double click the Make Target you just created.
N) While you are waiting the build to complete, open your appropriate COM port with terminal tool such
as TeraTerm and set baud rate as 115200bps
E) Wait for a while to complete the build, then you will see below.
F) 1LD is now configured in soft-AP mode. Connect to the SSID WICED_AWS, from your laptop using the
Password in the terminal.

Type1LD AWS IoT Core Quick Start Guide
Page 18
G) Open the web browser and access the URL http://192.168.0.1
H) Type “testThing” in the Thing Name filed and click Save Settings button. Thing Name must match with
the name you created on AWS IoT Core Console.
I) Click the first Choose File button and select 43xxx_Wi-Fi\resources\apps\aws\iot\subscriber\client.cer,
then click Upload Certificate button.
Then click the second Choose File button and select 43xxx_Wi-
Fi\resources\apps\aws\iot\subscriber\privkey.cer, then click Upload key button.
Note) In some environment, Chrome doesn’t work fine. Please try Firefox instead if you see this error
message in later step: [Shadow] Failed to Initialize Wiced AWS library

Type1LD AWS IoT Core Quick Start Guide
Page 19
J) Click Wi-Fi Setup > button, then select SSID of your access point and type the password. Click Connect
button.
K) 1LD will restart.
L) Once 1LD is restarted, you shall see the below
Note) In some environment, Chrome fails uploading certificate and private key in step I). If you see this
error message, please try Firefox instead: [Shadow] Failed to Initialize Wiced AWS library

Type1LD AWS IoT Core Quick Start Guide
Page 20
M) Visit AWS IoT Core Console and select Manage - Things from the left menu, then click testThing.
N) You will see below if everything is going well. Click Edit to update 1LD status.
O) Confirm the desired status is ON, then click Save.