Lcd Library
mikroBasic PRO for FT90x provides a library for communication with Lcds (with HD44780 compliant controllers) through the 4-bit interface. An example of Lcd connections is given on the schematic at the bottom of this page.
For creating a set of custom Lcd characters use Lcd Custom Character Tool.
Library Dependency Tree
External dependencies of Lcd Library
| The following variables must be defined in all projects using Lcd Library : | Description : | Example : |
|---|---|---|
dim LCD_RS as sbit sfr external |
Register Select line. | dim LCD_RS as sbit at GPIO_PIN13_bit |
dim LCD_EN as sbit sfr external |
Enable line. | dim LCD_EN as sbit at GPIO_PIN18_bit |
dim LCD_D4 as sbit sfr external |
Data 4 line. | dim LCD_D4 as sbit at GPIO_PIN51_bit |
dim LCD_D5 as sbit sfr external |
Data 5 line. | dim LCD_D5 as sbit at GPIO_PIN44_bit |
dim LCD_D6 as sbit sfr external |
Data 6 line. | dim LCD_D6 as sbit at GPIO_PIN35_bit |
dim LCD_D7 as sbit sfr external |
Data 7 line. | dim LCD_D7 as sbit at GPIO_PIN26_bit |
Library Routines
Lcd_Init
| Prototype |
sub procedure Lcd_Init() |
|---|---|
| Description |
Initializes Lcd module. |
| Parameters |
None. |
| Returns |
Nothing. |
| Requires |
External dependencies of the library from the top of the page must be defined before using this function. |
| Example |
' LCD module connections dim LCD_RS as sbit at GPIO_PIN13_bit dim LCD_EN as sbit at GPIO_PIN18_bit dim LCD_D4 as sbit at GPIO_PIN51_bit dim LCD_D5 as sbit at GPIO_PIN44_bit dim LCD_D6 as sbit at GPIO_PIN35_bit dim LCD_D7 as sbit at GPIO_PIN26_bit ' End LCD module connections ... Lcd_Init() ' Initialize LCD |
| Notes |
None. |
Lcd_Out
| Prototype |
sub procedure Lcd_Out(dim row, column as word, dim byref text as string) |
|---|---|
| Description |
Prints text on Lcd starting from specified position. Both string variables and literals can be passed as a text. |
| Parameters |
|
| Returns |
Nothing. |
| Requires |
The Lcd module needs to be initialized. See Lcd_Init routine. |
| Example |
' Write text "Hello!" on Lcd starting from row 1, column 3: Lcd_Out(1, 3, "Hello!") |
| Notes |
None. |
Lcd_Out_Cp
| Prototype |
sub procedure Lcd_Out_Cp(dim byref text as string) |
|---|---|
| Returns |
Nothing. |
| Description |
Prints text on Lcd at current cursor position. Both string variables and literals can be passed as a text. |
| Parameters |
|
| Requires |
The Lcd module needs to be initialized. See Lcd_Init routine. |
| Example |
' Write text "Here!" at current cursor position:
Lcd_Out_Cp("Here!")
|
| Notes |
None. |
Lcd_Chr
| Prototype |
sub procedure Lcd_Chr(dim row, column as word, dim out_char as byte) |
|---|---|
| Description |
Prints character on Lcd at specified position. Both variables and literals can be passed as a character. |
| Parameters |
|
| Returns |
Nothing. |
| Requires |
The Lcd module needs to be initialized. See Lcd_Init routine. |
| Example |
' Write character "i" at row 2, column 3: Lcd_Chr(2, 3, "i") |
| Notes |
None. |
Lcd_Chr_Cp
| Prototype |
sub procedure Lcd_Chr_Cp(dim out_char as byte) |
|---|---|
| Description |
Prints character on Lcd at current cursor position. Both variables and literals can be passed as a character. |
| Parameters |
|
| Returns |
Nothing. |
| Requires |
The Lcd module needs to be initialized. See Lcd_Init routine. |
| Example |
' Write character "e" at current cursor position:
Lcd_Chr_Cp("e")
|
| Notes |
None. |
Lcd_Cmd
| Prototype |
sub procedure Lcd_Cmd(dim out_char as byte) |
|---|---|
| Description |
Sends command to Lcd. |
| Parameters |
|
| Returns |
Nothing. |
| Requires |
The Lcd module needs to be initialized. See Lcd_Init table. |
| Example |
' Clear Lcd display: Lcd_Cmd(_LCD_CLEAR) |
| Notes |
Predefined constants can be passed to the function, see Available Lcd Commands. |
Available Lcd Commands
| Lcd Command | Purpose |
|---|---|
| _LCD_FIRST_ROW | Move cursor to the 1st row |
| _LCD_SECOND_ROW | Move cursor to the 2nd row |
| _LCD_THIRD_ROW | Move cursor to the 3rd row |
| _LCD_FOURTH_ROW | Move cursor to the 4th row |
| _LCD_CLEAR | Clear display |
| _LCD_RETURN_HOME | Return cursor to home position, returns a shifted display to its original position. Display data RAM is unaffected. |
| _LCD_CURSOR_OFF | Turn off cursor |
| _LCD_UNDERLINE_ON | Underline cursor on |
| _LCD_BLINK_CURSOR_ON | Blink cursor on |
| _LCD_MOVE_CURSOR_LEFT | Move cursor left without changing display data RAM |
| _LCD_MOVE_CURSOR_RIGHT | Move cursor right without changing display data RAM |
| _LCD_TURN_ON | Turn Lcd display on |
| _LCD_TURN_OFF | Turn Lcd display off |
| _LCD_SHIFT_LEFT | Shift display left without changing display data RAM |
| _LCD_SHIFT_RIGHT | Shift display right without changing display data RAM |
What do you think about this topic ? Send us feedback!



