Jump to content
Sign in to follow this  
aBUGSworstnightmare

SSD1308 I2C OLED - Stellaris driver API

Recommended Posts

Hi there,

 

I have written a driver API for SSD1308 based I2C OLEDs (can be used with SSD1306 too with no/only minor changes in the initialization routine) which I will use for my C3ii INS Stellaris Booster Pack (http://e2e.ti.com/group/microcontrollerprojects/m/msp430microcontrollerprojects/664688.aspx).

 

The driver is comparable to the 'Simple Display' example from the EVALBOT.

 

The API relies on my Stellaris I2C driver which you can find here: http://forum.stellarisiti.com/topic/417-i2c-with-stellaris-lm4f120h5qr-working-driver-api-example-code/ or here http://e2e.ti.com/support/microcontrollers/stellaris_arm_cortex-m3_microcontroller/f/473/t/235926.aspx .

 

The API allows displaying:

1.) Images (black&white)

3162.SANY0061.JPG

 

 

The image needs to be a black&white .BMP-Image file which must be converted into a data array for use with the API. A little programm called 'LCDAssistent' is included in the attached .zip file which can be used for this task. LCDAssistant is ease to use and also allows inclusion of the image size into the output array. Refer to the file 'logos.h' for examples (original .bmp-file is included too). 

 

2.) Centered Text

3566.SANY0066.JPG

 

If the supplied text is to large to fit the screen it will be clipped left and right.

 

3.) Strings

5661.SANY0063.JPG

 

The string will be printed 'until space lasts'! That means: you can't supply a string that is to long.

 

 

4.) It makes use of an undocumented SSD1306/1308 command called 'Double-Size-Font' (0xD6). 

After receiving this command, the SSD1308 OLED controller displays  each scan line of the first 4 text lines twice. This is resulting in a font which is 2 pages large.

5078.SANY0067.JPG

 

 

Using the 0xD6 command will not affect/alter the content of the SSD1308 GDDRAM! When in 'Double-Size-Font'-Mode, the 'Set Display Start Line' command is used to display the pages PAGE4 to PAGE7.

 
3644.SANY0063.JPG
Step1: Initial display content

 

7367.SANY0064.JPG

Step 2: Double-Size-Font-Mode switched ON

 

 

1602.SANY0065.JPG

Step 3: Display start line set to 0x32 (start of PAGE4)

 

6758.SANY0063.JPG

Step 4: Double-Size-Font Mode switched OFF and Display Start Line set back to 0x40 (beginning of the PAGE1)

 

The display shown/used is a 0.96in 128x64pixels white OLED from WIDE.Hk. Here's the link to the product page: http://www.wide.hk/products.php?product=I2C-0.96%22-OLED-display-module-%28-compatible-Arduino-%29

 

EDIT (01/18/2012):

Added a new version of my I2C OLED API! The r03-release includes some new functions:

 

 

// Clears a partial row on the OLED display.

void Display128x64x1ClearArea(unsigned long ulI2CBase, unsigned long ulXStart, unsigned long ulXEnd, unsigned long ulY)

 

 

// Displays a length-restricted string on the OLED display at the current cursor position.

void Display128x64x1StringCurrentPos(unsigned long ulI2CBase, const char *pcStr, unsigned long ulLen)

 

 

// Set the Cursor to the specified position on the OLED display (GDDRAM address).

void Display128x64x1SetCursor(unsigned long ulI2CBase, unsigned long ulX, unsigned long ulY)

 

 

// A simple I2C based printf function supporting \%c, \%d, \%p, \%s, \%u, \%x, and \%X for use with OLED displays.

void I2COLEDprintf(const char *pcString, ...)

 

 

Please report any issues/improvements!

 

 

Enjoy your OLEDs!

Kind regards

aBUGSworstnightmare

I2C OLED 128x64 - API_r03.zip

Share this post


Link to post
Share on other sites

Hi there,

 

my OLED driver API for SSD1308/1306 is ready. Find it enclosed to this post.

 

I will add a description tomorrow! For you 'early adapters': more info is here http://e2e.ti.com/support/microcontrollers/stellaris_arm_cortex-m3_microcontroller/f/473/t/238721.aspx

 

Enjoy your OLEDs!

Kind regards

aBUGSworstnightmare

Thanks!

Is this I2C? I think it is, since you shared your I2C example before.

Share this post


Link to post
Share on other sites

Thanks!

Is this I2C? I think it is, since you shared your I2C example before.

Hi bluehash,

 

yes, it is a I2C OLED from wide.hk. I've used the white version but I will try to get hands-on the Area-Colored version too.

 

aBUGSworstnightmare

Share this post


Link to post
Share on other sites

Hi bluehash,

 

yes, it is a I2C OLED from wide.hk. I've used the white version but I will try to get hands-on the Area-Colored version too.

 

aBUGSworstnightmare

If it's not too much, I can help organize a Group Buy for 10 units. Maybe they will go cheaper.

Share this post


Link to post
Share on other sites

Well, I doubt that they will get cheaper! Shipping is not that expensive (and was really fast last time), so I think I will order some to play with in the near future.

 

@ all of you! WATCH THIS SPACE FOR AN UPDATE ON MY OLED API!!!!

 

Here are some lines of code for you to think about:

    ...

    uccount = 170;

    Display128x64x1SetCursor(I2CTELEMETRIEBUS, 20, 0);

    I2COLEDprintf("uccount = %4d", uccount);

    Display128x64x1SetCursor(I2CTELEMETRIEBUS, 0, 1);

    I2COLEDprintf("uccount = 0x%x", uccount);

    ...

 

And this is the result which you'll see on the OLED:

 

4431.SANY0071.JPG

 

Yes, you're right! 'I2COLEDprintf()' is very similar to the C library 'fprintf()' function. Here's an excerpt from the comments:

...

//! A simple I2C based printf function supporting \%c, \%d, \%p, \%s, \%u,
//! \%x, and \%X for use with OLED displays.
...

//! - \%c to print a character
//! - \%d or \%i to print a decimal value
//! - \%s to print a string
//! - \%u to print an unsigned decimal value
//! - \%x to print a hexadecimal value using lower case letters
//! - \%X to print a hexadecimal value using upper case letters 
//! - \%p to print a pointer as a hexadecimal value
//! - \%\% to print out a \% character
//!
//! For \%s, \%d, \%i, \%u, \%p, \%x, and \%X, an optional number may reside
//! between the \% and the format character, which specifies the minimum number
//! of characters to use for that value; if preceded by a 0 then the extra
//! characters will be filled with zeros instead of spaces.  For example,
//! ``\%8d'' will use eight characters to print the decimal value with spaces
//! added to reach eight; ``\%08d'' will use eight characters as well but will
//! add zeroes instead of spaces.

 

 

Rgds
aBUGSworstnightmare 

Share this post


Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
Sign in to follow this  

×