Comments: Micro OLED Breakout Hookup Guide


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.

  • Member #186381 / about 11 months ago / 1

    question. should i use a level shifter for 5v boards? because this display uses 3.3v. although, i did have it working with resistors in line and powered by 3.3v.

  • Member #186381 / about 11 months ago * / 1

    the first picture for spi hookup shows it wired to 5v not 3.3v. should be 3.3v. edit: didn't see the link right away. now submitted.

  • Mad Tinker / about 4 years ago / 1

    sorry newb here; i'm trying to connect this display to an MLX90614 Evaluation Board. I'm a bit lost on the pin connections. Any suggestions? Thanks

  • gvorster / about 6 years ago / 1

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

  • Member #851722 / about 7 years ago * / 1

    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".

  • Member #892241 / about 7 years ago / 1

    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!!

    • Member #916385 / about 7 years ago / 1

      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.

  • Member #760536 / about 8 years ago / 1

    never mind i got it

  • Member #760536 / about 8 years ago / 1

    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?

  • Member #798236 / about 8 years ago / 1

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

    This corrects the issues with the fonts.

  • Member #798236 / about 8 years ago / 1

    I figured it out. Works nice now.

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

  • Member #798236 / about 8 years ago / 1

    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.

      • Member #798236 / about 8 years ago / 1

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

        This corrects the issues with the fonts.

  • Julien Vanier / about 8 years ago / 1

    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.

  • kbowerma / about 9 years ago / 1

    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.

  • liyanage / about 9 years ago / 1

    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:

    Note that this modified version only supports SPI for now.

  • Member #620683 / about 9 years ago / 1

    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

  • Member #292976 / about 9 years ago / 1

    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?

    • Joel_E_B / about 9 years ago / 1

      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 an issue with this tutorial content, please send us your feedback!