Report the temperature with ESP8266 to MQTT

I recently learned about the ESP8266, a $5 chip that includes WiFi and is Arduino compatible. This means that all your DIY projects can now be done for a fraction of the price.

For this tutorial, I’ll walk through how to get going with ESP8266, get the temperature and humidity and report it to MQTT where Home Assistant can pick it up.

Picture of the final setup (+ 2 LED for decoration)

Home Assistant will keep track of historical values and allow you to integrate it into automation.


I’ve been using Adafruit for my shopping:

Besides this, you will need the usual hardware prototype equipment: a breadboard, some wires, soldering iron + wire, Serial USB cable.


Since this article has been published the HDC1008 has been discontinued. Updated sketches are available for the following alternatives:


On your breadboard, make the following connections from your ESP8266 to the HDC1008:

ESP8266 HDC1008 GND GND 3V Vin 14 SCL #2 SDA

I picked #2 and 14 myself, you can configure them in the sketch.

Preparing your IDE

Follow these instructions on how to install and prepare the Arduino IDE for ESP8266 development.

After you’re done installing, open the Arduino IDE, in the menu click on sketch -> include library -> manage libraries and install the following libraries:

  • PubSubClient by Nick ‘O Leary
  • Adafruit HDC1000


If you have followed the previous steps, you’re all set.

  • Open Arduino IDE and create a new sketch (File -> New)
  • Copy and paste the below sketch to the Arduino IDE
  • Adjust the values line 6 - 14 to match your setup
  • Optional: If you want to connect to an MQTT server without a username or password, adjust line 62.
  • To have the ESP8266 accept our new sketch, we have to put it in upload mode. On the ESP8266 device keep the GPIO0 button pressed while pressing the reset button. The red led will glow half bright to indicate it is in upload mode.
  • Press the upload button in Arduino IDE
  • Open the serial monitor (Tools -> Serial Monitor) to see the output from your device

This sketch will connect to your WiFi network and MQTT broker. It will read the temperature and humidity from the sensor every second. It will report it to the MQTT server if the difference is > 1 since last reported value. Reports to the MQTT broker are sent with retain set to True. This means that anyone connecting to the MQTT topic will automatically be notified of the last reported value.

#include <ESP8266WiFi.h>
#include <Wire.h>
#include <PubSubClient.h>
#include <Adafruit_HDC1000.h>
#define wifi_ssid "YOUR WIFI SSID"
#define wifi_password "WIFI PASSWORD"
#define mqtt_server "YOUR_MQTT_SERVER_HOST"
#define mqtt_user "your_username"
#define mqtt_password "your_password"
#define humidity_topic "sensor/humidity"
#define temperature_topic "sensor/temperature"
WiFiClient espClient;
PubSubClient client(espClient);
Adafruit_HDC1000 hdc = Adafruit_HDC1000();
void setup() {
  client.setServer(mqtt_server, 1883);
  // Set SDA and SDL ports
  Wire.begin(2, 14);
  // Start sensor
  if (!hdc.begin()) {
    Serial.println("Couldn't find sensor!");
    while (1);
void setup_wifi() {
  // We start by connecting to a WiFi network
  Serial.print("Connecting to ");
  WiFi.begin(wifi_ssid, wifi_password);
  while (WiFi.status() != WL_CONNECTED) {
  Serial.println("WiFi connected");
  Serial.println("IP address: ");
void reconnect() {
  // Loop until we're reconnected
  while (!client.connected()) {
    Serial.print("Attempting MQTT connection...");
    // Attempt to connect
    // If you do not want to use a username and password, change next line to
    // if (client.connect("ESP8266Client")) {
    if (client.connect("ESP8266Client", mqtt_user, mqtt_password)) {
    } else {
      Serial.print("failed, rc=");
      Serial.println(" try again in 5 seconds");
      // Wait 5 seconds before retrying
bool checkBound(float newValue, float prevValue, float maxDiff) {
  return !isnan(newValue) &&
         (newValue < prevValue - maxDiff || newValue > prevValue + maxDiff);
long lastMsg = 0;
float temp = 0.0;
float hum = 0.0;
float diff = 1.0;
void loop() {
  if (!client.connected()) {
  long now = millis();
  if (now - lastMsg > 1000) {
    lastMsg = now;
    float newTemp = hdc.readTemperature();
    float newHum = hdc.readHumidity();
    if (checkBound(newTemp, temp, diff)) {
      temp = newTemp;
      Serial.print("New temperature:");
      client.publish(temperature_topic, String(temp).c_str(), true);
    if (checkBound(newHum, hum, diff)) {
      hum = newHum;
      Serial.print("New humidity:");
      client.publish(humidity_topic, String(hum).c_str(), true);

Configuring Home Assistant

The last step is to integrate the sensor values into Home Assistant. This can be done by setting up Home Assistant to connect to the MQTT broker and subscribe to the sensor topics.

  username: your_username
  password: your_password
  platform: mqtt
  name: "Temperature"
  state_topic: "sensor/temperature"
  qos: 0
  unit_of_measurement: "ºC"
sensor 2:
  platform: mqtt
  name: "Humidity"
  state_topic: "sensor/humidity"
  qos: 0
  unit_of_measurement: "%"

This is a companion discussion topic for the original entry at

How can I add the availability topic? Should I send hearbeats or reply to requests?

Hello Paulus;

I am interested in doing this project, however, I am confused as to your connections. I am using the AM2302 - supposed to be a dht22 in a housing. What confuses me is your connections (SCL #14, SDA #2). On my AM2302, I only have 3 leads; power, ground and one data. How should this be connected in my case?

Hello Stiofan,

these sensors use different communication protocols.
Just use one of the free GPIOs for the data pin.
I choose GPIO 2 in my thermostat project.

But in the .ino code there are definitions for 2 pins. Should i just define them both to the same number?

I used esp home for my am2302

1 Like

The Arduino library which used in paulus sketch is incompatible with the AM2302 / DHT22.
You need to use another library, I use “DHT sensor library for ESPx”

Why not simply use esphome?

1 Like

My question wasn’t really related to the software, but the physical connections. I have in the mean time got it working.

Thanks everyone for your help.

It’s basic mqtt integration thx for your share