Solder Header
Before you start wiring, a strip of header must be soldered onto the OLED. It is not possible to "press-fit" the header, it must be attached!
I2C or SPI
The nice thing about the 128x64 OLEDs is that they can be used with I2C (+ a reset line) or SPI. SPI is generally faster than I2C but uses more pins. It's also easier for some microcontrollers to use SPI. Anyways, you can use either one with this display
Using with I2C
The display can be used with any I2C microcontroller. Because the I2C interface is for 'writing' to the display only, you'll still have to buffer the entire 512 byte frame in the microcontroller RAM - you can't read data from the OLED (even though I2C is a bidirectional protocol).To start, you'll need to solder the two jumpers on the back of the OLED. Both must be soldered 'closed' for I2C to work!
Finally, connect the pins to your Arduino
- GND goes to ground
- Vin goes to 5V
- Data to I2C SDA (on the Uno, this is A4 on the Mega it is 20 and on the Leonardo digital 2)
- Clk to I2C SCL (on the Uno, this is A5 on the Mega it is 21 and on the Leonardo digital 3)
- RST to digital 4 (you can change this pin in the code, later)
This matches the example code we have written. Once you get this working, you can try a different Reset pin (you can't change the SDA and SCL pins).
Finally you can run the File→Sketchbook→Libraries→Adafruit_SSD1306→SSD1306_128x64_i2c example
Using with SPI
The breakouts are ready for SPI by default, but if you used them for I2C at some point, you'll need to remove the solder jumpers. Use wick or a solder sucker to make sure both are clear!
Finally, connect the pins to your Arduino -
(Note: If using the display with other SPI devices, D/C, CLK and DAT may be shared, but CS must be unique for each device.)
This matches the example code we have written. Once you get this working, you can try another set of pins.
Finally you can run the File→Sketchbook→Libraries→Adafruit_SSD1306→SSD1306_128x64_spi example
This guide was first published on Jul 29, 2012. It was last
updated on Sep 24, 2018.
This page (Wiring 128x64 OLEDs) was last updated on Jan 02, 2018.
-
GND goes to ground
-
Vin goes to 5V
-
DATA to digital 9
-
CLK to digital 10
-
D/C to digital 11
-
RST to digital 13
-
CS to digital 12
(Note: If using the display with other SPI devices, D/C, CLK and DAT may be shared, but CS must be unique for each device.)
This matches the example code we have written. Once you get this working, you can try another set of pins.
Finally you can run the File→Sketchbook→Libraries→Adafruit_SSD1306→SSD1306_128x64_spi example
