Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

DRAFT
Status
colourYellow
title
Table of Contents

Introduction

This guide will show you how to connect (WiFi) devices in the OpenDevice server and send data to save in storage and further visualization in dashboards, all in real time. server to store and then use this data to perform analysis using the dashboards.

We will use the DHT22 sensor connected to the WiFi ESP8266 module to collect temperature and humidity, and send the server using the MQTT protocol.

...

DHT22

NodeMCU DEVKIT 1.0.jpg

NodeMCU

Wiring


The most basic DHT humidity and temperature sensor comes in two variants with different levels of accuracy.


DHT-11DHT-22
Humidity range20%-80%RH (±5%RH)0%-100%RH (±2%RH)
Temperature range0-50°C (±2°C)-40-80°C (±0.5°C)
Measurement time1s per sample2s per sample

Setup

To program the NodeMCU, we are going to use Arduino's IDE. It's the easiest way to get up and running with the DHT22.

First, you'll have to set up your machine : (Device Setup Instructions). These instructions take you through installing the IDE, ESP8266 and the proper required libraries.

In addition to this, you'll have to install DHT sensor library to read the sensor, we are going to use Adafruit's DHT22 library, and Adafruit Unified Sensor Driver

Install Adafruit's DHT22 library. using Library Manager:

Image Added

Next, install Adafruit Unified Sensor Driver

Image Added

Code / Firmware

...

Code Block
#include <ESP8266WiFi.h>  // Enable ESP8266 / WiFi
#include <PubSubClient.h> // enable MQTT
#include <ArduinoOTA.h>   // Remote Updates
XXXXXXXXXXXX DHT

// Sensor Libraries
#include <Adafruit_Sensor.h>
#include <DHT.h>
#include <DHT_U.h>

#include <OpenDevice.h>  // Must be included after

Next we need to configure the device name (you choose) and the api key (see this guide).

App Code (full example)

Code Block
languagecpp
#define ODEV_API_KEY "-----"
#define ODEV_MODULE_NAME "ODevESP8266-1"

app code:

Code Block
const char* ssid = "--";
const char* password = "--" DHTPIN            D2         // Pin which is connected to the DHT sensor.

// Available types:  DHT11, DHT22, DHT21
DHT_Unified dht(DHTPIN, DHT11);

DHT_Unified::Temperature sTemp = dht.temperature();
DHT_Unified::Humidity sHumidity = dht.humidity();

void setup() {
  ODevSerial.enableDebugbegin(115200); 
  
  ODev.name(ODEV_MODULE_NAME"ODevHT-01");
  ODev.apiKey(ODEV_API_KEY"----APIKEY-----");
  ODev.server("192.168.3.106""----SERVER IP-----");

  dht.begin(); // Initialize device.
  
  ODev.addSensor("HT01_Temperature", new AdafruitSensor(sTemp))
    ->setInterval(2 * (1000)); // Change2sec
  Server ! 
  ODev.addDeviceaddSensor("LEDHT01_Humidity", 2, Device::DIGITAL);new AdafruitSensor(sHumidity))
    -- XXXXXXXXXXXX DHT>setInterval(2 * (1000)); // 2sec

  WiFi.mode(WIFI_AP_STA);
  WiFi.begin(ssid, password);"---- WIFI----", "---- PASS----");

  ODev.begin();
}

void loop() {
  ODev.loop();
}

...

Next, upload code to the board and open up your serial monitor, you should see the data:IMAGEM DA SERIALLLLLLLLLLLLLLLLLLLLLLLLLL

Code Block
20:08:06.529 -> DB:WiFi :: Conneted
20:08:07.523 -> DB:SoftAP :: OK
20:08:07.523 -> DB:TCPServer :: OK
20:08:07.523 -> Mode: STA+AP
20:08:07.523 -> Auto connect: 1
20:08:07.523 -> SSID (10): xxxxxxxxxxx
20:08:07.523 -> Passphrase (10): xxxxxxxxxx
20:08:07.523 -> DB:IP STA: 
20:08:07.523 -> 192.168.2.113
20:08:07.523 -> DB:IP softAP: 
20:08:07.523 -> 192.168.4.1
20:08:07.523 -> DB:MQTT :: BEGIN
20:08:27.640 -> DB:MQTT :: connecting... 
20:08:27.673 -> DB:MQTT :: [connected]

Sending data to the cloud

As I mentioned before, you You do not have to do much, just make sure you are looking at the console, if the WiFi connection and the server MQTT was successfully performed.

...

Start the OpenDevice (guide), access (http://localhost:8181), and verify that your devices have been registered correctly.

IMAGEMXXXXXXXXXXXXXXXXXXXXXXXXXXXX - devices

IMAGEMXXXXXXXXXXXXXXXXXXXXXXXXXXXX - interna dos devicesIn the Boards page, you should see your device/module already.:

Image Added

Our module has two linked devices:

Image Added

On this page we already have a series of tools and visualizations that we can analyze how the device is behaving.

But we have a better tool to do the analyzes that are the Dashboards

Create custom visualizations using Dashboards

...

First create the dashboardIMAGEM

On dashboards page click in " New Dashboard ", set the name and select it in the list.

Image Added

Then add Widgets

Vamos criar o  gráfico de linha para exibir as informações da temparatura nas útimas 4 horas

IMAGEMLet's create the line graph to display as temperature information in the last 4 hours.

Click and Add Item/Chart and select Line Chart

Image Added

You can also add more then on device on the chart:

Image Added

Let's now add a gauge that shows the temperature value in real time:

Image Added

You have the freedom to edit and position and enlarge the graph as you wish

Vamos agora adicionar uma gauge que mostre o valor da temperatura em tempo real:

IMAGEM

TIP: In the dashboard you can use shortcuts like: F2 (edit), and: CTRL + S (save). And numeric shortcuts: 1..10, to change dashboard view

After organizing our charts, dragging and expanding, we get the result:

Image Added

Update firmware over WiFi (OTA)

Now after the device is working and online, we can upgrade via OTA. In the Arduino IDE, the device should appear as if it were a Port:

Guide: Remote Updates (OTA)


Image Added

WHAT'S NEXT? 

At this point, you are collecting and visualizing data. But, what about reacting to it? The next step is to build a Rule(

...

/wiki/spaces/DOC/pages/99352732to send yourself a text message whenever the humidity gets too

...

lowSee examples

Examples:

https://github.com/OpenDevice/opendevice-lib-arduino/tree/master/examples

Recommended Resources:

...