Skip to content

Home

Jump to bottom
James Francis Dougherty, III edited this page Jan 8, 2017 · 11 revisions

Overview

This library implements Text and Graphics functionality for the Digole Serial OLED Display modules made by Digole . Tested and verified with Digole 1.8" Serial: UART/I2C/SPI OLED True Color 160x128 OLED Module DS160128COLED-46

Serial HW Setup

For testing and initial bringup, the core library runs on Linux via USB Serial and only 3 wires (TXD, VCC, GND) are soldered to the module. Pinout is defined as below:

Black - Ground (connect to ground on OLED module)
Brown - CTS
Red - VCC (3V model used - connect to VCC on OLED module)
Orange - TXD (connect to Data on OLED module)
Yellow - RXD (not currently used - may be in the future)
Green - RTS

For more information on the FTDI USB->Serial Adapter Cable, see also: http://www.ftdichip.com/Support/Documents/DataSheets/Cables/DS_TTL-232R_CABLES.pdf

Serial Module Connections

The Digole HW module is setup as below. Pin-out for the module is from the Digole HW Adapter manual: HW Setup Diagram

Raspberry Pi SPI Connections

For real applications, the SPI port on Raspberry PI is supported by connecting the module to the pinouts as below. 200Kbps SPI mode is used, which is the maximum speed supported by the module.

SPI Module Connections

The SPI module interface on Raspberry Pi is interfaced to the Digole module using the pin mapping below.

Pi GND - Digole GND Pi 3.3V - Digole VCC Pi CE1 - Digole SS (Shift Select) Pi SCK - Digole CLK/SCL Pi MOSI - Digole DATA HW Setup Diagram

API Documentation

Doxygen is used for API Documentation

Porting

Relevant porting files and API's are defined in io.c and serial.c for the Linux platform

Testing

A test application (oledtest) is provided to verify the functionality and perform testing. Some snapshots are shown below. Black cat image Bahamas image Rendered text Blackrock Truecolor Image

A mandelbrot fractal generator program which outputs PNG has been modified to use the display library. Mandelbrot image

Additional utilities and test applications may be provided in the future.

Reference

See also: http://www.digole.com/index.php?productID=859

See also: http://www.digole.com//images/file/Tech_Data/Digole_Serial_Display_Adapter-Manual.pdf

Software

The software is written in C99, Linux kernel coding style and is distributed under the MIT License. Doxygen is used for[http://realflightsystems.com/techpubs/digole/html/](API Documentation)

Copyright

Copyright (C) 2016 Real Flight Systems

Author

James F Dougherty <[email protected]>
Clone this wiki locally