AT&T IoT Starter Kit (LTE-M, STM32L4) Getting Started Guide

3y ago
41 Views
2 Downloads
3.16 MB
32 Pages
Last View : 1m ago
Last Download : 3m ago
Upload by : Camden Erdman
Transcription

AT&T IoT Starter Kit (LTE-M, STM32L4)Getting Started GuideVersion 1.3o STM32L4 Discovery Kit IoT Nodeo Avnet M14A2A WNC Cellular Shieldo 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 thisfeature, application, or standard, Avnet makes no representation that this implementation is free from any claims of infringement. You are responsible for obtaining any rightsyou may require for your implementation. Avnet expressly disclaims any warranty whatsoever with respect to the adequacy of the implementation, including but not limited toany 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

Document ControlDocument Version:1.3Document Date:06/11/2018Document Author:Peter FennDocument Classification:PublicDocument Distribution:PublicPrior Version HistoryVersionDateCommentDraft 0.1Draft 0.212/22/201701/15/2018Draft /201806/11/2018Initial DraftAdded:- Support forums- Keil download and licensing instructions- Missing diagramsTypo correctionsFirst release- Updated Kit name and Avnet shield name- Updated and added missing figuresFormatted to Avnet document templateKeil MDK installation and licensing section updated- References to starterkit.att.com now corrected tomarketplace.att.com/quickstart- Procedure added for configuring the cloned AT&T Flow project- Installation of STM32L475VGT device to Keil tools added- Renumbered all procedure steps for easier reference- Appendix B SIM Management section addedPage 2

ContentsIntroduction . 5Starter Kit Contents . 5STMicroelectronics STM32L4 Discovery Kit IoT Node . 7Avnet M14A2A LTE Cellular Shield . 8WNC Module Firmware . 9ARM Keil IDE . 9Keil Software Download . 9Install Keil License. 10Use Pack Installer to Add STM32L475VGT to the Keil Tools . 12Create Online Accounts . 13Register Cloudconnectkits.org Account (Avnet) . 13Register an AT&T Account and Activate the AT&T SIM . 13Clone the AT&T Flow Designer Project . 13Register a PubNub Account . 18Create a PubNub Application . 19Connect AT&T Flow to PubNub . 21Register a Freeboard.io Account . 22Link Freeboard.io to PubNub . 22Assemble the AT&T IoT Kit Hardware. 23Download and Configure the Example Application . 24Verify the Dashboard Visualization. 28Appendix A – WNC Module Firmware Update . 29Appendix B – SIM Management . 31Page 3

FiguresFigure 1 - AT&T IoT Starter Kit (LTE-M, STM32L4) Data Flow . 5Figure 2 - AT&T IoT Starter Kit (LTE-M, STM32L4) Contents . 6Figure 3 - STM32L4 Discovery Kit IoT Node . 7Figure 4 - Avnet WNC M14A2A Cellular Shield . 8Figure 5 - The AT&T IOT Starter Kit Two Board Assembly . 8Figure 6 - Block Diagram of Assembled System . 9Figure 7 - Screenshot of KEIL Software Download Page . 10Figure 8 - Key Steps In the License Management Dialog . 11Figure 9 - Keil PSN Label On The Quick Start Card . 11Figure 10 – How To Launch Flow From AT&T Menu . 14Figure 11 - Accessing AT&T Flow Community Projects . 14Figure 12 - Search for Avnet STM32L4 IoT Kit Project . 15Figure 13 - Forking the Avnet STM32L4 IoT Kit Project . 15Figure 14 - Deploying the Project . 16Figure 15 - Project Deployment in Progress . 16Figure 16 - Steps to Update the Host Name and URL . 17Figure 17 - Pubnub Landing Page . 18Figure 18 - Accessing the Pubnub Registration Page . 18Figure 19 - The Pubnub Registration Form . 18Figure 20 - Create a New Pubnub App . 19Figure 21 - Name the Pubnub App . 19Figure 22 - Opening the Pubnub App . 19Figure 23 - The Pubnub App Keys . 20Figure 24 - Pubnub related nodes in AT&T Flow . 21Figure 25 - Adding the Pubnub Keys to Flow . 21Figure 26 - A Fully Assembled Kit . 23Figure 27 - Locating the Reference Design Project Files . 24Figure 28 - Customizing the Device ID and End Point Address in main.c . 24Figure 29 - Accessing Flow Endpoint Information . 25Figure 30 - Opening the FlowStreamClient.h Header File . 25Figure 31 - Saving Files in Keil . 26Figure 32 - Build the Keil Project . 26Figure 33 - Keil Build Output After a Successful Project Build . 26Figure 34 - Flash the MCU on the STM32L4 Discovery Kit IoT Node . 27Figure 35 - Keil Output Showing Successful Flashing of MCU . 27Figure 36 - Dashboard Showing Data Published to the Cloud from IoT Starter Kit. 28Figure 37 - WNC M14A2A Module Firmware Query – LTE Cat-1 Firmware . 29Figure 38 - WNC M14A2A Module Firmware Query – LTE-M (Cat-M1) Firmware . 30Page 4

