Status
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.
...
- OpenDevice server up and running (guide)
- Arduino IDE (with required OpenDevice Libraries)
- ESP8266 module (like NodeMCU)
- DHT22 sensor DHT22/DHT11 sensor (and Adafruit's DHT22 library)
DHT22 | NodeMCU |
---|
Wiring
The most basic DHT humidity and temperature sensor comes in two variants with different levels of accuracy.
DHT-11 | DHT-22 | |
---|---|---|
Humidity range | 20%-80%RH (±5%RH) | 0%-100%RH (±2%RH) |
Temperature range | 0-50°C (±2°C) | -40-80°C (±0.5°C) |
Measurement time | 1s per sample | 2s 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:
Next, install Adafruit Unified Sensor Driver
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 | ||
---|---|---|
| ||
#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.
In the Boards page, you should see your device/module already.
IMAGEMXXXXXXXXXXXXXXXXXXXXXXXXXXXX - devices
IMAGEMXXXXXXXXXXXXXXXXXXXXXXXXXXXX - interna dos devices:
Our module has two linked devices:
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.
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
You can also add more then on device on the chart:
Let's now add a gauge that shows the temperature value in real time:
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:
IMAGEMTIP: 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:
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)
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/99352732) in Losant to send yourself a text message whenever the humidity gets too highlow. See examples
Examples:
https://github.com/OpenDevice/opendevice-lib-arduino/tree/master/examples
Recommended Resources:
- ESP8266 Troubleshooting Guide
- Getting Started Guide for the ESP8266 WiFi Module
- DHT11/DHT22 Humidity and Temperature Sensor With Arduino
...