Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
NewTextLCD.cpp@0:9cf1d79ebe04, 2011-09-08 (annotated)
- Committer:
- geiineuville
- Date:
- Thu Sep 08 08:57:21 2011 +0000
- Revision:
- 0:9cf1d79ebe04
v0 v1 v2 \"v3\"
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
geiineuville | 0:9cf1d79ebe04 | 1 | /* mbed TextLCD Library, for a 4-bit LCD based on HD44780 |
geiineuville | 0:9cf1d79ebe04 | 2 | * Copyright (c) 2007-2010, sford, http://mbed.org |
geiineuville | 0:9cf1d79ebe04 | 3 | * Changes by Erik Kerger |
geiineuville | 0:9cf1d79ebe04 | 4 | * |
geiineuville | 0:9cf1d79ebe04 | 5 | * |
geiineuville | 0:9cf1d79ebe04 | 6 | * Permission is hereby granted, free of charge, to any person obtaining a copy |
geiineuville | 0:9cf1d79ebe04 | 7 | * of this software and associated documentation files (the "Software"), to deal |
geiineuville | 0:9cf1d79ebe04 | 8 | * in the Software without restriction, including without limitation the rights |
geiineuville | 0:9cf1d79ebe04 | 9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
geiineuville | 0:9cf1d79ebe04 | 10 | * copies of the Software, and to permit persons to whom the Software is |
geiineuville | 0:9cf1d79ebe04 | 11 | * furnished to do so, subject to the following conditions: |
geiineuville | 0:9cf1d79ebe04 | 12 | * |
geiineuville | 0:9cf1d79ebe04 | 13 | * The above copyright notice and this permission notice shall be included in |
geiineuville | 0:9cf1d79ebe04 | 14 | * all copies or substantial portions of the Software. |
geiineuville | 0:9cf1d79ebe04 | 15 | * |
geiineuville | 0:9cf1d79ebe04 | 16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
geiineuville | 0:9cf1d79ebe04 | 17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
geiineuville | 0:9cf1d79ebe04 | 18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
geiineuville | 0:9cf1d79ebe04 | 19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
geiineuville | 0:9cf1d79ebe04 | 20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
geiineuville | 0:9cf1d79ebe04 | 21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
geiineuville | 0:9cf1d79ebe04 | 22 | * THE SOFTWARE. |
geiineuville | 0:9cf1d79ebe04 | 23 | */ |
geiineuville | 0:9cf1d79ebe04 | 24 | |
geiineuville | 0:9cf1d79ebe04 | 25 | #include "NewTextLCD.h" |
geiineuville | 0:9cf1d79ebe04 | 26 | #include "mbed.h" |
geiineuville | 0:9cf1d79ebe04 | 27 | |
geiineuville | 0:9cf1d79ebe04 | 28 | TextLCD::TextLCD(PinName rs, PinName rw, PinName e, PinName d4, PinName d5, |
geiineuville | 0:9cf1d79ebe04 | 29 | PinName d6, PinName d7, LCDType type) : _rs(rs), _rw(rw), _e(e), |
geiineuville | 0:9cf1d79ebe04 | 30 | _d(d4, d5, d6, d7), _type(type) { |
geiineuville | 0:9cf1d79ebe04 | 31 | _rs = 0; // command mode |
geiineuville | 0:9cf1d79ebe04 | 32 | _rw = 0; // r/w in defined state |
geiineuville | 0:9cf1d79ebe04 | 33 | _e = 0; // 0 --> inactive (most important change to original TextLCD) |
geiineuville | 0:9cf1d79ebe04 | 34 | |
geiineuville | 0:9cf1d79ebe04 | 35 | if (_type != LCDuser) |
geiineuville | 0:9cf1d79ebe04 | 36 | setLCDparam(_type); // otherwise rows, colums, comdelay, adresses must be set before |
geiineuville | 0:9cf1d79ebe04 | 37 | |
geiineuville | 0:9cf1d79ebe04 | 38 | wait(0.050f); // Wait 50ms to ensure powered up |
geiineuville | 0:9cf1d79ebe04 | 39 | |
geiineuville | 0:9cf1d79ebe04 | 40 | // send "Display Settings" 3 times (Only top nibble of 0x30 as we've got 4-bit bus) |
geiineuville | 0:9cf1d79ebe04 | 41 | // this sets controler into 8 bit mode, so we have a defined state |
geiineuville | 0:9cf1d79ebe04 | 42 | for (int i=0; i<3; i++) { |
geiineuville | 0:9cf1d79ebe04 | 43 | _e = 1; |
geiineuville | 0:9cf1d79ebe04 | 44 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 45 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 46 | _d = 0x3; |
geiineuville | 0:9cf1d79ebe04 | 47 | __nop(); // data setup time at least 60 ns |
geiineuville | 0:9cf1d79ebe04 | 48 | _e = 0; |
geiineuville | 0:9cf1d79ebe04 | 49 | wait(0.005f); // 5ms |
geiineuville | 0:9cf1d79ebe04 | 50 | } |
geiineuville | 0:9cf1d79ebe04 | 51 | _e = 1; |
geiineuville | 0:9cf1d79ebe04 | 52 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 53 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 54 | _d = 0x2; // 4 Bit mode (after this command, we have to send 2 nibbles) |
geiineuville | 0:9cf1d79ebe04 | 55 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 56 | _e = 0; |
geiineuville | 0:9cf1d79ebe04 | 57 | wait_us(LCDparam.delay); |
geiineuville | 0:9cf1d79ebe04 | 58 | |
geiineuville | 0:9cf1d79ebe04 | 59 | writeCommand(0x28); // Function set 4 Bit, 2Line, 5*7 |
geiineuville | 0:9cf1d79ebe04 | 60 | writeCommand(0x08); // Display off |
geiineuville | 0:9cf1d79ebe04 | 61 | cls(); // clear display, reset _column and _row |
geiineuville | 0:9cf1d79ebe04 | 62 | writeCommand(0x04); // cursor right, Display is not shifted |
geiineuville | 0:9cf1d79ebe04 | 63 | writeCommand(0x0C); // Display on , Cursor off |
geiineuville | 0:9cf1d79ebe04 | 64 | } |
geiineuville | 0:9cf1d79ebe04 | 65 | |
geiineuville | 0:9cf1d79ebe04 | 66 | void TextLCD::character(int column, int row, int c) { |
geiineuville | 0:9cf1d79ebe04 | 67 | int a = 0x80 | (LCDparam.adresses[row & 3] + column); |
geiineuville | 0:9cf1d79ebe04 | 68 | writeCommand(a); // set cursor address |
geiineuville | 0:9cf1d79ebe04 | 69 | writeData(c); // write char |
geiineuville | 0:9cf1d79ebe04 | 70 | } |
geiineuville | 0:9cf1d79ebe04 | 71 | |
geiineuville | 0:9cf1d79ebe04 | 72 | void TextLCD::cls() { |
geiineuville | 0:9cf1d79ebe04 | 73 | writeCommand(0x01); // cls, and set cursor to 0 |
geiineuville | 0:9cf1d79ebe04 | 74 | locate(0, 0); // set internal position |
geiineuville | 0:9cf1d79ebe04 | 75 | wait_us(45 * LCDparam.delay); // CLS need much time |
geiineuville | 0:9cf1d79ebe04 | 76 | } |
geiineuville | 0:9cf1d79ebe04 | 77 | |
geiineuville | 0:9cf1d79ebe04 | 78 | void TextLCD::locate(int column, int row) { |
geiineuville | 0:9cf1d79ebe04 | 79 | _column = column; // set position for next char |
geiineuville | 0:9cf1d79ebe04 | 80 | _row = row; // note: cursor is not set yet |
geiineuville | 0:9cf1d79ebe04 | 81 | } |
geiineuville | 0:9cf1d79ebe04 | 82 | |
geiineuville | 0:9cf1d79ebe04 | 83 | |
geiineuville | 0:9cf1d79ebe04 | 84 | |
geiineuville | 0:9cf1d79ebe04 | 85 | int TextLCD::_putc(int value) { |
geiineuville | 0:9cf1d79ebe04 | 86 | if (value == '\n') { |
geiineuville | 0:9cf1d79ebe04 | 87 | _column = 0; |
geiineuville | 0:9cf1d79ebe04 | 88 | _row++; |
geiineuville | 0:9cf1d79ebe04 | 89 | if (_row >= LCDparam.rows) { |
geiineuville | 0:9cf1d79ebe04 | 90 | _row = 0; |
geiineuville | 0:9cf1d79ebe04 | 91 | } |
geiineuville | 0:9cf1d79ebe04 | 92 | } else { |
geiineuville | 0:9cf1d79ebe04 | 93 | character(_column, _row, value); |
geiineuville | 0:9cf1d79ebe04 | 94 | _column++; |
geiineuville | 0:9cf1d79ebe04 | 95 | if (_column >= LCDparam.columns) { |
geiineuville | 0:9cf1d79ebe04 | 96 | _column = 0; |
geiineuville | 0:9cf1d79ebe04 | 97 | _row++; |
geiineuville | 0:9cf1d79ebe04 | 98 | if (_row >= LCDparam.rows) { |
geiineuville | 0:9cf1d79ebe04 | 99 | _row = 0; |
geiineuville | 0:9cf1d79ebe04 | 100 | } |
geiineuville | 0:9cf1d79ebe04 | 101 | } |
geiineuville | 0:9cf1d79ebe04 | 102 | } |
geiineuville | 0:9cf1d79ebe04 | 103 | return value; |
geiineuville | 0:9cf1d79ebe04 | 104 | } |
geiineuville | 0:9cf1d79ebe04 | 105 | |
geiineuville | 0:9cf1d79ebe04 | 106 | // Dummy function - read not supported |
geiineuville | 0:9cf1d79ebe04 | 107 | int TextLCD::_getc() { |
geiineuville | 0:9cf1d79ebe04 | 108 | return -1; |
geiineuville | 0:9cf1d79ebe04 | 109 | } |
geiineuville | 0:9cf1d79ebe04 | 110 | |
geiineuville | 0:9cf1d79ebe04 | 111 | void TextLCD::writeByte(int value) { |
geiineuville | 0:9cf1d79ebe04 | 112 | _e = 1; |
geiineuville | 0:9cf1d79ebe04 | 113 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 114 | _d = value >> 4; // higher nibble first |
geiineuville | 0:9cf1d79ebe04 | 115 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 116 | _e = 0; |
geiineuville | 0:9cf1d79ebe04 | 117 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 118 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 119 | _e = 1; |
geiineuville | 0:9cf1d79ebe04 | 120 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 121 | _d = value >> 0; // then lower |
geiineuville | 0:9cf1d79ebe04 | 122 | __nop(); |
geiineuville | 0:9cf1d79ebe04 | 123 | _e = 0; |
geiineuville | 0:9cf1d79ebe04 | 124 | } |
geiineuville | 0:9cf1d79ebe04 | 125 | |
geiineuville | 0:9cf1d79ebe04 | 126 | void TextLCD::writeCommand(int command) { |
geiineuville | 0:9cf1d79ebe04 | 127 | _rs = 0; |
geiineuville | 0:9cf1d79ebe04 | 128 | writeByte(command); |
geiineuville | 0:9cf1d79ebe04 | 129 | wait_us(LCDparam.delay); |
geiineuville | 0:9cf1d79ebe04 | 130 | } |
geiineuville | 0:9cf1d79ebe04 | 131 | |
geiineuville | 0:9cf1d79ebe04 | 132 | |
geiineuville | 0:9cf1d79ebe04 | 133 | void TextLCD::writeData(int data) { |
geiineuville | 0:9cf1d79ebe04 | 134 | _rs = 1; |
geiineuville | 0:9cf1d79ebe04 | 135 | writeByte(data); |
geiineuville | 0:9cf1d79ebe04 | 136 | wait_us(LCDparam.delay); |
geiineuville | 0:9cf1d79ebe04 | 137 | } |
geiineuville | 0:9cf1d79ebe04 | 138 | |
geiineuville | 0:9cf1d79ebe04 | 139 | |
geiineuville | 0:9cf1d79ebe04 | 140 | // set user defined char |
geiineuville | 0:9cf1d79ebe04 | 141 | void TextLCD::writeCGRAM(int address, int pattern[8]){ |
geiineuville | 0:9cf1d79ebe04 | 142 | int i; |
geiineuville | 0:9cf1d79ebe04 | 143 | address = address & 7; //max 8 char |
geiineuville | 0:9cf1d79ebe04 | 144 | for(i=0;i<8;i++){ |
geiineuville | 0:9cf1d79ebe04 | 145 | writeCommand(0x40 | (address * 8) + i); |
geiineuville | 0:9cf1d79ebe04 | 146 | writeData(pattern[i]); |
geiineuville | 0:9cf1d79ebe04 | 147 | } |
geiineuville | 0:9cf1d79ebe04 | 148 | } |
geiineuville | 0:9cf1d79ebe04 | 149 | |
geiineuville | 0:9cf1d79ebe04 | 150 | void TextLCD::setLCDparam(LCDType _type){ |
geiineuville | 0:9cf1d79ebe04 | 151 | switch (_type) { |
geiineuville | 0:9cf1d79ebe04 | 152 | |
geiineuville | 0:9cf1d79ebe04 | 153 | case LCD16x2: |
geiineuville | 0:9cf1d79ebe04 | 154 | case LCD16x2B: |
geiineuville | 0:9cf1d79ebe04 | 155 | LCDparam.columns = 16; |
geiineuville | 0:9cf1d79ebe04 | 156 | break; |
geiineuville | 0:9cf1d79ebe04 | 157 | case LCD20x2: |
geiineuville | 0:9cf1d79ebe04 | 158 | case LCD20x4: |
geiineuville | 0:9cf1d79ebe04 | 159 | LCDparam.columns = 20; |
geiineuville | 0:9cf1d79ebe04 | 160 | break; |
geiineuville | 0:9cf1d79ebe04 | 161 | case LCD24x2: |
geiineuville | 0:9cf1d79ebe04 | 162 | LCDparam.columns = 24; |
geiineuville | 0:9cf1d79ebe04 | 163 | break; |
geiineuville | 0:9cf1d79ebe04 | 164 | } |
geiineuville | 0:9cf1d79ebe04 | 165 | if (_type == LCD20x4) |
geiineuville | 0:9cf1d79ebe04 | 166 | LCDparam.rows = 4; |
geiineuville | 0:9cf1d79ebe04 | 167 | else |
geiineuville | 0:9cf1d79ebe04 | 168 | LCDparam.rows = 2; |
geiineuville | 0:9cf1d79ebe04 | 169 | |
geiineuville | 0:9cf1d79ebe04 | 170 | LCDparam.adresses[0] = 0; |
geiineuville | 0:9cf1d79ebe04 | 171 | |
geiineuville | 0:9cf1d79ebe04 | 172 | if (_type == LCD16x2B) |
geiineuville | 0:9cf1d79ebe04 | 173 | LCDparam.adresses[1] = 40; |
geiineuville | 0:9cf1d79ebe04 | 174 | else |
geiineuville | 0:9cf1d79ebe04 | 175 | LCDparam.adresses[1] = 0x40; |
geiineuville | 0:9cf1d79ebe04 | 176 | |
geiineuville | 0:9cf1d79ebe04 | 177 | if (_type == LCD20x4) { |
geiineuville | 0:9cf1d79ebe04 | 178 | LCDparam.adresses[2] = 0x14; |
geiineuville | 0:9cf1d79ebe04 | 179 | LCDparam.adresses[3] = 0x54;} |
geiineuville | 0:9cf1d79ebe04 | 180 | else { |
geiineuville | 0:9cf1d79ebe04 | 181 | LCDparam.adresses[2] = 0; |
geiineuville | 0:9cf1d79ebe04 | 182 | LCDparam.adresses[3] = 0;} |
geiineuville | 0:9cf1d79ebe04 | 183 | |
geiineuville | 0:9cf1d79ebe04 | 184 | LCDparam.delay = 50; // 50 us delays as default |
geiineuville | 0:9cf1d79ebe04 | 185 | } |
geiineuville | 0:9cf1d79ebe04 | 186 |