IntroductionThis guide provides an overview of the AT&T IoT Starter Kit (LTE-M, STM32L4) hardware and softwareand includes the key steps to quickly begin using this kit.The IoT Starter Kit consists of a hardware platform comprised of a STMicroelectronics STM32L4Discovery 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.The example software provided lets you take measurements using a variety of sensors on the STM32L4Discovery IoT board and send these values to a Freeboard.io dashboard via PubNub and the AT&T FLOWserver.The Firmware is developed and compiled using the ARM Keil MDK tools.Once installed on the STM32L4 microcontroller, the application software uses several interfaces such asI2C, GPIO, and UART to communicate with the various sensors on the IoT board and the cellular modem.Periodically, data is read from the sensors, formatted and sent to the cloud via the cellular modem.Commands, in the form of JSON strings, can be sent back to the IoT Starter Kit from the cloud and instructthe device to control on-board components (such as the user LED for example).System data flow is shown below.FIGURE 1 - AT&T IOT S TARTER KIT (LTE-M, STM32L4) D ATA F LOWStarter Kit ContentsThe kit contains all the elements needed to implement a complete wireless IoT solution. It includes all thecomponents shown and described on the next page Page 5

FIGURE 2 - AT&T IOT S TARTER KIT (LTE-M, STM32L4) C ONTENTS STMicroelectronics STM32L4 Discovery Kit IoT NodeAvnet WNC M14A2A Cellular ShieldAT&T Starter SIM1 LTE Blade Antenna2 micro USB cables5V DC power adapter to power Avnet WNC M14A2A Cellular ShieldQuick Start CardDownloadable example designs and tutorials available ot-starter-kitForum support available via the following sites:Avnet WNC M14A2A Cellular Shield, Reference Design and AT&T related 75 board, ST-LINK, STM32 software libraries, nityKeil MDK tool questions:http://www.keil.com/forumPage 6

STMicroelectronics STM32L4 Discovery Kit IoT NodeThe 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 memoryBluetooth V4.1 moduleSub-GHz low-power-programmable RF moduleWi-Fi module Inventek ISM43362-M3G-L44 (802.11 b/g/n compliant)Dynamic NFC tag2 digital omnidirectional microphones (MP34DT01)Capacitive digital sensor for relative humidity and temperature (HTS221)High-performance 3-axis magnetometer (LIS3MDL)3D accelerometer and 3D gyroscope (LSM6DSL)260-1260 hPa absolute digital output barometer (LPS22HB)Time-of-Flight and gesture-detection sensor (VL53L0X)2 push-buttons (user and reset)USB OTG FS with Micro-AB connectorOn-board ST-LINK/V2-1 debugger/programmerMore information on the STM32 series of microcontrollers from STMicroelectronics can be found at:https://www.st.com/stm32F IGURE 3 - STM32L4 DISCOVERY KIT IOT NODEPage 7

Avnet M14A2A LTE Cellular ShieldThe Avnet-designed Arduino Shield is based on a Wistron NeWeb Corporation (WNC) M14A2A cellularmodule. This module contains all necessary protocol stack functionality needed to establish and maintaina data connection in an LTE-M network. The WNC cellular module is controlled/managed via AT commandsexchanged using a serial port connection to the STM32L4 Discovery Kit IoT Node. This is referred by WNCas a Type III interface to allow support for the 3GPP defined AT commands plus proprietary AT commands.FIGURE 4 - AVNET WNC M14A2A C ELLULAR S HIELDFIGURE 5 - T HE AT&T IOT S TARTER KIT TWO B OARD ASSEMBLYPage 8

