This program connects to a few sensors via I2C and sends the data collected to a WNC Cellular Module which is located on an Avnet WNC-Shield card.

Dependencies:   FXOS8700CQ MODSERIAL mbed

/media/uploads/kevinkeryk/avnet_logo_tagline_rgb.png

Avnet Cellular IoT Instructions

  • One problematic area is setting the MY_SERVER_URL. When you copy the URL from the flow, you must make sure the MY_SERVER_URL is also set to the appropriate server. It can be either "run-east.att.io" or "run-west.att.io".

Useful Links

Adding Additional Sensors

The FLOW_DEVICE_NAME field must contain the name of the instance of the Virtual Starter Kit in FLOW you will be communicating with. Usually this is "vstarterkit001", but if you have problems communicating you can verify this is correct. Note: This device will not be created until you click the “Initialize” input on the Virtual Device tab of the Starter Kit project in FLOW. At that point, it becomes available in M2X and you can see it as the DEVICE SERIAL field under Devices as in the image below. /media/uploads/JMF/vstarterkit.png

Sensors: When executing, the FRDM-K64F board uploads sensor measurements to AT&T’s Flow environment every 5 seconds, using the Cellular shield board. You can adjust how often you want to do this by editing the SENSOR_UPDATE_INTERVAL_MS value in the header file.

Temperature and humidity: By default, the board reports readings from the HTS221 temperature and humidity sensor. These two values are sent to the HTTP IN /climate port in FLOW with field names “temp” and “humidity”. Temperature is in degrees Fahrenheit and humidity is a %. This default assignment is: iSensorsToReport = TEMP_HUMIDITY_ONLY;

Accelerometer: If you want to expand and use the onboard motion sensor, you can also send 3-axis accelerometer information from the board as “accelX”, “accelY”, and “accelZ”. This is useful if you want to know the stationary position of the board with regards to gravity, or whether it is in motion. These readings are in g’s. To send these values, change the assignment to: iSensorsToReport = TEMP_HUMIDITY_ACCELEROMETER;

PMOD Sensors: If you have a Silicon Labs sensor module that can plug into the PMOD connector on the Cellular shield, you are able to measure proximity, UV light, ambient visible and infrared light from the Si1145 sensor. This PMOD also has a temperature and humidity sensor, but in this case it is redundant. When enabled, the fields “proximity”, “light_uv”, “light_vis” and “light_ir” are also sent. To enable all these sensors, change the assignment to: iSensorsToReport = TEMP_HUMIDITY_ACCELEROMETER_PMODSENSORS;

Connecting the PMOD sensors: Because the pinouts do not align, the SiLabs PMOD sensor board cannot be plugged into the J10 PMOD receptacle on the shield directly. The following wiring instructions must be followed:

SignalJ10ShieldPMOD Color in the image below
VCCPin 6Pin 6Red
GNDPin 5Pin 5Black
SDAPin4Pin 3Green
SCLPin3Pin 2Yellow

/media/uploads/JMF/xyz.jpg

AT&T M2X and FLOW Instructions

M2X & FLOW Instructions

Link to AT&T M2X

M2X

Link to AT&T Flow

FLOW

Avnet WNC-Shield Information

Getting Started with the Avnet WNC-Shield Software

  • This project uses Revision 119 of the MBED library because of I2C implementation differences with the tip (Revision 121).
  • This project uses Revision 4 of the FXOS8700CQ library for sensors.

Easily Modifiable Parameters

