background image

 
 
 
 

 

 

© 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 

 

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 

 

Содержание AT&T IoT Starter Kit

Страница 1: ...plementation 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 merchan...

Страница 2: ...17 2018 Typo corrections 1 0 02 22 2018 First release Updated Kit name and Avnet shield name Updated and added missing figures 1 1 03 07 2018 Formatted to Avnet document template 1 2 03 14 2018 Keil MDK installation and licensing section updated 1 3 06 11 2018 References to starterkit att com now corrected to marketplace att com quickstart Procedure added for configuring the cloned AT T Flow proje...

Страница 3: ...ccounts 13 Register Cloudconnectkits org Account Avnet 13 Register an AT T Account and Activate the AT T SIM 13 Clone the AT T Flow Designer Project 13 Register a PubNub Account 18 Create a PubNub Application 19 Connect AT T Flow to PubNub 21 Register a Freeboard io Account 22 Link Freeboard io to PubNub 22 Assemble the AT T IoT Kit Hardware 23 Download and Configure the Example Application 24 Ver...

Страница 4: ... Accessing the Pubnub Registration Page 18 Figure 19 The Pubnub Registration Form 18 Figure 20 Create a New Pubnub App 19 Figure 21 Name the Pubnub App 19 Figure 22 Opening the Pubnub App 19 Figure 23 The Pubnub App Keys 20 Figure 24 Pubnub related nodes in AT T Flow 21 Figure 25 Adding the Pubnub Keys to Flow 21 Figure 26 A Fully Assembled Kit 23 Figure 27 Locating the Reference Design Project Fi...

Страница 5: ... PubNub and the AT T FLOW server 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 as I2C 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 ...

Страница 6: ...ular Shield Quick Start Card Downloadable example designs and tutorials available at http cloudconnectkits org product att stm32 iot starter kit Forum support available via the following sites Avnet WNC M14A2A Cellular Shield Reference Design and AT T related questions http cloudconnectkits org forum STM32L475 board ST LINK STM32 software libraries etc https community st com community stm32 commun...

Страница 7: ...ag 2 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 connector On board ST LINK V2 ...

Страница 8: ...ablish 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 This is referred by WNC as a Type III interface to allow support for the 3GPP defined AT commands plus proprietary AT commands FIGURE 4 AVNET WNC M14A2A CELLULAR SHIELD FIGURE 5 THE AT T IOT STARTER KI...

Страница 9: ...Keil IDE The firmware for the STM32L4 Discovery Kit IoT Node is developed compiled and debugged using Arm Keil MDK a full featured IDE with advanced debugging capabilities and CMSIS library support for thousands of Arm Cortex M devices More detail about this professional IDE is available at http www2 keil com mdk5 Keil Software Download Download the Keil tools as follows 1 Go to https www keil com...

Страница 10: ... the Keil tools The key steps in this licensing procedure are summarized below 1 Right click on the Keil uVision5 desktop icon and select Run as Administrator 2 Navigate to Menu File License Management 3 Select the Single Use License tab in the dialog window that appears 4 Click the Get LIC via Internet button then click the button OK to register the product This action opens the License Managemen...

Страница 11: ...ncluded inside the shipping box this has your unique PSN number authorizing use of the Keil tools for 90 days FIGURE 9 KEIL PSN LABEL ON THE QUICK START CARD 6 Enter this 15 character PSN where prompted together with your contact info and click the Submit button An e mail is sent back with the License ID Code LIC within a few minutes ...

Страница 12: ...e license_sul_install htm Use Pack Installer to Add STM32L475VGT to the Keil Tools 8 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 from http www keil com dd2 stmicroelectronics stm32l475vgtx eula container 10 Once this has completed select File Impo...

Страница 13: ...design documentation bill of materials reference designs and other information http cloudconnectkits org product att stm32 iot starter kit Register an AT T Account and Activate the AT T SIM 18 Navigate to https marketplace att com quickstart 19 Click on Login then Signup top right corner of webpage 20 Complete the AT T IoT Platform Account Signup form then click the Create Account button 21 Once l...

Страница 14: ...s and account keys added 24 Navigate to https flow att io and login using your AT T account credentials 25 From lower left side of the Flow IDE click Resources Community Projects FIGURE 11 ACCESSING AT T FLOW COMMUNITY PROJECTS 26 In the main pane under Search Projects enter Avnet STM32 27 Select Avnet STM32L4 IoT Kit NoM2X ...

Страница 15: ...reate 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 dialog box FIGURE 13 FORKING THE AVNET STM32L4 IOT KIT PROJECT 30 Once the project is copied click the blue Deploy button in top right hand corner of the Flow GUI ...

Страница 16: ...rst time it is deployed but subsequent deployments are much quicker FIGURE 15 PROJECT DEPLOYMENT IN PROGRESS 32 Once the Deploy step has completed locate the unique Base URL address that has been allocated this is visible in the Endpoints panel at bottom of the page Copy this Base URL via the Windows clipboard to a Windows Notebook window ...

