Toshiba_Command
Syntax
Toshiba_Command Command, Value
Overview
Send a command with or without parameters to a Toshiba T6963 graphic LCD.
Parameters
Command can be a constant, variable, or expression, that contains the command to send to the LCD. This will always be an 8-bit value. Value can be a constant, variable, or expression, that contains an 8-bit or 16-bit parameter associated with the command. An 8-bit value will be sent as a single parameter, while a 16-bit value will be sent as two parameters. Parameters are optional as some commands do not require any. Therefore if no parameters are included, only a command is sent to the LCD.
Because the size of the parameter is vital to the correct operation of specific commands, you can force the size of the parameter sent by issuing either the text “Byte” or “Word” prior to the parameter’s value.
Toshiba_Command $C0, Byte $FF01 ' Send the low byte of the 16-bit value.
Toshiba_Command $C0, Word $01 ' Send a 16-bit value regardless.The explanation of each command is too lengthy for this document, however they can be found in the Toshiba T6963C datasheet.
Example
' Toshiba T6963C Command demo
'
Device = 24FJ64GA002 ' Select the device to compile for
Declare Xtal = 16
'
' Toshiba T6963C graphic LCD Pin configuration
'
Declare LCD_Type = Toshiba ' LCD's type is Toshiba T6963C
Declare LCD_DTPort = PORTB.Byte0 ' The LCD's 8-bit Data port
Declare LCD_WRPin = PORTB.12 ' The LCD's WR pin
Declare LCD_RDPin = PORTB.11 ' The LCD's RD pin
Declare LCD_CEPin = PORTB.10 ' The LCD's CE pin
Declare LCD_CDPin = PORTB.8 ' The LCD's CD pin
Declare LCD_RSTPin = PORTB.9 ' The LCD's RST pin (optional)
'
' Toshiba T6963C graphic LCD setup configuration
'
Declare LCD_Font_Width = 8 ' The font width ( 6 or 8)
Declare LCD_X_Res = 128 ' The X resolution of the LCD
Declare LCD_Y_Res = 64 ' The Y resolution of the LCD
Declare LCD_Text_Home_Address = 0 ' The home address of the LCD
Declare LCD_RAM_Size = 8192 ' The amount of RAM the LCD contains
Declare LCD_Text_Pages = 1 ' The amount of text pages required
Include "T6963C.inc" ' Load the Toshiba T6963C routines into the program
Dim PanLoop As Byte
Dim Ypos As Byte
'---------------------------------------------------------------------------
Main:
Cls ' Clear Text and Graphic RAM
'
' Place text on two screen pages
'
For Ypos = 1 To 6
Print At Ypos,0," THIS IS PAGE ONE THIS IS PAGE TWO"
Next
'
' Draw a box around the display
'
Line 1,0,0,127,0 ' Top line
LineTo 1,127,63 ' Right line
LineTo 1,0,63 ' Bottom line
LineTo 1,0,0 ' Left line
'
' Pan from one screen to the next then back
'
Do ' Create an infinite loop
'
' Increment the Text home address
'
For PanLoop = 0 To 23
Toshiba_Command cT6963_SET_TEXT_HOME_ADDRESS , Word PanLoop
DelayMs 200
Next
DelayMs 200
'
' Decrement the Text home address
'
For PanLoop = 23 To 0 Step -1
Toshiba_Command cT6963_SET_TEXT_HOME_ADDRESS , Word PanLoop
DelayMs 200
Next
DelayMs 200
Loop ' Do it foreverNotes.
When the Toshiba LCD’s Declares are issued within the BASIC program, several internal variables and constants are automatically created that contain the Port and Bits used by the actual interface and also some constant values holding valuable information concerning the LCD’s RAM boundaries and setup. These variables and constants can be used within the BASIC or Assembler environment. The internal variables and constants are: -
Variables.
| _ _LCD_DTPort | The Port where the LCD’s data lines are attached. |
| _ _LCD_WRPort | The Port where the LCD’s WR pin is attached. |
| _ _LCD_RDPort | The Port where the LCD’s RD pin is attached. |
| _ _LCD_CEPort | The Port where the LCD’s CE pin is attached. |
| _ _LCD_CDPort | The Port where the LCD’s CD pin is attached. |
| _ _LCD_RSTPort | The Port where the LCD’s RST pin is attached. |
Constants.
| _ _LCD_Type | The type of LCD targeted. 0 = Alphanumeric, 1 = KS0108, 2 = Toshiba. |
| _ _LCD_WRPin | The Pin where the LCD’s WR line is attached. |
| _ _LCD_RDPin | The Pin where the LCD’s RD line is attached. |
| _ _LCD_CEPin | The Pin where the LCD’s CE line is attached. |
| _ _LCD_CDPin | The Pin where the LCD’s CD line is attached. |
| _ _LCD_RSTPin | The Pin where the LCD’s RST line is attached. |
| _ _LCD_Text_Pages | The amount of TEXT pages chosen. |
| _ _LCD_Graphic_Pages | The amount of Graphic pages chosen. |
| _ _LCD_RAM_Size | The amount of RAM that the LCD contains. |
| _ _LCD_X_Res | The X resolution of the LCD. i.e. Horizontal pixels. |
| _ _LCD_Y_Res | The Y resolution of the LCD. i.e. Vertical pixels. |
| _ _LCD_Font_Width | The width of the font. i.e. 6 or 8. |
| _ _LCD_Text_AREA | The amount of characters on a single line of TEXT RAM. |
| _ _LCD_Graphic_AREA | The amount of characters on a single line of Graphic RAM. |
| _ _LCD_Text_Home_Address | The Starting address of the TEXT RAM. |
_ _LCD_Graphic_Home_Address The Starting address of the Graphic RAM. _ _LCD_CGRAM_Home_Address The Starting address of the CG RAM.
| _ _LCD_End_OF_Graphic_RAM | The Ending address of Graphic RAM. |
| _ _LCD_CGRAM_OFFset | The Offset value for use with CG RAM. |
Notice that each name has two underscores preceding it. This should ensure that duplicate names are not defined within the BASIC environment.
It may not be apparent straight away why the variables and constants are required, however, the Toshiba LCDs are capable of many tricks such as panning, page flipping, text manipulation etc, and all these require some knowledge of RAM boundaries and specific values relating to the resolution of the LCD used.
See also : LCDRead, LCDWrite, Pixel, Plot, Toshiba_UDG, UnPlot.
