LCD Interfacing with AVR Microcontroller.
When you start working with LCD modules you will start feeling the real power of MCU and your imaginations will be touching sky you will wonder how many exciting a powerful gadgets you can create and that’s so very easily.
LCD Modules can present textual information to user. It’s like a cheap “monitor” that you can hook in all of your gadgets. They come in various types. The most popular one can display 2 lines of 16 characters. These can be easily interfaced to MCU's, thanks to the API( Functions used to easily access the modules) we provide. LCD interfacing is just fun !
Fig: A 16x2 LCD Module |
PIN Configurations.
The lcd modules has 16 PINs for interfacing. The details are given below.
| LCD Module Pin Configuration |
| 1 VSS (GND Supply) |
| 2 VCC (+5V) |
| 3 VEE (Contrast Adjust) |
4 RS |
5 R/W |
6 E |
7 DB0 |
8 DB1 |
9 DB2 |
10 DB3 |
11 DB4 |
12 DB5 |
13 DB6 |
14 DB7 |
15 LED + |
16 LED - |
Connection with ATmega8/ATmega168 etc.
The lcd module can be easily connected to the any 28 pin AVR MCU like ATmega8/ATmega168/ATmega328 etc. The diagram below shows the LCD connection with AVR MCUs port pins.
![]() |
Fig: Connection with 28 PIN AVR MCUs |
Connect the required pins of PORTB and PORTD as shown in the diagram. The PORTs are clearly marked in the board. For connection you will need single pin female to female wires. Supply the LCD using the onboard 5V supply output using a 2 PIN connecter. Leave D0-D4 of LCD unconnected.
Connection with 40 PIN MCUs like ATmega16/ATmega32
![]() |
Fig: Connection with 40 PIN AVR MCUs |
NOTE: The 10K Pot (RV1) is very important, so please don't omit that ! When powered on for the first time you need to adjust this pot to get a clear display. Without proper adjustment of this pot you can even get a completely blank display !
Adding LCD support to your project
To add LCD support to your C projects we have made a easy to use library. To use this library first create a new project in AVR Studio then copy the following files to your project folder. lcd.c lcd.h myutils.h from lcdlibv20.zip then add them to your project by right clicking project view and selecting “Add Existing Source File(s)…” and then select the “lcd.c”. Similarly add “lcd.h” and “myutils.h” in Header Files section. Now you are ready to start coding LCD applications !!!
Fig: Adding files to projects. |
Programming.
In your main C file include the file lcd.h as #include “lcd.h” then initialize the LCD subsystem using a call to LCDInit(LS_BLINK|LS_ULINE); the argument specify the type of cursor required the LS_BLINK gives a blinking cursor. LS_ULINE gives a underlined cursor. To write any text call LCDWriteString("Welcome"); To write any number call void LCDWriteInt(int val,unsigned int field_length); This will print a integer contained in “val” . The field length is the length of field in which the number is printed.
For example LCDWriteInt(3,4); will print as follows
![]() |
While LCDWriteInt(123,5) will print as follows.
![]() |
To goto any particular position on screen call.
| void LCDGotoXY(uint8_t x,uint8_t y); |
| LCDGotoXY(11,1); |
![]() |
Fig: Cursor Positioning. |
Now anything you write to LCD will be printed at (11,1).
Clearing the display
| LCDClear(); |
This will clear the display and bring the cursor back to (0,0). There are two more functions that will go to specific position and print in one call.
Writing Text at a specific position.
LCDWriteStringXY(x,y,msg); ____________________________ x,y : the location where to print “msg” msg : the message to print Ex: LCDWriteStringXY(3,0,”hello”); LCDWriteStringXY(8,1,”world”); Output:
|
Writing Number at a specific position.
Similarly there is a function for integers.
LCDWriteIntXY(x,y,num,field_length); ____________________________________ x,y : the location where to print “num” num : the integer number to print field_length : the length of field (see LCDWriteInt() function above). |
Sample Program
#include <avr/io.h>
#include <util/delay.h>
#include "lcd.h"
void main()
{
unsigned char i;
//Initialize LCD module
LCDInit(LS_BLINK|LS_ULINE);
//Clear the screen
LCDClear();
//Simple string printing
LCDWriteString("Congrats ");
//A string on line 2
LCDWriteStringXY(0,1,"Loading ");
//Print some numbers
for (i=0;i<99;i+=1)
{
LCDWriteIntXY(9,1,i,3);
LCDWriteStringXY(12,1,"%");
_delay_loop_2(0);
_delay_loop_2(0);
_delay_loop_2(0);
_delay_loop_2(0);
}
//Clear the screen
LCDClear();
//Some more text
LCDWriteString("Hello world");
LCDWriteStringXY(0,1,"By YourName Here"); // <--- Write ur NAME HERE !!!!!!!!!!!
//Wait
for(i=0;i<100;i++) _delay_loop_2(0);
//Some More ......
LCDClear();
LCDWriteString(" eXtreme");
LCDWriteStringXY(0,1," Electronics");
}
Advance Use – Configuring Connections.
The library is designed to be fully customizable. If you want to connect the LCD module to some different i/o ports of the MCU then you can do so easily. You just have to modify the lcd.h file. Let’s see how. Open lcd.h and find a section “LCD Connections” it looks like![]() |
Fig: Configuring LCD Connection. |
Set LCD_DATA to the port where you have connected the LCD data lines. Then set LCD_DATA_POS to the starting pin of data lines. The LCD data lines D4 to D7 must be connected to consecutive pins starting from LCD_DATA_POS. For example if you wise to connect like this.
| PORTD (MCU) | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
| DATA LINEs (LCD) | D4 | D5 | D6 | D7 |
You must configure like this
#define LCD_DATA D //Because we are using PORTD
#define LCD_DATA_POS 3 // Because LCD DATA4 is connected to PD3
Please note that LCD Data lines DATA0 to DATA3 are always unused only DATA4 to DATA7 are required.
The library uses advance 4-bit mode so DATA0-DATA-3 of LCD are not used, saving 4 MCU pins! Now set the port where you have connected LCD’s ‘E’ signal. In example it is PORTB so #define LCD_E B Then specify to which PIN of PORTB it is connected, this is done by #define LCD_E_POS PB4 So ‘E’ pin of LCD is connected to PORTD-6 In same way set RS and RW signals. And that’s all! So you saw how easy is to customize the library.
Downloads
- Core library files.
- AVR Studio Project for 28 PIN AVR MCUs (Tested on ATmega8).
- AVR Studio Project for 40 PIN AVR MCUs (Tested on ATmega32/ATmega16).
- HEX File ready to burn on ATmega8.
- HEX File ready to burn on ATmega16.
- HEX File ready to burn on ATmega32.
Custom Character ?
Some times we need to show characters that are not the part of standard character set, like some special symbols (say heart or symbols of other language like Hindi). In that case we can use custom characters. They are also easy to make and use. Full article on using custom characters on alphanumeric lcds is available here.
![]() |
Fig: Custom Char Demo ! See the heart and other symbols? |
Going Graphical ?
If you have more sophisticated display requirement then you may go for Graphical LCDs (GLCD) they can render graphics like Icons and bitmaps (images), support graphic primitives like line,circle, rectangle etc. Also they can draw text in different fonts and sizes. That means 100% fun! And they are cheap and very easy to get started (thanks to ProGFX.org). We have some beginners tutorials for it too. So why waiting? Go Graphical!
Have fun and don’t forget to bookmark this page. If you think this tutorial has helped you please post a comment.
Author
Avinash Gupta











