Rune Langoy / LCDLib

A TextLCD interface for driving 4-bit 16x2 KS0066U LCD

Dependents:   KS0066U4_16x2 LAB05_Oppgave4 LAB05_Oppgave2 LAB05_Oppgave3 ... more

Import program
KS0066U4_16x2 - main.cpp

00001  #include "mbed.h"
00002  #include "TextLCD.h"
00003  
00004  TextLCD lcd(D11,D10,D9,D5,D4,D3,D2);
00005  int main()
00006  {    
00007     lcd.gotoxy(1,1);
00008     lcd.printf("Hello");
00009  
00010     lcd.gotoxy(4,2);
00011     lcd.printf("World");
00012     
00013     while(1) {
00014         wait_ms(300);
00015     }
00016  }

Import library
LCDLib - TextLCD Class Reference

Public Member Functions

TextLCD (PinName rs, PinName rw, PinName e, PinName d4, PinName d5, PinName d6, PinName d7, const char *name=NULL)
Create a TextLCD interface and initiated 16x2 char mode.
void lcdComand (unsigned char cmd)
Writes a Command to the LCD-module.
void lcdData (unsigned char data)
Writes charecters to the LCD display.
void gotoxy (int, int)
moves text cursor to a screen column and row
int putc (int c)
Write a character to the LCD.
int printf (const char *format,...)
Write a formatted string to the LCD.

Protected Member Functions

void writeLcdBitD4toD7 (char data)
Writes the low nible of data to the LCD-module.
void pulseEn ()
Causes the LCD-module to read the data on the data input pins EN = 1 for L-to-H / EN = 0 for H-to-L.
void init_4BitMode2LinesDisplayOn ()
Enable 4 bit mode From KS0066U Documentation.

/media/uploads/rlanghbv/lcdmoduletop.jpg /media/uploads/rlanghbv/lcdmodulebottom.jpg

TextLCD.cpp@16:ca413e232eaa, 2015-09-21 (annotated)

