background image

 

 

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 

 

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

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

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

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

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

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

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

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

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

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

Страница 10: ...Page 10 ...

Страница 11: ... https developer mbed org and follow the instructions to create an account Once you have an account you can download and modify the firmware for the kit AT T Flow and M2X Accounts To begin using the AT T Flow and M2X accounts you need to sign up for an AT T IoT Services account This is done by going to https m2x att com signup and creating an account ...

Страница 12: ...a device manually go to https m2x att com onboarding Flow Account Flow can be entered by selecting Flow from the AT T IoT Services account dropdown menu as shown Flow is a GUI based IoT development tool based on NodeJS It allows for data input and output along with user defined rules for up to 100 000 data points per month free of charge Data flows through nodes from left to right when viewing a F...

Страница 13: ...box com s 15umqzirkrmgru2yl7utbp8x4jv0bgmg For the IoT Kit we start by copying a reference design and modifying it Each Flow design is unique in terms of its endpoint addresses and account keys so you need to edit these unique parameters To duplicate an existing project follow these steps 1 On the lower left side of the Flow IDE click Resources Projects Library 2 In the top middle under Search Pro...

Страница 14: ...e first time Subsequent deploy actions will be quicker Now that the project is built and deployed modifications to the WNC Shield software must be made for it to work properly These changes are detailed in the section on Compiling M2X Account M2X is a time series data store that is free for up to 10 devices Navigate to https m2x att com or access it from within your AT T IoT Services Account When ...

Страница 15: ... the Flow Configuration Function 1 In M2X click the Hello power button on the top right and select Account Settings 2 Highlight the Master Key and copy it to the clipboard 3 Return to Flow in your other window tab and find the Configuration function Notice the graphical design has different tabs for each logical section The Configuration function is on the Data tab ...

Страница 16: ...ript to update 5 At the bottom of the canvas where the configuration bubble is located click the Endpoints tab where the Base URL field is located Click the Copy button The copied information is used to update two fields base_hostname and base_url The Base URL is https run west att io 1e464b19cdcde 774c88d68202 86694923d5bf28a in flow The first part run west att io is the base_hostname The base_ur...

Страница 17: ...ction and paste the fields where they belong Click the OK button 7 With the configuration updated a blue dot appears on your function graphic This indicates it has changed but has not been deployed Click the Deploy button to resolve this ...

Страница 18: ...nd find the Initialize component in the bottom left Click once on the solid part to the left of Initialize 9 You can verify the component has been created in the M2X environment by returning to your M2X window and clicking Devices Your virtual device should appear If you expand it by clicking the plus sign you will see the different M2X streams that have been created for it ...

Страница 19: ... cellular shield requires 5V power supplied by the included AC DC power adapter It is not recommended to use a laptop USB port for this power source due to the limited power capabilities of most USB ports Plug a microUSB cable into the 5V USB shield power X5 on the Cellular shield and connect the other end of the cable to the provided AC DC supply LED1 illuminates light green 5 Plug a microUSB cab...

Страница 20: ... Verify the firmware is at version 0226 or higher by opening the DETAILS TXT file located on the MBED drive The following shows how this information is displayed If the firmware is not at 0226 or higher update it by following the instruction provided at https developer mbed org handbook Firmware FRDM K64F ...

Страница 21: ...FRDM K64F board log into your mbed org account and navigate to https developer mbed org teams Avnet code Avnet_ATT_Cellular_IOT Select the Import this Program button Your screen should appear as follows After clicking the Import button the development environment opens and the code for the FRDM K64F board is imported A dialog box as shown below appears Accept the defaults Note please use mbed tagg...

Страница 22: ...isolated to the config_me h file located in the Avnet_ATT_Cellular_IOT project The parts that require updating in config_me h are MY_SERVER_URL 1 FLOW_BASE_URL 2 and FLOW_DEVICE_NAME 3 The correct values for the defines are obtained by clicking the Climate GET cell opening Endpoints and obtaining the Base URL shown below ...

