A fast and flexible library for the SSD1306 OLED screens

A SSD1306 OLED driver for various OLED screen sizes.

• Supports SPI and I2C.
• Supports partial screen updates for fast rendering.
• Supports screen buffering and direct rendering to SSD1306.
• Supports 2D graphics and text printing.

Example

#include "devices/SSD1306I2C.h"

using namespace g3rb3n;

SSD1306I2C oled(0x3C);

void setup()
{
  Serial.begin(230400);
  Serial.println();
  oled.begin();
}

void loop()
{
  oled.drawCircle(63, 31, 31);
  oled.drawRectangle(0, 0, 127, 63);
  oled.drawLine(0, 0, 127, 63);
  oled.setCursor(0,0);
  oled.print("Hello world");
  oled.display();
}

Main features

• Multiple communication bus protocols support: I2C and SPI.
• Multiple buffering options: Direct write, full buffered, page buffered, byte buffered.
• 2D graphics and Text rendering.
• Multiple font support.
• Separation of driver, io, GFX and buffers.

This library has mainly two parts. One for drawing graphics and one for communication with the OLED MCU.

Devices

Device implementations which make it easy to implement the library.

• SSD1306 Generic SSD1306 OLED screen. Configurable IO bus and buffer.
• SSD1306I2C Full size (128x64 pixel) SSD1306 OLED screen, uses I2C and ByteBuffer.
• SSD1306I2C64x48 Small size (64x48 pixels) OLED screen, uses I2C and ByteBuffer.
• SSD1306I2CNoBuffer Basic SSD1306 OLED screen driver for low memory requirements for I2C.

IO

• IOBus (Base)

• I2CBus

• SPIBus Basic read / write functionality over various buses.

• CommandDataIO For the SSD1306 command / data protocol structure.

Drivers

• SSD1306Driver A C++ driver for the SSD1306 OLED that exposes all functionality specified in the docs.

ScreenBuffers

• ScreenBuffer Byte buffer which supports full updates.
• PageUpdateScreenBuffer Byte buffer which supports paged updates.
• ByteUpdateScreenBuffer Byte buffer which supports updates per changed byte.

ScreenMap

Direct write to SSD1306 RAM support.

Fonts

A C++ fonts library.

GFX

• Graphics2D Basic 2D graphics for pixel based operations.
• GraphicsPrint For writing fonts to the screen buffer.

ToDo

• Optimize 8 micros -> 5 micros on ESP8266 CPU@160MHz I2C@700kHz.
• Write automated tests.
• Use macro from platform for enabling Wire.getClock().
• Fix macros in Graphics2D
• Include more fonts.
• Include more OLED boards: 64x48 monochrome, Nokia 5110, 2 color OLED, full color OLED, ...