Let's Workshop: 128x64 7pin OLED Module


Here is a quick introduction to using 128x64 7pin OLED modules. This will provide you with an entry point to using OLED modules and help give you the confidence to begin using them in your projects.

This example will demonstrate the use of an Arduino UNO in communicating with the display using SPI communication protocol, before loading a picture on to the screen. This will use the universal 8bit graphics library created by Oliver Kraus to interface with the display chipset and provide functions to operate it.

Components

  • 1pcs Arduino UNO or Compatible - LCAA100005
  • 1pcs 0.96" 128x64 White OLED Display Module - BCAA100003
  • 7pcs Male to Female Jumper Cables - GBAA100002

Wiring

Wire the two boards together as can be seen in the image below, taking care to match the pin numbers.

Coding

The code consists of an include, initialisation, a definition and loop. First the U8glib.h library is linked to the code. This is followed by the initialisation of the display object, taking note of screen size and driving chipset. Next is a large definition, this is the byte data for a bitmap image taken from a xbm file. You can generate these types of files using a number of different imaging software. We use GIMP, ensuring the image is the right size. The file can then be opened in a text editior and the image values extracted. In the loop we first call the draw function from the library and pass it the screen coordinates, size of the image and the array the image data is held in. A final while catch is put in to restrict the loop to a single run.

Load the code below into the Arduino IDE and upload it to your board.

/*
  A simple program designed to setup and demonstrate the u8glib library and 
  a 128x64 OLED 7 pin OLED module.
 
  The program uses the u8glib library to initialise a 128x64 monochrome display module and
  displays an bitmap (xbm) image on it.
  
  modified 3 May 2019
  by Sebastian Karam - Flux Workshop
  
  The universal 8bit graphics library created by Oliver Kraus
  https://github.com/olikraus/u8glib
*/ 

#include "U8glib.h" // include the universal graphcs library

U8GLIB_SSD1306_128X64 u8g(12, 11, 10, 9, 8);	// initialise a u8g display object

