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. Support for Serial and SPI under Linux is provided.
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
The Digole HW module is setup as below. Pin-out for the module is from the Digole HW Adapter manual:
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.
Pi GND - Digole GND
Pi 3.3V - Digole VCC
Pi CE1 - Digole SS (Shift Select)
Pi SCK - Digole CLK/SCL
Pi MOSI - Digole DATA
Doxygen is used for API Documentation
Relevant porting files and API's are defined in io.c and serial.c for the Linux platform
A test application is provided to verify the functionality and perform testing.
Some snapshots are shown below.
A mandelbrot fractal generator program which outputs PNG has been modified to use the display library.
A demo which shows how to make simple controls and UI elements.
img_load is an application for loading the background image and setting startup options; you can use this to program the default start-up screen when the module boots.
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
The software is written in C99, Linux kernel coding style and is distributed under the MIT License. Doxygen is used for API Documentation
The code should be portable to many POSIX based systems here is a link to how it was used on Odroid
Copyright (C) 2016-2023 Real Flight Systems
James F Dougherty <[email protected]>