The system-level block diagram for this version of AT&T IoT Starter Kit is shown below:FIGURE 6 - BLOCK DIAGRAM OF ASSEMBLED S YSTEMWNC Module FirmwareThe 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-Aat the end of this documentARM Keil IDEThe firmware for the STM32L4 Discovery Kit IoT Node is developed, compiled and debugged usingArm Keil MDK, a full-featured IDE with advanced debugging capabilities and CMSIS library support forthousands of Arm Cortex-M devices. More detail about this professional IDE is available at:http://www2.keil.com/mdk5Keil Software DownloadDownload the Keil tools as follows:1. Go to: https://www.keil.com/demo/eval/arm.htm2. Provide the information requested in the form there and click Submit3. Follow the instructions on the page which follows that, to download and install the Keil tools Page 9

FIGURE 7 - S CREENSHOT OF KEIL S OFTWARE D OWNLOAD P AGEInstall Keil LicenseAfter installing the Keil tools, a license needs to be installed. This IoT Starter kit includes a Product SerialNumber (PSN) for a 90-day license for the Keil tools.The key steps in this licensing procedure are summarized below:1.2.3.4.Right-click on the Keil uVision5 desktop icon and select Run as AdministratorNavigate to Menu / File / License Management Select the Single-Use License tab in the dialog window that appears,Click the Get LIC via Internet button , then click the button OK to register the product.This action opens the License Management page on the Keil web site.Page 10

FIGURE 8 - KEY S TEPS IN THE LICENSE M ANAGEMENT D IALOG5. Locate the PSN label on the “IoT Starter Kit Quick Start Card” that was included inside theshipping box (this has your unique PSN number authorizing use of the Keil tools for 90-days)FIGURE 9 - KEIL PSN L ABEL ON T HE QUICK S TART C ARD6. Enter this 15 character PSN where prompted, together with your contact info and click theSubmit button. An e-mail is sent back with the License ID Code (LIC) within a few minutes.Page 11

7. Returning to the License Management dialog box, locate the field labeled New License IDCode (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 yourapplication software for the STM32L4 Discovery Kit IoT Node If additional detail is required on the license installation procedure, please refer to the Keil se/license sul install.htmUse Pack Installer to Add STM32L475VGT to the Keil Tools8. Launch the Keil IDE, then open the Pack Installer (from the menu icon, or Project Manage)9. Support for the STM32L475VGT device needs to be installed.Download the applicable STM32L4 Device Family Pack m32l475vgtx/eula-container10. Once this has completed, select File Import to import the downloaded DFP file(Keil.STM32L4xx DFP.2.0.0.pack)11. In the Device Installer, select the Devices tab, then enter STM32L475VGT in the search box12. Click on the relevant Unpack buttons in the right-hand panel and then exit the Device Installeronce this has completedPage 12

Create Online AccountsTo implement the out-of-box example, the following is required:a) Accounts need to be set-up on four websitesb) An AT&T SIM card needs to be activatedThis is tabled below and step-by-step details provided in the paragraphs that follow:Account Name / Website eeboard.ioPurposeAvnet support forums, project files and documentationAT&T account registration, SIM activation, Flow, etc accessReal-time data streaming service from AT&T to dashboardBrowser-based dashboard visualization of measurement dataRegister Cloudconnectkits.org Account (Avnet)13.14.15.16.Navigate to http://cloudconnectkits.orgPress the Sign In/Register button. A drop-down appears from which you can create an account.When asked for Serial Kit Number, use the WNC Serial Number (S/N) as shown below.Once registered, you are logged in and a confirmation email is sent to your email address.17. Select the AT&T IoT Starter Kit (LTE-M, STM32L4) webpage for access to this kit’s designdocumentation, bill of materials, reference designs and other t-stm32-iot-starter-kitRegister an AT&T Account and Activate the AT&T SIM18.19.20.21.Navigate to https://marketplace.att.com/quickstartClick-on Login then Signup (top right corner of webpage)Complete the AT&T IoT Platform Account Signup form then click the Create Account buttonOnce logged-into your new account, select Management Register SIMs from the menu at thetop of the webpage22. Type-in the SIM Card’s ICCID (20 digit number printed on the SIM card) into the form and providea descriptive nickname for this SIM23. Click the Register SIMs button(150 MB data and 150 SMS messages has now been allocated to the Starter SIM account)Clone the AT&T Flow Designer ProjectBefore proceeding with setup of a PubNub account, it is recommended to complete the initial setup of theAT&T Flow project that will be needed for the reference design.Flow is a GUI-based IoT development tool based on NodeJS. It allows for data input and output alongwith user defined rules (for additional information on Flow, see https://flow.att.com/start )Flow can be located via drop-down menu from your AT&T IoT Platform account,or accessed directly using https://flow.att.ioPage 13

