Table of Contents
Advertisement
Quick Links
AT&T IoT Starter Kit (LTE-M, STM32L4)
Getting Started Guide
Version 1.3
o STM32L4 Discovery Kit IoT Node
o Avnet M14A2A WNC Cellular Shield
o AT&T Flow Designer
© 2018 Avnet. All rights reserved. All trademarks and registered trademarks are the property of their respective owners. All specifications are subject to change without notice.
NOTICE OF DISCLAIMER: Avnet is providing this design, code, or information "as is." By providing the design, code, or information as one possible implementation of this
feature, application, or standard, Avnet makes no representation that this implementation is free from any claims of infringement. You are responsible for obtaining any rights
you may require for your implementation. Avnet expressly disclaims any warranty whatsoever with respect to the adequacy of the implementation, including but not limited to
any warranties or representations that this implementation is free from claims of infringement and any implied warranties of merchantability or fitness for a particular purpose.
Page 1
Advertisement
Table of Contents
Related Manuals for Avnet AT&T IoT Starter Kit
Summary of Contents for Avnet AT&T IoT Starter Kit
- Page 1 AT&T Flow Designer © 2018 Avnet. All rights reserved. All trademarks and registered trademarks are the property of their respective owners. All specifications are subject to change without notice. NOTICE OF DISCLAIMER: Avnet is providing this design, code, or information "as is." By providing the design, code, or information as one possible implementation of this feature, application, or standard, Avnet makes no representation that this implementation is free from any claims of infringement.
- Page 2 - Missing diagrams Draft 0.3 01/17/2018 Typo corrections 02/22/2018 First release - Updated Kit name and Avnet shield name - Updated and added missing figures 03/07/2018 Formatted to Avnet document template 03/14/2018 Keil MDK installation and licensing section updated 06/11/2018 - References to starterkit.att.com now corrected to...
-
Page 3: Table Of Contents
Contents Introduction ......................... 5 Starter Kit Contents ..................... 5 STMicroelectronics STM32L4 Discovery Kit IoT Node ..........7 Avnet M14A2A LTE Cellular Shield ................8 WNC Module Firmware ....................9 ARM Keil IDE ......................9 Keil Software Download ....................9 Install Keil License..................... 10 Use Pack Installer to Add STM32L475VGT to the Keil Tools ........ - Page 4 Figure 10 – How To Launch Flow From AT&T Menu ................. 14 Figure 11 - Accessing AT&T Flow Community Projects ................14 Figure 12 - Search for Avnet STM32L4 IoT Kit Project ................15 Figure 13 - Forking the Avnet STM32L4 IoT Kit Project ................15 Figure 14 - Deploying the Project .......................
-
Page 5: Introduction
The IoT Starter Kit consists of a hardware platform comprised of a STMicroelectronics STM32L4 Discovery Kit IoT Node board plus an Avnet Arduino-compatible WNC M14A2A Cellular modem shield, stacked onto it. The modem sends/receives data via cellular data link back to the AT&T M2X/Flow website. -
Page 6: Figure 2 - At&T Iot Starter Kit (Lte-M, Stm32L4) Contents
AT&T Starter SIM 1 LTE Blade Antenna 2 micro USB cables 5V DC power adapter to power Avnet WNC M14A2A Cellular Shield Quick Start Card Downloadable example designs and tutorials available at: http://cloudconnectkits.org/product/att-stm32-iot-starter-kit ... -
Page 7: Stmicroelectronics Stm32L4 Discovery Kit Iot Node
STMicroelectronics STM32L4 Discovery Kit IoT Node The STM32L4 Discovery Kit IoT Node is the host development and operational platform. It features: An STM32L475VG microcontroller (80 MHz, 1MB Flash, 128kB SRAM) 64-Mbit Quad-SPI Flash memory Bluetooth V4.1 module ®... -
Page 8: Avnet M14A2A Lte Cellular Shield
Avnet M14A2A LTE Cellular Shield The Avnet-designed Arduino Shield is based on 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-M network. The WNC cellular module is controlled/managed via AT commands exchanged using a serial port connection to the STM32L4 Discovery Kit IoT Node. -
Page 9: Wnc Module Firmware
The system-level block diagram for this version of AT&T IoT Starter Kit is shown below: 6 - B IGURE LOCK IAGRAM OF SSEMBLED YSTEM WNC Module Firmware The WNC M14A2A module has been factory programmed with IMA3 firmware for LTE Cat-M1 operation. If there is a need to check this firmware version or reprogram the module, please refer to Appendix-A at the end of this document ARM Keil IDE... -
Page 10: Install Keil License
7 - S KEIL S IGURE CREENSHOT OF OFTWARE OWNLOAD Install Keil License After installing the Keil tools, a license needs to be installed. This IoT Starter kit includes a Product Serial Number (PSN) for a 90-day license for the Keil tools. The key steps in this licensing procedure are summarized below: 1. -
Page 11: Figure 8 - Key Steps In The License Management Dialog
8 - K IGURE TEPS N THE ICENSE ANAGEMENT IALOG Locate the PSN label on the “IoT Starter Kit Quick Start Card” that was included inside the shipping box (this has your unique PSN number authorizing use of the Keil tools for 90-days) 9 - K PSN L IGURE... -
Page 12: Use Pack Installer To Add Stm32L475Vgt To The Keil Tools
7. Returning to the License Management dialog box, locate the field labeled New License ID Code (LIC) and now enter the LIC number received via email, then click Add LIC. Now that a valid license has been installed for the Keil tools, you are ready to start developing your application software for the STM32L4 Discovery Kit IoT Node…... -
Page 13: Create Online Accounts
This is tabled below and step-by-step details provided in the paragraphs that follow: Account Name / Website URL Purpose http://cloudconnectkits.org Avnet support forums, project files and documentation https://marketplace.att.com/quickstart AT&T account registration, SIM activation, Flow, etc access https://www.pubnub.com Real-time data streaming service from AT&T to dashboard https://freeboard.io... -
Page 14: Figure 10 - How To Launch Flow From At&T Menu
25. From lower left side of the Flow IDE, click Resources > Community Projects 11 - A AT&T F IGURE CCESSING OMMUNITY ROJECTS 26. In the main pane under Search Projects, enter Avnet STM32 27. Select Avnet STM32L4 IoT Kit NoM2X Page 14... -
Page 15: Figure 12 - Search For Avnet Stm32L4 Iot Kit Project
28. Click the blue Fork button in the top right to create a copy of the project for your exclusive use. 29. Name your copy of this project (eg. Avnet STM32L4 Kit Test) then click the Fork button inside the... -
Page 16: Figure 14 - Deploying The Project
14 - D IGURE EPLOYING THE ROJECT 31. This causes the project to be compiled and deployed/activated. This step will take a while the first time it is deployed but subsequent deployments are much quicker. 15 - P IGURE ROJECT EPLOYMENT IN ROGRESS 32. -
Page 17: Figure 16 - Steps To Update The Host Name And Url
33. Double click the Configuration function node of the cloned Flow design and then edit the following parameters using the copied base URL (pay attention to the format of these): base_hostname base_uri 16 - S IGURE TEPS TO PDATE THE AME AND 34. -
Page 18: Register A Pubnub Account
Register a PubNub Account Next, a free PubNub account is created to allow Flow to be connected to a dashboard on freeboard.io. 35. Open a new browser tab or window, do not close the Flow window/tab as we will be using it in an upcoming step. -
Page 19: Create A Pubnub Application
Create a PubNub Application Next, we create a new PubNub application and connect it to AT&T Flow: 39. Click Create New App button in the top right of the web page 20 - C IGURE REATE A UBNUB 40. Give the App a name, for example ATT_IoT_Starter_Kit 21 - N IGURE AME THE... -
Page 20: Figure 23 - The Pubnub App Keys
42. Click on the Demo Keyset tile to open the keys 23 - T IGURE UBNUB 43. Rename Demo Keyset to something more meaningful such as STM32L4_DK_IoT 44. Copy the Publish and Subscribe Keys (to a text file) – we will need to add these keys to the Flow project to allow it to publish data to this PubNub app. -
Page 21: Connect At&T Flow To Pubnub
Connect AT&T Flow to PubNub 45. Return to the Flow application and look for a set of 4 nodes that start with a pubnub GET HTTP IN node. Double click on the pubnub_stm32 PUBNUB OUT node to open its parameters pane: 24 - P AT&T F IGURE... -
Page 22: Register A Freeboard.io Account
Register a Freeboard.io Account Next we will create a free account at Freeboard.io to allow us to view data sent by the STM32L4 Discovery Kit IoT Node to the cloud. 51. Open a new browser tab or window (do not close the Flow or PubNub tabs/windows, they will be required in a future step). -
Page 23: Assemble The At&T Iot Kit Hardware
The hardware is delivered as two separate boards. Use the following instructions to connect the boards. 63. Plug the Avnet WNC M14A2A Cellular shield into the Arduino headers on the STM32L4 Discovery Kit IoT Node board, making sure the Arduino pins and headers are correctly aligned 64. -
Page 24: Download And Configure The Example Application
Download and Configure the Example Application 68. Download the Reference Design project listed under the “Startup Files & Reference Designs” tab on the product webpage at: http://cloudconnectkits.org/product/att-stm32-iot-starter-kit 27 - L IGURE OCATING THE EFERENCE ESIGN ROJECT ILES 69. Unzip the project archive to a convenient location on your hard drive. We suggest keeping the path of the project as short to avoid path length limitations. -
Page 25: Figure 29 - Accessing Flow Endpoint Information
72. Double click on main.c to open this file in the editor pane on the right. 73. Scroll down until you reach a line starting with char deviceId[] then assign a device identifier of your choice by replacing the text within the quote marks. 74. -
Page 26: Figure 31 - Saving Files In Keil
78. Save all files by clicking the Save All icon: 31 - S IGURE AVING ILES IN 79. Click the Build button to build your device firmware 32 - B IGURE UILD THE ROJECT 80. If there are no errors, the target binary file will have been built 33 - K IGURE UILD... -
Page 27: Figure 34 - Flash The Mcu On The Stm32L4 Discovery Kit Iot Node
81. You can now flash the STM32L4 Discovery Kit IoT Node board with the firmware by clicking the Download button: 34 - F STM32L4 D IGURE LASH THE ON THE ISCOVERY 82. Successful flashing of the board is indicated by Keil in the Build Output pane: 35 - K IGURE UTPUT... -
Page 28: Verify The Dashboard Visualization
Verify the Dashboard Visualization 36 - D IGURE ASHBOARD HOWING UBLISHED TO THE LOUD FROM TARTER Page 28... -
Page 29: Appendix A - Wnc Module Firmware Update
Appendix A – WNC Module Firmware Update The WNC M14A2A Cellular Module can be configured to run firmware to connect to LTE Cat-1 or LTE-M (LTE Cat-M1) cellular networks. This AT&T IoT Starter Kit (LTE-M, STM32L4) is intended for connection to the AT&T LTE-M network. -
Page 30: Figure 38 - Wnc M14A2A Module Firmware Query - Lte-M (Cat-M1) Firmware
– LTE-M (C 38 - WNC M14A2A M -M1) F IGURE ODULE IRMWARE UERY IRMWARE 8. LTE firmware will have its version number preceded by M14A2A_ as shown in Figure 37 - WNC M14A2A Module Firmware Query – LTE Cat-1 Firmware. If your modem is still configured with LTE Cat-1 firmware you will need to flash your modem with LTE-M firmware by following the steps described in step 10 below. -
Page 31: Appendix B - Sim Management
Appendix B – SIM Management You can monitor the status of your AT&T SIM card(s) from the AT&T Control Center Navigate to this via the User drop-down menu at top-right of AT&T Marketplace webpage On the screen that follows, click on the Launch AT&T Control Center button Once the AT&T Control Center webpage displays, click on Devices to view a listing of your SIMs: Page 31... - Page 32 AT&T Control Center includes useful tools for SIM Status Monitoring and Usage Analytics… Page 32...
Need help?
Do you have a question about the AT&T IoT Starter Kit and is the answer not in the manual?
Questions and answers