Avnet AT&T Cellular IoT Kit User manual

Page 1
Copyright © 2017 Avnet, Inc. AVNET, “Reach Further,” and the AV logo are registered
trademarks of Avnet, Inc. All other brands are the property of their respective owners.
LIT# 5176-GSG-ATT-IOT_v1
AT&T Cellular IoT Kit
Getting Started Guide
Version 1.3

Page 2
Revision History
Document Version:
Version 1.3
Document Date:
11/29/2016
Prior Version History:
Version:
Date:
Comment:
1.0
2016/08/18
Initial Release
1.1
2016/08/25
URL corrections
1.2
2016/11/10
Updated URL correction for OOB demo
1.3
2016/11/29
Added firmware upgrade topic, point to AT&Ts
web-site, point to Avnet ARM mbed website.
Comments:

Page 3
Contents
Revision History ..........................................................................................................2
Introduction .................................................................................................................4
Kit Contents....................................................................................................................................5
NXT FRDM-K64F Single Board Computer (SBC)............................................................................6
WNC-Shield Board .........................................................................................................................6
IoT Kit Software..............................................................................................................................7
Cellular Shield WNC 14A2A Firmware ............................................................................................7
Creating Online Accounts............................................................................................7
Cloudconnectkits.org Account.........................................................................................................7
Jasper Account for SIM Card..........................................................................................................9
ARM mbed.org Account................................................................................................................ 11
AT&T Flow and M2X Accounts......................................................................................................11
Flow Account ................................................................................................................12
M2X Account.................................................................................................................14
Connect Flow and M2X.................................................................................................15
Assembling the AT&T IoT Kit Hardware....................................................................19
SBC Firmware.............................................................................................................................. 20
Importing, Compiling, and Programming AT&T IoT Kit Software ..............................21
Compiling .....................................................................................................................................21
Programming................................................................................................................................24
Running Example Software.......................................................................................25
Install the COM driver (Windows)..................................................................................................25
Install/Setup of Terminal Program.................................................................................................27
Running the IoT Flow and M2X Program.......................................................................................27
Getting Help and Support..........................................................................................28
Appendix A: Extending Shield Card Capabilities with External Sensors ...................29
Silicon Labs PMOD Sensor Auxiliary Board ..................................................................................29
Seeedstudio Xadow v2 GPS module.............................................................................................29
FRDM-K64F Software Modifications .............................................................................................30
Appendix B: Charting/Graphing Capabilities.............................................................31
Appendix C: M2X TRIGGERS...................................................................................33
Appendix D: Data Processing in Flow.......................................................................35
Appendix E: Avnet ARM mbed C++ Libraries and Example Programs ....................36

Page 4
Introduction
This guide provides an overview of the Avnet AT&T Cellular IoT Starter Kit hardware and
software. The guide includes steps that allow you to quickly begin using the kit. The example
software lets you take measurements using various sensors and send the values to the AT&T
M2X/Flow server. Commands, in the form of JSON strings, are sent back to the IoT Starter Kit
from the cloud and instruct the device to control on-board components such as the user LED.
The IoT Starter Kit consists of a hardware platform comprised of an NXP FRDM-K64F single-
board computer (SBC) and an Avnet Arduino-compatible WNC Cellular modem shield mounted
on top. The WNC modem sends/receives data via cellular data link back to the AT&T M2X/Flow
website. System data flow is shown below.
M2X FLOW
Data to
WNC
Module
LTE Cat1
I2C Data From HTS221
Sensor and WNC
Module

Page 5
Kit Contents
The kit contains all the elements needed to implement a complete wireless IoT solution. It
includes all the components shown and described below:
–AT&T IoT SIM Starter Pack
–Quick Start Card
–Downloadable example designs and tutorials
–Forum support via:
http://cloudconnectkits.org/forum/topic/att-cellular-iot-starter-kit
Arduino compatible WNC-Shield
NXP K64F MCU carrier board with
Arduino™ R3 expansion slot
2 LTE antennas
2 USB cables
AC power adapter to USB DC 5V

Page 6
NXT FRDM-K64F Single Board Computer (SBC)
The NXP FRDM-K64F SBC is the host development and operational platform (the controller).
The elements used by the IoT Kit are as follows:
–MK64FN1M0VLL12 MCU (120 MHz, 1 MB flash memory, 256
KB RAM, USB) which is based on a Cortex M4 ARM processor
core
–RGB LED
–The OpenSDAv2 debug circuit supporting the CMSIS-DAP
Interface to allow programming and monitoring software
–Serial port interface
–I2C interface for communicating with off-board sensors
–UART interface for communicating with the WNC-Shield card
WNC-Shield Board
Avnet has produced an Arduino Shield with a Wistron NeWeb
Corporation (WNC) M14A2A cellular module. This module
contains all necessary protocol stack functionality needed to
establish and maintain a data connection in an LTE network.
The WNC cellular module is controlled/managed via AT
commands exchanged using a serial port connection to the
FRDM-K64F. This is referred by WNC as a Type III interface
to allow support for the 3GPP defined AT commands plus
proprietary AT commands.
The block diagram for the WNC-Shield is shown below:

Page 7
IoT Kit Software
The NXP FRDM-K64F SBC uses the ARM mBed operating software and associated
development tools. This allows all development to take place in a Web browser (e.g., Firefox,
Chrome, or Explorer) and removes the need to install tools on your PC. Once installed on the
Freedom board, the software uses various interfaces such as I2C, GPIOs, and UARTS.
At power up, the software configures the hardware and initializes the WNC-Shield card which
can take up to 60 seconds to complete.
Cellular Shield WNC 14A2A Firmware
Before assembling the kit or proceeding to the next steps, please ensure you are using the
latest WNC 14A2A firmware. Instructions for how to upgrade the firmware can be found on the
AT&T website:
https://starterkit.att.com/tutorials/cellular-shield-firmware-upgrade
Note: Please carefully read all of the instructions before performing the firmware upgrade, there
are several steps that are not intuitive.
Creating Online Accounts
There are five accounts required to use the IoT Kit:
1. Cloudconnectkits.org account for kit registration
2. Jasper account for SIM card registration
3. ARM Mbed.org account for compiling and modifying the SBC/WNC-Shield software
4. AT&T Flow account for implementing the sensor data
5. AT&T M2X account for an end-point device used by Flow. Essentially, this is the location where
sensor data is stored to and read from.
Cloudconnectkits.org Account
After obtaining the IoT Kit, it is best to register at www.cloudconnectkits.org to be aware of any
firmware/software updates as well as other information.
1. Navigate to www.cloudconnectkits.org .
2. Press the Sign In/Register button. A drop-down appears from which you can create an account.

Page 8
3. When asked for the Serial Kit Number, use the WNC Serial Number (S/N) as shown below.
4. Once registered, you are logged into the site. A confirmation email is sent to the email address you
provided. You now have access to several product support pages as shown.

Page 9
From the AT&T Cellular IoT Starter Kit page, you can view much of the kit’s design
documentation, bill of materials, and other information.
Jasper Account for SIM Card
You have a choice between purchasing a SIM Card or a complete hardware kit. Both choices
come with a data plan and the connectivity API. You must also obtain a free IoT Developer
Services account by registering at https://StarterKit.att.com.
Once registered, the IoT Developer Services account provides 300 MB of data and 300 SMS
messages.

Page 10