AutocadHow-ToBeginner · 3 min read

How to Use LiquidCrystal Library in Arduino for LCD Display

To use the LiquidCrystal library in Arduino, first include it with #include <LiquidCrystal.h>, then create an object specifying the LCD pins. Use methods like begin() to initialize and print() to display text on the LCD screen.

📐

Syntax

The LiquidCrystal library controls LCD displays using specific Arduino pins. You create an object by specifying the pins connected to the LCD's RS, Enable, and data lines. Then, you initialize the LCD size and use methods to display text.

#include <LiquidCrystal.h>: Includes the library.
LiquidCrystal lcd(rs, enable, d4, d5, d6, d7);: Creates the LCD object with pin numbers.
lcd.begin(cols, rows);: Sets the LCD size (columns and rows).
lcd.print("text");: Prints text on the LCD.

arduino

#include <LiquidCrystal.h>

// Create LCD object with pins: RS, Enable, D4, D5, D6, D7
LiquidCrystal lcd(12, 11, 5, 4, 3, 2);

void setup() {
  lcd.begin(16, 2); // Initialize 16x2 LCD
  lcd.print("Hello, World!"); // Print text
}

void loop() {
  // Nothing here
}

Output

LCD screen shows: Hello, World!

💻

Example

This example shows how to display a message on a 16x2 LCD using the LiquidCrystal library. It initializes the LCD and prints "Hello, Arduino!" on the first line.

arduino

#include <LiquidCrystal.h>

LiquidCrystal lcd(7, 8, 9, 10, 11, 12); // RS, E, D4, D5, D6, D7 pins

void setup() {
  lcd.begin(16, 2); // Set LCD size to 16 columns and 2 rows
  lcd.print("Hello, Arduino!"); // Display message
}

void loop() {
  // No repeated actions needed
}

Output

LCD screen shows: Hello, Arduino!

⚠️

Common Pitfalls

Common mistakes when using the LiquidCrystal library include:

Incorrect pin connections or wrong pin numbers in the code.
Not calling lcd.begin() before printing text.
Trying to print text longer than the LCD width without managing cursor position.
Forgetting to clear the screen with lcd.clear() when updating display content.

Always double-check wiring and initialize the LCD properly.

arduino

// Wrong: Missing lcd.begin()
#include <LiquidCrystal.h>
LiquidCrystal lcd(12, 11, 5, 4, 3, 2);

void setup() {
  lcd.print("Oops!"); // This won't show correctly
}

void loop() {}

// Correct:
#include <LiquidCrystal.h>
LiquidCrystal lcd(12, 11, 5, 4, 3, 2);

void setup() {
  lcd.begin(16, 2); // Initialize LCD
  lcd.print("Fixed!");
}

void loop() {}

Output

Wrong code: No visible text on LCD Correct code: LCD shows 'Fixed!'

📊

Quick Reference

Function	Description
LiquidCrystal(rs, enable, d4, d5, d6, d7)	Create LCD object with pin numbers
lcd.begin(cols, rows)	Initialize LCD size
lcd.print(text)	Display text on LCD
lcd.setCursor(col, row)	Set cursor position
lcd.clear()	Clear the display
lcd.noDisplay()	Turn off display
lcd.display()	Turn on display

✅

Key Takeaways

Include and create an LCD object with correct pins.

Always call lcd.begin() with your LCD's size before printing.

Use lcd.print() to show text and lcd.setCursor() to position it.

Check wiring carefully to avoid display issues.

Clear the screen with lcd.clear() when updating content.