Neal Horman / Adafruit_GFX

A derived version of the BSD licensed Adafrut GFX library for the SSD1306 controller for an OLED 128x32 or 128x64 display using SPI or I2C.

Dependents:   servo_sensor ArchPro_TFT BLE_Display SSD1306_demo ... more

Import libraryAdafruit_GFX

A derived version of the BSD licensed Adafrut GFX library for the SSD1306 controller for an OLED 128x32 or 128x64 display using SPI or I2C.

Last commit 11 Nov 2014 by Neal Horman

This is an SPI or I2C driver, font, and graphics drawing library as initially provided by Adafruit which has been modified for use in the mbed envionment.

128x32 OLED Display

Example

/*
 *  Copyright (c) 2012 Neal Horman - http://www.wanlink.com
 *  
 *  License: MIT open source (http://opensource.org/licenses/MIT)
 *      Summary;
 *      Use / modify / distribute / publish it how you want and 
 *      if you use it, or don't, you can't hold me liable for how
 *      it does or doesn't work.
 *      If it doesn't work how you want, don't use it, or change
 *      it so that it does work.
 */
 
#include "mbed.h"
#include "Adafruit_SSD1306.h"

DigitalOut myled(LED1);

// an SPI sub-class that provides a constructed default
class SPIPreInit : public SPI
{
public:
    SPIPreInit(PinName mosi, PinName miso, PinName clk) : SPI(mosi,miso,clk)
    {
        format(8,3);
        frequency(2000000);
    };
};

// an I2C sub-class that provides a constructed default
class I2CPreInit : public I2C
{
public:
    I2CPreInit(PinName sda, PinName scl) : I2C(sda, scl)
    {
        frequency(400000);
        start();
    };
};

SPIPreInit gSpi(p5,NC,p7);
Adafruit_SSD1306_Spi gOled1(gSpi,p26,p25,p24);

I2CPreInit gI2C(p9,p10);
Adafruit_SSD1306_I2c gOled2(gI2C,p27);

int main()
{   uint16_t x=0;

    gOled1.printf("%ux%u OLED Display\r\n", gOled1.width(), gOled1.height());
    gOled2.printf("%ux%u OLED Display\r\n", gOled2.width(), gOled2.height());
    
    while(1)
    {
        myled = !myled;
        gOled1.printf("%u\r",x);
        gOled1.display();
        gOled2.printf("%u\r",x);
        gOled2.display();
        x++;
        wait(1.0);
    }
}

Adafruit_SSD1306.h

Committer:
Neal Horman
Date:
2014-10-18
Revision:
6:1be3e3b46eb7
Parent:
3:969ca9fe5e2b
Child:
7:779204e24db4

File content as of revision 6:1be3e3b46eb7:

/*********************************************************************
This is a library for our Monochrome OLEDs based on SSD1306 drivers

  Pick one up today in the adafruit shop!
  ------> http://www.adafruit.com/category/63_98

These displays use SPI to communicate, 4 or 5 pins are required to  
interface

Adafruit invests time and resources providing this open source code, 
please support Adafruit and open-source hardware by purchasing 
products from Adafruit!

Written by Limor Fried/Ladyada  for Adafruit Industries.  
BSD license, check license.txt for more information
All text above, and the splash screen must be included in any redistribution
*********************************************************************/

/*
 *  Modified by Neal Horman 7/14/2012 for use in LPC1768
 */

#ifndef _ADAFRUIT_SSD1306_H_
#define _ADAFRUIT_SSD1306_H_

#include "mbed.h"
#include "Adafruit_GFX.h"

/*=========================================================================
    SSD1306 Displays
    -----------------------------------------------------------------------
    The driver is used in multiple displays (128x64, 128x32, etc.).
    Select the appropriate display below to create an appropriately
    sized framebuffer, etc.

    SSD1306_128_64  128x64 pixel display

    SSD1306_128_32  128x32 pixel display

    You also need to set the LCDWIDTH and LCDHEIGHT defines to an 
    appropriate size

    -----------------------------------------------------------------------*/
//#define SSD1306_128_64
#define SSD1306_128_32

