Arduino Programming
Part 6: LCD Panel Output
EAS 199B, Winter 2013
Gerald Recktenwald
Portland State University
gerry@me.pdx.edu
Goals
Use the 20x4 character LCD display for output
Overview of assembly detailed instructions on the web
http://web.cecs.pdx.edu/~eas199/B/howto/LCDwiring/
http://www.ladyada.net/learn/lcd/charlcd.html
Introduction to the LCD library
Simple demonstration
Map the 20x4 character display for fish tank data
http://www.arduino.cc/en/Tutorial/LiquidCrystal
Arduino Programming Part 6: EAS 199B
Breadboard connection via Adafruit Tutorial
*!!"
!"#$%%&'"()*'+,)-$."()
)!!"
0+%%)1232)!"#$%%&'"()4'#5.5)6&')
-.."/-0"
-.."1/"
(!!"
/-0"234567849"
'!!"
1/"234567849"
&!!"
%!!"
$!!"
#!!"
!"
'+$$"
(+##"
)+#"
)+$#"
*+#!"
*+%!"
,+#,"
#!+,"
/+(')
Arduino Programming Part 6: EAS 199B
http://www.ladyada.net/learn/lcd/charlcd.html
The Adafruit kit
1. Header for
electrical
connections
2. Potentiometer for
contrast adjustment
3. Panel on PCB
Arduino Programming Part 6: EAS 199B
Wiring diagram
Connector
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Arduino
Green
Red
Yellow
Brown
Green
White
Ground
+5V
Wiper of 10k potentiometer
pin 8
Ground
pin 9
Blue
Black
Gray
Orange
Red
Green
pin 10
pin 11
pin 12
pin 13
+5V
Ground
16
Arduino Programming Part 6: EAS 199B
Step 1: Solder the header
Arduino Programming Part 6: EAS 199B
Step 2: Assemble the wiring harness
Arduino Programming Part 6: EAS 199B
Crimp Connectors: they are small!
Arduino Programming Part 6: EAS 199B
Crimp connectors are small
Dont bother with the male connectors
They are fragile when not enclosed in a connector shell
Just tin the stranded wire
Please be careful
Connectors are not free
Some failed connections are inevitable
Arduino Programming Part 6: EAS 199B
Crimp connectors are small
Dont bother with the male connectors
They are fragile when not enclosed in a connector shell
Just tin the stranded wire
Please be careful
Connectors are not free
Some failed connections are inevitable
Do not raid kits for extra connectors! Ask your
instructor for spares if you need them.
Arduino Programming Part 6: EAS 199B
10
Use jumpers to avoid unnecessary wire
Connection to
+5V on Arduino
Connection to
ground on Arduino
+5V on pin 2
and pin 15
Ground on
pin 1, pin 5
and pin 16
Arduino Programming Part 6: EAS 199B
11
Locate the crimp connector in the tool
Arduino Programming Part 6: EAS 199B
12
Crimp the strain relief
Arduino Programming Part 6: EAS 199B
13
Finished crimping for the female connector
Arduino Programming Part 6: EAS 199B
14
Finished female and male connectors
Female connector for LCD end
Male pins for Arduino end
Note: These male pins still need heat shrink to
insulate pins from each other when they are
inserted into a breadboard.
Arduino Programming Part 6: EAS 199B
15
Finished female and male connectors
Female connector for LCD end
Male pins for Arduino end
Note: These male pins still need heat shrink to
insulate pins from each other when they are
inserted into a breadboard.
Arduino Programming Part 6: EAS 199B
16
Programming Arduino for LCD Display
Refer to Adafruit tutorial
http://www.ladyada.net/learn/lcd/charlcd.html
and Arduino documentation
http://www.arduino.cc/en/Tutorial/LiquidCrystal
Arduino Programming Part 6: EAS 199B
17
Breadboard connection via Adafruit Tutorial
*!!"
!"#$%%&'"()*'+,)-$."()
)!!"
0+%%)1232)!"#$%%&'"()4'#5.5)6&')
-.."/-0"
-.."1/"
(!!"
/-0"234567849"
'!!"
1/"234567849"
&!!"
%!!"
$!!"
#!!"
!"
'+$$"
(+##"
)+#"
)+$#"
*+#!"
*+%!"
,+#,"
#!+,"
/+(')
Arduino Programming Part 6: EAS 199B
http://www.ladyada.net/learn/lcd/charlcd.html
18
Test the display
// include the library code:
#include <LiquidCrystal.h>
File Examples LiquidCrystal HelloWorld
// initialize the library with the numbers of the interface pins
LiquidCrystal lcd(12, 11, 5, 4, 3, 2);
void setup() {
// set up the LCD's number of columns and rows:
lcd.begin(16, 2);
// Print a message to the LCD.
lcd.print("hello, world!");
}
void loop() {
// set the cursor to column 0, line 1
// Line 1 is the second row, because counting begins with 0
lcd.setCursor(0, 1);
// print the number of seconds since reset:
lcd.print(millis()/1000);
}
Arduino Programming Part 6: EAS 199B
19
Test the display
// include the library code:
#include <LiquidCrystal.h>
Change pin assignments to
match wiring harness:
(8,9,10,11,12,13)
// initialize the library with the numbers of the interface pins
LiquidCrystal lcd(12, 11, 5, 4, 3, 2);
void setup() {
// set up the LCD's number of columns and rows:
lcd.begin(16, 2);
Change to (20,4)
// Print a message to the LCD.
lcd.print("hello, world!");
}
void loop() {
// set the cursor to column 0, line 1
// Line 1 is the second row, because counting begins with 0
lcd.setCursor(0, 1);
// print the number of seconds since reset:
lcd.print(millis()/1000);
}
Arduino Programming Part 6: EAS 199B
File Examples LiquidCrystal HelloWorld
20
Test the display
// include the library code:
#include <LiquidCrystal.h>
// initialize the library with the numbers of the interface pins
LiquidCrystal lcd(12, 11, 5, 4, 3, 2);
void setup() {
// set up the LCD's number of columns and rows:
lcd.begin(16, 2);
// Print a message to the LCD.
lcd.print("hello, world!");
}
lcd is a LiquidCrystal object
void loop() {
// set the cursor to column 0, line 1
// Line 1 is the second row, because counting begins with 0
lcd.setCursor(0, 1);
// print the number of seconds since reset:
lcd.print(millis()/1000);
}
Arduino Programming Part 6: EAS 199B
File Examples LiquidCrystal HelloWorld
21
Arduino code to write to the LCD panel
Include the LCD library
#include <LiquidCrystal.h>
In the header:
(outside and before setup)
Initialize the display by creating a LiquidCrystal object
Before using the display: LiquidCrystal lcd(p1,p2,p3,p4,p5,p6);
lcd.begin(20,4);
Send characters in a two-step process
Move the cursor:
Display the message:
lcd.setCursor(column,row)
lcd. print(message)
Arduino Programming Part 6: EAS 199B
22
Character matrix on a 4 X 20 display
Row and column indices begin with zero
0
1
2
3
01234567890123456789
Arduino Programming Part 6: EAS 199B
23
Character matrix on a 4 X 20 display
Row and column indices begin with zero
lcd.setCursor(0,0)
0
1
2
3
01234567890123456789
Arduino Programming Part 6: EAS 199B
lcd.setCursor(6,2)
24
Display fish tank salinity
Modify the HelloWorld code to display the salinity
Salinity = and Average of can be displayed once at the start
x.xx and NNN values change, and are updated on the display.
01234567890123456789
0 Salinity = x.xx%
1 Average of NNN
2
3
Arduino Programming Part 6: EAS 199B
25
Programming Paradigms
To think about styles of programming, we can organize
programming languages into paradigms
Paradigm
Representative Languages
Procedural or Sequential Fortran, C, Basic
Object-oriented
C++, smalltalk
Parallel /Concurrent
occam, erlang
Dataflow
LabVIEW
Functional
Haskel, Lisp
Scripting
perl, python
Note that many modern program languages have features of
more than one paradigm
Arduino Programming Part 6: EAS 199B
26
Object-Oriented Programming (OOP)
As you might expect, Objects are central to OOP
Objects have data
Objects have methods (like functions)
Objects can be assembled into other objects.
Arduino Programming
Uses the object-oriented language C++
Dont get carried away with the OOP on Arduino
Keep your Arduino programs from becoming too complex
Basic structure of code, with setup() and loop() is sequential
Libraries for the Serial Monitor and LCD output use OOP
Know enough OOP to use existing libraries
OOP can be handy when programming with new types of sensors
Arduino Programming Part 6: EAS 199B
27
OOP in the LCD library code
Create a new LiquidCrystal object:
LiquidCrystal lcd(p1,p2,p3,p4,p5,p6);
Type of object
Name of the new object
Data passed to the object constructor
When a new object is created, the data passed to the
constructor is stored in the object. Thus, whenever we use
the variable lcd again in the program, the lcd object
knows that it is connected to p1, p2, ..., p6.
Arduino Programming Part 6: EAS 199B
28
OOP in the LCD library code
Tell the lcd object about the size of the display
lcd.begin(20,4)
Run the begin method
Pass the values 20 and 4 to the begin method
Objects have data and methods
Data are values associated with a particular instance of an object
Some data may be public. Programmers can view or change public data.
Some data may be private, and therefore unavailable to programmers.
Methods are functions that an object knows how to perform
Methods can return values
Methods can change public data
Methods can perform computations and interact with the environment (sensors)
Arduino Programming Part 6: EAS 199B
29
OOP in the LCD library code
Change the current cursor position:
lcd.setCursor(12,1)
Run the setCursor method
Pass 12 and 1 to the setCursor method
The setCursor methods prepares lcd for its next action
lcd.print(Hello)
Run the print method
Use Hello as data for the print method
lcd.print(...) works because the lcd object knows about its
current position (from setCursor), the size of the display
(from begin), and from the pin assignments from the
constructor. When the lcd.print() method runs, it unleashes
action that is constrained by data stored in the object.
Arduino Programming Part 6: EAS 199B
30