Comments: Micro OLED Breakout Hookup Guide

Pages

Looking for answers to technical questions?

We welcome your comments and suggestions below. However, if you are looking for solutions to technical questions please see our Technical Assistance page.

  • I don't know if this was called out, but I couldn't find it anywhere in the guide: if you're using I2C mode, you need to add pull-up resistors (4.7k worked for me) on the SCL and SDA lines.

  • Can I directly use a 3.7v lipo battery or do I need a 3.3v regulator.

  • I'm trying to get this board to work on an arduino and a Raspberry.

    On both, I2C works. SPI doesn't work though. Doing the hello world sketch gives me a scrambled screen.

    First I tried it on a Raspberry PI 3. I2C worked without a problem. SPI didn't work. At first I thought it was something I did wrong, but trying on an Arduino I get the same results. I2C works, SPI doesn't work.

    What could be wrong?

    edit : never mind I found my problem. The D/C jumper was still set to "0" and should've been fully open, meaning not "1" and not "0".

  • I was super excited about this board but I cannot seem to get it to work. The screen just won't turn on. I use an Arduino Leonardo, plugging it into all the same ports except I use 3.3V instead of VCC. Did I break my board by doing so? I really want to get this thing to work and build awesome stuff with it!!

    • Yours is exactly the same problem I'm having. Did you ever get this to work? I'm using SPI, 3.3V versus Vcc just like you.

  • never mind i got it

  • I am trying to do the line and pixel as shown in the tutorial/guide but is shows the line/pixel on top of the Sparkfun logo which won't go away. Also in the guide it says do the oled.begin in the setup and when I try this it doesn't allow me. Any help?

  • Sorry; wrong library. You need to use this library...works awesome:

    https://github.com/EdwinRobotics/ER_Micro_OLED_Arduino_library

    This corrects the issues with the fonts.

  • I figured it out. Works nice now.

    Make sure you download the latest library which includes the compatibility for ESP8266.

    https://github.com/sparkfun/SparkFun_Micro_OLED_Arduino_Library

  • I recently purchased one of these and am trying to use with Sparkfun thing. I updated the jumpers for I2C; I can get the OLED to draw shapes (as well as run the clock demo), but I cannot get it to display text (even in the clock). Any advice?

    • Try this. https://github.com/EdwinRobotics/ER_Micro_OLED_Arduino_Library

      • Sorry; wrong library. You need to use this library…works awesome:

        https://github.com/EdwinRobotics/ER_Micro_OLED_Arduino_library

        This corrects the issues with the fonts.

  • Since the library is heavily based on the MicroView library, you can check out the MicroView website for more resources like a guide on how to add a new font to the library.

  • Awesome product. If you want to use this with i2c your soldering (really de-soldering) skills should be at 11. The jump pads are very close together, but making the jumps are not too bad. I did have to fix one after I mine did not power up (Member #620683 I would check this first) However setting the BS1 jumper to 1 means you have to desolder the default (0) jumper. This took me a while since I have not mastered desolder at such a small scale, but eventually confirmed with my multi meter that I successfully broke my jump. This is such an awesome product I don't think I would buy another 16x2 lcd again. I just wish Sparkfun we sell a version with the default i2c jumpers already set (hint hint). Again thanks for make such great products. I love this.

  • I bought this display and like it a lot. I adapted the code on GitHub so it runs on a Spark Core (and presumably in the future Spark Photon) module:

    https://github.com/liyanage/Micro_OLED_Breakout

    Note that this modified version only supports SPI for now.

  • Dear sparkfun,

    I have setup the OLED for I2C, however the display does not appear to be powering up. It is completely black.

    I have loaded the DEMO sketch and nothing appears to be happening.

    Thank you, T

  • Very good guide, but is there a complete list of the functions that can be used? I tried looking at the read-me file, but I found nothing. Looking at library files for them is a bit too advanced advanced for me. I was especially looking for displaying bitmaps like in your Graphic LCD Hookup Guide. Any help?

    • I recently added a drawBitmap() function to the MicroOLED library. If you download the latest version from GitHub, it will have the most up to date library and an example sketch showing how to use the drawBitmap() function. It will be added to this tutorial shortly. I will also add a complete list of functions in the tutorial for easy reference. Thanks for the suggestions, and thanks for reading!


If you've found a bug or have other constructive feedback for our tutorial authors, please send us your feedback!