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);
    }
Committer:
simon
Date:
Thu May 27 13:44:15 2010 +0000
Revision:
1:ac48b187213c
Parent:
0:edfb85c53631
Child:
2:227356c7d12c

        

Who changed what in which revision?

UserRevisionLine numberNew contents of line
simon 1:ac48b187213c 1 /* mbed TextLCD Library, for a 4-bit LCD based on HD44780
simon 1:ac48b187213c 2 * Copyright (c) 2007-2010, sford
simon 1:ac48b187213c 3 *
simon 1:ac48b187213c 4 * Permission is hereby granted, free of charge, to any person obtaining a copy
simon 1:ac48b187213c 5 * of this software and associated documentation files (the "Software"), to deal
simon 1:ac48b187213c 6 * in the Software without restriction, including without limitation the rights
simon 1:ac48b187213c 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
simon 1:ac48b187213c 8 * copies of the Software, and to permit persons to whom the Software is
simon 1:ac48b187213c 9 * furnished to do so, subject to the following conditions:
simon 1:ac48b187213c 10 *
simon 1:ac48b187213c 11 * The above copyright notice and this permission notice shall be included in
simon 1:ac48b187213c 12 * all copies or substantial portions of the Software.
simon 1:ac48b187213c 13 *
simon 1:ac48b187213c 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
simon 1:ac48b187213c 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
simon 1:ac48b187213c 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
simon 1:ac48b187213c 17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
simon 1:ac48b187213c 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
simon 1:ac48b187213c 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
simon 1:ac48b187213c 20 * THE SOFTWARE.
simon 1:ac48b187213c 21 */
simon 1:ac48b187213c 22
simon 1:ac48b187213c 23 #ifndef MBED_TEXTLCD_H
simon 1:ac48b187213c 24 #define MBED_TEXTLCD_H
simon 1:ac48b187213c 25
simon 1:ac48b187213c 26 #include "mbed.h"
simon 1:ac48b187213c 27 class TextLCD : public Stream {
simon 1:ac48b187213c 28 public:
simon 1:ac48b187213c 29
simon 1:ac48b187213c 30 // the different LCDs and addressing modes
simon 1:ac48b187213c 31 /** Select the type of LCD */
simon 1:ac48b187213c 32 enum LCDType {
simon 1:ac48b187213c 33 LCD16x2
simon 1:ac48b187213c 34 , LCD16x2B
simon 1:ac48b187213c 35 , LCD20x2
simon 1:ac48b187213c 36 , LCD20x4
simon 1:ac48b187213c 37 };
simon 1:ac48b187213c 38
simon 1:ac48b187213c 39 TextLCD(PinName rs, PinName e, PinName d0, PinName d1, PinName d2, PinName d3, LCDType type = LCD16x2);
simon 1:ac48b187213c 40 // int putc(int c) inherited from Stream
simon 1:ac48b187213c 41 // int printf(...) inherited from Stream
simon 1:ac48b187213c 42 void character(int column, int row, int c);
simon 1:ac48b187213c 43 void locate(int column, int row);
simon 1:ac48b187213c 44 void cls();
simon 1:ac48b187213c 45
simon 1:ac48b187213c 46 int rows();
simon 1:ac48b187213c 47 int columns();
simon 1:ac48b187213c 48
simon 1:ac48b187213c 49
simon 1:ac48b187213c 50 protected:
simon 1:ac48b187213c 51
simon 1:ac48b187213c 52 // Stream implementation functions
simon 1:ac48b187213c 53 virtual int _putc(int value);
simon 1:ac48b187213c 54 virtual int _getc();
simon 1:ac48b187213c 55
simon 1:ac48b187213c 56 // internal tx functions
simon 1:ac48b187213c 57 void writeByte(int value);
simon 1:ac48b187213c 58 void writeCommand(int command);
simon 1:ac48b187213c 59 void writeData(int data);
simon 1:ac48b187213c 60 int address(int column, int row);
simon 1:ac48b187213c 61
simon 1:ac48b187213c 62 DigitalOut _rs, _e;
simon 1:ac48b187213c 63 BusOut _d;
simon 1:ac48b187213c 64 LCDType _type;
simon 1:ac48b187213c 65
simon 1:ac48b187213c 66 // current row/column
simon 1:ac48b187213c 67 int _column;
simon 1:ac48b187213c 68 int _row;
simon 1:ac48b187213c 69 };
simon 1:ac48b187213c 70
simon 1:ac48b187213c 71 #endif