chris stevens / 4spi_oled_ssd1305

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   univision_oled

Fork of spk_oled_ssd1305 by Toby Harris

Embed: (wiki syntax)

« Back to documentation index

SPKDisplay Class Reference
Public Member Functions | Data Fields

SPKDisplay Class Reference

Display class for 128x64 OLEDs using the SSD1305 driver, connected via SPI. More...

#include <4spi_oled_ssd1305.h>

Public Member Functions

 SPKDisplay (PinName mosi, PinName clk, PinName cs, PinName dc, PinName res, Serial *debugSerial=NULL)
 Create a display object connected via SPI.
void clearBuffer ()
 Completely clear the object's display representation.
void clearBufferRow (int row)
 Clear a row of the object's display representation.
void imageToBuffer (const uint8_t *image)
 Replace the object display representation with the contents of image.
void horizLineToBuffer (int y)
 Draw a horizontal line in the object's display representation.
void sendBuffer ()
 Send the object's display representation to the OLED.

Data Fields

const int * fontStartCharacter
 Font - Assign the ASCII value of the character at the start of the implemented range.
const int * fontEndCharacter
 Font - Assign the ASCII value of the character at the end of the implemented range.
uint8_t const ** fontCharacters
 Font - Assign the font, an array of 8x8px characters.

Detailed Description

Display class for 128x64 OLEDs using the SSD1305 driver, connected via SPI.

Display ie. DENSITRON - DD-12864YO-3A

This is a ground-up, minimal library. Further functionality as and when its needed or anybody wants to contribute.

This library includes two processing sketches to create a font and full-screen image in the required byte representations. Without creating your font and any images, all this library will do is blank the screen and draw horizontal lines. But at least you'll know its working!

Terminology: 'rows' are 8 pixel high rows across the display, 0 being the topmost and 7 the bottom. 'lines' are single pixel lines, origin top left.

Definition at line 57 of file 4spi_oled_ssd1305.h.

Constructor & Destructor Documentation

SPKDisplay ( PinName  mosi,
PinName  clk,
PinName  cs,
PinName  dc,
PinName  res,
Serial *  debugSerial = NULL 
)

Create a display object connected via SPI.

Parameters:
mosiSPI MOSI
clkSPI SCK
csChip Select - a digital out pin
dcData/Command - a digital out pin
resReset - a digital out pin
debugSerialAn optional serial object to log to

Definition at line 355 of file 4spi_oled_ssd1305.cpp.

Member Function Documentation

void clearBuffer (  )

Completely clear the object's display representation.

Definition at line 415 of file 4spi_oled_ssd1305.cpp.

void clearBufferRow ( int  row )

Clear a row of the object's display representation.

Parameters:
rowThe row to clear.

Definition at line 427 of file 4spi_oled_ssd1305.cpp.

void horizLineToBuffer ( int  y )

Draw a horizontal line in the object's display representation.

Parameters:
yThe y position of the line to draw

Definition at line 444 of file 4spi_oled_ssd1305.cpp.

void imageToBuffer ( const uint8_t *  image )

Replace the object display representation with the contents of image.

Parameters:
imageAn array of 1056 bytes representing an image.
Note:
The processing sketch spk_oled_screenByteMaker--processing takes 132x64 images and creates the code to declare such arrays

Definition at line 421 of file 4spi_oled_ssd1305.cpp.

void sendBuffer (  )

Send the object's display representation to the OLED.

You can safely call this once per main loop, it will only transmit the buffer contents if there has been an update

Definition at line 500 of file 4spi_oled_ssd1305.cpp.

Field Documentation

uint8_t const** fontCharacters

Font - Assign the font, an array of 8x8px characters.

Note:
The processing sketch spk_oled_fontByteMaker--processing takes characterCount*8px x 8px images and creates the code to declare the font array needed by this method

Definition at line 81 of file 4spi_oled_ssd1305.h.

const int* fontEndCharacter

Font - Assign the ASCII value of the character at the end of the implemented range.

Definition at line 75 of file 4spi_oled_ssd1305.h.

const int* fontStartCharacter

Font - Assign the ASCII value of the character at the start of the implemented range.

Definition at line 72 of file 4spi_oled_ssd1305.h.

Generated on Sat Jul 23 2022 17:07:20 by  doxygen 1.7.2