Change config file suit LCD used
Fork of TextLCD by
TextLCD.cpp
- Committer:
- wim
- Date:
- 2013-02-04
- Revision:
- 10:dd9b3a696acd
- Parent:
- 9:0893d986e717
- Child:
- 11:9ec02df863a1
File content as of revision 10:dd9b3a696acd:
/* mbed TextLCD Library, for a 4-bit LCD based on HD44780 * Copyright (c) 2007-2010, sford, http://mbed.org * 2013, WH, Updated LCD types and fixed lcd address issues * * 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 "TextLCD.h" #include "mbed.h" TextLCD::TextLCD(PinName rs, PinName e, PinName d4, PinName d5, PinName d6, PinName d7, LCDType type) : _rs(rs), _e(e), _d(d4, d5, d6, d7), _type(type) { _e = 1; _rs = 0; // command mode wait(0.015); // Wait 15ms to ensure powered up // send "Display Settings" 3 times (Only top nibble of 0x30 as we've got 4-bit bus) for (int i=0; i<3; i++) { writeByte(0x3); wait(0.00164); // this command takes 1.64ms, so wait for it } writeByte(0x2); // 4-bit mode wait(0.000040f); // most instructions take 40us // Display is now in 4-bit mode switch (_type) { case LCD8x1: writeCommand(0x20); // Function set 001 BW N F - - // N=0 (1 line) // F=0 (5x7 dots font) break; case LCD24x4: // Special mode for KS0078 writeCommand(0x2A); // Function set 001 BW N RE DH REV // N=1 (Dont care for KS0078) // RE=0 (Extended Regs, special mode for KS0078) // DH=1 (Disp shift, special mode for KS0078) // REV=0 (Reverse, special mode for KS0078) writeCommand(0x2E); // Function set 001 BW N RE DH REV // N=1 (Dont care for KS0078) // RE=1 (Ena Extended Regs, special mode for KS0078) // DH=1 (Disp shift, special mode for KS0078) // REV=0 (Reverse, special mode for KS0078) writeCommand(0x09); // Ext Function set 0000 1 FW BW NW // FW=0 (5-dot font, special mode for KS0078) // BW=0 (Cur BW invert disable, special mode for KS0078) // NW=1 (4 Line, special mode for KS0078) writeCommand(0x2A); // Function set 001 BW N RE DH REV // N=1 (Dont care for KS0078) // RE=0 (Dis. Extended Regs, special mode for KS0078) // DH=1 (Disp shift, special mode for KS0078) // REV=0 (Reverse, special mode for KS0078) break; default: writeCommand(0x28); // Function set 001 BW N F - - // N=1 (2 lines) // F=0 (5x7 dots font) break; } writeCommand(0x0C); // Display Ctrl 0000 1 D C B // Display On, Cursor Off, Blink Off _cursor = CurOff; writeCommand(0x06); // Entry Mode 0000 01 CD S // Cursor Direction and Display Shift // CD=1 (Cur incr) // S=0 (No display shift) cls(); } void TextLCD::character(int column, int row, int c) { int addr = getAddress(column, row); writeCommand(0x80 | addr); writeData(c); } void TextLCD::cls() { writeCommand(0x01); // cls, and set cursor to 0 wait(0.00164f); // This command takes 1.64 ms locate(0, 0); } void TextLCD::locate(int column, int row) { _column = column; _row = row; } int TextLCD::_putc(int value) { if (value == '\n') { _column = 0; _row++; if (_row >= rows()) { _row = 0; } } else { character(_column, _row, value); _column++; if (_column >= columns()) { _column = 0; _row++; if (_row >= rows()) { _row = 0; } } } return value; } int TextLCD::_getc() { return -1; } void TextLCD::writeByte(int value) { _d = value >> 4; wait(0.000040f); // most instructions take 40us _e = 0; wait(0.000040f); _e = 1; _d = value >> 0; wait(0.000040f); _e = 0; wait(0.000040f); // most instructions take 40us _e = 1; } void TextLCD::writeCommand(int command) { _rs = 0; writeByte(command); } void TextLCD::writeData(int data) { _rs = 1; writeByte(data); } #if (0) // This is the original method. // It is confusing since it returns the memoryaddress or-ed with the set memorycommand 0x80. // Left it in here for compatibility with older code. New applications should use getAddress() instead. // int TextLCD::address(int column, int row) { switch (_type) { case LCD20x4: switch (row) { case 0: return 0x80 + column; case 1: return 0xc0 + column; case 2: return 0x94 + column; case 3: return 0xd4 + column; } case LCD16x2B: return 0x80 + (row * 40) + column; case LCD16x2: case LCD20x2: default: return 0x80 + (row * 0x40) + column; } } #endif // This replaces the original method. // Left it in here for compatibility with older code. New applications should use getAddress() instead. int TextLCD::address(int column, int row) { return 0x80 | getAddress(column, row); } // This is new method to return the memory address based on row, column and displaytype. // int TextLCD::getAddress(int column, int row) { switch (_type) { case LCD8x1: return 0x00 + column; case LCD16x4: switch (row) { case 0: return 0x00 + column; case 1: return 0x40 + column; case 2: return 0x10 + column; case 3: return 0x50 + column; } case LCD20x4: switch (row) { case 0: return 0x00 + column; case 1: return 0x40 + column; case 2: return 0x14 + column; case 3: return 0x54 + column; } // Special mode for KS0078 case LCD24x4: switch (row) { case 0: return 0x00 + column; case 1: return 0x20 + column; case 2: return 0x40 + column; case 3: return 0x60 + column; } // Not sure about this one, seems wrong. case LCD16x2B: return 0x00 + (row * 40) + column; case LCD8x2: case LCD16x2: case LCD20x2: case LCD24x2: case LCD40x2: return 0x00 + (row * 0x40) + column; // Should never get here. default: return 0x00; } } // Added for consistency. Set row, colum and update memoryaddress. // void TextLCD::setAddress(int column, int row) { locate(column, row); int addr = getAddress(column, row); writeCommand(0x80 | addr); } int TextLCD::columns() { switch (_type) { case LCD8x1: case LCD8x2: return 8; case LCD16x2: case LCD16x2B: case LCD16x4: return 16; case LCD20x2: case LCD20x4: return 20; case LCD24x2: case LCD24x4: return 24; case LCD40x2: return 40; // Should never get here. default: return 0; } } int TextLCD::rows() { switch (_type) { case LCD8x1: return 1; case LCD8x2: case LCD16x2: case LCD16x2B: case LCD20x2: case LCD24x2: case LCD40x2: return 2; case LCD16x4: case LCD20x4: case LCD24x4: return 4; default: return 0; } } TextLCD::LCDCursor TextLCD::cursor(TextLCD::LCDCursor show) { LCDCursor cur = _cursor; switch (show) { case CurOn : writeCommand(0x0F); // Cursor on and Blink char wait_us(40); _cursor = show; break; case CurOff : writeCommand(0x0C); wait_us(40); _cursor = show; break; default : break; } return cur; }