!

Digital Solutions Serial Character/Graphic LCD/OLED User Manual

!
Digole Serial:UART/I2C/SPI Character/Graphic LCD/OLED Display Module User
Manual

(last updated: Mar. 3rd 2014)
!
This manual will describe most common futures for our Serial LCD/OLED displays and modules, each particular
products may have different looks, size and material, but all interface to your master circuits and control commands
are same, that means you can switch Digole Serial display in your application without any modification of you
master circuit and software.
Our Serial display products are list in figure-1, you can purchase them with lowest price at: http://www.digole.com/
index.php?categoryID=153
!
What benefits you if using these products in you electronic projects?

• Save lots of the I/O resources: these products only need 1 to 3 I/O pins from your master controller that
depends on the communication type you want.
• Easy to use: the commands sending to products are easy to remember and understand.
On Graphic serial products:
• Save huge memory space to store font and start screen on graphic display: in graphic product, there are 7
preloaded fonts ready for your application, and also have 16KB memory space for your user fonts, once you
uploaded the start screen or user fonts, it will stored in products.
• Using user fonts function, you can display any graphs or characters in any language
• These products already integrated graphic functions such as: draw line/rectangle/circle/image, send few bytes
of instruction to products, it will do it for you, that also save your lots of code space
• You can display contents in 4 different directions: 0º, 90º, 180º, 270º(clockwise) on same screen, the product
will map the coordinate accordingly.

FEATURES:
• Communication mode: UART/I2C/SPI, • Low power consumption: less than 4mA (for
detect your setting automatically adapter only, completed module may higher
• Receiving buffer: 64/256 bytes depends on the backlight power consumption)
• Work with all microcontroller and
• Simple command sets, easy to remember
microprocessor • Simple graphic engine integrated (Graphic
• Communication signal can work on 3.3V Products)
and 5.0V TTL • 7 preloaded fonts, font’s data structure full
• Default setting: UART baud 9600bps, compatible with U8Glib(Graphic Products)
I2C 0x27 address • UART baud (bps): 300, 1200, 2400, 4800, 9600,
14400, 19200, 28800, 38400, 57600, 115200

1 of 9
 ! Digital Solutions Serial Character/Graphic LCD/OLED User Manual
!

!
Figure-1
!

2 of 9
 ! Digital Solutions Serial Character/Graphic LCD/OLED User Manual
!

! !
Meduim Size (7x4.6cm) 12864 Serial LCD+Backlight Small size(4.6x3cm) 12864 Serial LCD+Backlight

! 

1.8” 160x128 True Color Serial OLED Module
 0.96” 96x64 65K Color Serial OLED Module

3 of 9
! Digital Solutions Serial Character/Graphic LCD/OLED User Manual
!
!
What are adapters used for?

Character adapters can work with most 1602,1604,2002,2004 and 4002 character LCDs. 

The Universal Graphic adapter work with 128 x 64 dots LCD, which LCD controller is ST7920 or KS0108 or
ST7565. 

We didn’t sell adapters with a LCD due to you might already have LCDs or can easy to get one at low price from
somewhere, so this way gives you more flexible options on your project.

How to set up the communication mode?

There are 3 different communication modes on all products: UART, I2C and SPI, what you need is just use solder to
short the I2C/SPI jumper on adapter and make it works at I2C or SPI, if both jumpers are open, it works at UART,

you can find a similar jumper like this: ! on board.

Protocols:

• UART : 8-N-1, 8bits, No parity bit, 1 stop bit.

• I2C: Slave Mode, 7-bit address, default address is Hex:27, change able. This mode may give you a headache
due to more signal options in I2C, but we make it works as standard, you just need setup your I2C on master
controller as Standard Master Mode.

• SPI: 8-bits, MSB first, data on raise edge of SCK sampled; this is Standard setting on SPI too.

4 of 9
! Digital Solutions Serial Character/Graphic LCD/OLED User Manual
!
!
Character/Graphic Display Shared Command: (B-one byte, B…-Bytes)

Char
 Mono- Color-

Command Description Arduino lib function note Display Graph Graph

The module will

CLear screen and set the display position to first not execute this
CL Column and first Row (x=0.y=0), for graphic LCD, clearScreen(); command until √ √ √
it also set the font to default and turn off the cursor. other command
received.

enableCursor();

CSB set CurSor on/off
disableCursor();
B=0 off, B=1 on √ √ √

unavailable on
backLightOn();

BLB Set Back Light ON/OFF, B=0 or 1, 0 off, 1 on
backLightOff();
Character Adapter √ √ √
V1.x

Set Screen ON/OFF to save power
 For GLCD/OLED

SOOB
B=0 or 1, 0 off, 1 on only
√ √ √

Display Config on/off, the factory default set is on,

so, when the module is powered up, it will display displayConfig(0);

DCB
current communication mode on LCD, after you displayConfig(1);
B=0 off, B=1 on √ √ √
design finished, you can turn it off

When adapter
Set UART Baud, B are ASCII characters, the
power up or reset,
available values are: “300”, “1200”, “2400”,”4800”, Set BAUD when initial
SBB…
“9600”, “14400”, “19200”, “28800”, “38400”, the class
always start with √ √ √
9600bps Baud
“57600”,”115200”
rate

