tcworld / glcd-library Goto Github PK

gLCD Library for Arduino 0022,0023, 1.0.[0 to 3], and 1.5.[0,1]

A library for Arduino which allows the communication of the Arduino with a Nokia 128px x 128px display such as those sold by SparkFun Electronics.
The library allows communication with both the Phillips and EPSON controllers, so should work with almost all of these screens(1).

Please see the example sketches and also the gLCD.h header file for extensive information as to what functions are in the library and how they work.


Ready-to-go library folders can be downloaded in ZIP format here:
https://github.com/TCWORLD/gLCD-Library/tree/master/Downloads


This library is released under the MIT License. Please refer the the file named LICENSE


The gLCD folder contains a copy of the current code version to allow the library to be cloned.


---------------------------------------------------------------------------------------
Current Version 3.5
---------------------------------------------------------------------------------------

Version 3.5 fixes a bug that prevented floating point (decimal) numbers being printed.


---------------------------------------------------------------------------------------
Version 3.3 onwards support rotating screens by either 0, 90, 180 or 270 degrees clockwise.

The rotation is specified by adding an extra variable to the end of the begin() call:
begin(Xzero, Yzero, InvertColour, driver, ROTATION_x)
where ROTATION_x is one of the following:
ROTATION_0
ROTATION_180
ROTATION_90
ROTATION_270

(If ROTATION_x is omitted, it will be assumed to be 0degrees so the new version is fully compatible with older versions)

Alternatively rotation can be set by calling:
setRotation(ROTATION_x);

For displays that use 0degree rotation, no remapping is required at all and so performance is the same as prior versions.
It should however be noted that rotating the screen by any other amount reduces the performance of the display
because the coordinates have to be remapped before being send to the screen. 

The impact is mostly confined to text and drawing lines.
Filling areas such as with Clear() or Box() doesn't require remapping so is unaffected by performance reduction.

---------------------------------------------------------------------------------------


Note 1: How to initialise screens on versions 3.x

For EPSON Displays:
---------------------------------------------------------------------------------------
begin(Xzero, Yzero, InvertColour,EPSON):
- Initialise the display. This may need changing for certain screens. Xzero and Yzero are (0,0) offset. Invert colour can be used if White appears as black, which it does on some displays.(1 = Invert, 0 = Normal)


For Phillips Displays:
---------------------------------------------------------------------------------------
begin(Xzero, Yzero, InvertColour, PHILLIPS_x) 
Where the x is a number between 0 and 3 inclusive which selects the correct phillips driver.
Choose from these four:
PHILLIPS_0
PHILLIPS_1
PHILLIPS_2
PHILLIPS_3
If you run the BasicFunctions sketch, then use trial and error to find the correct driver for your screen. Once you have found a driver which the text is not mirrored and is visible, you have found the correct one.