Committer:
rlanghbv
Date:
Mon Sep 21 09:25:53 2015 +0000
Revision:
16:ca413e232eaa
Parent:
15:dc4f024fd1aa
Child:
17:5ffb16966db2
Init Fixed for other 16x2 Display modules

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rlanghbv 1:8902f6be12a5 1
rlanghbv 1:8902f6be12a5 2 #include "mbed.h"
rlanghbv 1:8902f6be12a5 3 #include "TextLCD.h"
rlanghbv 1:8902f6be12a5 4
rlanghbv 1:8902f6be12a5 5 #define SET_EN() (LCD_EN=1)
rlanghbv 1:8902f6be12a5 6 #define SET_RS() (LCD_RS=1)
rlanghbv 1:8902f6be12a5 7 #define SET_RW() (LCD_RW=1)
rlanghbv 1:8902f6be12a5 8
rlanghbv 1:8902f6be12a5 9 #define CLEAR_EN() (LCD_EN=0)
rlanghbv 1:8902f6be12a5 10 #define CLEAR_RS() (LCD_RS=0)
rlanghbv 1:8902f6be12a5 11 #define CLEAR_RW() (LCD_RW=0)
rlanghbv 1:8902f6be12a5 12
rlanghbv 1:8902f6be12a5 13
rlanghbv 4:264d9b06bf60 14 TextLCD::TextLCD(PinName rs,PinName rw, PinName e, PinName d4, PinName d5,
rlanghbv 15:dc4f024fd1aa 15 PinName d6, PinName d7, const char* name) : Stream(name), LCD_RS(rs),LCD_RW(rw), LCD_EN(e),
rlanghbv 10:8d5383e2546e 16 LCD_D4to7(d4,d5,d6,d7)
rlanghbv 10:8d5383e2546e 17 {
rlanghbv 4:264d9b06bf60 18 CLEAR_RW();
rlanghbv 4:264d9b06bf60 19 wait_ms(50); // Wait for disp to turn on
rlanghbv 4:264d9b06bf60 20
rlanghbv 3:d2f70de20dbe 21 CLEAR_EN(); //EN =0
rlanghbv 4:264d9b06bf60 22 CLEAR_RS();
rlanghbv 3:d2f70de20dbe 23
rlanghbv 4:264d9b06bf60 24 init_4BitMode2LinesDisplayOn(); //enabler 4 bit mode
rlanghbv 4:264d9b06bf60 25 wait_ms(1);
rlanghbv 4:264d9b06bf60 26
rlanghbv 4:264d9b06bf60 27 lcdComand(0x00);
rlanghbv 3:d2f70de20dbe 28 wait_us(100);
rlanghbv 3:d2f70de20dbe 29
rlanghbv 4:264d9b06bf60 30 lcdComand(0x28);//(0b0010 1000); // 4- bit mode LCD 2 line 16x2 Matrix
rlanghbv 3:d2f70de20dbe 31 wait_us(100);
rlanghbv 4:264d9b06bf60 32
rlanghbv 8:b12188ddd403 33 lcdComand(0xE);//(0b0000 1110);
rlanghbv 3:d2f70de20dbe 34 wait_us(100);
rlanghbv 8:b12188ddd403 35 lcdComand(0x01); //(0b00000001);
rlanghbv 3:d2f70de20dbe 36 wait_us(100);
rlanghbv 8:b12188ddd403 37 lcdComand(0x06);//(0b00000110);
rlanghbv 3:d2f70de20dbe 38 wait_us(100);
rlanghbv 9:9529e943259c 39 gotoxy(1,1);
rlanghbv 1:8902f6be12a5 40 }
rlanghbv 1:8902f6be12a5 41
rlanghbv 1:8902f6be12a5 42 // Causes the LCD-module to read the data on the data input pins
rlanghbv 1:8902f6be12a5 43 void TextLCD::pulseEn()
rlanghbv 1:8902f6be12a5 44 {
rlanghbv 1:8902f6be12a5 45 SET_EN(); // EN = 1 for L-to-H /
rlanghbv 1:8902f6be12a5 46 wait_us(200);
rlanghbv 1:8902f6be12a5 47 CLEAR_EN(); // EN = 0 for H-to-L
rlanghbv 1:8902f6be12a5 48 }
rlanghbv 1:8902f6be12a5 49
rlanghbv 1:8902f6be12a5 50 //Writes the low lible of data to the LCD-module data pins D4 to D7
rlanghbv 1:8902f6be12a5 51 void TextLCD::writeLcdBitD4toD7(char data)
rlanghbv 1:8902f6be12a5 52 {
rlanghbv 8:b12188ddd403 53 LCD_D4to7=data;
rlanghbv 1:8902f6be12a5 54 }
rlanghbv 1:8902f6be12a5 55
rlanghbv 1:8902f6be12a5 56 //Enable 4 bit mode From KS0066U Documentation
rlanghbv 1:8902f6be12a5 57 void TextLCD::init_4BitMode2LinesDisplayOn()
rlanghbv 1:8902f6be12a5 58 {
rlanghbv 16:ca413e232eaa 59
rlanghbv 1:8902f6be12a5 60 //Start by selecting configuration mode
rlanghbv 1:8902f6be12a5 61 CLEAR_RS();
rlanghbv 1:8902f6be12a5 62 CLEAR_RW();
rlanghbv 1:8902f6be12a5 63
rlanghbv 16:ca413e232eaa 64 wait(.015); // Wait 150ms to ensure powered up
rlanghbv 16:ca413e232eaa 65
rlanghbv 4:264d9b06bf60 66 // send "Display Settings" 3 times (Only top nibble of 0x30 as we've got 4-bit bus)
rlanghbv 4:264d9b06bf60 67 writeLcdBitD4toD7(0x3);
rlanghbv 4:264d9b06bf60 68 pulseEn();
rlanghbv 4:264d9b06bf60 69 wait_ms(2);
rlanghbv 4:264d9b06bf60 70 writeLcdBitD4toD7(0x3);
rlanghbv 4:264d9b06bf60 71 pulseEn();
rlanghbv 4:264d9b06bf60 72 wait_ms(2);
rlanghbv 4:264d9b06bf60 73 writeLcdBitD4toD7(0x3);
rlanghbv 4:264d9b06bf60 74 pulseEn();
rlanghbv 4:264d9b06bf60 75 wait_ms(2);
rlanghbv 4:264d9b06bf60 76
rlanghbv 1:8902f6be12a5 77 //Enable 4 bit mode From KS0066U Documentation
rlanghbv 16:ca413e232eaa 78 writeLcdBitD4toD7(0x2);// (0b0010) 4- bit start / 4-bit mode
rlanghbv 1:8902f6be12a5 79 wait_us(100);
rlanghbv 16:ca413e232eaa 80 writeLcdBitD4toD7(0x2);
rlanghbv 16:ca413e232eaa 81 pulseEn();
rlanghbv 16:ca413e232eaa 82 wait_us(100);
rlanghbv 1:8902f6be12a5 83 writeLcdBitD4toD7(0x2);////(0b0010); // Select 4- bit start (Already on the out port no need to write once more )
rlanghbv 1:8902f6be12a5 84 pulseEn(); //LCD exec function
rlanghbv 16:ca413e232eaa 85 wait_us(50);
rlanghbv 1:8902f6be12a5 86
rlanghbv 1:8902f6be12a5 87 writeLcdBitD4toD7(0xC);//(0b1100); // 2 Lines + Disp On
rlanghbv 1:8902f6be12a5 88 pulseEn(); //LCD exec function
rlanghbv 16:ca413e232eaa 89
rlanghbv 16:ca413e232eaa 90 lcdComand(0x01); // Clear Display
rlanghbv 16:ca413e232eaa 91 wait_ms(3);
rlanghbv 16:ca413e232eaa 92 lcdComand(0x28); // Function set 001 BW N F - -
rlanghbv 16:ca413e232eaa 93 lcdComand(0x06); // Cursor Direction and Display Shift : 0000 01 CD S (CD 0-left, 1-right S(hift) 0-no, 1-yes
rlanghbv 16:ca413e232eaa 94 lcdComand(0x0C); // Dispon + Hide cursor
rlanghbv 1:8902f6be12a5 95 wait_us(100);
rlanghbv 1:8902f6be12a5 96 }
rlanghbv 1:8902f6be12a5 97
rlanghbv 1:8902f6be12a5 98
rlanghbv 1:8902f6be12a5 99 //Writes the byte comand to the LCD-module using 4 bits mode
rlanghbv 1:8902f6be12a5 100 void TextLCD::lcdComand(unsigned char cmd)
rlanghbv 1:8902f6be12a5 101 {
rlanghbv 1:8902f6be12a5 102 writeLcdBitD4toD7(cmd>>4); //Write the first high cmd nibble
rlanghbv 1:8902f6be12a5 103
rlanghbv 1:8902f6be12a5 104 CLEAR_RS(); // RS = 0 for command
rlanghbv 1:8902f6be12a5 105 CLEAR_RW(); // RW = 0 for write
rlanghbv 1:8902f6be12a5 106
rlanghbv 1:8902f6be12a5 107 pulseEn(); //EN Hi-Lo
rlanghbv 1:8902f6be12a5 108
rlanghbv 1:8902f6be12a5 109 writeLcdBitD4toD7(cmd); //Write the second low cmd nibble
rlanghbv 1:8902f6be12a5 110
rlanghbv 1:8902f6be12a5 111 pulseEn(); //EN H to Lo
rlanghbv 1:8902f6be12a5 112
rlanghbv 1:8902f6be12a5 113 wait_us(100); //wait
rlanghbv 1:8902f6be12a5 114 }
rlanghbv 1:8902f6be12a5 115
rlanghbv 1:8902f6be12a5 116 void TextLCD::lcdData(unsigned char data)
rlanghbv 1:8902f6be12a5 117 {
rlanghbv 1:8902f6be12a5 118 writeLcdBitD4toD7(data>>4); //Write the first high data nibble
rlanghbv 1:8902f6be12a5 119
rlanghbv 1:8902f6be12a5 120 SET_RS(); // RS = 1 for data
rlanghbv 1:8902f6be12a5 121 CLEAR_RW(); // RW = 0 for write
rlanghbv 1:8902f6be12a5 122 pulseEn(); // EN H to Lo
rlanghbv 1:8902f6be12a5 123 wait_us(100); //wait
rlanghbv 1:8902f6be12a5 124
rlanghbv 1:8902f6be12a5 125 writeLcdBitD4toD7(data);
rlanghbv 1:8902f6be12a5 126
rlanghbv 1:8902f6be12a5 127 pulseEn(); //EN H to Lo
rlanghbv 1:8902f6be12a5 128 wait_us(100); //wait
rlanghbv 1:8902f6be12a5 129 }
rlanghbv 1:8902f6be12a5 130
rlanghbv 1:8902f6be12a5 131 //Moves cursor to the X,Y position
rlanghbv 2:f0a520c95838 132 void TextLCD::gotoxy(int x, int y)
rlanghbv 1:8902f6be12a5 133 {
rlanghbv 1:8902f6be12a5 134 unsigned char firstCharAdr[]= { 0x80,0xc0,0x94,0xD4};
rlanghbv 1:8902f6be12a5 135 lcdComand(firstCharAdr[y-1]+ x -1);
rlanghbv 1:8902f6be12a5 136
rlanghbv 1:8902f6be12a5 137 wait_us(100);
rlanghbv 1:8902f6be12a5 138 }
rlanghbv 1:8902f6be12a5 139
rlanghbv 1:8902f6be12a5 140 int TextLCD::_putc(int value)
rlanghbv 1:8902f6be12a5 141 {
rlanghbv 1:8902f6be12a5 142 lcdData(value);
rlanghbv 1:8902f6be12a5 143 return value;
rlanghbv 1:8902f6be12a5 144 }
rlanghbv 1:8902f6be12a5 145
rlanghbv 4:264d9b06bf60 146 int TextLCD::_getc()
rlanghbv 1:8902f6be12a5 147 {
rlanghbv 4:264d9b06bf60 148 return -1;
rlanghbv 1:8902f6be12a5 149 }