Murata ABR User manual

Version :
Author :
Document ID :
Release Date :
0.2.0
SyChip Engineering
S10204
August 11, 2020
Notice
Murata reserves the right to make changes in specifications at anytime and without notice. The information
furnished in this data sheet is believed to be accurate and reliable. However, no responsibility is assumed by
Murata for its use,no any infringements of patents or other rights of third parties resulting from its use.
No license is generated under any rights of Murata or its supporters unless specifically agreed.
Preliminary & Public
Murata Manufacturing Co., Ltd.
TypeABR AWS FreeRTOS SDK
Getting Started Guide
Document ID : S10204
User manual

i
CONTENTS
1 Introduction 2
1.1 Scope......................................................................................................................................................2
1.2 Audience.................................................................................................................................................2
1.3 Contact Information and Support...........................................................................................................2
1.4 Text Conventions....................................................................................................................................2
1.5 Acronyms ...............................................................................................................................................3
1.6 Related Documents.................................................................................................................................3
2 Overview 4
2.1 System Diagram .....................................................................................................................................4
2.2 Preparation .............................................................................................................................................5
2.2.1 Hardware Preparation...............................................................................................................5
2.2.2 Software Preparation ................................................................................................................5
2.3 AWS IoT Settings...................................................................................................................................5
2.3.1 AWS account and permissions..................................................................................................5
2.3.2 Register with AWS IoT.............................................................................................................5
3 Build The AWS FreeeRTOS SDK 6
3.1 Set up development environment............................................................................................................6
3.2 Get the AWS FreeeRTOS SDK ..............................................................................................................6
3.3 AWS FreeeRTOS SDK Modifications....................................................................................................7
3.4 Build the AWS demos firmware .............................................................................................................8
4 Run the Firmware 9
4.1 Download the firmwares.........................................................................................................................9
4.2 Run the FreeRTOS demo project............................................................................................................9
4.3 Monitoring MQTT messages on the cloud........................................................................................... 10
5 LastWillAndTestament 11
5.1 Reference Solution ...............................................................................................................................11
5.2 Reference Patches................................................................................................................................. 13
5.3 Reference Running Logs......................................................................................................................13
6 PRECONDITION TO USE OUR PRODUCTS 14

CONTENTS
1
TypeABR AWS FreeRTOS SDK Getting Started Guide
Revision History
Revision
Date
Description
V0.1.0
2020-06-17
• Initial version.
V0.2.0
2020-08-11
• Add the section for LastWillAndTestament test case.
• Revise for public release.

2
CHAPTER
ONE
INTRODUCTION
1.1 Scope
This document provides instructions about how to use AWS FreeRTOS SDK to build the AWS Demo and Run the
AWS Demo on Murata TypeABR module.
1.2 Audience
This document is intended for software/firmware engineers to evaluate AWS IOT with Murata TypeABR module.
1.3 Contact Information and Support
For general contact, technical support services, technical questions and report documentation errors contact Mu-
rata Technical Support window. Please keep us informed of your comments and suggestions for improvements.
Murata will take into consideration any and all feedback from the users of this information.
1.4 Text Conventions
Tip: Provides advice and suggestions that may be useful when using the product.
Note: Provides note admonitions that should be took into considerations when using the product.
Caution: Alerts the user to important points about using the product; if these points are not followed, the
product and end user equipment may fail or malfunction.
Danger: This information MUST be followed or catastrophic equipment failure or bodily injury may occur.

1.5. Acronyms
3
TypeABR AWS FreeRTOS SDK Getting Started Guide
1.5 Acronyms
Abbr.
Description
EVB
EvaluationBoard
1.6 Related Documents
• [DS]TypeABR_Module_Datasheet.pdf,Murata
• [UG] CMWC1ZZABR EVB Hardware Manual.pdf, Murata
• [AN]S10093-TypeABR_Firmware_Upgrade_Guide.pdf,Murata

4
CHAPTER
TWO
OVERVIEW
This tutorial contains instructions for the following getting started steps:
1. Required preparation materials.
2. Connecting your board to a host machine.
3. Installing software on the host machine for developing and debugging embedded applications.
4. Cross-compiling a FreeRTOS demo application to a binary image.
5. Loading the application binary image to your board and then running the application.
6. Interacting with the application running on your board across a serial connection for monitoring and debug-
ging purposes.
2.1 System Diagram
The typical system diagram shown as below:
Fig. 2.1: System Diagram

2.2. Preparation
5
TypeABR AWS FreeRTOS SDK Getting Started Guide
2.2 Preparation
2.2.1 HardwarePreparation
Table 2.1: Hardware Preparation
Name
Quantity
Comment
TypeABR EVB
1
TypeABR Evaluation Kit
USB-to-UART adaptor& cable
1
Monitoring the log
J-Link
1
JTAG adaptor for loading image
Laptop with Ubuntu/Linux OS
1
Host machine for cross-compiling and load image
AP Router
1
Provide Internet access to AWS Cloud Server
2.2.2 SoftwarePreparation
Table 2.2: Software Preparation
Name
Quantity
Comment
Tera Term
1
Or similar serial terminals.
2.3 AWS IoT Settings
2.3.1 AWS account and permissions
You need an AWS account, an IAM user with permission to access AWS IoT and FreeRTOS cloud services.
Please complete the instructions in Setting up your AWS account and permissions .
2.3.2 Register with AWS IoT
To register your board with AWS IoT, you need the following:
An AWS IoT policy The AWS IoT policy grants your device permissions to access AWS IoT resources. It is
stored on the AWS Cloud.
An AWS IoT thing An AWS IoT thing allows you to manage your devices in AWS IoT. It is stored on the AWS
Cloud.
A private key and X.509 certificate The private key and certificate allow your device to authenticate with AWS
IoT.
Please follow the procedures in Registering your MCU board with AWS IoT to register your board manually.

