Dan East
TextLCD library for controlling various LCD panels based on the HD44780 4-bit interface. Includes support for custom character bitmaps.
Dependents: HD44780-LCD_with_Bluetooth
Fork of
TextLCD
by 
Simon Ford
Examples
Hello world in custom font
#include "mbed.h"
#include "TextLCD.h"
int main() {
lcd=new TextLCD(D8, D9, D4, D5, D6, D7);
char c_H[]={0x1b,0x1b,0x1b,0x1f,0x1b,0x1b,0x1b,0x1b};
char c_e[]={0x0,0x0,0xe,0x1b,0x1f,0x18,0x18,0xf};
char c_l[]={0x6,0x6,0x6,0x6,0x6,0x6,0x6,0x6};
char c_o[]={0x0,0x0,0xe,0x1b,0x1b,0x1b,0x1b,0xe};
char c_W[]={0x1b,0x1b,0x1b,0x1b,0x1f,0x1f,0x1f,0x1b};
char c_r[]={0x0,0x0,0xe,0x1b,0x18,0x18,0x18,0x18};
char c_d[]={0x3,0x3,0xf,0x1b,0x1b,0x1b,0x1b,0xf};
lcd->defineChar(1, c_H);
lcd->putc(1);
lcd->defineChar(2, c_e);
lcd->putc(2);
lcd->defineChar(3, c_l);
lcd->putc(3);
lcd->putc(3);
lcd->defineChar(4, c_o);
lcd->putc(4);
lcd->putc(32);
lcd->defineChar(5, c_W);
lcd->putc(5);
lcd->putc(4);
lcd->defineChar(6, c_r);
lcd->putc(6);
lcd->putc(3);
lcd->defineChar(7, c_d);
lcd->putc(7);
while (1) {
}
}
Animated busy indicator
This animation only uses 1 of the 8 custom character slots, and can be used like a regular character in the output and will automatically animate in-place. Any number of the animated characters can be displayed on the display at once using this animation technique.
#include "mbed.h"
#include "TextLCD.h"
int main() {
lcd=new TextLCD(D8, D9, D4, D5, D6, D7);
//The 7 animation characters
char spin[]={ 0x4,0x4,0x4,0x4,0x4,0x4,0x4,0x0,
0x2,0x2,0x2,0x4,0x8,0x8,0x8,0x0,
0x1,0x2,0x2,0x4,0x8,0x8,0x10,0x0,
0x0,0x0,0x3,0x4,0x18,0x0,0x0,0x0,
0x0,0x0,0x0,0x1f,0x0,0x0,0x0,0x0,
0x0,0x0,0x18,0x4,0x3,0x0,0x0,0x0,
0x10,0x8,0x8,0x4,0x2,0x2,0x01,0x0
};
//Output text.
lcd->printf("\1 Please wait \1");
//Animation loop
int frame=0;
while (1) {
lcd->defineChar(1, spin+frame*8);
frame=(frame+1)%(sizeof(spin)/8);
wait(.14);
}
Diff: TextLCD.h
- Revision:
- 1:ac48b187213c
- Parent:
- 0:edfb85c53631
- Child:
- 2:227356c7d12c
--- a/TextLCD.h Sat May 22 18:18:19 2010 +0000
+++ b/TextLCD.h Thu May 27 13:44:15 2010 +0000
@@ -1,48 +1,71 @@
-/* mbed TextLCD Library, for a 4-bit 2x16 LCD
- * Copyright (c) 2007-2010, sford
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include "TextDisplay.h"
-
-#ifndef MBED_TEXTLCD_H
-#define MBED_TEXTLCD_H
-
-class TextLCD : public TextDisplay {
-public:
-
- TextLCD(PinName rs, PinName rw, PinName e, PinName d0, PinName d1, PinName d2, PinName d3);
- virtual void character(int column, int row, int c);
- virtual int rows();
- virtual int columns();
-
- // locate, cls, putc, printf come from derived classes
-
-protected:
-
- void writeByte(int value);
- void writeCommand(int command);
- void writeData(int data);
-
- DigitalOut _rw, _rs, _e;
- BusOut _d;
-};
-
-#endif
+/* mbed TextLCD Library, for a 4-bit LCD based on HD44780
+ * Copyright (c) 2007-2010, sford
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#ifndef MBED_TEXTLCD_H
+#define MBED_TEXTLCD_H
+
+#include "mbed.h"
+class TextLCD : public Stream {
+public:
+
+ // the different LCDs and addressing modes
+ /** Select the type of LCD */
+ enum LCDType {
+ LCD16x2
+ , LCD16x2B
+ , LCD20x2
+ , LCD20x4
+ };
+
+ TextLCD(PinName rs, PinName e, PinName d0, PinName d1, PinName d2, PinName d3, LCDType type = LCD16x2);
+ // int putc(int c) inherited from Stream
+ // int printf(...) inherited from Stream
+ void character(int column, int row, int c);
+ void locate(int column, int row);
+ void cls();
+
+ int rows();
+ int columns();
+
+
+protected:
+
+ // Stream implementation functions
+ virtual int _putc(int value);
+ virtual int _getc();
+
+ // internal tx functions
+ void writeByte(int value);
+ void writeCommand(int command);
+ void writeData(int data);
+ int address(int column, int row);
+
+ DigitalOut _rs, _e;
+ BusOut _d;
+ LCDType _type;
+
+ // current row/column
+ int _column;
+ int _row;
+};
+
+#endif