Home Automation in The Cloud With The Esp8266 and Adafruit Io
Home Automation in The Cloud With The Esp8266 and Adafruit Io
https://learn.adafruit.com/home-automation-in-the-cloud-with-the-esp8266-and-adafruit-io
Introduction 3
How to Go Further 12
This makes it the perfect chip for DIY electronics projects, and especially in the home
automation field. There are many breakout boards available for the ESP8266, but in
this guide we are going to use the Adafruit HUZZAH ESP8266 breakout, which is a
very convenient ESP8266 breakout board.
In this project, we are going to use the ESP8266 to build two components which are
very useful in home automation: a sensor module, and a lamp controller.
We are also going to link these two projects to Adafruit IO, which will allow you to
control this small home automation system from anywhere in the world. Let's start!
For both modules, you will need one Adafruit HUZZAH ESP8266 breakout, which will
be the central component of each module. You will also need a breadboard and some
male/male jumper wires to make the necessary connections.
For the sensor board, you will also need a DHT22 sensor, which we will use to
measure the temperature & humidity. You can also use a DHT11 sensor which is
cheaper but less precise (which is the one you will see on the pictures), you will only
have to change one line of code.
For the lamp controller, we are going to use a PowerSwitch Tail 2, which makes it
really easy to attach a lamp (or any electrical device) to your project.
On the software side, you will need the Arduino IDE that you can get from:
https://www.arduino.cc/en/main/software ()
Finally, also create an Adafruit IO account if it is not done yet. You can do so by going
to:
http://io.adafruit.com/ ()
You will need your Adafruit account name & Adafruit AIO key later in this tutorial.
The first step is to place the ESP8266 breakout board on the breadboard, as well as
the DHT sensor. Then, connect the V+ (or VCC) pin from the ESP8266 board to the
first pin of the DHT sensor (look at the picture below).
After that, connect the GND pin of the ESP8266 to the last pin of the DHT. Finally,
connect pin number 5 of the ESP8266 breakout board to the pin number 2 of the
DHT sensor.
As mentioned before, you will see that I used a DHT11 sensor on this picture.
However, the code you will find on GitHub is made for the DHT22 sensor, and I really
suggest using a DHT22 sensor as it is more precise.
Then, the only thing you need to do is to connect the PowerSwitch Tail Kit. Connect
the two pins on the right (-in and Ground) on the GND pin of the ESP8266 board and
the +in pin to the pin number 5 of the ESP8266.
Then, also connect a lamp or any electrical device to the PowerSwitch, and the other
end of the PowerSwitch to the mains electricity.
https://github.com/openhomeautomation/adafruit-io-esp8266 ()
The sketch for the ESP8266 sensor module starts by including the right libraries:
#include <ESP8266WiFi.h>
#include "Adafruit_MQTT.h"
#include "Adafruit_MQTT_Client.h"
#include "DHT.h"
#define DHTPIN 5
#define DHTTYPE DHT22
After that, there is the section of the code where you need to modify some data. You
need to enter your WiFi network name & password, your Adafruit account name, and
your AIO key:
// WiFi parameters
#define WLAN_SSID "WLAN_SSID"
#define WLAN_PASS "WLAN_PASS"
We also define on which feed we want to send the data to. By default, the sketch will
simply send temperature measurements to a feed called temperature, and humidity
measurements to a feed called humidity.
dht.begin();
Then, in the loop() function of the sketch, we constantly check if we are still
connected to Adafruit IO. If that's not the case, we reconnect the board to Adafruit IO:
if(! mqtt.ping(3)) {
// reconnect to adafruit io
if(! mqtt.connected())
connect();
}
if (! temperature.publish(temperature_data))
Serial.println(F("Failed to publish temperature"));
else
Serial.println(F("Temperature published!"));
if (! humidity.publish(humidity_data))
Serial.println(F("Failed to publish humidity"));
delay(10000);
Let's now see the specificities of the lamp controller sketch. We have to define on
which pin the PowerSwitch Tail is connected to:
We also define a new feed for the project, simply called lamp:
In the setup() function, we set the pin of the PowerSwitch Tail to an output:
pinMode(lamp_pin, OUTPUT);
mqtt.subscribe(&lamp);
Then, in the loop() function, we have to listen to incoming messages from Adafruit IO,
to know if we need to turn the lamp on or off. It starts by creating a subscription
instance:
Adafruit_MQTT_Subscribe *subscription;
Then, we listen for incoming messages. If the message is 'ON', we switch the lamp on.
And if it's 'OFF', we simply switch the lamp off again. This is done by the following
piece of code:
}
}
Note that you can find the complete code for this guide inside the GitHub repository
of the project:
https://github.com/openhomeautomation/adafruit-io-esp8266 ()
We are now going to program the board. The first step is to plug the FTDI friend
board to the ESP8266 breakout:
Open the code with your Arduino IDE, and select ‘Adafruit HUZZAH ESP8266’ from
the Tools>Boards menu of the Arduino IDE. Also select the Serial port corresponding
to the FTDI board you are using.
Then, put the ESP8266 board in bootloader mode so you can program it. On the
Adafruit ESP8266 board, it is really simple: just hold the GPIO0 button pressed, and
then press the Reset button.
Make sure that you also modified the code with your own data (WiFi network
credentials & Adafruit IO credentials).
After that, upload the code to the board. When it is finished, open the Serial monitor,
and reset the board: you should see that the board automatically connects to Adafruit
IO.
If your ESP8266 resets when you run the progem, note that there have been
recent changes to the Adafruit_IO library. You will have to remove references to
PROGMEM. Edit your sketch to match the code sample below:
WiFiClient client;
// Setup the MQTT client class by passing in the WiFi client and MQTT server and
login details.
Adafruit_MQTT_Client mqtt(&client, AIO_SERVER, AIO_SERVERPORT, AIO_USERNAME,
AIO_KEY);
(if you're using the sensor sketch, make the appropriate changes):
https://io.adafruit.com ()
If it is not done yet, create the feeds that we used in our project: temperature,
humidity, and lamp.
Then, add a new 'Gauge' widget, and link it to the temperature feed. Do the same for
humidity:
Your dashboard is now ready to be used. If you followed all the instructions in this
guide so far, you should see that the temperature & humidity gauges have already
been updated, as the ESP8266 sensor module already sent data to Adafruit IO:
Congratulations, you now learned the basics on how to build home automation
modules with the ESP8266 & control them from anywhere with Adafruit IO!
How to Go Further
There are of course several ways to improve this project. One way is to connect more
of these modules to your Adafruit IO dashboard. You can perfectly have several lamp
modules for example, and control them all from your Adafruit IO dashboard.
You can also experiment with different kind of modules. For example, you can build
cheap motion sensors based on the ESP8266, and monitor them as well from your
Adafruit IO dashboard.