Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
118 changes: 117 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,117 @@
# 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.
![Contact's Reach](/unit/images/contact-reach.png)

- 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.
![Main Screen](/unit/images/group-msg-00.png)
![Selecting Locations to communicate](/unit/images/sending-msg.png)

- 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.
![Main Screen](/unit/images/simple-mesh.png)

## 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.
![Main Screen](/unit/images/contact-reach.png)
![Main Screen](/unit/images/simple-mesh.png)
![Selecting Locations to communicate](/unit/images/msg-units-selection.png)

- 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.
![Main Screen](/unit/images/simple-mesh.png)

### 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.
![Main Screen](/unit/images/group-msg-00.png)
![Receiving Messages](/unit/images/group-msg-02.png)

### 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.
![Unit Inside](/unit/images/unit-inside.jpg)

### 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.
![Unit](/unit/images/contact-unit.jpg)
- 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.
![Contact Setup Screen](/unit/images/contact-setup.png)
- 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](/unit/images/form-data.png)
[Data form example]
```javascript
function sendData() {
var jsonData = jsonForm(document.getElementById('form'));
SendToServer(jsonData, 'GOVERNMENT'); // Your Contact Unit
document.getElementById('datos').innerHTML +=
'<pre>' + jsonData + '</pre><br>';
}

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<fields.length;i++){
var n = fields[i].getAttribute('name');
var v = document.getElementById(n).value;

jsonString += "'" + n + "':'" + v + "',";
//objects[objects.length] = { name: fields[i].getAttribute("name"), value: fields[i].getAttribute("value") };
}
jsonString = jsonString.substr(0, jsonString.length - 1);
jsonString += "]}";
}
return jsonString;
}
function SendToServer(msg, unit) {
fetch('http://1.2.3.4/put?message=' + msg + '&unit=' + unit + '&usr=JSON'
, {mode: 'no-cors'})
.then(response => 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.
![Gateway Confirmation Screen](/unit/images/gateway.png)
- *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.
![Beacon Screen](/unit/images/beacon-option.png)
![Beacon On](/unit/images/beacon-active.png)

## 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]
![Contac Api Architecture](/API/images/architecture.png)
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
72 changes: 72 additions & 0 deletions unit/README.md
Original file line number Diff line number Diff line change
@@ -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]

<Añadir información de Janiel de como trabaja>


[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"
Loading