6
CHAPTER
THREE
BUILD THE AWS FREEERTOS SDK
The below steps were verified on Ubuntu x86_64 GNU/Linux OS.
3.1 Set up development environment
1. Install the required packages
2. Install the gcc-arm-none-eabi toolchain.
3. make sure that the cmake version is after 3.15 and python version is 2.7
Note: You can download the latest version of CMake from CMake.org . Both source and binary distributions are
available.
You can download the specific release of Python from Python.org .
3.2 Get the AWS FreeeRTOS SDK
Clone the amazon-freertos from gitub
git clone [email protected]:aws/amazon-freertos.git
cd amazon-freertos
git checkout origin/202002.00 -b 202002.00
git submodule update --init --recursive
cd ..
python --version
Python 2.7.17
cmake --version
cmake version 3.15.3
wget https://launchpad.net/gcc-arm-embedded/4.9/4.9-2015-q3-update/+download/gcc-
C→arm-none-eabi-4_9-2015q3-20150921-linux.tar.bz2
tar -vxf gcc-arm-none-eabi-4_9-2015q3-20150921-linux.tar.bz2
# Add gcc-arm-none-eabi-gcc toolchain to System PATH
PATH="$PATH:~/gcc-arm-none-eabit-4_9_2015_q3/bin"
sudo apt-get install lib32ncursesw5 lib32z1 lib32ncurses5 libbz2-1.0:i386
C→
libncurses5-dev lib32ncurses5-dev libncursesw5-dev

3.3. AWS FreeeRTOS SDK Modifications
7
TypeABR AWS FreeRTOS SDK Getting Started Guide
3.3 AWS FreeeRTOS SDK Modifications
1. Modify board file for TypeABR module
Modifybelowsettingsinmw300_rd.clocatedinaws_freertos/vendors/marvell/WMSDK/mw320/sdk/src/boards
51
52
53
54
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
2. Modify the WiFi AP SSID and PASSWORD in SDK
Modifybelowsettingsinamazon-freertos/demos/include/aws_clientcredential.h
58 #define clientcredentialWIFI_SSID
"TestAP"
64 #define clientcredentialWIFI_PASSWORD "12345678"
Modify the security if needed.
74 #define clientcredentialWIFI_SECURITY
eWiFiSecurityWPA2
3. Modify the AWS Ting Name and endpoint in SDK
Modifybelowsettingsinamazon-freertos/demos/include/aws_clientcredential.h
34
41
4. Modify AWS Thing cert and private key
modify below setting in amazon-freertos/demos/include/aws_clientcredential_keys.h with the cert and private
key download from AWS-IoT.
39
#define keyCLIENT_CERTIFICATE_PEM
"-----BEGIN CERTIFICATE-----\n"\
40
"...base64 data...\n"\
41
"-----END CERTIFICATE-----\n"
void
board_uart_pin_config(
int
id)
{ switch (id)
{ case UART0_ID:
GPIO_PinMuxFun(GPIO_2, GPIO2_UART0_TXD);
GPIO_PinMuxFun(GPIO_3, GPIO3_UART0_RXD);
GPIO_PinMuxFun(GPIO_0, GPIO0_UART0_CTSn);
GPIO_PinMuxFun(GPIO_1, GPIO1_UART0_RTSn);
break;
case UART1_ID:
break;
case UART2_ID:
break;
}
}
#define clientcredentialMQTT_BROKER_ENDPOINT
C→
ap-northeast-1.amazonaws.com"
"xxxxxxxxxxxxxx-ats.iot.
return false;
int
board_32k_osc()
{
}
/* Not implemented yet */
GPIO_PinMuxFun(GPIO_48, GPIO48_UART2_TXD);
GPIO_PinMuxFun(GPIO_49, GPIO49_UART2_RXD);
#define clientcredentialIOT_THING_NAME "aws_demo_led"

8
3.4. Build the AWS demos firmware
TypeABR AWS FreeRTOS SDK Getting Started Guide
60
#define keyCLIENT_PRIVATE_KEY_PEM
"-----BEGIN CERTIFICATE-----\n"\
61
"...base64 data...\n"\
62
"-----END CERTIFICATE-----\n"
3.4 Build the AWS demos firmware
The firmware file aws_demos.bin is located in build after below commands.
cd amazon-freertos
cmake -DVENDOR=marvell -DBOARD=mw320 -DCOMPILER=arm-gcc -S . -B build -DAFR_ENABLE_
C→ TESTS=0
cd build
make all -j4