Thanks so much for this info. the library and the instructions you provided was really really helpful. it was also easy to understand, even for a beginner like me.
Thanks!
Sir i wanted to reverse map the data ports.. hw is this possible? for eg need to connect d4 to pd6, d5 to pd5, d6 to pd4 and d7 to pd3..
how to do this..
Plase… i’m request LCD libarary for ATmega16,32 ..
Thanks for u…
azizmetronet@yahoo.com
Dear sir,
I think your tutorial and the library is very helpful. I should like to ask you if I may use your library for my robotic project in a students’ technical competition?
Yours faithfully
@Matthew,
Yes you can use them
Thank you
Hye Avinash and thanks for this tutorial !!! It’s help me a lot for my project.
I have one question… I want to use my LCD display in 8bit mode like this (with atmega16):
D7 => PORTC pin 7 to D0 => PORTC pin 0
R/E/RW => No change.
What I should modify ?? Is it easy to do?
Thanks
Aurélien
PS: Merry Christmas
Nice tutorial, thanks. My first running application with Atmega32 and LCD with large number of not working before. I have tried move all pins to port D, but display doesnot works correctly. I would like to get free C port for realtime chip on my kit (http://shop.onpa.cz/?kit-evb-4.3,27) and SDA and SCL pins. I will try move them on port B on my board tomorow. Thank again. Czech Republic
other wise you may try SoftI2C
http://extremeelectronics.co.in/avr-tutorials/ds1307-i2c-rtcc-interface-using-softi2c-lib/
This is very good and easy to use lcd library.
I have 2 questions: Is there possibility to make custom characters with this library?
How can I print character which exist in lcd rom but is not available throu keyboard? Like some lcd special characters. For example degree symbol ° is not available throu keyboard, or am I wrong?
Thanks,
regards
filip
@Filip,
Nice question. Although our internal version has support, yet the public version is short on that feature.
Soon we will release the custom char supported version.
Great, I’m looking forward this new edition.
If I want to display specific character from lcd ascii table should I write
LCDWriteString(223) ?
Instead write
LCDData(96);
you can use any valid ASCII code as parameter.
Nice project, helped me a lot!
Does this library handle 16×4 or 20×4 LCD-s with HD44780 controller?
Thanks, Attila
Thanks alot for providing this much of valuable information in easy to use LCD library.In this code i made two changes i.e.,1)connected R/W pin to GND,and commented LCDBusyLoop(); 2 times one at InitLCD and second at LCDByte(); insted of busy loop function i inserted a delay 10 ms, so here i saved one M.C.U pin.
2)I connected data pins(D4,D5,D6,D7) from LCD to higher nibble at MCUport(PD4,PD5,PD6,PD7)
with some changes at InitLCD();LCDByte();,it is working good.My question is it ok eliminate reading data from L.C.D or it’s needed,
Thanks&Regards
Murali,
Waiting for your reply….
Dear Mr. Avinash
Wonderful tutorial. I have a question. In the library you define l lcd.c following:
# ifndef F_CPU
# define F_CPU 12000000UL
If I use a crystal of 4, 8 or 16Mhz working properly the LCD, simply runs less or more speed, right.
But will it affect if I let something like this and use an 8MHz crystal of handling the USART and / or I2C?
Thanks, best regards.
Hello avinash,
If I want to use a single port (like B) for all the pins of an atmega16 then what all changes do I need to make in the associated files.
sorry, i meant port B of atmega16 for the lcd pins
extreme electronic is very good for learning electronics. thanks
hai avinash,i have a doubt.will the fuse bits vary from frequency to frequency.what will be the fuse bits for 8mhz crystal?
Chock the datasheet of the mcu you are using. Its given clearly. After that, to be certain, use http://www.engbedded.com/fusecalc/
Hey,
Thanks for the tutorial,
My dev board connections to the LCD are as follows,
PD0-PD7 go to the 8 control pins
PB6 goes to Rs
PB7 goes to R/W
and PC7 goes to E,
Please can you tell me what changes i have to make to the lcd.c to get it working….
Thanks
Sethu
PS: i’m using Atmega8 and i’m interfacing the LCD to a custom made dev board
thanx man, u indians are pretty good in tutorial writing easily for beginners. thanx again man
You may say that Avinash Ji is exceptional.
Great tutorials!
They are pretty useful for my diploma project.
Can you help me with the modifications needed for the 4×20 or 4×16 LCD?
Thank you again!
Thank you again Avinash for the tutorials!
I managed to make it 20×4.
Here is what I did:
I changed void LCDGotoXY at the end of “lcd.c” with this part:
********************************************
void LCDGotoXY(uint8_t x,uint8_t y)
{
if(x<40)
{
switch(y)
{
case 0://1 line starts at 0×80(0b10000000)
x|=0b10000000;
break;
case 1://2 line starts at 0xC0(0b11000000)
x|=0b11000000;
break;
case 2://3 line starts at 0×94(0b10010100)
x|=0b10010100;
break;
case 3://4 line starts at 0xD4(0b11010100)
x|=0b11010100;
break;
}
LCDCmd(x);
}
}
********************************************
Thank you again!
Thanks so much. It’s just what I’m looking for. And it works perfectly. Thanks again.
@Diego Thanks !
Can I have this article in pdf form ? want to print them
Thank you
Whoooa!
That worked right out of the box. Amazing.
Thanks!
thanks sir for the module.
I need to show on LCD a function A^A+b, where a and b are introduced with the help of an 6×4 keypad which must have 0-9 , delete, ok, reset button and 10,20 and other values. The LCD is 16×2. Help me with the code in AVR please!!!!
Hello Mr. Avinash
I wrote the exact code you wrote as in the post,included source files and header files like you said,
earlier it was giving errors such as..
lcd.h:No such file or directory
../lcdtesting.c:7: error: ‘LS_ULINE’ undeclared (first use in this function)
../lcdtesting.c:7: error: (Each undeclared identifier is reported only once
../lcdtesting.c:7: error: for each function it appears in.)
../lcdtesting.c:25: error: ‘LS_ULINE’ undeclared (first use in this function)
Please help..
@Deepanshu Lulla
Dekh boss mere ko ise logo pe bahut gussa atta, samjha !
tere ko C ata kya ??? Mere ko to nei lagta tere ko zara bhi ata!
Clearly english me compiler error de raha aur tuhje us saltana bhi nei ata.
Ja jake koi aur kaam kar !
seriously!! even i have this problem pls help what can be done!!!
i cant understand Hindi!!
Hi man, this library is really a god thing!!!
I’m having some troublesand need some help.
When i try to print int or characters, lcd work fine. But when i try with strings, the lcd shows much black squares as characters i try to print… I think the problem is associated with the passing argument to the function, or the way the string is saved on program memory, but i dont know.
I’m working on linux-ubuntu, can the SO, or some routine of it, have something to do?
Thanks