EVM6418 LCD Module

This module displays characters on the LCD screen on the EVM’s keypad/display. The LCD is organized as an array 128 pixels wide and 64 pixels tall. Each 8-bits chunk of data written to the display represents an 8-bit vertical slice, so you can think of the raw display organization of 128 columns of eight 8-bit tall rows.

The BSL contains a character set for the viewable ASCII characters (ASCII 32 – ASCII 127). You can modify the character set by re-compiling the LCD module. Each character is defined as a matrix of monochrome pixels 6 pixels wide and 8 pixels tall. The character data is packed in 16-bit data words with the first vertical slice in the most significant byte of the first word, the second vertical slize in the LSB of the first word, the third vertical slice in the BSM of the second word, etc.

The text commands use device coordinates based on characters (0 – 20 horizontal, 0 – 7 vertical). The raw data commands use raw coordinates to give flexibility (0-127 horizontal, 0-7 vertical).

The display maintains an invisible cursor where the next piece of display data will appear. The LCD module functions output text and graphics at the current position with alternative forms of the commands available to set the position beforehand (these have the postfix Pos appended such as EVM6418_LCD_textPos() ).

Description
Initializes the LCD module, must be first LCD module function called.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_init( )

Parameters
None

Return Value
None

Example

    /* Initialize the LCD module */
    EVM6418_LCD_init( );

Description
Sends commands and data to the LCD controller.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_rset(Int16 a0, Uint16 data)

Parameters
a0 – the state of the LCD controller’s A0 line when the data is sent. When a0 = 0, the data will be interpreted as a command. When a0 = 1, the data will be interpreted as display data.
data – the data to be sent to the LCD. Only the lower 8-bits are used.

Return Value
None

Example

    /* Send a byte of raw display data 
     * (0xA5) to the screen */
    EVM6418_LCD_rset(1, 0xA5);

Description
Set the current cursor position. The next byte of display data sent to the LCD will appear here.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_setPos(Int16 x, Int16 y)

Parameters
x – horizontal position in raw device coordinates (0 – 127)
y – vertical position in raw device coordinates (0 – 7)

Return Value
None

Example

    /* Set the cursor position 
     * to the middle of the top row */
    EVM6418_LCD_setPos(63, 0);

Description
Display a character at the current position.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_char(Int16 ch)

Parameters
ch – ASCII index of character to display (32 – 127)

Return Value
None

Example

    /* Draw an ‘A’ at the current position */
    EVM6418_LCD_char(‘A’);

Description
Display raw graphics data at the current position.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_raw(Uint16 *pdata, Int16 len)

Parameters
pdata – pointer to display data
len – number of bytes to display

Return Value
None

Example

    /* Display a circle at the current position */
    Uint16 circle[] = {0x1c22, 0x4141, 0x4122, 0x1c00}
    EVM6418_LCD_raw(circle, 8);

Description
Display raw graphics data at a fixed position.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_rawPos(Int16x, Int16y, Uint16 *pdata, Int16 len)

Parameters
x – horizontal position in raw device coordinates (0 – 127)
y – vertical position in raw device coordinates (0 – 7)
pdata – pointer to display data
len – number of bytes to display

Return Value
None

Example

    /* Display a circle in the upper left corner */
    Uint16 circle[] = {0x1c22, 0x4141, 0x4122, 0x1c00}
    EVM6418_LCD_rawPos(0, 0, circle, 8);

Description
Display a text string at the current position.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_text(char *str)

Parameters
str – zero terminated character string to display

Return Value
None

Example

    /* Display the message "Hello" */
    EVM6418_LCD_text("Hello");

Description
Display a text string at a fixed position.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_textPos(Int16 x, Int16 y, char *str)

Parameters
x – horizontal position in text coordinates (0 – 20)
y – vertical position in text coordinates (0 – 7)
str– zero terminated character string to display

Return Value
None

Example

    /* Display the message "Hello" 
     * in the middle of the top row */
    EVM6418_LCD_textPos(8, 0, "Hello");

Description
Display a 16-bit hex number at the current position.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_hex(Uint16 hexnum)

Parameters
hexnum – value to display

Return Value
None

Example

    /* Display the hex number 0xABCD
     * at the current position */
    EVM6418_LCD_hex(0xABCD);

Description
Display a 16-bit hex number at a fixed position.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_hexPos(Int16 x, Int16 y, Uint16 hexnum)

Parameters
x – horizontal position in text coordinates (0 – 20)
y – vertical position in text coordinates (0 – 7)
hexnum – value to display.

Return Value
None

Example

    /* Display the hex number 0xABCD
     * in the middle of the top line */
    EVM6418_LCD_hexPos(8, 0, 0xABCD);

Description
Fill the screen with a fixed value.

Required Headers
evm6418.h
evm6418_lcd.h

Required Libraries
evm6418bsl.lib

Function Prototype
void EVM6418_LCD_fillScreen(Int16 value)

Parameters
value – value to fill screen with. Only lower 8-bits are used

Return Value
None

Example

    /* Clear the screen */
    EVM6418_LCD_fillScreen(0);