From 9fce338a01bf0c279351b04648aa6f9afcd1ab7f Mon Sep 17 00:00:00 2001
From: javierdastas <43615461+javierdastas@users.noreply.github.com>
Date: Fri, 28 Sep 2018 06:33:46 -0400
Subject: [PATCH 1/3] Update Readme.md
---
README.md | 116 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 115 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 09f7129..caa4c7e 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,115 @@
-# Contact
+# CONTACT
+
+## What is CONTACT?
+An open platform that brings together software and hardware to allow everyone to communicate up to eight mile radius.
+
+## Why we create CONTACT?
+During and after an emergency, communication with communities is critical.
+
+Helping people at all levels to communicate empowers them to recognize important issues and find common grounds for action, and builds a sense of identity and participation in order to implement decisions.
+
+Well-conceived and effectively delivered emergency messages can help ensure public safety, protect property, facilitate response efforts, elicit cooperation, instill public confidence, and help families reunite.
+
+> Delivering effective emergency communications is an essential part of emergency management. We have learned through the experience of Hurricane Maria first that the people around you respond more quickly than the government. Second, although government assistance is available, coordination between people and agencies is needed, and communication is necessary for this.
+[imagen unidades contact]
+
+
+## How it's Work?
+- Contact combines the use of an IoT device that includes a LoRa transmitter and an ESP32 microcontroller to provide communication access up to eight miles away.
+[imagen de distancia]
+[enlace a fotos]
+- It's the same as using the Internet in a Hotspot. It is not necessary to download additional applications, you only need a device with WiFi and a Web Browser.
+
+
+
+- Contact code allows each unit to extend the distance by replicating any message up to two more units, creating a simple MESH by using a lifetime for each data packet that has been sent.
+
+
+## Features
+### Communication Reach
+- It is possible to reach *up to 8 miles* away in a communication. Within cities with buildings or structures allows a communication of up to two miles, even within structures. But it is possible to double or triple the distance when using the units with a simple MESH.
+
+
+- Is an alternative way of *taking communications trough hard places*. In most emergency incidents, mainly in natural disasters, geography or lack of access do not allow communication.
+
+
+### Ease of Use
+- To use contact it is not necessary to download any application. The unit works just like a hostpot, you use a WiFi connection and then you use the tools through any web browser.
+
+
+
+### Ease of Access
+- The price is very affordable, the cost is $11.00 to produce a unit. But it can be less by producing more units in a bigger scale.
+
+
+### Hardware Flexibility
+- It is *Portable*, it's measure only 3.1 inches (8cm) x 2 inches (5cm). But we know that it can be smaller.
+
+- It uses *rechargeable batteries* (3.7v 3.6aH, 18650) that can extend its use up to *30 continuous hours*. It *can be recharged and used with any usb micro "b" power source*, such as power banks for cell phones, small solar panels or the Eton Red Cross Charger.
+
+
+### Scalability
+- It uses a *frequency free of licenses* for Industry, Science and Medicine (900-Mhz frequencies, ISM band) in the United States. But it is possible to select **other LoRa license-free frequencies for other Countries** through a configuration screen.
+
+- It can be *used as an open network platform to send any form data*. It has sending or receiving functions through specific RESTful technology.
+
+[Data form example]
+```javascript
+ function sendData() {
+ var jsonData = jsonForm(document.getElementById('form'));
+ SendToServer(jsonData, 'GOVERNMENT'); // Your Contact Unit
+ document.getElementById('datos').innerHTML +=
+ '
' + jsonData + '
';
+ }
+
+ function jsonForm(form) {
+ // var objects = [];
+ var jsonString = "{data[{";
+ if (typeof form == 'object' && form.nodeName.toLowerCase() == "form") {
+ var fields = form.getElementsByTagName("input");
+ for(var i=0;i response.json())
+ .then(json => console.log(json))
+ .catch(function(error) {
+ console.log('Request failed', error)
+ });
+ }
+```
+- It **can be used as a Network or Internet Gateway** to send all received messages to another network, the Internet, [Contact API] or another platform such as Twilio.
+
+- *Beacon and Geolocation Integration*. It allowing it to be used as a Beacon to locate people in other rescue situations. By using a powerful open-technology microcontroller (ESP32) you can extend the capacity of the device while maintaining low cost and performance.
+
+
+
+## CALL FOR CODE + CONTACT
+We believe that everyone has creative ideas. We, in response to **Call for Code**, develop the **Contact** capabilities around the powerful tools of **IBM Cloud** to demonstrate that it is a powerful platform that can grow.
+- [Contact API]
+- [Contact API - Github]
+
+The Contact API is **designed to help _you_ understand what your users are saying.** The API receives messages and analyzes them for sentiment and emotional tone. We store all the analysis data in a database and visualize it through charts, graphs and maps to help you make appropriate and informed decisions. [Click here][contact-home] to see it up and running.
+
+That is a reason why we provide a complete *Open Communication Platform* that allows others to control the hardware and the data directly; the people can create custom interfaces and even send the data to other platforms.
+- [Unit Code on Github]
+- [Unit Interfaces]
+
+
+[inside]: https://github.com/jdastas/contact-platform/unit/images/unit-inside.jpg "Unit Inside"
+[setup]: https://github.com/jdastas/contact-platform/unit/images/setup.png "Contact Setup Screen"
+[gateway]: https://github.com/jdastas/contact-platform/unit/images/gateway.png "Internet Gateway"
+[Data form example]: https://github.com/jdastas/contact-platform/unit/interfaces/form-data.html "Data Form Demo"
+[Contact API]: https://contact-app.mybluemix.net/ "Contact API"
+[Contact API - Github]: https://github.com/javierdastas/Contact/tree/master/API
From 89852818b5b746f7e8e52787c74fae7e3c0c6110 Mon Sep 17 00:00:00 2001
From: javierdastas <43615461+javierdastas@users.noreply.github.com>
Date: Fri, 28 Sep 2018 06:58:10 -0400
Subject: [PATCH 2/3] Update Contact Git
---
unit/README.md | 72 +
unit/device/device.ino | 1007 ++++++++++++
unit/images/beacon-active.png | Bin 0 -> 34769 bytes
unit/images/beacon-option.png | Bin 0 -> 99022 bytes
unit/images/data-form.png | Bin 0 -> 145514 bytes
unit/images/gateway.png | Bin 0 -> 149271 bytes
unit/images/main-interface.png | Bin 0 -> 90335 bytes
unit/images/msg-between-units.png | Bin 0 -> 95215 bytes
unit/images/msg-group.png | Bin 0 -> 71182 bytes
unit/images/msg-units-selection.png | Bin 0 -> 93695 bytes
unit/images/sending-msg.png | Bin 0 -> 94738 bytes
unit/images/setup.png | Bin 0 -> 143488 bytes
unit/images/simple-mesh.png | Bin 0 -> 390694 bytes
unit/images/units.png | Bin 0 -> 967691 bytes
unit/interfaces/gateway/delete-sms.html | 15 +
unit/interfaces/gateway/pushsms.html | 149 ++
unit/interfaces/main/main-screen.html | 1388 +++++++++++++++++
.../other-data-example/form-data.html | 135 ++
18 files changed, 2766 insertions(+)
create mode 100644 unit/README.md
create mode 100644 unit/device/device.ino
create mode 100644 unit/images/beacon-active.png
create mode 100644 unit/images/beacon-option.png
create mode 100644 unit/images/data-form.png
create mode 100644 unit/images/gateway.png
create mode 100644 unit/images/main-interface.png
create mode 100644 unit/images/msg-between-units.png
create mode 100644 unit/images/msg-group.png
create mode 100644 unit/images/msg-units-selection.png
create mode 100644 unit/images/sending-msg.png
create mode 100644 unit/images/setup.png
create mode 100644 unit/images/simple-mesh.png
create mode 100644 unit/images/units.png
create mode 100644 unit/interfaces/gateway/delete-sms.html
create mode 100644 unit/interfaces/gateway/pushsms.html
create mode 100644 unit/interfaces/main/main-screen.html
create mode 100644 unit/interfaces/other-data-example/form-data.html
diff --git a/unit/README.md b/unit/README.md
new file mode 100644
index 0000000..efc8505
--- /dev/null
+++ b/unit/README.md
@@ -0,0 +1,72 @@
+# CONTACT-UNIT
+
+## What is CONTACT?
+An open platform that brings together software and hardware to allow everyone to communicate up to eight mile radius.
+
+## Why we create CONTACT?
+During and after an emergency, communication with communities is critical.
+
+Helping people at all levels to communicate empowers them to recognize important issues and find common grounds for action, and builds a sense of identity and participation in order to implement decisions.
+
+Well-conceived and effectively delivered emergency messages can help ensure public safety, protect property, facilitate response efforts, elicit cooperation, instill public confidence, and help families reunite.
+
+> Delivering effective emergency communications is an essential part of emergency management. We have learned through the experience of Hurricane Maria first that the people around you respond more quickly than the government. Second, although government assistance is available, coordination between people and agencies is needed, and communication is necessary for this.
+[imagen unidades contact]
+
+
+## How it's Work?
+- Contact combines the use of an IoT device that includes a LoRa transmitter and an ESP32 microcontroller to provide communication access up to eight miles away.
+[imagen de distancia]
+[enlace a fotos]
+- It's the same as using the Internet in a Hotspot. It is not necessary to download additional applications, you only need a device with WiFi and a Web Browser.
+[una imagen]
+[enlace a pantallas]
+- Contact code allows each unit to extend the distance by replicating any message up to two more units, creating a simple MESH by using a lifetime for each data packet that has been sent.
+[ejemplo del código]
+
+
+## Features
+### Communication Reach
+- It is possible to reach *up to 8 miles* away in a communication. Within cities with buildings or structures allows a communication of up to two miles, even within structures. But it is possible to double or triple the distance when using the units with a simple MESH.
+[imagen lista online communities]
+- Is an alternative way of *taking communications trough hard places*. In most emergency incidents, mainly in natural disasters, geography or lack of access do not allow communication.
+
+### Ease of Access
+- The price is very affordable, the cost is $11.00 to produce a unit. But it can be less by producing more units in a bigger scale.
+[imagen por dentro]
+
+### Hardware Flexibility
+- It is *Portable*, it's measure only 3.1 inches (8cm) x 2 inches (5cm). But we know that it can be smaller.
+[imagenes o fotos]
+- It uses *rechargeable batteries* (3.7v 3.6aH, 18650) that can extend its use up to *30 continuous hours*. It *can be recharged and used with any power source*, such as power banks for cell phones, small solar panels or the Eton Red Cross Charger.
+[imagen conectado]
+
+### Scalability
+- It uses a *frequency free of licenses* for Industry, Science and Medicine (900-Mhz frequencies, ISM band) in the United States. But it is possible to select **other LoRa license-free frequencies for other Countries** through a configuration screen.
+[setup]
+- It can be *used as an open network platform to send any form data*. It has sending or receiving functions through specific RESTful technology.
+[imagen formulario]
+[enlace código]
+- It **can be used as a Network or Internet Gateway** to send all received messages to another network, the Internet, [Contact API]() or another platform such as Twilio.
+[imagen]
+- *Beacon and Geolocation Integration*. It allowing it to be used as a Beacon to locate people in other rescue situations. By using a powerful open-technology microcontroller (ESP32) you can extend the capacity of the device while maintaining low cost and performance.
+[imagen]
+
+## CALL FOR CODE + CONTACT
+We believe that everyone has creative ideas. We, in response to **Call for Code**, develop the **Contact** capabilities around the powerful tools of **IBM Cloud** to demonstrate that it is a powerful platform that can grow.
+[enlace to dashboard]
+[enlace to github Janiel]
+
+
+That is a reason why we provide a complete *Open Communication Platform* that allows others to control the hardware and the data directly; the people can create custom interfaces and even send the data to other platforms.
+[enlace to github Contact Unit]
+[enlace a pantallas]
+
+
+
+
+[setup]: https://github.com/jdastas/contact-platform/setup.png "Contact Setup Screen"
+
+
+[setup]: https://github.com/jdastas/contact-platform/setup.png "Contact Setup Screen"
+[gateway]: https://github.com/jdastas/contact-platform/gateway.png "Internet Gateway"
\ No newline at end of file
diff --git a/unit/device/device.ino b/unit/device/device.ino
new file mode 100644
index 0000000..36583df
--- /dev/null
+++ b/unit/device/device.ino
@@ -0,0 +1,1007 @@
+/*******************************************************************************************
+ CONTACT
+ A real time Open and Portable Communication Platform.
+
+ Author: Javier A. Dastas
+
+ Contact is an open platform that brings together software and
+ hardware to allow everyone to communicate. t use an IoT device
+ that includes a LoRa transmitter and an ESP32 microcontroller
+ to provide communication access and forms bridges to the
+ Internet if it necessary. It is possible to reach a radius of
+ up to eight miles between units or up to two miles away
+ through efficient structures. The range can be doubled or
+ tripled when the units are used as a simple MESH. It's an
+ alternative way of providing communications in disaster
+ situations or to communities in need.
+
+ *******************************************************************************************/
+
+#include
+#include
+#include "EEPROM.h"
+//#include "SSD1306.h" // OLED - It's not necessary
+
+
+#include
+//#include // Avaible only on Some Units
+//#include //
+
+#include
+#include
+#include
+
+
+#include "Arduino.h" // Needed by ArduinoJSON Lib
+#include
+
+#define SS 18
+#define RST 14
+#define DI0 26
+
+// LoRa Frequency Bands
+#define BAND_0 915E6 // USA Only - We use as Default
+ // till change on Setup Screen
+#define BAND_1 920E6 // USA/Asia/Australia
+#define BAND_2 865E6 // Europe/India
+#define PABOOST true
+
+/********** GPS UNIT SETTINGS *************/
+#include
+
+HardwareSerial GPSSerial(2);
+
+#define RXD2 16
+#define TXD2 17
+
+TinyGPSPlus gps;
+String strGeo = "";
+/********** GPS *************/
+
+const char* hostName = "CONTACT";
+String deviceName = "CONTACT";
+const char* ssid = "wifi-gateway";
+const char* password = "";
+
+AsyncWebServer server(80);
+
+String MESH_MSG = "";
+
+String message = ""; // char message[]
+
+boolean sendLoRaMsg = false;
+boolean devNotification = false;
+boolean sendLoRaMsgToOther = false;
+
+byte msgCount = 0; // count of outgoing messages
+byte localAddress = 0xBB; // address of this device
+byte destination = 0xFF; // destination to send to
+long lastSendTime = 0; // last send time
+int interval = 2000; // interval between sends
+
+int nTTL_MAX = 2; // Time-To-Live Package (MESH)
+
+#define MAX_TX_MESSAGES 15
+#define MAX_RX_MESSAGES 50
+#define MAX_UNITS 10
+#define DATA_SIZE 500
+
+typedef struct MESSAGE_TYPE {
+ int packetId;
+ char TxID[12];
+ char RxID[12];
+ char data[DATA_SIZE];
+ int packetsQty;
+ int packetCtr;
+ int packetType; // 1-Txt; 2-Sound; 3-Image; 4-Hand Shake; 5-Alert; 6-JSON
+ int ttl;
+ int packetQId;
+ byte sender; // 0 - Me; 1 - Him
+};
+MESSAGE_TYPE rx_message_queue[MAX_RX_MESSAGES];
+MESSAGE_TYPE tx_message_queue[MAX_TX_MESSAGES];
+
+typedef struct UNIT_TYPE {
+ char TxID[12];
+ char lastDate[10];
+ char lastTime[18];
+};
+UNIT_TYPE unit_queue[MAX_UNITS];
+
+int rx_MSG_CTR_Q = 0;
+int tx_MSG_CTR_Q = 0;
+int UNITS_CTR_Q = 0;
+int tx_MSG_ID = 0;
+
+int LAST_MSG_ID = 0;
+char LAST_UNIT = 0;
+
+class FLASHvariables {
+public:
+ char unitName[14];
+ char unitDesc[30];
+
+ uint8_t unitFreq; // Unit Area Frequency
+
+ double lat;
+ double lng;
+
+ uint16_t isGateway; // 0 - No; 1 - Yes
+
+ char ssid[20];
+ char ssidPwd[20];
+
+ char smsServer[300];
+ char dataServer[300];
+
+ char helpMessage[300];
+
+ uint16_t tstVar; //
+
+ // METHODS
+ void save();
+ void get();
+ void initialize();
+
+} CONTACTvars;
+
+void FLASHvariables::save()
+{
+ EEPROM.put(0, CONTACTvars);
+ EEPROM.commit();
+}
+void FLASHvariables::get()
+{
+ EEPROM.begin(sizeof(CONTACTvars));
+ EEPROM.get(0, CONTACTvars);
+}
+void FLASHvariables::initialize()
+{
+ // If data not found on flash RAM initialize all vars
+ strcpy(unitName, "CONTACT");
+ strcpy(unitDesc, "Physical Location");
+
+ unitFreq = 0;
+
+ lat = 0.00; lng = 0.00;
+
+ isGateway = 0; // Default is SMS Unit
+
+ strcpy(ssid, "not-defined");
+ strcpy(ssidPwd, "not-defined");
+
+ strcpy(smsServer, "not-defined");
+ strcpy(dataServer, "not-defined");
+
+ strcpy(helpMessage, "I need Help, immedialty!");
+
+ tstVar = 111;
+
+ EEPROM.put(0, CONTACTvars);
+ EEPROM.commit();
+}
+
+void setup()
+{
+ pinMode(25,OUTPUT); //Send success, LED will bright 1 second
+ pinMode(16,OUTPUT);
+ digitalWrite(16, LOW); // set GPIO16 low to reset OLED
+ delay(50);
+ digitalWrite(16, HIGH);
+
+ Serial.begin(115200);
+ GPSSerial.begin(9600, SERIAL_8N1, RXD2, TXD2);
+
+ CONTACTvars.get();
+ if (CONTACTvars.tstVar != 111) // all data is correct
+ {
+ Serial.println("No Data Exist on Flash RAM ... Initializing to defaults." + micros());
+ CONTACTvars.initialize();
+ }
+ else
+ Serial.println("Success retrieved persistent variables." + micros());
+
+ Serial.print("UNIT Name: ");
+ Serial.println(CONTACTvars.unitName);
+
+ Serial.print("Device Type: ");
+ Serial.print(CONTACTvars.isGateway);
+ Serial.print(" - ");
+ Serial.println((CONTACTvars.isGateway==1?"Gateway":"Communication"));
+
+ if (CONTACTvars.isGateway == 0) // Use Only for Communication
+ {
+ WiFi.mode(WIFI_AP);
+
+ hostName = CONTACTvars.unitName;
+
+ WiFi.softAP(hostName); // Use as OPEN HOT SPOT Communication Device
+ // WiFi.softAP(hostName, CONTACTvars.unitPwd);
+ delay(100);
+ Serial.println("Connected!");
+
+ Serial.println("Set softAPConfig");
+ IPAddress Ip(1, 2, 3, 4);
+ IPAddress NMask(255, 255, 255, 0);
+ WiFi.softAPConfig(Ip, Ip, NMask);
+
+ Serial.print("IP address: ");
+ Serial.println(WiFi.softAPIP());
+ }
+ else // Use Unit as Internet Gateway
+ {
+ int nets = WiFi.scanNetworks();
+ Serial.println("scan done");
+ if (nets == 0) {
+ Serial.println("no networks found");
+ } else {
+ WiFi.mode(WIFI_STA);
+ WiFi.disconnect();
+
+ ssid = CONTACTvars.ssid;
+ password = CONTACTvars.ssidPwd;
+ WiFi.begin(ssid, password);
+ Serial.print("WiFi Status: ");
+ Serial.println(WiFi.status());
+ int conxTries = 0;
+ while ((WiFi.status() != WL_CONNECTED) and (conxTries++ < 40)) {
+ delay(500);
+ Serial.print(".");
+ }
+ Serial.println("");
+ if ( WiFi.status() != WL_CONNECTED) {
+ Serial.println("Couldn't Get a WiFi connection");
+ Serial.println("as Gateway.");
+ Serial.println("Please check the Settings Page.");
+
+ CONTACTvars.isGateway = 0; // Set Unit to Default Again
+ CONTACTvars.save();
+
+ ESP.restart();
+ }
+ else {
+ Serial.print("Connected to ");
+ Serial.print(ssid);
+ Serial.println(" Network.\n\n Ready to Send data as Gateway.");
+
+ Serial.println("WiFi connected!");
+ Serial.print(" IP address: ");
+ Serial.println(WiFi.localIP());
+ Serial.print(" ESP Mac Address: ");
+ Serial.println(WiFi.macAddress());
+ Serial.print(" Subnet Mask: ");
+ Serial.println(WiFi.subnetMask());
+ Serial.print(" Gateway IP: ");
+ Serial.println(WiFi.gatewayIP());
+ Serial.print(" DNS: ");
+ Serial.println(WiFi.dnsIP());
+
+ // Set up mDNS responder:
+ // - first argument is the domain name, in this example
+ // the fully-qualified domain name is "esp8266.local"
+ // - second argument is the IP address to advertise
+ // we send our IP address on the WiFi network
+ //if (MDNS.begin(CONTACTvars.unitName)) {
+ // Serial.println("MDNS Responder Started!");
+ //} else {
+ // Serial.println("Error setting up MDNS responder!");
+ //}
+ }
+ }
+ }
+ delay(100);
+
+ // Not for all Devices, only based on Chrome
+ // char mdnsHostName [12+1];
+ // mdnsHostName = CONTACTvars.unitName
+ // strcpy (mdnsHostName,"chat");
+
+ // if (!MDNS.begin(mdnsHostName)) {
+ // Serial.println("Error setting up MDNS responder!");
+ // while(1){
+ // delay(1000);
+ // }
+ // }
+ // Serial.println("MDNS Name Setted.");
+
+ SPI.begin(5,19,27,18);
+ LoRa.setPins(SS,RST,DI0);
+ Serial.println("Starting LoRa.");
+ Serial.print(" Frequency used 0-USA Only, 1-USA/Asia/Australia, 2-Europe/Indida: ");
+ Serial.println(CONTACTvars.unitFreq);
+ double BAND = (CONTACTvars.unitFreq == 0? BAND_0 : (CONTACTvars.unitFreq == 1? BAND_1 : BAND_2));
+ if (!LoRa.begin(BAND)) {
+ Serial.println("Starting LoRa failed!");
+ while (1);
+ }
+
+ // ********* Set Unit Web Pages and RESTs
+
+ server.on("/", HTTP_GET, [](AsyncWebServerRequest *request){
+ // Chat Page
+ request->send(200, "text/html", main_page());
+ });
+
+ server.on("/deletechat", HTTP_GET, [](AsyncWebServerRequest *request){
+ // Reset Chat Content
+ String jsonData = "";
+
+ int paramsNmbr = request->params();
+ if (paramsNmbr > 0) {
+ AsyncWebParameter* p1 = request->getParam(0);
+ int nKey = String(p1->value()).toInt();
+ String page = "";
+ if (nKey = 20172009)
+ page = " Document ";
+ else
+ page = " Document