T6963C Graphic Lcd Library
The mikroBasic PRO for 8051 provides a library for working with Glcds based on TOSHIBA T6963C controller. The Toshiba T6963C is a very popular Lcd controller for the use in small graphics modules. It is capable of controlling displays with a resolution up to 240x128. Because of its low power and small outline it is most suitable for mobile applications such as PDAs, MP3 players or mobile measurement equipment. Although small, this contoller has a capability of displaying and merging text and graphics and it manages all the interfacing signals to the displays Row and Column drivers.
For creating a custom set of Glcd images use Glcd Bitmap Editor Tool.
Note: ChipEnable(CE),
FontSelect(FS) and Reverse(MD) have to be set to appropriate levels by the
user outside of the T6963C_Init
function. See the Library Example code at the
bottom of this page.
Note: Some mikroElektronika's adapter boards have pinout different from T6369C datasheets. Appropriate relations between these labels are given in the table below:
Adapter Board | T6369C datasheet |
RS | C/D |
R/W | /RD |
E | /WR |
External dependencies of T6963C Graphic Lcd Library
The following variables must be defined in all projects using T6963C Graphic Lcd library: | Description : | Example : |
---|---|---|
dim T6963C_dataPort as byte external sfr |
T6963C Data Port. | dim T6963C_dataPort as byte at P0 |
dim T6963C_ctrlwr as sbit bdata sfr external |
Write signal. | dim T6963C_ctrlwr as sbit at P1_2_bit |
dim T6963C_ctrlrd as sbit bdata sfr external |
Read signal. | dim T6963C_ctrlrd as sbit at P1_1_bit |
dim T6963C_ctrlcd as sbit bdata sfr external |
Command/Data signal. | dim T6963C_ctrlcd as sbit at P1_0_bit |
dim T6963C_ctrlrst as sbit bdata sfr external |
Reset signal. | dim T6963C_ctrlrst sbit at P1_4_bit |
Library Routines
- T6963C_Init
- T6963C_WriteData
- T6963C_WriteCommand
- T6963C_SetPtr
- T6963C_WaitReady
- T6963C_Fill
- T6963C_Dot
- T6963C_Write_Char
- T6963C_Write_Text
- T6963C_Line
- T6963C_Rectangle
- T6963C_Box
- T6963C_Circle
- T6963C_Image
- T6963C_Sprite
- T6963C_Set_Cursor
Note: The following low level library routines are implemented as macros. These macros can be found in the T6963C.h
header
file which is located in the T6963C example projects folders.
- T6963C_ClearBit
- T6963C_SetBit
- T6963C_NegBit
- T6963C_DisplayGrPanel
- T6963C_DisplayTxtPanel
- T6963C_SetGrPanel
- T6963C_SetTxtPanel
- T6963C_PanelFill
- T6963C_GrFill
- T6963C_TxtFill
- T6963C_Cursor_Height
- T6963C_Graphics
- T6963C_Text
- T6963C_Cursor
- T6963C_Cursor_Blink
T6963C_Init
Prototype |
sub procedure T6963C_init(dim width as word, dim height, fntW as byte) |
---|---|
Returns |
Nothing. |
Description |
Initalizes the Graphic Lcd controller. Parameters :
Display RAM organization: schematic: +---------------------+ /\ + GRAPHICS PANEL #0 + | + + | + + | + + | +---------------------+ | PANEL 0 + TEXT PANEL #0 + | + + \/ +---------------------+ /\ + GRAPHICS PANEL #1 + | + + | + + | + + | +---------------------+ | PANEL 1 + TEXT PANEL #1 + | + + | +---------------------+ \/ |
Requires |
Global variables :
|
Example |
' T6963CGlcd pinout definition dim T6963C_dataPort as byte at P0 sfr ' pointer to DATA BUS port dim T6963C_ctrlwr as sbit at P1_2_bit ' WR write signal dim T6963C_ctrlrd as sbit at P1_1_bit ' RD read signal dim T6963C_ctrlcd as sbit at P1_0_bit ' CD command/data signal dim T6963C_ctrlrst as sbit at P1_4_bit ' RST reset signal ... ' init display for 240 pixel width, 128 pixel height and 8 bits character width T6963C_init(240, 128, 8) |
T6963C_WriteData
Prototype |
sub procedure T6963C_WriteData(dim mydata as byte) |
---|---|
Returns |
Nothing. |
Description |
Writes data to T6963C controller. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_WriteData(AddrL) |
T6963C_WriteCommand
Prototype |
sub procedure T6963C_WriteCommand(dim mydata as byte) |
---|---|
Returns |
Nothing. |
Description |
Writes command to T6963C controller. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_WriteCommand(T6963C_CURSOR_POINTER_SET) |
T6963C_SetPtr
Prototype |
sub procedure T6963C_SetPtr(dim p as word, dim c as byte) |
---|---|
Returns |
Nothing. |
Description |
Sets the memory pointer p for command c. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_SetPtr(T6963C_grHomeAddr + start, T6963C_ADDRESS_POINTER_SET) |
T6963C_WaitReady
Prototype |
sub procedure T6963C_WaitReady() |
---|---|
Returns |
Nothing. |
Description |
Pools the status byte, and loops until Toshiba Glcd module is ready. |
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_WaitReady() |
T6963C_Fill
Prototype |
sub procedure T6963C_Fill(dim v as byte, dim start, len as word) |
---|---|
Returns |
Nothing. |
Description |
Fills controller memory block with given byte. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Fill(0x33,0x00FF,0x000F) |
T6963C_Dot
Prototype |
sub procedure T6963C_Dot(dim x, y as integer, dim color as byte) |
---|---|
Returns |
Nothing. |
Description |
Draws a dot in the current graphic panel of Glcd at coordinates (x, y). Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Dot(x0, y0, pcolor) |
T6963C_Write_Char
Prototype |
sub procedure T6963C_Write_Char(dim c, x, y, mode as byte) |
---|---|
Returns |
Nothing. |
Description |
Writes a char in the current text panel of Glcd at coordinates (x, y). Parameters :
Mode parameter explanation:
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Write_Char('A',22,23,AND) |
T6963C_Write_Text
Prototype |
sub procedure T6963C_Write_Text(dim str as ^byte, dim x, y, mode as byte) |
---|---|
Returns |
Nothing. |
Description |
Writes text in the current text panel of Glcd at coordinates (x, y). Parameters :
Mode parameter explanation:
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Write_Text(" Glcd LIBRARY DEMO, WELCOME !", 0, 0, T6963C_ROM_MODE_XOR) |
T6963C_Line
Prototype |
sub procedure T6963C_Line(dim x0, y0, x1, y1 as integer, dim pcolor as byte) |
---|---|
Returns |
Nothing. |
Description |
Draws a line from (x0, y0) to (x1, y1). Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Line(0, 0, 239, 127, T6963C_WHITE) |
T6963C_Rectangle
Prototype |
sub procedure T6963C_Rectangle(dim x0, y0, x1, y1 as integer, dim pcolor as byte) |
---|---|
Returns |
Nothing. |
Description |
Draws a rectangle on Glcd. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Rectangle(20, 20, 219, 107, T6963C_WHITE) |
T6963C_Box
Prototype |
sub procedure T6963C_Box(dim x0, y0, x1, y1 as integer, dim pcolor as byte) |
---|---|
Returns |
Nothing. |
Description |
Draws a box on Glcd Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Box(0, 119, 239, 127, T6963C_WHITE) |
T6963C_Circle
Prototype |
sub procedure T6963C_Circle(dim x, y as integer, dim r as longint, dim pcolor as byte) |
---|---|
Returns |
Nothing. |
Description |
Draws a circle on Glcd. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Circle(120, 64, 110, T6963C_WHITE) |
T6963C_Image
Prototype |
sub procedure T6963C_Image(const pic as ^byte) |
---|---|
Returns |
Nothing. |
Description |
Displays bitmap on Glcd. Parameters :
Use the mikroBasic’s integrated Glcd Bitmap Editor (menu option Tools › Glcd Bitmap Editor) to convert image to a constant array suitable for displaying on Glcd. |
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Image(mc) |
T6963C_Sprite
Prototype |
sub procedure T6963C_Sprite(dim px, py, sx, sy as byte, const pic as ^byte) |
---|---|
Returns |
Nothing. |
Description |
Fills graphic rectangle area (px, py) to (px+sx, py+sy) with custom size picture. Parameters :
Note: If |
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Sprite(76, 4, einstein, 88, 119) ' draw a sprite |
T6963C_Set_Cursor
Prototype |
sub procedure T6963C_Set_Cursor(dim x, y as byte) |
---|---|
Returns |
Nothing. |
Description |
Sets cursor to row x and column y. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Set_Cursor(cposx, cposy) |
T6963C_ClearBit
Prototype |
sub procedure T6963C_ClearBit(dim b as byte) |
---|---|
Returns |
Nothing. |
Description |
Clears control port bit(s). Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' clear bits 0 and 1 on control port T6963C_ClearBit(0x03) |
T6963C_SetBit
Prototype |
sub procedure T6963C_SetBit(dim b as byte) |
---|---|
Returns |
Nothing. |
Description |
Sets control port bit(s). Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' set bits 0 and 1 on control port T6963C_SetBit(0x03) |
T6963C_NegBit
Prototype |
sub procedure T6963C_NegBit(dim b as byte) |
---|---|
Returns |
Nothing. |
Description |
Negates control port bit(s). Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' negate bits 0 and 1 on control port T6963C_NegBit(0x03) |
T6963C_DisplayGrPanel
Prototype |
sub procedure T6963C_DisplayGrPanel(dim n as byte) |
---|---|
Returns |
Nothing. |
Description |
Display selected graphic panel. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' display graphic panel 1 T6963C_DisplayGrPanel(1) |
T6963C_DisplayTxtPanel
Prototype |
sub procedure T6963C_DisplayTxtPanel(dim n as byte) |
---|---|
Returns |
Nothing. |
Description |
Display selected text panel. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' display text panel 1 T6963C_DisplayTxtPanel(1) |
T6963C_SetGrPanel
Prototype |
sub procedure T6963C_SetGrPanel(dim n as byte) |
---|---|
Returns |
Nothing. |
Description |
Compute start address for selected graphic panel and set appropriate internal pointers. All subsequent graphic operations will be preformed at this graphic panel. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' set graphic panel 1 as current graphic panel. T6963C_SetGrPanel(1) |
T6963C_SetTxtPanel
Prototype |
sub procedure T6963C_SetTxtPanel(dim n as byte) |
---|---|
Returns |
Nothing. |
Description |
Compute start address for selected text panel and set appropriate internal pointers. All subsequent text operations will be preformed at this text panel. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' set text panel 1 as current text panel. T6963C_SetTxtPanel(1) |
T6963C_PanelFill
Prototype |
sub procedure T6963C_PanelFill(dim v as byte) |
---|---|
Returns |
Nothing. |
Description |
Fill current panel in full (graphic+text) with appropriate value (0 to clear). Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
clear current panel T6963C_PanelFill(0) |
T6963C_GrFill
Prototype |
sub procedure T6963C_GrFill(dim v as byte) |
---|---|
Returns |
Nothing. |
Description |
Fill current graphic panel with appropriate value (0 to clear). Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' clear current graphic panel T6963C_GrFill(0) |
T6963C_TxtFill
Prototype |
sub procedure T6963C_TxtFill(dim v as byte) |
---|---|
Returns |
Nothing. |
Description |
Fill current text panel with appropriate value (0 to clear). Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' clear current text panel T6963C_TxtFill(0) |
T6963C_Cursor_Height
Prototype |
sub procedure T6963C_Cursor_Height(dim n as byte) |
---|---|
Returns |
Nothing. |
Description |
Set cursor size. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
T6963C_Cursor_Height(7) |
T6963C_Graphics
Prototype |
sub procedure T6963C_Graphics(dim n as byte) |
---|---|
Returns |
Nothing. |
Description |
Enable/disable graphic displaying. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' enable graphic displaying T6963C_Graphics(1) |
T6963C_Text
Prototype |
sub procedure T6963C_Text(dim n as byte) |
---|---|
Returns |
Nothing. |
Description |
Enable/disable text displaying. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' enable text displaying T6963C_Text(1) |
T6963C_Cursor
Prototype |
sub procedure T6963C_Cursor(dim n as byte) |
---|---|
Returns |
Nothing. |
Description |
Set cursor on/off. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' set cursor on T6963C_Cursor(1) |
T6963C_Cursor_Blink
Prototype |
sub procedure T6963C_Cursor_Blink(dim n as byte) |
---|---|
Returns |
Nothing. |
Description |
Enable/disable cursor blinking. Parameters :
|
Requires |
Toshiba Glcd module needs to be initialized. See the T6963C_Init routine. |
Example |
' enable cursor blinking T6963C_Cursor_Blink(1) |
Library Example
The following drawing demo tests advanced routines of the T6963C Glcd library. Hardware configurations in this example are made for the T6963C 240x128 display, Easy8051B board and AT89S8253.
program T6963C_240x128 include __Lib_T6963C_Consts ' T6963C module connections dim T6963C_dataPort as byte at P3 ' DATA port T6963C_ctrlwr as sbit at P2_2_bit ' WR write signal T6963C_ctrlrd as sbit at P2_1_bit ' RD read signal T6963C_ctrlcd as sbit at P2_0_bit ' CD command/data signal T6963C_ctrlrst as sbit at P2_4_bit ' RST reset signal T6963C_ctrlce as sbit at P2_3_bit ' CE signal T6963C_ctrlfs as sbit at P2_6_bit ' FS signal T6963C_ctrlmd as sbit at P2_5_bit ' MD signal ' End T6963C module connections dim panel as byte ' current panel i as word ' general purpose register curs as byte ' cursor visibility cposx, cposy as word ' cursor x-y position txt, txt1 as string[29] idata main: txt1 = " EINSTEIN WOULD HAVE LIKED mE" txt = " GLCD LIBRARY DEMO, WELCOME !" T6963C_ctrlce = 0 ' Enable T6963C T6963C_ctrlfs = 0 ' Font Select 8x8 T6963C_ctrlmd = 0 ' Column number select ' Initialize T6963C T6963C_init(240, 128, 8) 'Delay_ms(1000) ' ' Enable both graphics and text display at the same time ' T6963C_graphics(1) T6963C_text(1) panel = 0 i = 0 curs = 0 cposy = 0 cposx = 0 ' ' Text messages ' T6963C_write_text(txt, 0, 0, T6963C_ROM_MODE_XOR) T6963C_write_text(txt1, 0, 15, T6963C_ROM_MODE_XOR) ' ' Cursor ' T6963C_cursor_height(8) ' 8 pixel height T6963C_set_cursor(0, 0) ' move cursor to top left T6963C_cursor(0) ' cursor off '#IFDEF COMPLETE_EXAMPLE ' ' Draw rectangles ' T6963C_rectangle(0, 0, 239, 127, T6963C_BLACK) T6963C_rectangle(20, 20, 219, 107, T6963C_BLACK) T6963C_rectangle(40, 40, 199, 87, T6963C_BLACK) T6963C_rectangle(60, 60, 179, 67, T6963C_BLACK) ' ' Draw a cross ' T6963C_line(0, 0, 239, 127, T6963C_BLACK) T6963C_line(0, 127, 239, 0, T6963C_BLACK) ' ' Draw solid boxes ' T6963C_box(0, 0, 239, 8, T6963C_BLACK) T6963C_box(0, 119, 239, 127, T6963C_BLACK) ' ' Draw circles ' T6963C_circle(120, 64, 10, T6963C_BLACK) T6963C_circle(120, 64, 30, T6963C_BLACK) T6963C_circle(120, 64, 50, T6963C_BLACK) T6963C_circle(120, 64, 70, T6963C_BLACK) T6963C_circle(120, 64, 90, T6963C_BLACK) T6963C_circle(120, 64, 110, T6963C_BLACK) T6963C_circle(120, 64, 130, T6963C_BLACK) T6963C_sprite(76, 4, @einstein, 88, 119) ' Draw a sprite T6963C_setGrPanel(1) ' Select other graphic panel T6963C_image(@mikroE_240x128_bmp) ' Fill the graphic screen with a picture '#ENDIF while TRUE ' Endless loop ' ' If P1_0 is pressed, toggle the display between graphic panel 0 and graphic 1 ' if ( P1_0_bit = 0) then T6963C_graphics(1) T6963C_text(0) Delay_ms(300) '#IFDEF COMPLETE_EXAMPLE ' ' If P1_1 is pressed, display only graphic panel ' else if ( P1_1_bit = 0) then Inc(panel) panel = panel and 1 T6963C_displayGrPanel(panel) Delay_ms(300) '#ENDIF ' ' If P1_2 is pressed, display only text panel ' else if ( P1_2_bit = 0) then T6963C_graphics(0) T6963C_text(1) Delay_ms(300) ' ' If P1_3 is pressed, display text and graphic panels ' else if( P1_3_bit = 0) then T6963C_graphics(1) T6963C_text(1) Delay_ms(300) ' ' If P1_4 is pressed, change cursor ' else if ( P1_4_bit = 0) then Inc(curs) if (curs = 3) then curs = 0 end if select case curs case 0 ' No cursor T6963C_cursor(0) case 1 ' Blinking cursor T6963C_cursor(1) T6963C_cursor_blink(1) case 2 ' Non blinking cursor T6963C_cursor(1) T6963C_cursor_blink(0) end select Delay_ms(300) end if end if end if end if end if ' ' Move cursor, even if not visible ' Inc(cposx) if(cposx = T6963C_txtCols) then cposx = 0 cposy = cposy + 1 if(cposy = (128 div T6963C_CHARACTER_HEIGHT)) then ' if y end cposy = 0 ' grafic height (128) div character height end if T6963C_set_cursor(cposx, cposy) Delay_ms(100) end if wend end.
HW Connection
T6963C Glcd HW connection
What do you think about this topic ? Send us feedback!