Inside the mbed Avnet_ATT_Cellular_IOT project, the parameters needed to customize your board are in the config_me.h file.

  • FLOW parameters: This project assumes you are using a fork of the Starter Kit Base project, which is a reference design created using AT&T’s FLOW (https://flow.att.com) that allows the creation of online virtualization and other IoT functionality. The default parameters in the config_me.h file are done for a specific instance of this project. When you fork the original project, you get your own instance and it will have its own base address. At the bottom of the FLOW environment, when you click on the Endpoints tab, URL information that is specific to your instance is displayed. Of note is the Base URL. In the example below (as in the default mbed project), the Base URL is: https://run-west.att.io/1e464b19cdcde/774c88d68202/86694923d5bf28a/in/flow You have to take note of two parts of this address. The run-west.att.io part is the server URL, and you have to make sure the
  • MY_SERVER_URL field in config_me.h matches this. The rest of the base URL, in green above, needs to be pasted into the FLOW_BASE_URL field.

There is also a FLOW_INPUT_NAME field. This should match the name of the HTTP IN port in the FLOW project that you want to send sensor data to. The default is "/climate", as in the FLOW image below.

/media/uploads/JMF/sf.png

Where is the Binary I compiled

When the COMPILE button is pressed, it compiles your project and links it. The result is placed in the DOWNLOAD folder you use when downloading files from the Internet. It will be called AvnetATT_shape_hackathon_K64F.bin.

Additional Information on Compiling/Configuring

Comprehensive instructions can be found at: Quick Start Instructions

Revisions of main.cpp

Revision Date Message Actions
77:c65eae5b9958 2016-08-15 Fixed some missing \r.; Added report of app version.; Added report of WNC firmware version.; File  Diff  Annotate
72:b500e1507b5f 2016-08-11 Add 4s startup delay and changed GPS_valid to number of satellites. File  Diff  Annotate
71:45a5e426df81 2016-08-11 Added GPS to FLOW. File  Diff  Annotate
70:24d5800f27be 2016-08-11 Correct GPS init error File  Diff  Annotate
68:6e311c747045 2016-08-11 Added Avnet copyright headers on all source files. File  Diff  Annotate
64:09004cd610df 2016-08-01 Replaced all printf's with PRINTF=pc.printf; moved to latest mbed library File  Diff  Annotate
63:90d7c69993cd 2016-08-01 Changed the mdm UART from SerialBuffered to MODSERIAL so there will only be one type. File  Diff  Annotate
61:f6b93129f954 2016-08-01 Moved cellular modem routines from main.cpp to cell_modem.cpp; Moved HTS221 routines from main.cpp to sensors.cpp File  Diff  Annotate
59:7ebb9436b2bd 2016-07-29 Changed the welcome message to:; "Hello World from the Cellular IoT Kit!" File  Diff  Annotate
56:cb42ff383dab 2016-07-28 Changes USB UART to use MODSERIAL library File  Diff  Annotate
55:3abf9e3f42e6 2016-07-28 Added virtual sensors. This uses the USB Rx unless you un-comment USE_VIRTUAL_SENSORS. Also reverted to mbed 119 because of problems. File  Diff  Annotate
53:dcccf2881fa0 2016-07-26 Added conditional debug.; Removed printf("D %s\r\n") which I never should have checked in this past weekend.; Left code with intermediate level of debug turned on. File  Diff  Annotate
52:9dafcb7f320f 2016-07-24 Added strcpy length check. File  Diff  Annotate
50:8ac42961458c 2016-07-24 Made sockread char buffer larger to handle more data coming back from a server. For now, 10*1500 bytes. File  Diff  Annotate
49:97f823273dc0 2016-07-24 Removed extra sockread_mdm File  Diff  Annotate
48:93a4ab6ac177 2016-07-24 Merged (hopefully correctly) Stefan's changes into mine. Also changed it to copy from the C++ string to the char buffer so that the C based JSON parser will work correctly everytime. The latter is what was causing an OS exception when no readback. File  Diff  Annotate
47:c07656706ca1 2016-07-24 Just making commit note.; This seems very stable now. File  Diff  Annotate
46:da9d788f5d5a 2016-07-24 Exception was not WNC issue or parsing. Being caused by bad conversion from string to char array. FIXED! File  Diff  Annotate
43:6821a9c78c4b 2016-07-24 Put back in 1ms between chars sent to WNC.; FIXED: exception error due to sockread on no response and string search results not checked! File  Diff  Annotate
41:9b14c40eebf6 2016-07-23 Changed the JSON extract sequence so it is not called when there is no response File  Diff  Annotate
38:564b312a719f 2016-07-23 Changed timeout for sockconn. File  Diff  Annotate
35:c9c2eb8fb0a8 2016-07-23 Fixed; // char * myJsonResponse;; char myJsonResponse[512];; File  Diff  Annotate
33:fa964b8b3b19 2016-07-22 20mS between AT command, still see NO response from WNC occasionally. Increased delay now to 40mS, so far so good. File  Diff  Annotate
32:1e052a3e73fe 2016-07-22 Removed in between character delays when talking to the WNC. File  Diff  Annotate
31:da32581b4507 2016-07-22 Per WNC: Added 20mS wait in the hardware init for AT command. File  Diff  Annotate
29:c69379977ae5 2016-07-22 new repository File  Diff  Annotate
26:8d6e7e7cdcae 2016-07-13 Merged in my changes with Stefan's (hopefully correctly) File  Diff  Annotate
25:e7996d22a7e6 2016-07-13 Only do 1 socket open (before was doing open -> write -> read -> close. So now do 1 open then write -> read -> write -> read ... File  Diff  Annotate
23:d6ceeb6d85ed 2016-07-13 Added text to config_me. Also moved the sensor update definition there. File  Diff  Annotate
21:d0038d14ee7c 2016-07-13 Cleaned up config_me.h a little and added some comments for the user variables. More comments need to be added. Cleaned up some of my unused debug code at the bottom of main(). File  Diff  Annotate
20:27a4f27254d0 2016-07-13 Set LED to RED for initialization, then BLUE after once the WNC is setup for internet comms, then GREEN after a response comes back from the server.; ; Then the LED is never touched and any incoming flow commands will set the color going forward. File  Diff  Annotate
19:f89baed3bd6f 2016-07-13 Right before the SOCKCONN during the WNC software initialization once in a while the WNC seems to be dropping a char that is sent to it, 'A' specifically. So I put in 2 "AT" commands right before the SOCKCONN and that seems to clean it up. File  Diff  Annotate
18:b08471eb1d1c 2016-07-13 Add a 3 sec delay between afterWNC hardware init is done and before the AT sockets commands are sent to the WNC. File  Diff  Annotate
17:38a8cc0c6ba5 2016-07-13 Updated power-up sequence per WNC. File  Diff  Annotate
16:17c5916f2d12 2016-07-13 Merged LED and JSON changes with power-up changes File  Diff  Annotate
15:61df4a452d38 2016-07-13 Added JSON parsing and displaying the LED color File  Diff  Annotate
14:0c353e212296 2016-07-13 Pulled in Steve Martin's new WNC initialization code.; Also removed the while(1) in case init fails, now it just continues to retry the initialization. File  Diff  Annotate
12:7c94ec5069dc 2016-07-12 Fixed GET string format and added 3 options for the sensors to be read. File  Diff  Annotate
11:e6602513730f 2016-07-12 Fixed I2C issues. ; a) Removed stop between HTS221 address and read; b) The latest MBED uses the slave address differently from the legacy. Stick with the old for now and fixed the HTS221 address to BF instead of 5F.; c) Made I2C definitions externs. File  Diff  Annotate
8:b08ec94d9e9f 2016-07-11 changed to serial File  Diff  Annotate
7:489835c87d95 2016-07-11 Changed device ID to serial File  Diff  Annotate
6:713b4cbf1a7d 2016-07-11 Slowed down enhanced Steve's send cmd, wait for response when sending to the wnc uart. 1mS in between every char now. File  Diff  Annotate
5:3417b6a84ee3 2016-07-11 Fixed get string to work proper with ATT test flow. File  Diff  Annotate
4:f83bedd9cab4 2016-07-11 Added a sensors file that will write the FRDM-K64F motion sensor and the values from the SiLabs PMOD into a structure. File  Diff  Annotate
3:26b3cc155f39 2016-07-10 Stefan added:; 1) Flow_parameters.h; 2) ms timer tick currently expires every 5 seconds; 3) function to parse values into sensor structure File  Diff  Annotate
2:0e2ef866af95 2016-07-10 Adding in WNC code from Fred File  Diff  Annotate
1:af7a42f7d465 2016-07-09 Adding string encode/decode; File  Diff  Annotate
0:9d5134074d84 2016-07-08 Initial version of AT&T_Avnet Shape Hackathon WNC Shield board File  Diff  Annotate