![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/ESP32-ESP8266-OLED-DHT22-DHT11-Temperature-Humidity.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nThe idea of using the OLED display with the ESP32 or ESP8266 is to ilustrate how you can create a physical user interface for your boards.<\/p>\n\n\n\n
Project Overview<\/h2>\n\n\n\n
In this project we’ll use an I2C SSD1306 128×64 OLED display<\/a> as shown in the following figure.<\/p>\n\n\n\n The temperature and humidity will be measured using the DHT22 temperature and humidity sensor<\/a> (you can also use DHT11<\/a>).<\/p>\n\n\n\n If you\u2019re not familiar with the DHT11\/DHT22 sensor, we recommend reading the following guide:<\/p>\n\n\n\n For this tutorial you need the following components:<\/p>\n\n\n\n You can use the preceding links or go directly to MakerAdvisor.com\/tools<\/a> to find all the parts for your projects at the best price!<\/p> The OLED display we’re using communicates via I2C communication protocol, so you need to connect it to the ESP32 or ESP8266 I2C pins.<\/p>\n\n\n\n By default, the ESP32 I2C pins are:<\/p>\n\n\n\n If you’re using an ESP8266, the default I2C pins are:<\/p>\n\n\n\n Follow the next schematic diagram if you’re using an ESP32 board:<\/p>\n\n\n\n Recommended reading:<\/strong> ESP32 Pinout Reference Guide<\/a><\/p>\n\n\n\n If you’re using an ESP8266 follow the next diagram instead.<\/p>\n\n\n\n In this case we’re connecting the DHT data pin to GPIO 14<\/span>, but you can use any other suitable GPIO.<\/p>\n\n\n\n Recommended reading:<\/strong> ESP8266 Pinout Reference Guide<\/a> <\/p>\n\n\n\n Before uploading the code, you need to install the libraries to write to the OLED display and the libraries to read from the DHT sensor.<\/p>\n\n\n\n There are several libraries available to control the OLED display with the ESP8266. In this tutorial we’ll use the libraries from adafruit: the Adafruit_SSD1306 library<\/a> and the Adafruit_GFX library<\/a>. Follow the next steps to install these libraries:<\/p>\n\n\n\n 1.<\/strong> Open your Arduino IDE and go to Sketch <\/strong>> Include Library<\/strong> > Manage Libraries<\/strong>. The Library Manager should open.<\/p>\n\n\n\n 2.<\/strong> Type “SSD1306<\/strong>” in the Search box and install the SSD1306 library from Adafruit.<\/p>\n\n\n\n 3.<\/strong> After installing the SSD1306 library from Adafruit, type “GFX<\/strong>” in the search box and install the library.<\/p>\n\n\n\n To read from the DHT sensor we’ll use the libraries from Adafruit.<\/p>\n\n\n\n 1.<\/strong> Open your Arduino IDE and go to Sketch <\/strong>> Include Library<\/strong> > Manage Libraries<\/strong>. The Library Manager should open.<\/p>\n\n\n\n 2.<\/strong> Search for “DHT<\/strong>” on the Search box and install the DHT library from Adafruit.<\/p>\n\n\n\n 3.<\/strong> After installing the DHT library from Adafruit, type “Adafruit Unified Sensor<\/strong>” in the search box. Scroll all the way down to find the library and install it.<\/p>\n\n\n\n We\u2019ll program the ESP32\/ESP8266 using Arduino IDE, so you must have the ESP32\/ESP8266 add-on installed in your Arduino IDE. If you haven\u2019t, follow the next tutorial first that fits your needs:<\/p>\n\n\n\n Finally, restart your Arduino IDE.<\/p>\n\n\n\n After installing the necessary libraries, you can copy the following code to your Arduino IDE and upload it to your ESP32 or ESP8266 board.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n Let’s take a quick look on how the code works.<\/p>\n\n\n\n The code starts by including the necessary libraries. The Wire<\/span>, Adafruit_GFX<\/span> and Adafruit_SSD1306<\/span> are used to interface with the OLED display. The Adafruit_Sensor<\/span> and the DHT<\/span> libraries are used to interface with the DHT22 or DHT11 sensors.<\/p>\n\n\n\n Then, define your OLED display dimensions. In this case, we’re using a 128×64 pixel display.<\/p>\n\n\n\n Then, initialize a display object with the width and height defined earlier with I2C communication protocol (&Wire<\/span>). <\/p>\n\n\n\n The (-1) parameter means that your OLED display doesn’t have a RESET pin. If your OLED display does have a RESET pin, it should be connected to a GPIO. In that case, you should pass the GPIO number as a parameter. <\/p>\n\n\n\n Then, define the DHT sensor type you’re using. If you’re using a DHT22 you don’t need to change anything on the code. If you’re using another sensor, just uncomment the sensor you’re using and comment the others.<\/p>\n\n\n\n Initialize a DHT<\/span> sensor object with the pin and type defined earlier.<\/p>\n\n\n\n In the setup()<\/span>, initialize the serial monitor for debugging purposes.<\/p>\n\n\n\n Initialize the DHT sensor:<\/p>\n\n\n\n Then, initialize the OLED display.<\/p>\n\n\n\n In this case, the address of the OLED display we’re using is 0x3C<\/strong>. If this address doesn’t work, you can run an I2C scanner sketch to find your OLED address. You can find the I2C scanner sketch here<\/a>. <\/p>\n\n\n\n Add a delay to give time for the display to initialize, clear the display and set the text color to white:<\/p>\n\n\n\n In the loop()<\/span> is where we read the sensor and display the temperature and humidity on the display.<\/p>\n\n\n\n The temperature and humidity are saved on the t<\/span> and h<\/span> variables, respectively. Reading temperature and humidity is as simple as using the readTemperature()<\/span> and readHumidity()<\/span> methods on the dht<\/span> object. <\/p>\n\n\n\n In case we are not able to get the readings, display an error message:<\/p>\n\n\n\n If you get that error message, read our troubleshooting guide: how to fix “Failed to read from DHT sensor”<\/a>.<\/p>\n\n\n\n The following lines display the temperature on the OLED display.<\/p>\n\n\n\n We use the setTextSize()<\/span> method to define the font size, the setCursor()<\/span> sets where the text should start being displayed and the print()<\/span> method is used to write something on the display.<\/p>\n\n\n\n To print the temperature and humidity you just need to pass their variables to the print()<\/span> method as follows:<\/p>\n\n\n\n The “Temperature” label is displayed in size 1, and the actual reading is displayed in size 2. <\/p>\n\n\n\n To display the \u00ba symbol, we use the Code Page 437<\/a> font. For that, you need to set the cp437<\/span> to true<\/span> as follows:<\/p>\n\n\n\n Then, use the write()<\/span> method to display your chosen character. The \u00ba symbol corresponds to character 167.<\/p>\n\n\n\n A similar approach is used to display the humidity:<\/p>\n\n\n\n Don’t forget that you need to call display.display()<\/span> at the end, so that you can actually display something on the OLED. <\/p>\n\n\n\n Recommended reading:<\/strong> ESP32 with DHT11\/DHT22 Temperature and Humidity Sensor using Arduino IDE<\/a><\/p>\n\n\n\n The following figure shows what you should get at the end of this tutorial. Humidity and temperature readings are displayed on the OLED.<\/p>\n\n\n\n If your DHT sensor fails to get the readings or you get the message “Failed to read from DHT sensor”, read our DHT Troubleshooting Guide<\/strong><\/a> to help you solve that problem.<\/p>\n\n\n\n If you get the “SSD1306 allocation failed<\/strong>” error or if the OLED is not displaying anything in the screen, it can be one of the following issues:<\/p>\n\n\n\n Wrong I2C address<\/strong><\/p>\n\n\n\n The I2C address for the OLED display we are using is 0x3C. However, yours may be different. So, make sure you check your display I2C address using an I2C scanner sketch<\/a>.<\/p>\n\n\n\n SDA and SCL not connected properly<\/strong><\/p>\n\n\n\n Please make sure that you have the SDA and SCL pins of the OLED display wired correctly. If you’re using:<\/p>\n\n\n\n We hope you’ve found this tutorial about displaying sensor readings on the OLED display useful. The OLED display is a great way to add a user interface to your projects. If you like this project, you may also like to know how to display sensor readings in your browser using an ESP Web Server:<\/p>\n\n\n\n You can learn more about the ESP32 and ESP8266 with our courses:<\/p>\n\n\n\n Thanks for reading.<\/p>\n","protected":false},"excerpt":{"rendered":" Learn how to display temperature and humidity readings from a DHT11\/DHT22 sensor in an SSD1306 OLED display using an ESP32 or an ESP8266 with Arduino IDE. The idea of using … <\/p>\n![\"I2C](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2016\/09\/ssd1306-oled-display-arduino.jpg?resize=750%2C412&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"DHT11](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/04\/DHT11-DHT22-Temperature-Humidity-Sensor.jpg?resize=750%2C442&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nParts required<\/h2>\n\n\n\n
![](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2017\/10\/header-200.png?w=1200&quality=100&strip=all&ssl=1\")
<\/a><\/p>\n\n\n\nSchematic<\/h2>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/oled-temperature-humidity-esp32_bb.png?resize=1024%2C947&quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\n\n![\"ESP8266](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/oled-temperature-humidity-esp8266.png?resize=880%2C892&quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\n\nInstalling Libraries<\/h2>\n\n\n\n
Installing the OLED libraries<\/h3>\n\n\n\n
![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/install-ssd1306-adafruit-library.png?resize=788%2C443&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/install-gfx-library-adafruit.png?resize=786%2C443&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nInstalling the DHT Sensor libraries<\/h3>\n\n\n\n
![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/04\/adafruit_dht_library.png?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"Installing](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/04\/adafruit_unified_sensor_library.png?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nInstalling the ESP boards<\/h3>\n\n\n\n
Code<\/h2>\n\n\n\n
\/*********\n Rui Santos\n Complete project details at https:\/\/randomnerdtutorials.com \n*********\/\n\n#include <Wire.h>\n#include <Adafruit_GFX.h>\n#include <Adafruit_SSD1306.h>\n#include <Adafruit_Sensor.h>\n#include <DHT.h>\n\n#define SCREEN_WIDTH 128 \/\/ OLED display width, in pixels\n#define SCREEN_HEIGHT 64 \/\/ OLED display height, in pixels\n\n\/\/ Declaration for an SSD1306 display connected to I2C (SDA, SCL pins)\nAdafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);\n\n#define DHTPIN 14 \/\/ Digital pin connected to the DHT sensor\n\n\/\/ Uncomment the type of sensor in use:\n\/\/#define DHTTYPE DHT11 \/\/ DHT 11\n#define DHTTYPE DHT22 \/\/ DHT 22 (AM2302)\n\/\/#define DHTTYPE DHT21 \/\/ DHT 21 (AM2301)\n\nDHT dht(DHTPIN, DHTTYPE);\n\nvoid setup() {\n Serial.begin(115200);\n\n dht.begin();\n\n if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) {\n Serial.println(F("SSD1306 allocation failed"));\n for(;;);\n }\n delay(2000);\n display.clearDisplay();\n display.setTextColor(WHITE);\n}\n\nvoid loop() {\n delay(5000);\n\n \/\/read temperature and humidity\n float t = dht.readTemperature();\n float h = dht.readHumidity();\n if (isnan(h) || isnan(t)) {\n Serial.println("Failed to read from DHT sensor!");\n }\n \/\/ clear display\n display.clearDisplay();\n \n \/\/ display temperature\n display.setTextSize(1);\n display.setCursor(0,0);\n display.print("Temperature: ");\n display.setTextSize(2);\n display.setCursor(0,10);\n display.print(t);\n display.print(" ");\n display.setTextSize(1);\n display.cp437(true);\n display.write(167);\n display.setTextSize(2);\n display.print("C");\n \n \/\/ display humidity\n display.setTextSize(1);\n display.setCursor(0, 35);\n display.print("Humidity: ");\n display.setTextSize(2);\n display.setCursor(0, 45);\n display.print(h);\n display.print(" %"); \n \n display.display(); \n}\n<\/code><\/pre>\n\tHow the code works<\/h3>\n\n\n\n
Importing libraries<\/h4>\n\n\n\n
#include <Wire.h>\n#include <Adafruit_GFX.h>\n#include <Adafruit_SSD1306.h>\n#include <Adafruit_Sensor.h>\n#include <DHT.h><\/code><\/pre>\n\n\n\nCreate a display object<\/h4>\n\n\n\n
#define SCREEN_WIDTH 128 \/\/ OLED display width, in pixels\n#define SCREEN_HEIGHT 64 \/\/ OLED display height, in pixels<\/code><\/pre>\n\n\n\nAdafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);<\/code><\/pre>\n\n\n\nCreate a DHT object<\/h4>\n\n\n\n
\/\/#define DHTTYPE DHT11 \/\/ DHT 11\n#define DHTTYPE DHT22 \/\/ DHT 22 (AM2302)\n\/\/#define DHTTYPE DHT21 \/\/ DHT 21 (AM2301)<\/code><\/pre>\n\n\n\nDHT dht(DHTPIN, DHTTYPE);<\/code><\/pre>\n\n\n\nsetup()<\/h4>\n\n\n\n
Serial.begin(115200);<\/code><\/pre>\n\n\n\ndht.begin();<\/code><\/pre>\n\n\n\nif(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { \/\/ Address 0x3D for 128x64\n Serial.println(F(\"SSD1306 allocation failed\"));\n for(;;);\n}<\/code><\/pre>\n\n\n\ndelay(2000);\ndisplay.clearDisplay();\ndisplay.setTextColor(WHITE)<\/code><\/pre>\n\n\n\nGet temperature and humidity readings from DHT<\/h4>\n\n\n\n
float t = dht.readTemperature();\nfloat h = dht.readHumidity();<\/code><\/pre>\n\n\n\nif (isnan(h) || isnan(t)) {\n Serial.println(\"Failed to read from DHT sensor!\");\n}<\/code><\/pre>\n\n\n\nDisplay sensor readings on the OLED display<\/h4>\n\n\n\n
display.setTextSize(1);\n display.setCursor(0,0);\n display.print(\"Temperature: \");\n display.setTextSize(2);\n display.setCursor(0,10);\n display.print(t);\n display.print(\" \");\n display.setTextSize(1);\n display.cp437(true);\n display.write(167);\n display.setTextSize(2);\n display.print(\"C\");<\/code><\/pre>\n\n\n\ndisplay.print(t);<\/code><\/pre>\n\n\n\ndisplay.cp437(true);<\/code><\/pre>\n\n\n\ndisplay.write(167);<\/code><\/pre>\n\n\n\ndisplay.setTextSize(1);\ndisplay.setCursor(0, 35);\ndisplay.print(\"Humidity: \");\ndisplay.setTextSize(2);\ndisplay.setCursor(0, 45);\ndisplay.print(h);\ndisplay.print(\" %\"); <\/code><\/pre>\n\n\n\ndisplay.display(); <\/code><\/pre>\n\n\n\nDemonstration<\/h2>\n\n\n\n
![\"DHT11](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2019\/05\/ESP32-ESP8266-OLED-DHT22-DHT11-Display-Temperature-Humidity-readings.jpg?resize=750%2C630&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nTroubleshooting<\/h2>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n