han back / Mbed OS CLEO_UART_ACCEL

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.

TextLCD/TextLCD.cpp@0:f96b9b35ac4c, 2017-09-28 (annotated)

Committer:
SMART_CLEO
Date:
Thu Sep 28 03:29:42 2017 +0000
Revision:
0:f96b9b35ac4c
SMART_CLEO

Who changed what in which revision?

UserRevisionLine numberNew contents of line
SMART_CLEO 0:f96b9b35ac4c 1 /* mbed TextLCD Library, for a 4-bit LCD based on HD44780
SMART_CLEO 0:f96b9b35ac4c 2 * Copyright (c) 2007-2010, sford
SMART_CLEO 0:f96b9b35ac4c 3 *
SMART_CLEO 0:f96b9b35ac4c 4 * Permission is hereby granted, free of charge, to any person obtaining a copy
SMART_CLEO 0:f96b9b35ac4c 5 * of this software and associated documentation files (the "Software"), to deal
SMART_CLEO 0:f96b9b35ac4c 6 * in the Software without restriction, including without limitation the rights
SMART_CLEO 0:f96b9b35ac4c 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
SMART_CLEO 0:f96b9b35ac4c 8 * copies of the Software, and to permit persons to whom the Software is
SMART_CLEO 0:f96b9b35ac4c 9 * furnished to do so, subject to the following conditions:
SMART_CLEO 0:f96b9b35ac4c 10 *
SMART_CLEO 0:f96b9b35ac4c 11 * The above copyright notice and this permission notice shall be included in
SMART_CLEO 0:f96b9b35ac4c 12 * all copies or substantial portions of the Software.
SMART_CLEO 0:f96b9b35ac4c 13 *
SMART_CLEO 0:f96b9b35ac4c 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
SMART_CLEO 0:f96b9b35ac4c 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
SMART_CLEO 0:f96b9b35ac4c 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
SMART_CLEO 0:f96b9b35ac4c 17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
SMART_CLEO 0:f96b9b35ac4c 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
SMART_CLEO 0:f96b9b35ac4c 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
SMART_CLEO 0:f96b9b35ac4c 20 * THE SOFTWARE.
SMART_CLEO 0:f96b9b35ac4c 21 */
SMART_CLEO 0:f96b9b35ac4c 22
SMART_CLEO 0:f96b9b35ac4c 23 #include "TextLCD.h"
SMART_CLEO 0:f96b9b35ac4c 24 #include "mbed.h"
SMART_CLEO 0:f96b9b35ac4c 25
SMART_CLEO 0:f96b9b35ac4c 26 TextLCD::TextLCD(PinName rs, PinName rw, PinName e, PinName d0, PinName d1,
SMART_CLEO 0:f96b9b35ac4c 27 PinName d2, PinName d3, LCDType type) : _rs(rs), _rw(rw),
SMART_CLEO 0:f96b9b35ac4c 28 _e(e), _d(d0, d1, d2, d3),
SMART_CLEO 0:f96b9b35ac4c 29 _type(type) {
SMART_CLEO 0:f96b9b35ac4c 30
SMART_CLEO 0:f96b9b35ac4c 31 _rw = 0;
SMART_CLEO 0:f96b9b35ac4c 32 _e = 1;
SMART_CLEO 0:f96b9b35ac4c 33 _rs = 0; // command mode
SMART_CLEO 0:f96b9b35ac4c 34 _d.output();
SMART_CLEO 0:f96b9b35ac4c 35
SMART_CLEO 0:f96b9b35ac4c 36 wait(0.015); // Wait 15ms to ensure powered up
SMART_CLEO 0:f96b9b35ac4c 37
SMART_CLEO 0:f96b9b35ac4c 38 // send "Display Settings" 3 times (Only top nibble of 0x30 as we've got 4-bit bus)
SMART_CLEO 0:f96b9b35ac4c 39 for (int i=0; i<3; i++) {
SMART_CLEO 0:f96b9b35ac4c 40 writeByte(0x3);
SMART_CLEO 0:f96b9b35ac4c 41 wait(0.00164); // this command takes 1.64ms, so wait for it
SMART_CLEO 0:f96b9b35ac4c 42 }
SMART_CLEO 0:f96b9b35ac4c 43 writeByte(0x2); // 4-bit mode
SMART_CLEO 0:f96b9b35ac4c 44 wait(0.000040f); // most instructions take 40us
SMART_CLEO 0:f96b9b35ac4c 45
SMART_CLEO 0:f96b9b35ac4c 46 writeCommand(0x28); // Function set 001 BW N F - -
SMART_CLEO 0:f96b9b35ac4c 47 writeCommand(0x0C);
SMART_CLEO 0:f96b9b35ac4c 48 writeCommand(0x6); // Cursor Direction and Display Shift : 0000 01 CD S (CD 0-left, 1-right S(hift) 0-no, 1-yes
SMART_CLEO 0:f96b9b35ac4c 49 cls();
SMART_CLEO 0:f96b9b35ac4c 50 }
SMART_CLEO 0:f96b9b35ac4c 51
SMART_CLEO 0:f96b9b35ac4c 52 void TextLCD::character(int column, int row, int c) {
SMART_CLEO 0:f96b9b35ac4c 53 int a = address(column, row);
SMART_CLEO 0:f96b9b35ac4c 54 writeCommand(a);
SMART_CLEO 0:f96b9b35ac4c 55 writeData(c);
SMART_CLEO 0:f96b9b35ac4c 56 }
SMART_CLEO 0:f96b9b35ac4c 57
SMART_CLEO 0:f96b9b35ac4c 58 void TextLCD::cls() {
SMART_CLEO 0:f96b9b35ac4c 59 writeCommand(0x01); // cls, and set cursor to 0
SMART_CLEO 0:f96b9b35ac4c 60 wait(0.00164f); // This command takes 1.64 ms
SMART_CLEO 0:f96b9b35ac4c 61 locate(0, 0);
SMART_CLEO 0:f96b9b35ac4c 62 }
SMART_CLEO 0:f96b9b35ac4c 63
SMART_CLEO 0:f96b9b35ac4c 64 void TextLCD::locate(int column, int row) {
SMART_CLEO 0:f96b9b35ac4c 65 _column = column;
SMART_CLEO 0:f96b9b35ac4c 66 _row = row;
SMART_CLEO 0:f96b9b35ac4c 67 }
SMART_CLEO 0:f96b9b35ac4c 68
SMART_CLEO 0:f96b9b35ac4c 69 int TextLCD::_putc(int value) {
SMART_CLEO 0:f96b9b35ac4c 70 if (value == '\n') {
SMART_CLEO 0:f96b9b35ac4c 71 _column = 0;
SMART_CLEO 0:f96b9b35ac4c 72 _row++;
SMART_CLEO 0:f96b9b35ac4c 73 if (_row >= rows()) {
SMART_CLEO 0:f96b9b35ac4c 74 _row = 0;
SMART_CLEO 0:f96b9b35ac4c 75 }
SMART_CLEO 0:f96b9b35ac4c 76 } else {
SMART_CLEO 0:f96b9b35ac4c 77 character(_column, _row, value);
SMART_CLEO 0:f96b9b35ac4c 78 _column++;
SMART_CLEO 0:f96b9b35ac4c 79 if (_column >= columns()) {
SMART_CLEO 0:f96b9b35ac4c 80 _column = 0;
SMART_CLEO 0:f96b9b35ac4c 81 _row++;
SMART_CLEO 0:f96b9b35ac4c 82 if (_row >= rows()) {
SMART_CLEO 0:f96b9b35ac4c 83 _row = 0;
SMART_CLEO 0:f96b9b35ac4c 84 }
SMART_CLEO 0:f96b9b35ac4c 85 }
SMART_CLEO 0:f96b9b35ac4c 86 }
SMART_CLEO 0:f96b9b35ac4c 87 return value;
SMART_CLEO 0:f96b9b35ac4c 88 }
SMART_CLEO 0:f96b9b35ac4c 89
SMART_CLEO 0:f96b9b35ac4c 90 int TextLCD::_getc() {
SMART_CLEO 0:f96b9b35ac4c 91 return -1;
SMART_CLEO 0:f96b9b35ac4c 92 }
SMART_CLEO 0:f96b9b35ac4c 93
SMART_CLEO 0:f96b9b35ac4c 94 void TextLCD::writeByte(int value) {
SMART_CLEO 0:f96b9b35ac4c 95 _rw = 0;
SMART_CLEO 0:f96b9b35ac4c 96
SMART_CLEO 0:f96b9b35ac4c 97 _d = value >> 4;
SMART_CLEO 0:f96b9b35ac4c 98 wait(0.000040f); // most instructions take 40us
SMART_CLEO 0:f96b9b35ac4c 99 _e = 0;
SMART_CLEO 0:f96b9b35ac4c 100 wait(0.000040f);
SMART_CLEO 0:f96b9b35ac4c 101 _e = 1;
SMART_CLEO 0:f96b9b35ac4c 102 _d = value >> 0;
SMART_CLEO 0:f96b9b35ac4c 103 wait(0.000040f);
SMART_CLEO 0:f96b9b35ac4c 104 _e = 0;
SMART_CLEO 0:f96b9b35ac4c 105 wait(0.000040f); // most instructions take 40us
SMART_CLEO 0:f96b9b35ac4c 106 _e = 1;
SMART_CLEO 0:f96b9b35ac4c 107 }
SMART_CLEO 0:f96b9b35ac4c 108
SMART_CLEO 0:f96b9b35ac4c 109 void TextLCD::writeCommand(int command) {
SMART_CLEO 0:f96b9b35ac4c 110 _rs = 0;
SMART_CLEO 0:f96b9b35ac4c 111 writeByte(command);
SMART_CLEO 0:f96b9b35ac4c 112 }
SMART_CLEO 0:f96b9b35ac4c 113
SMART_CLEO 0:f96b9b35ac4c 114 void TextLCD::writeData(int data) {
SMART_CLEO 0:f96b9b35ac4c 115 _rs = 1;
SMART_CLEO 0:f96b9b35ac4c 116 writeByte(data);
SMART_CLEO 0:f96b9b35ac4c 117 }
SMART_CLEO 0:f96b9b35ac4c 118
SMART_CLEO 0:f96b9b35ac4c 119 int TextLCD::address(int column, int row) {
SMART_CLEO 0:f96b9b35ac4c 120 switch (_type) {
SMART_CLEO 0:f96b9b35ac4c 121 case LCD20x4:
SMART_CLEO 0:f96b9b35ac4c 122 switch (row) {
SMART_CLEO 0:f96b9b35ac4c 123 case 0:
SMART_CLEO 0:f96b9b35ac4c 124 return 0x80 + column;
SMART_CLEO 0:f96b9b35ac4c 125 case 1:
SMART_CLEO 0:f96b9b35ac4c 126 return 0xc0 + column;
SMART_CLEO 0:f96b9b35ac4c 127 case 2:
SMART_CLEO 0:f96b9b35ac4c 128 return 0x94 + column;
SMART_CLEO 0:f96b9b35ac4c 129 case 3:
SMART_CLEO 0:f96b9b35ac4c 130 return 0xd4 + column;
SMART_CLEO 0:f96b9b35ac4c 131 }
SMART_CLEO 0:f96b9b35ac4c 132 case LCD16x2B:
SMART_CLEO 0:f96b9b35ac4c 133 return 0x80 + (row * 40) + column;
SMART_CLEO 0:f96b9b35ac4c 134 case LCD16x2:
SMART_CLEO 0:f96b9b35ac4c 135 case LCD20x2:
SMART_CLEO 0:f96b9b35ac4c 136 default:
SMART_CLEO 0:f96b9b35ac4c 137 return 0x80 + (row * 0x40) + column;
SMART_CLEO 0:f96b9b35ac4c 138 }
SMART_CLEO 0:f96b9b35ac4c 139 }
SMART_CLEO 0:f96b9b35ac4c 140
SMART_CLEO 0:f96b9b35ac4c 141 int TextLCD::columns() {
SMART_CLEO 0:f96b9b35ac4c 142 switch (_type) {
SMART_CLEO 0:f96b9b35ac4c 143 case LCD20x4:
SMART_CLEO 0:f96b9b35ac4c 144 case LCD20x2:
SMART_CLEO 0:f96b9b35ac4c 145 return 20;
SMART_CLEO 0:f96b9b35ac4c 146 case LCD16x2:
SMART_CLEO 0:f96b9b35ac4c 147 case LCD16x2B:
SMART_CLEO 0:f96b9b35ac4c 148 default:
SMART_CLEO 0:f96b9b35ac4c 149 return 16;
SMART_CLEO 0:f96b9b35ac4c 150 }
SMART_CLEO 0:f96b9b35ac4c 151 }
SMART_CLEO 0:f96b9b35ac4c 152
SMART_CLEO 0:f96b9b35ac4c 153 int TextLCD::rows() {
SMART_CLEO 0:f96b9b35ac4c 154 switch (_type) {
SMART_CLEO 0:f96b9b35ac4c 155 case LCD20x4:
SMART_CLEO 0:f96b9b35ac4c 156 return 4;
SMART_CLEO 0:f96b9b35ac4c 157 case LCD16x2:
SMART_CLEO 0:f96b9b35ac4c 158 case LCD16x2B:
SMART_CLEO 0:f96b9b35ac4c 159 case LCD20x2:
SMART_CLEO 0:f96b9b35ac4c 160 default:
SMART_CLEO 0:f96b9b35ac4c 161 return 2;
SMART_CLEO 0:f96b9b35ac4c 162 }
SMART_CLEO 0:f96b9b35ac4c 163 }