Positron Compiler Documentation

Toshiba T6963C Graphic LCD specific Declares.

Source: Positron16 Compiler User Manual, PDF page 422

Declare LCD_DTPort Port

Assign the port that will output the 8-bit data to the graphic LCD.

There is no default setting for this Declare and it must be used within the BASIC program.

Declare LCD_WRPin Port.Pin Assigns the Port and Pin that the graphic LCD's WR line will attach to.

There is no default setting for this Declare and it must be used within the BASIC program.

Declare LCD_RDPin Port.Pin Assigns the Port and Pin that the graphic LCD's RD line will attach to.

There is no default setting for this Declare and it must be used within the BASIC program.

Declare LCD_CEPin Port.Pin Assigns the Port and Pin that the graphic LCD's CE line will attach to.

There is no default setting for this Declare and it must be used within the BASIC program.

Declare LCD_CDPin Port.Pin Assigns the Port and Pin that the graphic LCD's CD line will attach to.

There is no default setting for this Declare and it must be used within the BASIC program.

Declare LCD_RSTPin Port.Pin Assigns the Port and Pin that the graphic LCD's RST line will attach to.

The LCD’s RST (Reset) Declare is optional and if omitted from the BASIC code the compiler will not manipulate it. However, if not used as part of the interface, you must set the LCD’s RST pin high for normal operation.

Declare LCD_X_Res 0 to 255 LCD displays using the T6963 chipset come in varied screen sizes (resolutions). The compiler must know how many horizontal pixels the display consists of before it can build its library subroutines.

There is no default setting for this Declare and it must be used within the BASIC program. Declare LCD_Y_Res 0 to 255 LCD displays using the T6963 chipset come in varied screen sizes (resolutions). The compiler must know how many vertical pixels the display consists of before it can build its library subroutines.

There is no default setting for this Declare and it must be used within the BASIC program.

Declare LCD_Font_Width 6 or 8 The Toshiba T6963 graphic LCDs have two internal font sizes, 6 pixels wide by eight high, or 8 pixels wide by 8 high. The particular font size is chosen by the LCD’s FS pin. Leaving the FS pin floating or bringing it high will choose the 6 pixel font, while pulling the FS pin low will choose the 8 pixel font. The compiler must know what size font is required so that it can calculate screen and RAM boundaries.

Note that the compiler does not control the FS pin and it is down to the circuit layout whether or not it is pulled high or low. There is no default setting for this Declare and it must be used within the BASIC program.

Declare LCD_RAM_Size 1024 to 65535 Toshiba graphic LCDs contain internal RAM used for Text, Graphic or Character Generation. The amount of RAM is usually dictated by the display’s resolution. The larger the display, the more RAM is normally present. Standard displays with a resolution of 128x64 typically contain 4096 bytes of RAM, while larger types such as 240x64 or 190x128 typically contain 8192 bytes or RAM. The display’s datasheet will inform you of the amount of RAM present.

If this Declare is not issued within the BASIC program, the default setting is 8192 bytes.

Declare LCD_Text_Pages 1 to n As mentioned above, Toshiba graphic LCDs contain RAM that is set aside for text, graphics or characters generation. In normal use, only one page of text is all that is required, however, the compiler can re-arrange its library subroutines to allow several pages of text that is continuous. The amount of pages obtainable is directly proportional to the RAM available within the LCD itself. Larger displays require more RAM per page, therefore always limit the amount of pages to only the amount actually required or unexpected results may be observed as text, graphic and character generator RAM areas merge.

This Declare is purely optional and is usually not required. There is no default setting for this

Declare.

Declare LCD_Text_Home_Address 0 to n

The RAM within a Toshiba graphic LCD is split into three distinct uses, text, graphics and character generation. Each area of RAM must not overlap or corruption will appear on the display as one uses the other’s assigned space. The compiler’s library subroutines calculate each area of RAM based upon where the text RAM starts. Normally the text RAM starts at address 0, however, there may be occasions when it needs to be set a little higher in RAM. The order of RAM is; Text, Graphic, then Character Generation.

This Declare is purely optional and is usually not required. There is no default setting for this

Declare.