Страница 17: ...ned Flow design and then edit the following parameters using the copied base URL pay attention to the format of these base_hostname base_uri FIGURE 16 STEPS TO UPDATE THE HOST NAME AND URL 34 Once sure the edits are correct click on Done and then click on Deploy again ...

Страница 18: ... will be using it in an upcoming step 36 In the new tab window navigate to https www pubnub com and click on Login located in top right area of the web page FIGURE 17 PUBNUB LANDING PAGE 37 Click on No Account Register now located in top right area of the web page FIGURE 18 ACCESSING THE PUBNUB REGISTRATION PAGE 38 Provide the necessary information and click Register FIGURE 19 THE PUBNUB REGISTRAT...

Страница 19: ... connect it to AT T Flow 39 Click Create New App button in the top right of the web page FIGURE 20 CREATE A NEW PUBNUB APP 40 Give the App a name for example ATT_IoT_Starter_Kit FIGURE 21 NAME THE PUBNUB APP 41 Click on the app tile to open the app FIGURE 22 OPENING THE PUBNUB APP ...

Страница 20: ...s FIGURE 23 THE PUBNUB APP KEYS 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 ...

Страница 21: ... pane FIGURE 24 PUBNUB RELATED NODES IN AT T FLOW 46 Click on the Edit button to edit the keys and paste the publish and subscribe keys you obtained from your pubnub application step 39 above into the corresponding locations in this pane FIGURE 25 ADDING THE PUBNUB KEYS TO FLOW 47 Click Update 48 Click Done 49 Click Deploy 50 The Flow PUBNUB OUT node is now configured to communicate with your PubN...

Страница 22: ...ree 30 day trial period is exceeded Link Freeboard io to PubNub 57 Once you have a freeboard io account and are logged in navigate to https freeboard io board RflSl3 58 Click on the CLONE button in bottom right corner of the dashboard to make a copy of the dashboard to your account 59 Open the dashboard tools pane if it is not already open click on the wrench button at top center of the web page 6...

Страница 23: ...o the SIM socket on the shield 65 Attach the antenna to the Avnet M14A2A Cellular Shield SMA connector that is labelled Primary 66 The cellular shield requires 5V power from the provided USB power adapter Plug a microUSB cable into the 5V USB shield power on the Cellular shield and connect the other end of the cable to the provided USB Power adapter LED1 illuminates light green 67 Plug a microUSB ...

Страница 24: ... hard drive We suggest keeping the path of the project as short to avoid path length limitations In this example we unzip the files to c dev 70 Open the Keil project by double clicking on the applicable project file C dev ATT_IoT_Starter_Kit B L475E_IOT01A avnet_cell_port MDK ARM Project uvprojx 71 In the project panel on the left of the Keil window expand the folder structure for avnet_cell and U...

Страница 25: ...s from the Endpoints section at the bottom of the Flow GUI FIGURE 29 ACCESSING FLOW ENDPOINT INFORMATION 75 Back in the Keil IDE scroll a few lines up from the device ID in main c to a line which contains include FlowStreamClient h x 76 Right click on the line and select Open document FlowStreamClient h This will open the FlowStreamClient h header file in a new tab FIGURE 30 OPENING THE FLOWSTREAM...

Страница 26: ...con FIGURE 31 SAVING FILES IN KEIL 79 Click the Build button to build your device firmware FIGURE 32 BUILD THE KEIL PROJECT 80 If there are no errors the target binary file will have been built FIGURE 33 KEIL BUILD OUTPUT AFTER A SUCCESSFUL PROJECT BUILD ...

Страница 27: ... board to execute the firmware you have loaded onto the board The reset button is the black pushbutton on the STM32L4 Discovery Kit IoT Node board 84 Return to the freeboard io tab in the browser after a few seconds data should be displayed in the various gauges and graphs in the dashboard The following information is displayed in the dashboard Humidity Temperature Pressure 3 axis Accelerometer da...

Страница 28: ...Page 28 Verify the Dashboard Visualization FIGURE 36 DASHBOARD SHOWING DATA PUBLISHED TO THE CLOUD FROM IOT STARTER KIT ...

Страница 29: ...M32L4 Discovery Kit IoT Node 3 Power the modem using the provided USB charger and micro USB cable USB connector labeled 5V DC on the modem shield 4 Connect the modem to one of the PC s USB ports using other micro USB cable USB connector labeled USB 2 0 on the modem shield 5 Connect Tera Term to the modem s serial Port using the File New Connection dialog box Check Serial and select the COM port la...

Страница 30: ... IMA3_ as shown in Figure 38 WNC M14A2A Module Firmware Query LTE M Cat M1 Firmware If your modem is already running LTE M firmware you should flash your modem with new LTE M firmware if the version number reported by your modem is lower than the one described in step 10 below 10 Refer to the LTE Firmware Upgrade section of the AT T marketplace quickstart website for instructions on how to update ...

Страница 31: ...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 ...

Страница 32: ...Page 32 AT T Control Center includes useful tools for SIM Status Monitoring and Usage Analytics ...

Отзывы: