Lcd Library
The mikroC PRO for ARM 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
Stellaris
| The following variables must be defined in all projects using Lcd Library : | Description : | Example : |
|---|---|---|
extern sfr sbit LCD_RS: |
Register Select line. | sbit LCD_RS at GPIO_PORTA_DATA.B2; |
extern sfr sbit LCD_EN: |
Enable line. | sbit LCD_EN at GPIO_PORTA_DATA.B3; |
extern sfr sbit LCD_D4; |
Data 4 line. | sbit LCD_D4 at GPIO_PORTA_DATA.B4; |
extern sfr sbit LCD_D5; |
Data 5 line. | sbit LCD_D5 at GPIO_PORTA_DATA.B5; |
extern sfr sbit LCD_D6; |
Data 6 line. | sbit LCD_D6 at GPIO_PORTA_DATA.B6; |
extern sfr sbit LCD_D7; |
Data 7 line. | sbit LCD_D7 at GPIO_PORTA_DATA.B7 |
extern sfr sbit LCD_RS_Direction; |
Register Select direction pin. | sbit LCD_RS_Direction at GPIO_PORTA_DIR.B2; |
extern sfr sbit LCD_EN_Direction; |
Enable direction pin. | sbit LCD_EN_Direction at GPIO_PORTA_DIR.B3; |
extern sfr sbit LCD_D4_Direction; |
Data 4 direction pin. | sbit LCD_D4_Direction at GPIO_PORTA_DIR.B4; |
extern sfr sbit LCD_D5_Direction; |
Data 5 direction pin. | sbit LCD_D5_Direction at GPIO_PORTA_DIR.B5; |
extern sfr sbit LCD_D6_Direction; |
Data 6 direction pin. | sbit LCD_D6_Direction at GPIO_PORTA_DIR.B6; |
extern sfr sbit LCD_D7_Direction; |
Data 7 direction pin. | sbit LCD_D7_Direction at GPIO_PORTA_DIR.B7; |
STM32
| The following variables must be defined in all projects using Lcd Library : | Description : | Example : |
|---|---|---|
extern sfr sbit LCD_RS: |
Register Select line. | sbit LCD_RS at GPIOD_ODR.B2; |
extern sfr sbit LCD_EN: |
Enable line. | sbit LCD_EN at GPIOD_ODR.B3; |
extern sfr sbit LCD_D4; |
Data 4 line. | sbit LCD_D4 at GPIOD_ODR.B4; |
extern sfr sbit LCD_D5; |
Data 5 line. | sbit LCD_D5 at GPIOD_ODR.B5; |
extern sfr sbit LCD_D6; |
Data 6 line. | sbit LCD_D6 at GPIOD_ODR.B6; |
extern sfr sbit LCD_D7; |
Data 7 line. | sbit LCD_D7 at GPIOD_ODR.B7 |
Library Routines
Lcd_Init
| Prototype |
void 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 |
Stellaris// LCD module connections sbit LCD_RS at GPIO_PORTA_DATA.B2; sbit LCD_EN at GPIO_PORTA_DATA.B3; sbit LCD_D4 at GPIO_PORTA_DATA.B4; sbit LCD_D5 at GPIO_PORTA_DATA.B5; sbit LCD_D6 at GPIO_PORTA_DATA.B6; sbit LCD_D7 at GPIO_PORTA_DATA.B7; sbit LCD_RS_Direction at GPIO_PORTA_DIR.B2; sbit LCD_EN_Direction at GPIO_PORTA_DIR.B3; sbit LCD_D4_Direction at GPIO_PORTA_DIR.B4; sbit LCD_D5_Direction at GPIO_PORTA_DIR.B5; sbit LCD_D6_Direction at GPIO_PORTA_DIR.B6; sbit LCD_D7_Direction at GPIO_PORTA_DIR.B7; // End LCD module connections ... Lcd_Init(); STM32// LCD module connections sbit LCD_RS at GPIOD_ODR.B2; sbit LCD_EN at GPIOD_ODR.B3; sbit LCD_D4 at GPIOD_ODR.B4; sbit LCD_D5 at GPIOD_ODR.B5; sbit LCD_D6 at GPIOD_ODR.B6; sbit LCD_D7 at GPIOD_ODR.B7; // End LCD module connections ... Lcd_Init(); |
| Notes |
None. |
Lcd_Out
| Prototype |
void Lcd_Out(unsigned int row, unsigned int column, char *text); |
|---|---|
| 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 |
void Lcd_Out_Cp(char *text); |
|---|---|
| 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 |
void Lcd_Chr(unsigned int row, unsigned int column, char out_char); |
|---|---|
| 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 |
void Lcd_Chr_Cp(char out_char); |
|---|---|
| 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 |
void Lcd_Cmd(char out_char); |
|---|---|
| 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 |
Library Example
The following code demonstrates usage of the Lcd Library routines:
Stellaris
// LCD module connections
sbit LCD_RS at GPIO_PORTA_DATA.B2;
sbit LCD_EN at GPIO_PORTA_DATA.B3;
sbit LCD_D4 at GPIO_PORTA_DATA.B4;
sbit LCD_D5 at GPIO_PORTA_DATA.B5;
sbit LCD_D6 at GPIO_PORTA_DATA.B6;
sbit LCD_D7 at GPIO_PORTA_DATA.B7;
sbit LCD_RS_Direction at GPIO_PORTA_DIR.B2;
sbit LCD_EN_Direction at GPIO_PORTA_DIR.B3;
sbit LCD_D4_Direction at GPIO_PORTA_DIR.B4;
sbit LCD_D5_Direction at GPIO_PORTA_DIR.B5;
sbit LCD_D6_Direction at GPIO_PORTA_DIR.B6;
sbit LCD_D7_Direction at GPIO_PORTA_DIR.B7;
// End LCD module connections
char txt1[] = "mikroElektronika";
char txt2[] = "Stellaris";
char txt3[] = "Lcd4bit";
char txt4[] = "example";
char i; // Loop variable
void Move_Delay() { // Function used for text moving
Delay_ms(750); // You can change the moving speed here
}
void main(){
Lcd_Init(); // Initialize LCD
Lcd_Cmd(_LCD_CLEAR); // Clear display
Lcd_Cmd(_LCD_CURSOR_OFF); // Cursor off
Lcd_Out(1,6,txt3); // Write text in first row
Lcd_Out(2,6,txt4); // Write text in second row
Delay_ms(2000);
Lcd_Cmd(_LCD_CLEAR); // Clear display
Lcd_Out(1,1,txt1); // Write text in first row
Lcd_Out(2,4,txt2); // Write text in second row
Delay_ms(2000);
// Moving text
for(i=0; i<4; i++) { // Move text to the right 4 times
Lcd_Cmd(_LCD_SHIFT_RIGHT);
Move_Delay();
}
while(1) { // Endless loop
for(i=0; i<7; i++) { // Move text to the left 7 times
Lcd_Cmd(_LCD_SHIFT_LEFT);
Move_Delay();
}
for(i=0; i<7; i++) { // Move text to the right 7 times
Lcd_Cmd(_LCD_SHIFT_RIGHT);
Move_Delay();
}
}
}
STM32
// LCD module connections
sbit LCD_RS at GPIOD_ODR.B2;
sbit LCD_EN at GPIOD_ODR.B3;
sbit LCD_D4 at GPIOD_ODR.B4;
sbit LCD_D5 at GPIOD_ODR.B5;
sbit LCD_D6 at GPIOD_ODR.B6;
sbit LCD_D7 at GPIOD_ODR.B7;
// End LCD module connections
char txt1[] = "mikroElektronika";
char txt2[] = "Stellaris";
char txt3[] = "Lcd4bit";
char txt4[] = "example";
char i; // Loop variable
void Move_Delay() { // Function used for text moving
Delay_ms(750); // You can change the moving speed here
}
void main(){
Lcd_Init(); // Initialize LCD
Lcd_Cmd(_LCD_CLEAR); // Clear display
Lcd_Cmd(_LCD_CURSOR_OFF); // Cursor off
Lcd_Out(1,6,txt3); // Write text in first row
Lcd_Out(2,6,txt4); // Write text in second row
Delay_ms(2000);
Lcd_Cmd(_LCD_CLEAR); // Clear display
Lcd_Out(1,1,txt1); // Write text in first row
Lcd_Out(2,4,txt2); // Write text in second row
Delay_ms(2000);
// Moving text
for(i=0; i<4; i++) { // Move text to the right 4 times
Lcd_Cmd(_LCD_SHIFT_RIGHT);
Move_Delay();
}
while(1) { // Endless loop
for(i=0; i<7; i++) { // Move text to the left 7 times
Lcd_Cmd(_LCD_SHIFT_LEFT);
Move_Delay();
}
for(i=0; i<7; i++) { // Move text to the right 7 times
Lcd_Cmd(_LCD_SHIFT_RIGHT);
Move_Delay();
}
}
}
What do you think about this topic ? Send us feedback!