#define SSD_USES_SPI
//#define SSD_USES_I2C
/*=========================================================================*/

#if defined SSD1306_128_64 && defined SSD1306_128_32
    #error "Only one SSD1306 display can be specified at once in SSD1306.h"
#endif
#if !defined SSD1306_128_64 && !defined SSD1306_128_32
    #error "At least one SSD1306 display must be specified in SSD1306.h"
#endif

#if defined SSD1306_128_64
    #define SSD1306_LCDWIDTH 128
    #define SSD1306_LCDHEIGHT 64
#endif
#if defined SSD1306_128_32
    #define SSD1306_LCDWIDTH 128
    #define SSD1306_LCDHEIGHT 32
#endif

#if defined SSD_USES_SPI && defined SSD_USES_I2C
    #error "Only one communication mode can be specified at once in SSD1306.h"
#endif
#if !defined SSD_USES_SPI && !defined SSD_USES_I2C
    #error "At least one communication mode must be specified in SSD1306.h"
#endif

//#define WITHOUT_SPLASH
#define I2C_ADDRESS     0x78

#define SSD_Command_Mode    0x00
#define SSD_Data_Mode       0x40

#define SSD1306_SETCONTRAST 0x81
#define SSD1306_DISPLAYALLON_RESUME 0xA4
#define SSD1306_DISPLAYALLON 0xA5
#define SSD1306_NORMALDISPLAY 0xA6
#define SSD1306_INVERTDISPLAY 0xA7
#define SSD1306_DISPLAYOFF 0xAE
#define SSD1306_DISPLAYON 0xAF
#define SSD1306_SETDISPLAYOFFSET 0xD3
#define SSD1306_SETCOMPINS 0xDA
#define SSD1306_SETVCOMDETECT 0xDB
#define SSD1306_SETDISPLAYCLOCKDIV 0xD5
#define SSD1306_SETPRECHARGE 0xD9
#define SSD1306_SETMULTIPLEX 0xA8
#define SSD1306_SETLOWCOLUMN 0x00
#define SSD1306_SETHIGHCOLUMN 0x10
#define SSD1306_SETSTARTLINE 0x40
#define SSD1306_MEMORYMODE 0x20
#define SSD1306_COMSCANINC 0xC0
#define SSD1306_COMSCANDEC 0xC8
#define SSD1306_SEGREMAP 0xA0
#define SSD1306_CHARGEPUMP 0x8D
#define SSD1306_EXTERNALVCC 0x1
#define SSD1306_SWITCHCAPVCC 0x2

// an DigitalOut sub-class that provides a constructed default state
class DigitalOut2 : public DigitalOut
{
public:
    DigitalOut2(PinName pin, bool active = false) : DigitalOut(pin) { write(active); };
    DigitalOut2& operator= (int value) { write(value); return *this; };
    DigitalOut2& operator= (DigitalOut2& rhs) { write(rhs.read()); return *this; };
    operator int() { return read(); };
};

class Adafruit_SSD1306 : public Adafruit_GFX
{
 public:
#ifdef SSD_USES_SPI
    Adafruit_SSD1306(SPI &spi, PinName DC, PinName RST, PinName CS);
#elif defined SSD_USES_I2C
    Adafruit_SSD1306(I2C &i2c, PinName RST);
#endif
    void begin(uint8_t switchvcc = SSD1306_SWITCHCAPVCC);
    void ssd1306_command(uint8_t c);
    void ssd1306_data(uint8_t c);
    
    void clearDisplay(void);
    virtual void invertDisplay(bool i);
    void display();
    
    virtual void drawPixel(int16_t x, int16_t y, uint16_t color);
    
private:
    
    Serial pc;
    DigitalOut2 rst;
#ifdef SSD_USES_SPI
    SPI &mspi;
    DigitalOut2 cs,dc;
#elif defined SSD_USES_I2C
    I2C &mi2c;
#endif
    // the memory buffer for the LCD
    uint8_t buffer[SSD1306_LCDHEIGHT * SSD1306_LCDWIDTH / 8];
};

#endif