Страница 23: ...Page 23 Edit the config_me h file and update each define with the correct information To obtain the FLOW_DEVICE_NAME navigate to the M2X page and select the Virtual Starter Kit created previously ...

Страница 24: ... Climate GET port and is named climate SENSOR_UPDATE_INTERVAL_MS The update period for sending sensor data to Flow The default for this is 5 seconds Programming Disconnect and then reconnect the USB cable from your laptop to the FRDM K64F board to force a board power cycle Once the MBED drive is enumerated drag and drop the Avnet_ATT_Cellular_IOT bin you just created to the MBED drive This will pr...

Страница 25: ...r to allow Windows to see program output Follow the instructions at https developer mbed org handbook Windows serial configuration After the serial drivers have been installed determine which COM port is being used by opening the device manager Once selected the device manager is displayed and the serial port connected to the WNC Shield is listed under the Ports COM LPT ...

Страница 26: ...Page 26 ...

Страница 27: ... the FRDM K64F board should be RED when the wireless connection is first powered on It turns BLUE when it successfully connects to the AT T network and then either green magenta or turquoise depending on the response from the Flow project implementation The data being sent can also be monitored through the terminal connection that was previously set up Flow M2X Operation To verify messages from th...

Страница 28: ...3 4 In the mbed project open main cpp Use CTRL F to find the function parse_JSON Observe how the JSON response from the board is parsed to extract the LED color setting This simple example can be modified to send your own JSON messages from the Flow environment and to interpret them on the board side Getting Help and Support To download additional information on the kit including board schematics ...

Страница 29: ...to the above other sensor inputs can be provided via the PMOD connector on the WNC Shield Here are two examples of I2C sensors Silicon Labs PMOD Sensor Auxiliary Board This is a sensor module that measures proximity UV light ambient visible and infrared light using a Si1145 sensor Seeedstudio Xadow v2 GPS module This GPS module has a built in chip antenna and provides standard GPS outputs such as ...

Страница 30: ...700CQ motion sensor These values are sent to the HTTP IN climate port in Flow with field names temp humidity accelX accelY and accelZ Temperature is in degrees Fahrenheit Humidity is a percentage Acceleration is measured in G s the gravitational constant and is useful if you want to know the stationary position of the board with regards to gravity or its acceleration when in motion As discussed in...

Страница 31: ...our device you will see a number of enabled Streams on the left Select Acceleration Z axis If your board is lying flat with gravity accelerating your board downward at 1 00 g you should see a graph similar to the one displayed Note You can select how many values you want to view from the drop down box below the graph ...

Страница 32: ... button Note With the free account you can add a maximum of two streams You can create graphs that use streams from different devices It is also possible to draw a graph of Temperature vs Humidity by clicking Dashboards at the top of the screen and selecting different dashboards using customizable widgets that can be embedded elsewhere using the URL ...

Страница 33: ...IoT Kit project click Devices Virtual Starter Kit Triggers Flow automatically creates two triggers for Hot Temp and Cold Temp Click the edit pencil on the right You can modify the trigger conditions The Callback URL is the endpoint address for the trigger input in the Flow design ...

Страница 34: ...Page 34 Click the Trigger tab to explore how Flow processes the trigger inputs and uses them for notifications ...

Страница 35: ...he Flow Data canvas the M2X lead in function is where data enters Double click the bubble to open it Scroll to the bottom of the JavaScript content This is the function that composes the POST message for M2X This function contains the sensor fields that get extracted from the incoming payload Note If attempting to POST to an M2X stream that does not exist an error is generated ...

Страница 36: ... Avnet Including WncInterface An mbed C class that can be used in place of mbed s v5 EthInterface class WncControllerLibrary A C class that directly controls the 14A2A study it to learn AT cmds WncControllerK64F A C class that controls the 14A2A from the K64F Freedom Board And the original Out of the Box demo with the old controller method can also now be found here Also several examples can be fo...

Отзывы: