Pictiva 128x64x4 OLED displays (serdisplib)

disclaimer / info:

DISCLAIMER:
THIS IS EXPERIMENTAL SOFTWARE AND HARDWARE. USE AT YOUR OWN RISK. THE MAINTAINER(S) OF THESE PAGES AND THE DEVELOPER(S) OF SOFTWARE AND HARDWARE PRESENTED ON THESE PAGES CAN NOT BE HELD LIABLE UNDER ANY CIRCUMSTANCES FOR DAMAGE TO HARDWARE OR SOFTWARE, LOST DATA, OR OTHER DIRECT OR INDIRECT DAMAGE RESULTING FROM THE USE OF THIS SOFTWARE OR HARDWARE. IF YOU DO NOT AGREE TO THESE CONDITIONS, YOU ARE NOT PERMITTED TO USE OR FURTHER DISTRIBUTE THIS SOFTWARE OR TO USE ANY TEMPLATES FOR BUILDING HARDWARE PRESENTED HERE.

this page deals with connecting a Pictiva 128x64x4 OLED display to a parallel port and drive it using serdisplib
i'm not responsible for the content of external web pages
external web pages will generally open in separate browser windows or tabs
english is not my native language. please keep that in mind (corrections of english grammar and formulations are very welcome!)
email: mrwastl at users.sourceforge.net

Pictiva 128x64x4:

description

Osram Pictiva 128x64x4 is an OLED display with 16 yellow or greenlevels. its screen diagonal is 2.7".

specifications
resolution	128x64
colours	16 greyscale levels
controller	SSD0323
backlight	not needed (OLED -> self emitting)
adjustable contrast	yes
dimensions	module size: 89.7 x 46.7 mm; display area: 61.4 x 30.7 mm (datasheet)
name in serdisplib	"OLED128X64X4" (example: `serdisp_init(sdcd, "OLED128X64X4", "");` )

some images


output generated by `testserdisp`	output generated by `graphlcd`

some test output rendered by `multidisplay`	test output generated by `multidisplay` on a solaris 10 box

perfect view even when looking from above or sidewise	... and readable too

top ^

configuration notes

configuration notes for `graphlcd`

the default colour in graphlcd is set to black. current versions of graphlcd only draw information (when background and foreground colour are set to default) when using the foreground colour.
when using OLEDs (and depth > 1) the problem now is that information is only visible if the drawing colour is NOT black (because the background of the whole display is black). because of this the foreground colour has to be set to something else (usually white (0xFFFFFF)).

example configuration in graphlcd

 [serdisp]
 Driver=serdisp
 Device=/dev/parport0
 Controller=OLED128X64X4
 FGColour=0xFFFFFF

top ^

connecting a Pictiva 128x64x4 OLED display to the parallel port:

wiring

circuit:

connecting a Pictiva 128x64x4 OLED display to the parallel port

part list:


    Part#   Type                Value                  Annotation
    ---------------------------------------------------------------------------------------
    R1-R12  Resistor            1 kOhm       
    R13     Resistor            10 kOhm
    R14     Resistor            820 kOhm
    C1-C3   Capacitor           4.7 uF
    C4      Capacitor           10 uF

annotations:

the circuit is hard-wired to parallel bus data-transer
interface mode: 8080 (BS1 and BS2 wired to VDD)
hardware reset is used
LCD/D0 (pin 12) must be connected to PARPORT/D0 (pin 2), LCD/D1 (pin 11) must be connected to PARPORT/D1 (pin 3), and so on

top ^

passing options through serdisp_init():

intro

using the third parameter of serdisp_init(), driver specific options and custom wiring can be set.
common information about passing options and customisable wiring can be found in a separate document.

    examples:
    
      serdisp_init(sdcd, "OLED128X64X4", "CONTRAST=5");
      serdisp_init(sdcd, "OLED128X64X4", "INVERT=YES;INTERFACE=6800");

options

identifier	short	remark	default
ROTATE	ROT	rotate display (1 == 180 degrees)	0
INVERT	INV	invert display	0
DELAY		delay after each write/read operation. 0 .. no delay 1 .. one call of gettimeofday() >1 .. delay at least x nanoseconds	0
CONTRAST		set display contrast	5
INTERFACE	MODE	interface mode (0 .. 8080, 1 .. 6800, 2 .. SPI)	0
WIRING	WIRE	pre-defined or customisable wiring	0

ranges, aliases

identifier	range	aliases
ROTATE	0, 1, 90, 180, 270	YES=180, NO=0, TRUE=180, FALSE=0
INVERT	0, 1	YES=1, NO=0, TRUE=1, FALSE=0
DELAY	>= 0	NONE=0
CONTRAST	[0, 10]
INTERFACE	0, 1, 2	8080=0,6800=1,SPI=2,SERIAL=2

pre-defined wiring definitions

identifier	numeric id	protocol	description
Original	0	PAR	Original wiring
OriginalSWRes	1	PAR	Original wiring w/ software reset
SPI	3	PAR	simple SPI wiring

display signals

identifier	description	mandatory
parallel modes (8080, 6800)
D0 - D7	8 bit wide data bus	*
CS	chip select input, active low	*
DC	data or command	*
WR	write signal, active low	*
RD	read signal, active low
RESET	reset signal, active low; optional if wired to a hardware reset circuit
serial mode (SPI)
SDA	serial data	*
SCLK	serial clock	*
CS	chip select input, active low	*
DC	data or command	*
RESET	reset signal, active low; optional

top ^

links:

data sheets, technical informations
display datasheet	local copy of Pictiva 128x64x4 display datasheet	(english)	OLED_128X64_Gelb.pdf
technical reference	local copy of SSD0323 controller technical reference	(english)	Treiber_IC-SSD0323_OLED_128x64_GELB.pdf

links to other projects
Jens Dietrich	OLED Display - PICTIVA von Osram	(german)	http://www.icplan.de/seite24.htm

top ^

history:

2008-01-11	added configuration notes (thanks to apollo71 from vdr-portal for pointing this out)
2007-08-26	removed erraneous range description for non existing option depth
2007-08-25	first release

top ^

OLED Pictiva 128x64x4

disclaimer / info: