Avnet
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
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.
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:
| Signal | J10 | Shield | PMOD Color in the image below |
|---|---|---|---|
| VCC | Pin 6 | Pin 6 | Red |
| GND | Pin 5 | Pin 5 | Black |
| SDA | Pin4 | Pin 3 | Green |
| SCL | Pin3 | Pin 2 | Yellow |
AT&T M2X and FLOW Instructions
Link to AT&T M2X
Link to AT&T 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.
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
Revision 55:3abf9e3f42e6, committed 2016-07-28
- Comitter:
- stefanrousseau
- Date:
- Thu Jul 28 15:52:37 2016 +0000
- Parent:
- 54:beb1b53f7e2b
- Child:
- 56:cb42ff383dab
- Commit message:
- Added virtual sensors. This uses the USB Rx unless you un-comment USE_VIRTUAL_SENSORS. Also reverted to mbed 119 because of problems.
Changed in this revision
--- a/config_me.h Wed Jul 27 01:58:25 2016 +0000 +++ b/config_me.h Thu Jul 28 15:52:37 2016 +0000 @@ -32,9 +32,12 @@ // or you can add the reading of the FXO8700CQ motion sensor on the FRDM-K64F board // or if you have a SiLabs PMOD plugged into the shield, you can add its proximity sensor, // UV light, visible ambient light and infrared ambient light readings -#define TEMP_HUMIDITY_ONLY 1 -#define TEMP_HUMIDITY_ACCELEROMETER 2 -#define TEMP_HUMIDITY_ACCELEROMETER_PMODSENSORS 3 +// If you run the Windows "Sensor Simulator" utility, 8 additional virtual +// sensors can also be made available via USB. +#define TEMP_HUMIDITY_ONLY 1 +#define TEMP_HUMIDITY_ACCELEROMETER 2 +#define TEMP_HUMIDITY_ACCELEROMETER_PMODSENSORS 3 +#define TEMP_HUMIDITY_ACCELEROMETER_PMODSENSORS_VIRTUALSENSORS 4 static int iSensorsToReport = TEMP_HUMIDITY_ONLY; //modify this to change your selection // This is the APN name for the cellular network, you will need to change this, check the instructions included with your SIM card kit:
--- a/hardware.h Wed Jul 27 01:58:25 2016 +0000 +++ b/hardware.h Thu Jul 28 15:52:37 2016 +0000 @@ -1,5 +1,11 @@ #ifndef Hardware_H_ #define Hardware_H_ extern I2C i2c; //SDA, SCL -- define the I2C pins being used +extern Serial pc; //UART to USB host + +//Un-comment the definition below if you want to use the USB rx for another purpose. +//otherwise the USB rx will be used to receive virtual sensor data from Avnet's +//"Sensor Simulator Dashboard" utility +#define USE_VIRTUAL_SENSORS #endif
--- a/main.cpp Wed Jul 27 01:58:25 2016 +0000
+++ b/main.cpp Thu Jul 28 15:52:37 2016 +0000
@@ -1,4 +1,4 @@
- #include "mbed.h"
+#include "mbed.h"
#include <cctype>
#include <string>
#include "SerialBuffered.h"
@@ -284,7 +284,15 @@
.UVindex = "0",
.Proximity = "0",
.Temperature_Si7020 = "0",
- .Humidity_Si7020 = "0"
+ .Humidity_Si7020 = "0",
+ .Virtual_Sensor1 = "0",
+ .Virtual_Sensor2 = "0",
+ .Virtual_Sensor3 = "0",
+ .Virtual_Sensor4 = "0",
+ .Virtual_Sensor5 = "0",
+ .Virtual_Sensor6 = "0",
+ .Virtual_Sensor7 = "0",
+ .Virtual_Sensor8 = "0"
};
void GenerateModemString(char * modem_string)
@@ -306,6 +314,11 @@
sprintf(modem_string, "GET %s%s?serial=%s&temp=%s&humidity=%s&accelX=%s&accelY=%s&accelZ=%s&proximity=%s&light_uv=%s&light_vis=%s&light_ir=%s %s%s\r\n\r\n", FLOW_BASE_URL, FLOW_INPUT_NAME, FLOW_DEVICE_NAME, SENSOR_DATA.Temperature, SENSOR_DATA.Humidity, SENSOR_DATA.AccelX,SENSOR_DATA.AccelY,SENSOR_DATA.AccelZ, SENSOR_DATA.Proximity, SENSOR_DATA.UVindex, SENSOR_DATA.AmbientLightVis, SENSOR_DATA.AmbientLightIr, FLOW_URL_TYPE, MY_SERVER_URL);
break;
}
+ case TEMP_HUMIDITY_ACCELEROMETER_PMODSENSORS_VIRTUALSENSORS:
+ {
+ sprintf(modem_string, "GET %s%s?serial=%s&temp=%s&humidity=%s&accelX=%s&accelY=%s&accelZ=%s&proximity=%s&light_uv=%s&light_vis=%s&light_ir=%s&virt_sens1=%s&virt_sens2=%s&virt_sens3=%s&virt_sens4=%s&virt_sens5=%s&virt_sens6=%s&virt_sens7=%s&virt_sens8=%s %s%s\r\n\r\n", FLOW_BASE_URL, FLOW_INPUT_NAME, FLOW_DEVICE_NAME, SENSOR_DATA.Temperature, SENSOR_DATA.Humidity, SENSOR_DATA.AccelX,SENSOR_DATA.AccelY,SENSOR_DATA.AccelZ, SENSOR_DATA.Proximity, SENSOR_DATA.UVindex, SENSOR_DATA.AmbientLightVis, SENSOR_DATA.AmbientLightIr, SENSOR_DATA.Virtual_Sensor1, SENSOR_DATA.Virtual_Sensor2, SENSOR_DATA.Virtual_Sensor3, SENSOR_DATA.Virtual_Sensor4, SENSOR_DATA.Virtual_Sensor5, SENSOR_DATA.Virtual_Sensor6, SENSOR_DATA.Virtual_Sensor7, SENSOR_DATA.Virtual_Sensor8, FLOW_URL_TYPE, MY_SERVER_URL);
+ break;
+ }
default:
{
sprintf(modem_string, "Invalid sensor selected\r\n\r\n");
@@ -496,6 +509,9 @@
// Send and receive data perpetually
while(1) {
static unsigned ledOnce = 0;
+ #ifdef USE_VIRTUAL_SENSORS
+ ProcessUsbInterface();
+ #endif
if (bTimerExpiredFlag)
{
bTimerExpiredFlag = false;
--- a/mbed.bld Wed Jul 27 01:58:25 2016 +0000 +++ b/mbed.bld Thu Jul 28 15:52:37 2016 +0000 @@ -1,1 +1,1 @@ -http://mbed.org/users/mbed_official/code/mbed/builds/f9eeca106725 \ No newline at end of file +http://mbed.org/users/mbed_official/code/mbed/builds/aae6fcc7d9bb \ No newline at end of file
--- a/sensors.cpp Wed Jul 27 01:58:25 2016 +0000
+++ b/sensors.cpp Thu Jul 28 15:52:37 2016 +0000
@@ -1,13 +1,11 @@
#include "mbed.h"
+#include "hardware.h"
#include "sensors.h"
//I2C for pmod sensors:
#define Si1145_PMOD_I2C_ADDR 0xC0 //this is for 7-bit addr 0x60 for the Si7020
#define Si7020_PMOD_I2C_ADDR 0x80 //this is for 7-bit addr 0x4 for the Si7020
-#include "hardware.h"
-//I2C i2c(PTC11, PTC10); //SDA, SCL
-
#include "FXOS8700CQ.h"
// Pin names for the motion sensor FRDM-K64F board:
FXOS8700CQ fxos(PTE25, PTE24, FXOS8700CQ_SLAVE_ADDR1); // SDA, SCL, (addr << 1)
@@ -354,8 +352,137 @@
} //bMotionSensor_present
} //read_motion_sensor
+
+#ifdef USE_VIRTUAL_SENSORS
+bool bUsbConnected = false;
+volatile uint8_t usb_uart_rx_buff[256];
+//volatile uint8_t usb_uart_tx_buff[256];
+volatile unsigned char usb_uart_rx_buff_putptr = 0;
+volatile unsigned char usb_uart_rx_buff_getptr = 0;
+//volatile unsigned char usb_uart_tx_buff_putptr = 0;
+//volatile unsigned char usb_uart_tx_buff_getptr = 0;
+char usbhost_rx_string[256];
+unsigned char usbhost_rxstring_index;
+char usbhost_tx_string[256];
+
+
+float f_sensor1_value = 12.3;
+float f_sensor2_value = 45.6;
+float f_sensor3_value = 78.9;
+float f_sensor4_value = 78.9;
+float f_sensor5_value = 78.9;
+float f_sensor6_value = 78.9;
+float f_sensor7_value = 78.9;
+float f_sensor8_value = 78.9;
+char usb_sensor_string[110];
+
+
+//********************************************************************************************************************************************
+//* Parse the input sensor data from the USB host
+//********************************************************************************************************************************************
+int parse_usbhost_message()
+{
+ //printf("String = %s\n", usbhost_rx_string); //test
+ uint8_t length;
+ uint8_t x ;
+ //It seems that sscanf needs 11 characters to store a 7-character number. There must be some formatting and termination values...
+ char Record[8][11]; //There are 8 sensors with up to 7 characters each
+ char StringRecord[110]; //There are is a sensor "string" with up to 100 characters in it
+
+ // Data format is: "S1:1234,S2:5678,S3:1234,S4:5678,S5:1234,S6:5678,S7:5678,S8:5678,S9:abcde...\n"
+ int args_assigned = sscanf(usbhost_rx_string, "%[^','],%[^','],%[^','],%[^','],%[^','],%[^','],%[^','],%[^','],%[^\n]", Record[0], Record[1], Record[2], Record[3], Record[4], Record[5], Record[6], Record[7], StringRecord);
+
+ //StringRecord[109] = '\0';
+ //printf("Last = %s\n", StringRecord); //test
+
+ if (args_assigned == 9)
+ { //sscanf was able to assign all 9 values
+ for (x=0; x < 8; x++) // loop through the 8 sensors
+ {
+ // Strip the "Sx:" label characters from the field value
+ length = strlen(Record[x]); // max of 7 characters but could be less
+ strncpy(Record[x], Record[x] + 3, length);
+ Record[x][length] = '\0'; // null termination character manually added
+ }
+ length = strlen(StringRecord);
+ strncpy(StringRecord, StringRecord + 3, length);
+ StringRecord[length] = '\0'; // null termination character manually added
+
+ if ((usbhost_rx_string[0] == 'S') && (usbhost_rx_string[1] == '1')) //The message starts with "S1"
+ {
+ f_sensor1_value = atof(Record[0]);
+ f_sensor2_value = atof(Record[1]);
+ f_sensor3_value = atof(Record[2]);
+ f_sensor4_value = atof(Record[3]);
+ f_sensor5_value = atof(Record[4]);
+ f_sensor6_value = atof(Record[5]);
+ f_sensor7_value = atof(Record[6]);
+ f_sensor8_value = atof(Record[7]);
+ sprintf(usb_sensor_string,StringRecord);
+ //printf("Received = %s, %s, %s, %s, %s, %s, %s, %s, %s\n", Record[0], Record[1], Record[2], Record[3], Record[4], Record[5], Record[6], Record[7], usb_sensor_string); //test
+ sprintf(SENSOR_DATA.Virtual_Sensor1, "%s", Record[0]);
+ sprintf(SENSOR_DATA.Virtual_Sensor2, "%s", Record[1]);
+ sprintf(SENSOR_DATA.Virtual_Sensor3, "%s", Record[2]);
+ sprintf(SENSOR_DATA.Virtual_Sensor4, "%s", Record[3]);
+ sprintf(SENSOR_DATA.Virtual_Sensor5, "%s", Record[4]);
+ sprintf(SENSOR_DATA.Virtual_Sensor6, "%s", Record[5]);
+ sprintf(SENSOR_DATA.Virtual_Sensor7, "%s", Record[6]);
+ sprintf(SENSOR_DATA.Virtual_Sensor8, "%s", Record[7]);
+ }
+ } //sscanf was able to assign all values
+ return args_assigned;
+} //parse_usbhost_message()
+
+//********************************************************************************************************************************************
+//* Process any received message from the USB host
+//********************************************************************************************************************************************
+void process_usb_rx(unsigned char ucNewRxByte)
+{
+ if (ucNewRxByte == '?')
+ { //just pinging
+ usbhost_rxstring_index = 0;
+ return;
+ } //just pinging
+ usbhost_rx_string[usbhost_rxstring_index++] = ucNewRxByte;
+ if (ucNewRxByte == '\n')
+ { //end of message
+ usbhost_rx_string[usbhost_rxstring_index] = 0; //null terminate string
+ usbhost_rxstring_index = 0;
+ parse_usbhost_message();
+ } //end of message
+} //process_usb_rx()
+
+void ProcessUsbInterface(void)
+{
+ //Process the USB host UART receive commands:
+ if (usb_uart_rx_buff_getptr != usb_uart_rx_buff_putptr)
+ {
+ bUsbConnected = true;
+ while (usb_uart_rx_buff_getptr != usb_uart_rx_buff_putptr)
+ {
+ unsigned char ucByteFromHost = usb_uart_rx_buff[usb_uart_rx_buff_getptr++]; //Copy latest received byte
+ process_usb_rx(ucByteFromHost);
+ } //while (usb_uart_rx_buff_getptr != usb_uart_rx_buff_putptr)
+ } // if there are USB UART bytes to receive
+ //USB host UART transmit:
+ //while (usb_uart_tx_buff_getptr != usb_uart_tx_buff_putptr)
+ //{
+ //pc.putc(usb_uart_tx_buff[usb_uart_tx_buff_getptr++]);
+ //}
+} //ProcessUsbInterface()
+
+void pcrx_callback() //Rx interrupt for USB serial port
+{
+ // Note: you need to actually read from the serial to clear the RX interrupt
+ usb_uart_rx_buff[usb_uart_rx_buff_putptr++] = pc.getc();
+}
+#endif
+
void sensors_init(void)
{
+#ifdef USE_VIRTUAL_SENSORS
+ pc.attach(&pcrx_callback);
+#endif
Init_Si7020();
Init_Si1145();
init_motion_sensor();
--- a/sensors.h Wed Jul 27 01:58:25 2016 +0000
+++ b/sensors.h Thu Jul 28 15:52:37 2016 +0000
@@ -3,6 +3,7 @@
void sensors_init(void);
void read_sensors(void);
+void ProcessUsbInterface(void);
#define SENSOR_FIELD_LEN_LIMIT 32
typedef struct
@@ -21,6 +22,14 @@
char Proximity[SENSOR_FIELD_LEN_LIMIT];
char Temperature_Si7020[SENSOR_FIELD_LEN_LIMIT];
char Humidity_Si7020[SENSOR_FIELD_LEN_LIMIT];
+ char Virtual_Sensor1[SENSOR_FIELD_LEN_LIMIT];
+ char Virtual_Sensor2[SENSOR_FIELD_LEN_LIMIT];
+ char Virtual_Sensor3[SENSOR_FIELD_LEN_LIMIT];
+ char Virtual_Sensor4[SENSOR_FIELD_LEN_LIMIT];
+ char Virtual_Sensor5[SENSOR_FIELD_LEN_LIMIT];
+ char Virtual_Sensor6[SENSOR_FIELD_LEN_LIMIT];
+ char Virtual_Sensor7[SENSOR_FIELD_LEN_LIMIT];
+ char Virtual_Sensor8[SENSOR_FIELD_LEN_LIMIT];
} K64F_Sensors_t ;
extern K64F_Sensors_t SENSOR_DATA;
Repository toolbox
| Export to desktop IDE |
| Build repository |
Repository details
| Type: | Program |
|---|---|
| Mbed OS support: | Mbed 2 deprecated |
| Created: | 27 Sep 2016 |
| Imports: | 800 |
| Forks: | 5 |
| Commits: | 84 |
| Dependents: | 0 |
| Dependencies: | 3 |
| Followers: | 23 |
The code in this repository is Apache licensed.
Components
Avnet ATT WNC 14A2A Cellular IoT Kit