Set I2C Address,the default address is 0x27, the Change address to

SI2CAB
adapter will store the new address in memory
setI2CAddress(0x34);
0x34
√ √ √

The last 4 B
should
Set Text Columns and Rows, this command will
STCRBB be“\x80\xC0\x94\
BBBB
config your LCD if other than 1602 and the chip is setLCDColRow(20,4);
xD4”, it mapped
√
other than KS0066U/F / HD44780
the starting RAM
address on LCD

Only affect the

set Text Position for following display, BB are x and
TPBB
y
setPrintPos(x,y); following “TT” √ √ √
command

print(string);

The print function
display TexT string, the text will wraped in next row print(int);

in Arduino, can
if the current row fulled, the Text Postion will be print(char);

TTB…
changed to the last char displyed, this command print(float);

also print other √ √ √
data and format
ended by 0x00 or 0x0D received print(double);

the out put.
drawStr(x,y,string);

Manual CommanD: send command B to display Use it if you want

MCDB bypass the adapter directCommand(0xaf); to control the √ √ √
display directly

Manual DaTa: send data B to display bypass the Same as above

MDTB
adapter
directData(0x88); √ √ √

!
!

5 of 9
! Digital Solutions Serial Character/Graphic LCD/OLED User Manual
!
!
Graph Display Command: (B-one byte, B…-Bytes) for mono and color serial Graphic display only

Mono
 Color

Command Description Arduino lib function note
Graphic Graphic

set Graphic Position for following draw line

GPBB
command, BB are x and y in byte
setPrintPos(x,y,1); X,y=0 to 255 √ √

Set the Display Mode for on coming command, the

available values for B are: “!””~” not, “|” or, “^” xor, Like the Bitwise
DMB
“&” and, this means the next drawing pixel will logic
setMode(‘!’);
Operator in C
√ √
operation with pixel already on screen.

Display
image width, 4
DIMBBB Each byte present 8 pixels, if the image width not drawBitmap(x,y,width,
BB… divide 8, the last byte of a row only contain few height,*data);
√ √
pixels, eg. For width of 9 to 16, you need 2 bytes for
a row

setRotation(0);

The setRotation();
undoRotation();

Send graphic fuction Direction, the value of B is 0 to will accept 0 to 3
SDB
3, represent0 to 270 degree respectively.
setRot90();

represent0 to 270
√ √
setRot180();

degree respectively
setRot270();

Set display ConTrast, only for some models, Only for Only for ST7565
CTB
ST7565 LCD Controller
setContrast(30);
LCD Controller
√

In order to
compatible with u8g,
Draw a Filled Rectangle, 4 B are: X,Y(left top), X,Y drawBox(x,y,width,hei
FRBBBB
(right bottom) ght);
drawBox() in √ √
Arduino use width
and height

drawFrame () in
Draw a Rectangle, 4 B are: X,Y(left top), X,Y (right drawFrame(x,y,width,h
DRBBBB
bottom) eight);
Arduino use width √ √
and height

drawCircle(x,y,r,f);
 f=1 means filled

CCBBBB Draw a CirCle, 4 B are: X,Y, radius, filled or not
drawDisc(x,y,r); circel
√ √

Draw a Pixel, 2 B are: x,y. The color was set up by

DPBB
commands of “SC” or “ESC”
drawPixel(x,y); √ √

drawHLine()-
drawLine(x,y,x1,y1);

horizontal line

LNBBBB Draw a Line from (x,y) to (x1,y1), 4 B are: x,y,x1,y1 drawHLine(x,y,width);

drawVLine()-
√ √
drawVLine(x,y,height);
veritcal line

LTBB Draw a Line from Tast position to (x,y), 2 B are:x,y drawLineTo(x,y); √ √

The y pixels moved
depending on the
TRT Move text cursor to next line(call Text ReTurn) nextTextLine();
font size current
√ √
using

Set Font, follow by the font number, preloaded font

number is: 6,10,18,51,120,123,0(default), user font
number is 200,201,202,203 maps to 4 user font
SFB
memory sections, you can combine adjacent sections
setFont(0); √ √
together is the font size >4kb(each section has 4kb in
size)

6 of 9
! Digital Solutions Serial Character/Graphic LCD/OLED User Manual
!
0 and 1 for black
Set Color for following display, this command affect
white screen

SCB all following drawing command, such as: text, line, setColor(1);
0 to 255 for color
√ √
circle, pixel, rectangle…
screen

Move rectangle Area on screen to another place, the 6

MABBB moveArea(x,y,w,h,xoff
BBB
B are represent: (x,y)(left- top),(w,h)(width-height),
set,yoffset);
√ √
(xoffset,yoffset).

Enhanced set the current Text position Back to last

ETB char, this function will allow you display multiple setTextPosBack(); √ √
chars at same position.

Enhanced set Text position Offset, the 2 B are xoffset setTextPosOffset(xoffs

ETOBB
then yoffset, it will adjust the text position in pixels et, yoffset);
0 to 255 √ √

