Connect an I2C SSD1306 OLED display and an ESP-01 (ESP8266)

ESP-01 ESP8266 OLED i2C DISPLAY ECRAN LD1117V33 scanner wifi
Table of Contents

In this tutorial we will learn how to use a 0.96” monochrome OLED display (based on the SSD1306 chip) with an ESP8266 module and more specifically the ESP-01 module. We will use the 2 GPIO ports available on the ESP-01 to connect the SS1306 OLED display using the I2C bus.


To illustrate this article, we will realize a small WiFi scanner project that connects to a WiFi network and displays the ip address assigned to the ESP-01 as well as the strength of the WiFi signal on the OLED screen. In a next project, we will realize a small box by 3D printing to make our Wifi scanner portable and autonomous.

If you’re new to ESP8266, you might also be interested in these articles

Read Also
Nodemcu-build: Firmware NodeMCU ESP8266 custom (Frightanic)
Read Also
ESP-01: Reinstalling the Original NodeMCU Firmware (ESP8266)

Materials required for this project

To carry out the assembly of this project you will need the following equipment

Circuit and procedure for installing the code on the ESP-01

The management of the display on the OLED screen of this project is based on the work of. The WiFi part is managed thanks to the ESP8266Wifi library (Github).

The first step of this project is to put your ESP-01 module in bootload mode. Perform the following wiring.



Click to enlarge

Retrieve the project code from the DIY Projects Github. Open the file ESP01-OLED.ino and change the <ssid> and <password> variables according to your WiFi network. Download now the ESP8266Wifi library on Github and install there by going to the menu Sketch -> Include a library -> Add library .ZIP

Choose the Generic ESP8266 Module board and select ArduinoISP as programmer.

Now turn on your ESP8266 and press Upload. If your wiring is correct, downloading starts after compiling the program.

Connect the SSD1306 OLED display and start the WiFi scanner on the ESP-01

Now that the program is installed on the ESP8266, turn off the power to the module.

To use an OLED screen on an ESP-01 we will use the 2 GPIOs available on the module to connect them to the I2C bus that equips the SSD1306. The connection is very simple. Remove the cable connecting the GPIO0 to the GND and connect the OLED I2C screen as follows:




VCC <-> 3.3V

You can reverse the wiring. In this case, change the settings in the program and reinstall the program.


Now turn on the ESP-01. The WiFi scanner will first connect to the WiFi network and then retrieve the ip address assigned to the ESP-01 as well as the signal strength. After a few seconds, you should get this:

esp-01 esp8266 oled i2c display wifi scanner

Click to rate this post!
[Total: 0 Average: 0]

Thanks for your reading

Did you like this project ? Don't miss any more projects by subscribing to our weekly newsletter!

Are you having a problem with this topic?

Maybe someone has already found the solution, visit the forum before asking your question
1 Comment

Leave a Reply

Read more
DIY Projects
DIY Projects