Wim Huiskamp
Updated for more display types. Fixed memoryaddress confusion in address() method. Added new getAddress() method. Added support for UDCs, Backlight control and other features such as control through I2C and SPI port expanders and controllers with native I2C and SPI interfaces. Refactored to fix issue with pins that are default declared as NC.
Dependents: GPSDevice TestTextLCD SD to Flash Data Transfer DrumMachine ... more
Fork of
TextLCD
by 
Simon Ford
Example
Hello World! for the TextLCD
#include "mbed.h"
#include "TextLCD.h"
// Host PC Communication channels
Serial pc(USBTX, USBRX); // tx, rx
// I2C Communication
I2C i2c_lcd(p28,p27); // SDA, SCL
// SPI Communication
SPI spi_lcd(p5, NC, p7); // MOSI, MISO, SCLK
//TextLCD lcd(p15, p16, p17, p18, p19, p20); // RS, E, D4-D7, LCDType=LCD16x2, BL=NC, E2=NC, LCDTCtrl=HD44780
//TextLCD_SPI lcd(&spi_lcd, p8, TextLCD::LCD40x4); // SPI bus, 74595 expander, CS pin, LCD Type
TextLCD_I2C lcd(&i2c_lcd, 0x42, TextLCD::LCD20x4); // I2C bus, PCF8574 Slaveaddress, LCD Type
//TextLCD_I2C lcd(&i2c_lcd, 0x42, TextLCD::LCD16x2, TextLCD::WS0010); // I2C bus, PCF8574 Slaveaddress, LCD Type, Device Type
//TextLCD_SPI_N lcd(&spi_lcd, p8, p9); // SPI bus, CS pin, RS pin, LCDType=LCD16x2, BL=NC, LCDTCtrl=ST7032_3V3
//TextLCD_I2C_N lcd(&i2c_lcd, ST7032_SA, TextLCD::LCD16x2, NC, TextLCD::ST7032_3V3); // I2C bus, Slaveaddress, LCD Type, BL=NC, LCDTCtrl=ST7032_3V3
int main() {
pc.printf("LCD Test. Columns=%d, Rows=%d\n\r", lcd.columns(), lcd.rows());
for (int row=0; row<lcd.rows(); row++) {
int col=0;
pc.printf("MemAddr(Col=%d, Row=%d)=0x%02X\n\r", col, row, lcd.getAddress(col, row));
// lcd.putc('-');
lcd.putc('0' + row);
for (col=1; col<lcd.columns()-1; col++) {
lcd.putc('*');
}
pc.printf("MemAddr(Col=%d, Row=%d)=0x%02X\n\r", col, row, lcd.getAddress(col, row));
lcd.putc('+');
}
// Show cursor as blinking character
lcd.setCursor(TextLCD::CurOff_BlkOn);
// Set and show user defined characters. A maximum of 8 UDCs are supported by the HD44780.
// They are defined by a 5x7 bitpattern.
lcd.setUDC(0, (char *) udc_0); // Show |>
lcd.putc(0);
lcd.setUDC(1, (char *) udc_1); // Show <|
lcd.putc(1);
}
Handbook page
More info is here
Diff: TextLCD_Config.h
- Revision:
- 41:111ca62e8a59
- Parent:
- 40:d3496c3ea301
--- a/TextLCD_Config.h Wed May 20 18:46:51 2015 +0000 +++ b/TextLCD_Config.h Fri Nov 06 18:59:27 2015 +0000 @@ -8,6 +8,8 @@ * 2015, v06: WH, Performance improvement I2C portexpander * 2015, v07: WH, Fixed Adafruit I2C/SPI portexpander pinmappings, fixed SYDZ Backlight * 2015, v08: WH, Added defines to reduce memory footprint (eg LCD_ICON), added some I2C portexpander defines + * 2015, v09: WH, Added defines to reduce memory footprint (LCD_TWO_CTRL, LCD_CONTRAST, LCD_UTF8_FONT), + * Added UTF8_2_LCD decode for Cyrilic font (By Andriy Ribalko). Added setFont() * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal @@ -50,9 +52,16 @@ #define LCD_INVERT 1 /* Enable display Invert implementation -0.5K codesize*/ #define LCD_POWER 1 /* Enable Power control implementation -0.1K codesize*/ #define LCD_BLINK 1 /* Enable UDC and Icon Blink control implementation -0.8K codesize*/ +#define LCD_CONTRAST 1 /* Enable Contrast control implementation -0.9K codesize*/ +#define LCD_TWO_CTRL 1 /* Enable LCD40x4 (two controller) implementation -0.1K codesize*/ +#define LCD_FONTSEL 0 /* Enable runtime font select implementation using setFont -0.9K codesize*/ -//Select option to activate default fonttable or alternatively use conversion for specific controller versions (eg PCF2116C, PCF2119R) -#define LCD_DEF_FONT 1 +//Select option to activate default fonttable or alternatively use conversion for specific controller versions (eg PCF2116C, PCF2119R, SSD1803, US2066) +#define LCD_DEF_FONT 1 //Default HD44780 font +//#define LCD_C_FONT 1 //PCF21xxC font +//#define LCD_R_FONT 1 //PCF21xxR font +//#define LCD_UTF8_FONT 1 /* Enable UTF8 Support (eg Cyrillic tables) -0.4K codesize*/ +//#define LCD_UTF8_CYR_B 1 /* Select specific UTF8 Cyrillic table (SSD1803 ROM_B) */ //Pin Defines for I2C PCF8574/PCF8574A or MCP23008 and SPI 74595 bus expander interfaces //Different commercially available LCD portexpanders use different wiring conventions. @@ -510,6 +519,12 @@ #define AC780_SA2 0x7C #define AC780_SA3 0x7E +/* SPLC792A is clone of ST7032i */ +#define SPLC792A_SA0 0x78 +#define SPLC792A_SA1 0x7A +#define SPLC792A_SA2 0x7C +#define SPLC792A_SA3 0x7E + //Some native I2C controllers dont support ACK. Set define to '0' to allow code to proceed even without ACK //#define LCD_I2C_ACK 0 #define LCD_I2C_ACK 1 @@ -520,8 +535,16 @@ #define LCD_DEF_CONTRAST 0x20 //ST7032 EastRising ERC1602FS-4 display -//Contrast setting 6 significant bits -//Voltage Multiplier setting 3 significant bits +//Contrast setting 6 significant bits (0..63) +//Voltage Multiplier setting 3 significant bits: +// 0: 1.818V +// 1: 2.222V +// 2: 2.667V +// 3: 3.333V +// 4: 3.636V (ST7032 default) +// 5: 4.000V +// 6: 4.444V +// 7: 5.000V #define LCD_ST7032_CONTRAST 0x28 #define LCD_ST7032_RAB 0x04 @@ -552,5 +575,18 @@ //Contrast setting 2 significant bits, use 6 for compatibility #define LCD_PT63_CONTRAST 0x3F +//SPLC792A is clone of ST7032i +//Contrast setting 6 significant bits (0..63) +//Voltage Multiplier setting 3 significant bits: +// 0: 1.818V +// 1: 2.222V +// 2: 2.667V +// 3: 3.333V (SPLC792A default) +// 4: 3.636V +// 5: 4.000V +// 6: 4.444V +// 7: 5.000V +#define LCD_SPLC792A_CONTRAST 0x28 +#define LCD_SPLC792A_RAB 0x04 #endif //MBED_TEXTLCDCONFIG_H \ No newline at end of file
HD44780 and compatible Text LCD controllers (4bit, I2C or SPI I/F)