Skip to content
A lean library for SSD1306 0.96" I2C OLED.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A lean library for Arduino STM32, to use the ubiquitous SSD1306 0.96" I2C Oled display. Derived out of Daniel Turton's OzOled project 2014/2015.

The original target for this library was the $3 STM32F030F4P6 board, using Arduino IDE. This target has small flash memory, and the established oled libraries are too large to compile into flash. miniOled has minimalist code (just enough to be useful).

It also optionally uses software I2C library "SoftWire" to allow choice of I2C pins. The native Arduino IDE Wire configuration for this board has an allocation of I2C pins (PA10/PA9) that conflicts with how the cheap boards are constructed. These (The "STM32F030F4P6 Demo" board) designate PA9 and PA10 as UART TX/RX, and connect these to the uart header.

In this code, Oled updates are direct (no canvas buffer) and partial. But it is still slow, not very "snappy." The native I2C method is not much faster than the software method.


#include "miniOled.h"   // that's it. We have an "Oled" object

Oled.init(sda, scl); // in setup(). sda and scl will default (PA6/PA5) if omitted
(The sda/scl parameters will be ignored in case of not using SoftWire. PA10/PA9 will be used.)

Oled.wideFont = true;  // Tiny chars get double-width
Oled.chrSpace = 1;   // inter-char space. Use 1, 2 or 3.
Oled.printChar(chr, X, Y);
Oled.printString(str, X, Y);
Oled.printInt(int_number, X, Y);
Oled.drawLine(page, pattern);
Oled.printNumber(long_number, X, X);
Oled.printNumber(float_num, precision, X, Y);
Oled.drawBitmap(*imagebitmap, X, Y, width, height);
Oled.printBigNumber(char* "2.1", X, Y);  // Only "0"-"9" or [-./: ]   BigNumbers are 24x32
Oled.printNigNumber(-56, X, Y);  // integer

Oled.setCursorXY(Column, Row);
Oled.setPageMode();  // each (little) number printing is within one page
Oled.setHorizontalMode(); // (little) text can flow down whole display.

A "page" (0-7) is a horizontal slice of display, 8 pixels deep.  8 pages total.
"Pattern" is an 8bit pixel pattern to set which pixel lines to paint across a page.
X and Y are column / row cursor positions. In 8-pixel jumps! So X across is 0 - 15, Y down 0 - 7.
Bignumbers can use X 0-12, Y 0-4, else they fall off the display.
Multiple write without re-setting cursors will move across as expected.

There should be no reason that miniOled would not readily work in other scenarios.

miniOled code is here:

You will also need these for software I2C:

In file miniOled.cpp there is a line #define SOFTWIRE Leave this defined to use software I2C. Undefine it to use regular Arduino (STM32) "Wire.h". Using software I2C saves about 1.5k flash.

You can’t perform that action at this time.