Initial code

Author: tomekmalek

examples/7_distance_and_light_sensor/7_distance_and_light_sensor.ino

@@ -0,0 +1,49 @@
+/******************************************************************************
+   INCLUDES
+ ******************************************************************************/
+#include "arduino_secrets.h"
+#include <LiveObjects.h>
+#include "ExtDevices.h"
+
+/******************************************************************************
+   USER VARIABLES
+ ******************************************************************************/
+uint32_t messageRate = 5000;   // stores the current data message rate in Milliseconds
+unsigned long lastMessageTime = 0;   // stores the time when last data message was sent
+
+VL6180x sensor(VL6180X_ADDRESS);
+char ambient_light[20];     // ambient light level [lx]
+u_int8_t distance;          // distance from obstruction [mm]
+
+/******************************************************************************
+   USER PROGRAM
+ ******************************************************************************/
+void setup() {
+  Serial.begin(115200);
+
+  VL6180XInit();    // initialization of VL6180X sensor
+
+  Serial.print("\n*** Live Objects for Arduino MKR boards, revision ");
+  Serial.print(SW_REVISION);
+  Serial.println(" ***");
+  lo.setSecurity(TLS);
+  lo.begin(MQTT, TEXT, true);
+  lo.connect(); // connects to the network + Live Objects
+}
+
+void loop() {
+  if (millis() - lastMessageTime > messageRate) {
+    // collect data periodically
+    Serial.println("Sampling data");
+
+    distance = sensor.getDistance();
+    lo.addToPayload("distance", distance);               // adding 'distance' value to the current payload
+    sprintf(ambient_light, "%.2f", sensor.getAmbientLight(GAIN_1));
+    lo.addToPayload("ambient_light", ambient_light);     // adding 'ambient_light' value to the current payload
+    
+    Serial.println("Sending data to Live Objects");
+    lo.sendData();                                   // send the data to Live Objects
+    lastMessageTime = millis();
+  }
+  lo.loop();                             // don't forget to keep this in your main loop
+}

examples/7_distance_and_light_sensor/README.md

@@ -0,0 +1,23 @@
+# Send data to Live Objects
+
+This example shows how to send some sample data (device uptime) to Live Objects using Arduino MKR NB 1500.
+![diagram](img/send_data_diagram.png)
+
+## Running
+First of all, be sure that you installed the required libraries and generated an API key mentioned in the main README file, then:
+1. Open "1_send_data.ino" sketch using Arduino IDE
+2. Replace ```const char SECRET_LIVEOBJECTS_API_KEY[]="...";``` in arduino_secrets.h with API key you generated
+3. In ```lo.setSecurity()``` select security mode using ```TLS``` or ```NONE``` according to board abilities shown in **Compatibility** point in main **README.md**
+4. Upload *1_send_data.ino* sketch to your Arduino MKR NB 1500 board
+
+
+## Verify
+**Is device online:**<br>
+If all went fine under **devices** tab on Live Live Objects portal you should see online your device identified by its modem IMEI:
+
+![device_online](img/device_online.png)
+
+**Is device sending data:**<br>
+Under data tab on Live Objects portal you should see messages sent by your device, along with values *{ "uptime": xxxxx }*
+
+![data_portal](img/data_portal.png)

examples/7_distance_and_light_sensor/arduino_secrets.h

@@ -0,0 +1,16 @@
+	// Cellular connection cerdentials, used only for GSM boards
+extern const String SECRET_PINNUMBER = "";		// unless PIN is deactivated, specify your SIM card PIN number
+extern const String SECRET_APN = "";					// specify the APN name (if needed)
+extern const String SECRET_APN_USER = ""; 		// specify the username for your APN (if needed)
+extern const String SECRET_APN_PASS = "";		// specify the password for your APN (if needed)
+extern const String SECRET_SERVER_MSISDN = "";  // specify the number of server(gate)
+
+// WIFI connection credentials, used only for WiFi boards
+extern const String SECRET_SSID = "";		// unless PIN is deactivated, specify your SIM card PIN number
+extern const String SECRET_WIFI_PASS = "";					// specify the APN name (if needed)
+
+	// Live Objects credential: paste below your API key (see Configuration > API keys on the portal).
+	// You API key must have at least the predefined 'MQTT Device' rights profile
+	// (alternatively: 'Device Access' read + write rights if need to customise the rights).
+	// Please note that you *must* use a TLS connection (MQTTS) if you grant more rights to the API key.
+extern const String SECRET_LIVEOBJECTS_API_KEY = "...";

src/ExtDevices.cpp

@@ -0,0 +1,62 @@
+/*
+ * Copyright (C) Orange
+ *
+ * This software is distributed under the terms and conditions of the 'MIT'
+ * license which can be found in the file 'LICENSE.md' in this package distribution
+ */
+
+#include "ExtDevices.h"
+
+VL6180xIdentification identification;
+
+
+void VL6180XInit()
+{
+  VL6180x sensor(VL6180X_ADDRESS);
+  Wire.begin();         // Start I2C library
+  delay(1500);           // delay 1.5s
+
+  sensor.getIdentification(&identification); // Retrieve manufacture info from device memory
+  printVL6180xIdentification(&identification);      // Helper function to print all the Module information
+
+  if (sensor.VL6180xInit() != 0)
+  {
+    Serial.println("Failed to initialize VL6180X sensor. Freezing..."); // Initialize device and check for errors
+    while (1)
+      ;
+  }
+  sensor.VL6180xDefautSettings(); // Load default settings to get started.
+  delay(1000); // delay 1s
+}
+
+void printVL6180xIdentification(struct VL6180xIdentification *temp)
+{
+  Serial.println("VL6180X  sensor");
+
+  Serial.print("Model ID = ");
+  Serial.println(temp->idModel);
+
+  Serial.print("Model Rev = ");
+  Serial.print(temp->idModelRevMajor);
+  
+  Serial.println(temp->idModelRevMinor);
+
+  Serial.print("Module Rev = ");
+  Serial.print(temp->idModuleRevMajor);
+  
+  Serial.println(temp->idModuleRevMinor);
+
+  Serial.print("Manufacture Date = ");
+  Serial.print((temp->idDate >> 3) & 0x001F);
+  Serial.print("/");
+  Serial.print((temp->idDate >> 8) & 0x000F);
+  Serial.print("/1");
+  Serial.print((temp->idDate >> 12) & 0x000F);
+  Serial.print(" Phase: ");
+  Serial.println(temp->idDate & 0x0007);
+
+  Serial.print("Manufacture Time (s)= ");
+  Serial.println(temp->idTime * 2);
+  Serial.println();
+  // Serial.println();
+}

src/ExtDevices.h

@@ -0,0 +1,14 @@
+/*
+ * Copyright (C) Orange
+ *
+ * This software is distributed under the terms and conditions of the 'MIT'
+ * license which can be found in the file 'LICENSE.md' in this package distribution
+ */
+
+#include <Wire.h>
+#include <SparkFun_VL6180X.h>
+
+#define VL6180X_ADDRESS 0x29
+
+void VL6180XInit();
+void printVL6180xIdentification(struct VL6180xIdentification *temp);

src/LiveObjectsBase.h

@@ -12,7 +12,7 @@
  ******************************************************************************/
 #define PAYLOAD_DATA_SIZE 1024
 #define KEEP_ALIVE_NETWORK 1000
-#define SW_REVISION "2.0.4"
+#define SW_REVISION "2.1.0"
 
 
 /******************************************************************************