ESP8266-Hack – Piggybacking OLED display on WeMos D1 Mini

128x64 OLED display directly soldered on a WeMos D1 Mini
Do you like this post? Writing posts, developing libraries and programming online font creators is actually hard work. I order most of my electronics from a Chinese website called Banggood. It is save and the items usually arrive in good quality. With every order you do there by following this link you are supporting the blog. Thank you!

Inspired by Mike Rankin’s (@mikerankin) beautiful crossovers between an ESP8266 ESP-01 and an 0.96 Inch OLED I2C display I decided to try if there wasn’t an easy hack to marry the two components with as  little soldering as possible.

After turning, connecting and flashing different combinations of the two modules I finally found one that only requires you to solder 4 connections. Assuming that your display’s connectors are in the order GND, VCC, SCL and SDA just place the display on the bottom of your WeMos D1 Mini so that the two GND’s are connected with each other. VCC connects to D4, SCL to D3 and SDA to D2. I’m aware that I am “cheating” the D4 connector into being the power source, but I couldn’t find any data about the max. current the display draws. If you want to be 100% save add a connection between VCC (on the display) and 3V3 instead. Let me know in the comments if you are convinced that I’m doing something reckless.

128x64 OLED display directly soldered on a WeMos D1 Mini
128×64 OLED display directly soldered on a WeMos D1 Mini running the Weather Station Code
128x64 OLED display directly soldered on a WeMos D1 Mini Running the Weather Station Code
WeMos D1 Mini with Piggyback Oled display

If you are following my VCC-D4 hack from above make sure that you enable D4 for output and to set it to HIGH:

pinMode(D4, OUTPUT);
digitalWrite(D4, HIGH);




Shopping List



Posted by squix78


    • Hi Gerard
      Thank you very much for pointing this out! Do you think connecting 3V3 with D4 and setting D4 to input mode with a PULLUP could resolve the problem? That would still allow for easy soldering…

  1. Hey, thanks for this tip, and you know what, I’m buying these I2C Oled for years see and guess what new OLED version have VCC/GND reversed, It’s a pity since I got all by boards with old pinout
    VCC/GND/SCL/SDA but the good new is that if you buy a “old” oled you can plug it as is with VCC to 5V GND to GND and then SCL=GPIO2 and SDA=GPIO0
    Could works but need to be tried since GPIO2/GPIO0 need special level to but ESP8266
    You can find old one here×64+oled&submit=Search&_sid=1090683909

Leave a Reply