FIGURE 10 – H OW T O L AUNCH F LOW FROM AT&T M ENUAn existing Flow project will now be cloned and unique endpoint addresses and account keys added:24. Navigate to https://flow.att.io/ and login using your AT&T account credentials25. From lower left side of the Flow IDE, click Resources Community ProjectsFIGURE 11 - ACCESSING AT&T FLOW COMMUNITY PROJECTS26. In the main pane under Search Projects, enter Avnet STM3227. Select Avnet STM32L4 IoT Kit NoM2XPage 14

FIGURE 12 - SEARCH FOR AVNET STM32L4 IOT KIT P ROJECT28. 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 thedialog boxFIGURE 13 - F ORKING THE AVNET STM32L4 IOT KIT P ROJECT30. On

This guide provides an overview of the AT&T IoT Starter Kit (LTE-M, STM32L4) hardware and software and includes the key steps to quickly begin using this kit. The IoT Starter Kit consists of a hardware platform comprised of a STMicroelectronics STM32L4

Related Documents:

2 Valve body KIT M100201 KIT M100204 KIT M100211 KIT M100211 KIT M100218 KIT M300222 7 Intermediate cover (double diaphragm) - - - KIT M110098 KIT M110100 KIT M110101 4 Top cover KIT M110082 KIT M110086 KIT M110092 KIT M110082 KIT M110082 KIT M110082 5 Diaphragm KIT DB 16/G KIT DB 18/G KIT DB 112/G - - - 5 Viton Diaphragm KIT DB 16V/S KIT

Arduino Starter Kit —Grove-Starter Kit For someone first dabbling in the world of Arduino, the Grove-Starter Kit is an excellent choice in the journey of learning. This kit includes a variety of basic input and output modules and se

The SSD1928 evaluation kit is sold with optional iHirose FX10A socket for Microchip PIC32 Starter Kits. All current models of the starter kits are supported, including PIC32MX GP Starter Kit, PIC32MX USB Starter Kit (I/II), and PIC32MX Ethernet Starter Kit. Two screens are included in every kit. They are 3.5" QVGA (320x240) display in 8-bit .

SAP Cloud Platform Internet of Things Device Management Your Gateway System Environment Cloud Platform PaaSeg., HANA, Kafka, PostgreSQL App User Admin IoT Core Service IoT Message Management Service Your IoT Data IoT service IoT Gateway Edge Devices Device 1 Device 2 Device 3 IoT Gateway Cloud IoT Service Cockpit Send and receive

MINOR DEGREE IN INTERNET OF THINGS (IoT) (DRAFT SYLLABUS) Course Structure Sr. No. Semester Temp. Course Code Course Title L T P Credits 1. 3 IoT-1 Introduction to Internet of Things 3 0 2 4 2. 4 IoT-2 IoT Protocols 3 0 2 4 3. 5 IoT-3 IoT System Design 3 0 2 4 4. 6 IoT-4 Industry 4.0 and IIoT 3 0 2 4 5.

The potentiometer output is connected to the terminal AI0 Yotta A-1010. 2 IOT STARTER KIT hardware 2.5.6 Voltmeter The IOT Starter Kit includes analog voltmeter with 0-10 V graduated scale. It measures the signal strength, set by the user, on a scale of 0-10 V, and provides st

It can be the PIC32 GP Starter Kit (DM320001), PIC32 USB Starter Kit II (DM320003-2), or PIC32 Ethernet Starter Kit (DM320004). A PC compatible system running Microsoft Windows XP SP2 or above Two USB ports on the PC, one for USB-UART bridge for program debug, and the other USB port for PIC32 Starter Kit.

Abrasive water jet machining experiments conducted on carbon fibre composites. This work reported that standoff distance was the significant parameter which - reduced the surface roughness and the minimum of 1.53 µm surface roughness was obtained [31]. Garnet abrasive particles was used for machining prepreg laminates reinforced with carbon fiber using the epoxy polymer resin matrix (120 .