const uint8_t flux_xbm[] PROGMEM = {
   0x00, 0x00, 0x00, 0xfc, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0xff, 0xff, 0x03, 0x00, 0x00,
   0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf8, 0xff, 0xff, 0x1f, 0x00, 0x00, 0x00, 0x78, 0x0e, 0x38, 0x80, 0x73, 0x00, 0x07,
   0x00, 0x00, 0xfe, 0xff, 0xff, 0x7f, 0x00, 0x00, 0x00, 0x7e, 0x0e, 0x38, 0x80, 0x73, 0x00, 0x07, 0x00, 0x80, 0xff, 0xff, 0xff, 0xff, 0x01, 0x00,
   0x00, 0x7f, 0x0e, 0x38, 0x80, 0x73, 0x00, 0x07, 0x00, 0xc0, 0xff, 0xff, 0xff, 0xff, 0x03, 0x00, 0x80, 0x0f, 0x0e, 0x38, 0x80, 0xf3, 0x80, 0x07,
   0x00, 0xf0, 0xff, 0xff, 0xff, 0xff, 0x0f, 0x00, 0x80, 0x03, 0x0e, 0x38, 0x80, 0xe3, 0x80, 0x03, 0x00, 0xf8, 0xff, 0x07, 0xe0, 0xff, 0x1f, 0x00,
   0xc0, 0x01, 0x0e, 0x38, 0x80, 0xe3, 0xe3, 0x03, 0x00, 0xfc, 0xff, 0x00, 0x00, 0xfe, 0x3f, 0x00, 0xc0, 0x01, 0x0e, 0x38, 0x80, 0xc3, 0xff, 0x01,
   0x00, 0xfe, 0x1f, 0x00, 0x00, 0xf8, 0x7f, 0x00, 0xc0, 0x01, 0x0e, 0x38, 0x80, 0x83, 0xff, 0x00, 0x00, 0xff, 0x07, 0x00, 0x00, 0xe0, 0xff, 0x00,
   0xc0, 0x01, 0x0e, 0x38, 0x80, 0xc3, 0xff, 0x01, 0x80, 0xff, 0x03, 0x00, 0x00, 0x80, 0xff, 0x01, 0xc0, 0x1f, 0x1e, 0x78, 0x80, 0xe3, 0xe3, 0x03,
   0xc0, 0xff, 0x00, 0x00, 0x00, 0x00, 0xff, 0x03, 0xc0, 0x1f, 0x1c, 0x70, 0xc0, 0xe1, 0x80, 0x03, 0xc0, 0x7f, 0x00, 0x00, 0x00, 0x00, 0xfe, 0x07,
   0xc0, 0x1f, 0x7c, 0xf0, 0xf1, 0xf1, 0x80, 0x07, 0xe0, 0x3f, 0x00, 0x00, 0x00, 0x00, 0xfc, 0x07, 0xc0, 0x01, 0xf8, 0xe1, 0xff, 0x70, 0x00, 0x07,
   0xf0, 0x1f, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x0f, 0xc0, 0x01, 0xf0, 0xc3, 0x7f, 0x70, 0x00, 0x07, 0xf0, 0x0f, 0x00, 0x00, 0x00, 0x00, 0xf0, 0x1f,
   0xc0, 0x01, 0xc0, 0x01, 0x1f, 0x70, 0x00, 0x07, 0xf8, 0x0f, 0x30, 0x00, 0x00, 0x18, 0xe0, 0x1f, 0xc0, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
   0xf8, 0x07, 0x7c, 0x00, 0x00, 0x7c, 0xe0, 0x3f, 0xc0, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xfc, 0x03, 0x7c, 0x00, 0x00, 0x7e, 0xc0, 0x3f,
   0xc0, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xfc, 0x03, 0xfc, 0x00, 0x00, 0x7e, 0x80, 0x3f, 0xc0, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
   0xfc, 0x01, 0xfc, 0x00, 0x00, 0x7e, 0x80, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xfe, 0x01, 0xfc, 0x00, 0x00, 0x7e, 0x80, 0x7f,
   0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xfe, 0x00, 0xfc, 0x00, 0x00, 0x7e, 0x00, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
   0xfe, 0x00, 0xfc, 0x01, 0x00, 0x3f, 0x00, 0xff, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0x00, 0xf8, 0x01, 0x80, 0x3f, 0x00, 0xff,
   0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0x00, 0xf8, 0x03, 0x80, 0x3f, 0x00, 0xfe, 0xc0, 0x01, 0x1c, 0xfc, 0x00, 0x1c, 0x81, 0x01,
   0x7f, 0x00, 0xf0, 0x0f, 0xe0, 0x1f, 0x00, 0xfe, 0xc0, 0x01, 0x1c, 0xfe, 0x03, 0xbf, 0xc3, 0x01, 0x7f, 0x00, 0xe0, 0x3f, 0xf8, 0x0f, 0x00, 0xfe,
   0xc0, 0x01, 0x1c, 0xff, 0x87, 0x9f, 0xc3, 0x01, 0x7f, 0x00, 0xe0, 0xff, 0xff, 0x0f, 0x00, 0xfe, 0xc0, 0x01, 0x9c, 0x07, 0xc7, 0x83, 0xe3, 0x00,
   0x7f, 0x00, 0xc0, 0xff, 0xff, 0x07, 0x00, 0xfe, 0xc1, 0x01, 0x9c, 0x03, 0xce, 0x81, 0xf3, 0x00, 0x7f, 0x00, 0x80, 0xff, 0xff, 0x03, 0x00, 0xfe,
   0xc1, 0x01, 0xdc, 0x01, 0xee, 0x80, 0x73, 0x00, 0x7f, 0x00, 0x80, 0xff, 0xff, 0x03, 0x00, 0xfe, 0xc1, 0x71, 0xdc, 0x01, 0xec, 0x80, 0x7f, 0x00,
   0x7f, 0x00, 0xc0, 0xff, 0xff, 0x07, 0x00, 0xfe, 0xc1, 0xf9, 0xdc, 0x01, 0xec, 0x80, 0xff, 0x00, 0x7f, 0x00, 0xe0, 0xff, 0xff, 0x0f, 0x00, 0xfe,
   0xc0, 0xfd, 0xdd, 0x01, 0xee, 0x80, 0xff, 0x01, 0x7f, 0x00, 0xf0, 0x0f, 0xf0, 0x1f, 0x00, 0xfe, 0xc0, 0x8f, 0x9f, 0x03, 0xee, 0x80, 0xc3, 0x03,
   0x7f, 0x00, 0xf0, 0x07, 0xc0, 0x1f, 0x00, 0xfe, 0xc0, 0x07, 0x9f, 0x07, 0xe7, 0x80, 0x83, 0x03, 0xff, 0x00, 0xf8, 0x03, 0x80, 0x3f, 0x00, 0xfe,
   0xc0, 0x03, 0x1e, 0xff, 0xe7, 0x80, 0x03, 0x07, 0xff, 0x00, 0xf8, 0x01, 0x00, 0x3f, 0x00, 0xff, 0xc0, 0x03, 0x1e, 0xfe, 0xe3, 0x80, 0x03, 0x07,
   0xfe, 0x00, 0xfc, 0x00, 0x00, 0x7f, 0x00, 0xff, 0xc0, 0x01, 0x1c, 0xf8, 0xe0, 0x80, 0x03, 0x07, 0xfe, 0x00, 0xfc, 0x00, 0x00, 0x7e, 0x00, 0x7f,
   0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x02, 0xfe, 0x01, 0xfc, 0x00, 0x00, 0x7e, 0x80, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
   0xfc, 0x01, 0xfc, 0x00, 0x00, 0x7e, 0x80, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xfc, 0x03, 0xfc, 0x00, 0x00, 0x7e, 0x80, 0x3f,
   0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xfc, 0x03, 0x7c, 0x00, 0x00, 0x7c, 0xc0, 0x3f, 0x00, 0x00, 0x1c, 0x00, 0x00, 0x00, 0x00, 0x00,
   0xf8, 0x07, 0x78, 0x00, 0x00, 0x3c, 0xe0, 0x3f, 0x00, 0x00, 0x1c, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x0f, 0x00, 0x00, 0x00, 0x00, 0xe0, 0x1f,
   0x00, 0x00, 0x1c, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf0, 0x0f, 0x00, 0x00, 0x00, 0x00, 0xf0, 0x1f, 0x80, 0x1f, 0x1c, 0x00, 0xe0, 0x01, 0x7c, 0x00,
   0xf0, 0x1f, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x0f, 0xc0, 0x1f, 0xdc, 0x07, 0xf8, 0x07, 0xff, 0x01, 0xe0, 0x3f, 0x00, 0x00, 0x00, 0x00, 0xfc, 0x07,
   0xe0, 0x1f, 0xfc, 0x1f, 0xfc, 0x8f, 0xff, 0x03, 0xc0, 0x7f, 0x00, 0x00, 0x00, 0x00, 0xfe, 0x07, 0xe0, 0x00, 0xfc, 0x3f, 0x0e, 0x8e, 0x83, 0x03,
   0xc0, 0xff, 0x00, 0x00, 0x00, 0x00, 0xff, 0x03, 0xe0, 0x00, 0x7c, 0x3c, 0x06, 0xdc, 0x81, 0x07, 0x80, 0xff, 0x03, 0x00, 0x00, 0x80, 0xff, 0x01,
   0xe0, 0x3f, 0x3c, 0x78, 0x07, 0xdc, 0x01, 0x07, 0x00, 0xff, 0x07, 0x00, 0x00, 0xe0, 0xff, 0x00, 0xc0, 0x7f, 0x1c, 0x70, 0x07, 0xd8, 0x01, 0x07,
   0x00, 0xfe, 0x1f, 0x00, 0x00, 0xf8, 0x7f, 0x00, 0x80, 0xff, 0x1c, 0x70, 0x07, 0xdc, 0x01, 0x07, 0x00, 0xfc, 0xff, 0x00, 0x00, 0xfe, 0x3f, 0x00,
   0x00, 0xe0, 0x1c, 0x70, 0x06, 0xdc, 0x01, 0x07, 0x00, 0xf8, 0xff, 0x07, 0xe0, 0xff, 0x1f, 0x00, 0x00, 0xe0, 0x1c, 0x70, 0x0e, 0xce, 0x83, 0x03,
   0x00, 0xf0, 0xff, 0xff, 0xff, 0xff, 0x0f, 0x00, 0xe0, 0xff, 0x1c, 0x70, 0xbc, 0xcf, 0xef, 0x03, 0x00, 0xc0, 0xff, 0xff, 0xff, 0xff, 0x03, 0x00,
   0xe0, 0x7f, 0x1c, 0x70, 0xf8, 0xc7, 0xff, 0x01, 0x00, 0x80, 0xff, 0xff, 0xff, 0xff, 0x01, 0x00, 0xe0, 0x3f, 0x1c, 0x70, 0xf0, 0xc1, 0x79, 0x00,
   0x00, 0x00, 0xfe, 0xff, 0xff, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x01, 0x00, 0x00, 0x00, 0xf8, 0xff, 0xff, 0x1f, 0x00, 0x00,
   0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x01, 0x00, 0x00, 0x00, 0xc0, 0xff, 0xff, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x01, 0x00,
   0x00, 0x00, 0x00, 0xfc, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
};

void setup(void) {
}

void loop(void) {
  u8g.drawXBMP( 0, 0, 128, 64, flux_xbm); // send the xbm image to the display, specifying position and size
  while (1==1) {} // set the loop to only run once
}

Running

With the board loaded with the program and all the connections made the screen will produce an output like the one seen below. Do note that although there appears to be lines in the colour this is a result of refresh rates and cameras. To the human eye, it is uniform colour.

What to try next?

  • Investigate further display functions
  • Update the screen regularly to produce a digital dial
  • Use the cursor and fonts to build a visual output for a projects menu structure
  • Check the soldering communication table on the rear of the board - you might want to try a different communication protocol
Previous article Let's Workshop: 20x4 LCD Module and I2C Adapter
Next article Let's Workshop: 128x64 6pin OLED Module

Leave a comment

* Required fields