Enhanced set Text Position as pixels on screen, the 2

ETPBB
B are x, y coordinate on screen
setTextPosAbs(x,y); X,y=0 to 255 √ √

Set Start For mono display,the

length, 2nd length of data should
SSSBBB following by data.
 uploadStartScreen(102 be: screen
… For mono display, the start screen is bitmap data;
 4, *data); Width*High/8, eg.
√ √
For color display, the start screen is commands set, For 128x64 LCD,
the first and second bytes are the commands length. the length is 1024

Set User
SUFBBB uploadUserFont(1,143
B…
upload, 2nd
4,*data);
√ √
the higher byte of data length, following by data

Display Start Screen stored in memory, also set up 1= on, 0=off

displayStartScreen(1 or
DSSB Automatic start screen display or not on next power
0)
√ √
up

Send a Byte to output head on board, the current The output head are
DOUTB
driving ability for each pin is: 25mA (Sink/Source)
digitalOutput(0x1F);
vary from adapters
√ √

Set Line Pattern when drawing line, only for new Old version not
SLPB version firmware later than Jan. 2013.
 setLinePattern(pattern); support this fucntion √ √
eg. B=0xAA is dot line, B=0xFA is dash line

Enhanced Display Image, 1 byte color format.


EDIM1B The following 4 bytes are start positon: x, y, image drawBitmap256(x,y,wi
BBBB… width, height, then following image data, each byte dth,hight, *data)
√
represent one pixel

Enhanced Display Image, 2 byte color format.


The following 4 bytes are start positon: x, y, image Available on
EDIM2B drawBitmap65K(x,y,wi
BBBB…
width, height, then following image data, each pixel
dth,hight, *data)
firmware version 2.7 √
occupy 2 bytes: B1:B0, the color structure: and higher
RRRRRGGG, GGGBBBBB, MSB first.

Enhanced Display Image, 3 byte color format.


The following 4 bytes are start positon: x, y, image
EDIM3B drawBitmap262K(x,y,
BBBB…
width, height, then following image data, 3 bytes
width,hight, *data)
√
represent one pixel: Red, Green, Blue, the validate
value: 0 to 64 (6bits)

Enhanced Set Color for following display, the BBB

are color Red, color Green and Color Blue, this
ESCBBB
command affect all following drawing command,
setTrueColor(R,G,B); √
such as: text, line, circle, pixel, rectangle…

7 of 9
! Digital Solutions Serial Character/Graphic LCD/OLED User Manual
!
Special Command: (B-one byte, B…-Bytes)

Command Description Arduino lib function note

Only for multi-chip driver adapter:

B=0 or ‘0’ for ST7920

B=1 or ‘1’ for KS0108 (“E” Low, “CS1”&”CS2” Low)

For Universal
B=2 or ‘2’ for ST7565

Graphic Serial
SLCDB Since product after Apr. 20 2013:
 setLCDChip(chip_num);
LCD Adapter
B=3 or ‘3’ for KS0108 (“E” Low, “CS1”&”CS2” High)

only
B=4 or ‘4’ for KS0108 , follow by effective level for
“E”, “CS1” and “CS2”, eg. “SLCD4011” is same as
“SLCD3”

Set up universal graphic serial LCD adapter:

1) For ST7920 LCD controller:
• Verify and compare the pinout on adapter and LCD panel, they should be same on order (refer to the picture bellow);
• Pull up PSB pin (usually pin# 15) to VCC to let the LCD panel work at parallel mode;
• Connect the adapter with the LCD panel, adjust the contrast pot, power up the adapter, you should see the welcome screen
displayed.
2) For KS0108 controller:
• Verify and compare the pinout on adapter and LCD panel, they should be same on order (refer to the picture bellow);
• Shorting the 2 KS0108 jumper: 7 on the picture;
• In most case you need add a 10K contrast pot by yourself;
• Connect the adapter with the LCD panel, power up the adapter, send chip configuration command (refer to above table) to
adapter;
• Adjust the contrast pot, you should see the welcome screen displayed, if not, you probably need to try other value (1,3,4) in
chip configuration command.
3) For ST7565 controller:
NOTE: There are vary of ST7565 LCD panels on market, and the pin out are vary from one module to others, this adapter only
support SPI mode on the LCD panel, you usually need to connect pins on this adapter with LCD panel corresponding.
• Connect the pins on the adapter with LCD panel corresponding;
• Power up the adapter, then send chip configuration command to adapter (“SLCD2”), then you will see the welcome screen
on the panel;
• You can use the set contrast command to adjust the contrast (ST7565 support software contrast adjustment).
!

8 of 9
 ! Digital Solutions Serial Character/Graphic LCD/OLED User Manual
!
!
Pinout of this module connect to MCU:

PI PI
Description Description
N N
SS: SPI mode only

1 GND (0V) 2
chip select control in, low active
UART mode:

RX

I2C and SPI mode:
 I2C mode:

3 4
SCK/SCL: Clock in SDA

SPI mode:

SDI
VCC: power supply

5 1.8V to 5.5V depends on you
LCD

Connect with your master circuit:


9 of 9