Display text on LCD displays (even on multiple ones). Allow to create windows (frames) on display, and to combine them (split, add, duplicate, scroll). See http://mbed.org/users/hlipka/notebook/lcdwindow/ for more information.
ks0108_8bit.cpp@3:e5d5e2fe4bf6, 2010-11-28 (annotated)
- Committer:
- hlipka
- Date:
- Sun Nov 28 22:09:54 2010 +0000
- Revision:
- 3:e5d5e2fe4bf6
- Parent:
- 2:5ac5bab7daaf
- Child:
- 9:2fe93daa2106
Made LCD driver thread safe (to allow usage from timers)
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
hlipka | 0:ae5037e3d6e0 | 1 | /* |
hlipka | 0:ae5037e3d6e0 | 2 | * mbed LCDWindow library |
hlipka | 0:ae5037e3d6e0 | 3 | * Copyright (c) 2010 Hendrik Lipka |
hlipka | 0:ae5037e3d6e0 | 4 | * |
hlipka | 0:ae5037e3d6e0 | 5 | * Permission is hereby granted, free of charge, to any person obtaining a copy |
hlipka | 0:ae5037e3d6e0 | 6 | * of this software and associated documentation files (the "Software"), to deal |
hlipka | 0:ae5037e3d6e0 | 7 | * in the Software without restriction, including without limitation the rights |
hlipka | 0:ae5037e3d6e0 | 8 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
hlipka | 0:ae5037e3d6e0 | 9 | * copies of the Software, and to permit persons to whom the Software is |
hlipka | 0:ae5037e3d6e0 | 10 | * furnished to do so, subject to the following conditions: |
hlipka | 0:ae5037e3d6e0 | 11 | * |
hlipka | 0:ae5037e3d6e0 | 12 | * The above copyright notice and this permission notice shall be included in |
hlipka | 0:ae5037e3d6e0 | 13 | * all copies or substantial portions of the Software. |
hlipka | 0:ae5037e3d6e0 | 14 | * |
hlipka | 0:ae5037e3d6e0 | 15 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
hlipka | 0:ae5037e3d6e0 | 16 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
hlipka | 0:ae5037e3d6e0 | 17 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
hlipka | 0:ae5037e3d6e0 | 18 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
hlipka | 0:ae5037e3d6e0 | 19 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
hlipka | 0:ae5037e3d6e0 | 20 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
hlipka | 0:ae5037e3d6e0 | 21 | * THE SOFTWARE. |
hlipka | 0:ae5037e3d6e0 | 22 | */ |
hlipka | 0:ae5037e3d6e0 | 23 | |
hlipka | 0:ae5037e3d6e0 | 24 | #include "ks0108_8bit.h" |
hlipka | 0:ae5037e3d6e0 | 25 | |
hlipka | 0:ae5037e3d6e0 | 26 | #include "BusOut.h" |
hlipka | 0:ae5037e3d6e0 | 27 | #include "DigitalOut.h" |
hlipka | 0:ae5037e3d6e0 | 28 | #include "wait_api.h" |
hlipka | 0:ae5037e3d6e0 | 29 | #include "font.h" |
hlipka | 0:ae5037e3d6e0 | 30 | |
hlipka | 0:ae5037e3d6e0 | 31 | #define ENABLE 1 |
hlipka | 0:ae5037e3d6e0 | 32 | |
hlipka | 2:5ac5bab7daaf | 33 | void KS0108LCD8bit::writeText(const unsigned int column, const unsigned int row, const char text[]) { |
hlipka | 0:ae5037e3d6e0 | 34 | int i=0; |
hlipka | 0:ae5037e3d6e0 | 35 | while (text[i]!=0) { |
hlipka | 2:5ac5bab7daaf | 36 | character(column+i, row,text[i]); |
hlipka | 0:ae5037e3d6e0 | 37 | i++; |
hlipka | 0:ae5037e3d6e0 | 38 | } |
hlipka | 0:ae5037e3d6e0 | 39 | } |
hlipka | 0:ae5037e3d6e0 | 40 | |
hlipka | 0:ae5037e3d6e0 | 41 | void KS0108LCD8bit::clear() { |
hlipka | 3:e5d5e2fe4bf6 | 42 | _guard->take(); |
hlipka | 0:ae5037e3d6e0 | 43 | clearHalf(_left); |
hlipka | 0:ae5037e3d6e0 | 44 | if (NULL!=_right) |
hlipka | 0:ae5037e3d6e0 | 45 | clearHalf(_right); |
hlipka | 3:e5d5e2fe4bf6 | 46 | _guard->release(); |
hlipka | 0:ae5037e3d6e0 | 47 | } |
hlipka | 0:ae5037e3d6e0 | 48 | |
hlipka | 0:ae5037e3d6e0 | 49 | void KS0108LCD8bit::clearHalf(DigitalOut* cs) { |
hlipka | 0:ae5037e3d6e0 | 50 | for (int x=0;x<8;x++) |
hlipka | 0:ae5037e3d6e0 | 51 | { |
hlipka | 2:5ac5bab7daaf | 52 | sendCmd(0xb8|x,cs); |
hlipka | 2:5ac5bab7daaf | 53 | wait_us(1); |
hlipka | 0:ae5037e3d6e0 | 54 | for (int y=0;y<64;y++) |
hlipka | 0:ae5037e3d6e0 | 55 | { |
hlipka | 0:ae5037e3d6e0 | 56 | sendCmd(0x40|y,cs); |
hlipka | 0:ae5037e3d6e0 | 57 | wait_us(1); |
hlipka | 0:ae5037e3d6e0 | 58 | sendData(0,cs); |
hlipka | 0:ae5037e3d6e0 | 59 | wait_us(1); |
hlipka | 0:ae5037e3d6e0 | 60 | } |
hlipka | 0:ae5037e3d6e0 | 61 | } |
hlipka | 0:ae5037e3d6e0 | 62 | } |
hlipka | 0:ae5037e3d6e0 | 63 | |
hlipka | 2:5ac5bab7daaf | 64 | void KS0108LCD8bit::character(int column, int row, int c){ |
hlipka | 0:ae5037e3d6e0 | 65 | DigitalOut* cs=NULL; |
hlipka | 2:5ac5bab7daaf | 66 | int icolumn=column; |
hlipka | 2:5ac5bab7daaf | 67 | if (icolumn>7) |
hlipka | 0:ae5037e3d6e0 | 68 | { |
hlipka | 0:ae5037e3d6e0 | 69 | cs=_right; |
hlipka | 2:5ac5bab7daaf | 70 | icolumn-=8; |
hlipka | 0:ae5037e3d6e0 | 71 | } |
hlipka | 0:ae5037e3d6e0 | 72 | else |
hlipka | 0:ae5037e3d6e0 | 73 | { |
hlipka | 0:ae5037e3d6e0 | 74 | cs=_left; |
hlipka | 0:ae5037e3d6e0 | 75 | } |
hlipka | 0:ae5037e3d6e0 | 76 | if (NULL==cs) |
hlipka | 0:ae5037e3d6e0 | 77 | return; |
hlipka | 0:ae5037e3d6e0 | 78 | |
hlipka | 3:e5d5e2fe4bf6 | 79 | _guard->take(); |
hlipka | 2:5ac5bab7daaf | 80 | sendCmd(0xb8|row,cs); // set x page |
hlipka | 0:ae5037e3d6e0 | 81 | |
hlipka | 2:5ac5bab7daaf | 82 | unsigned int y=icolumn*8; |
hlipka | 0:ae5037e3d6e0 | 83 | sendCmd(0x40|y,cs); // set start line |
hlipka | 0:ae5037e3d6e0 | 84 | |
hlipka | 0:ae5037e3d6e0 | 85 | // send character data |
hlipka | 0:ae5037e3d6e0 | 86 | for (int i=0;i<8;i++) |
hlipka | 0:ae5037e3d6e0 | 87 | { |
hlipka | 0:ae5037e3d6e0 | 88 | sendData(font_data[c][i],cs); |
hlipka | 0:ae5037e3d6e0 | 89 | } |
hlipka | 0:ae5037e3d6e0 | 90 | |
hlipka | 3:e5d5e2fe4bf6 | 91 | _guard->release(); |
hlipka | 0:ae5037e3d6e0 | 92 | } |
hlipka | 0:ae5037e3d6e0 | 93 | |
hlipka | 0:ae5037e3d6e0 | 94 | KS0108LCD8bit::KS0108LCD8bit |
hlipka | 2:5ac5bab7daaf | 95 | (const unsigned int columns, const unsigned int rows, BusOut *data, const PinName enable, const PinName rs, const PinName leftCS, const PinName rightCS) |
hlipka | 2:5ac5bab7daaf | 96 | :TextLCDBase(columns, rows) { |
hlipka | 0:ae5037e3d6e0 | 97 | _data=data; |
hlipka | 0:ae5037e3d6e0 | 98 | _rs=new DigitalOut(rs); |
hlipka | 0:ae5037e3d6e0 | 99 | _enable=new DigitalOut(enable); |
hlipka | 0:ae5037e3d6e0 | 100 | _left=new DigitalOut(leftCS); |
hlipka | 0:ae5037e3d6e0 | 101 | _left->write(1-ENABLE); |
hlipka | 0:ae5037e3d6e0 | 102 | if (NC!=rightCS) |
hlipka | 0:ae5037e3d6e0 | 103 | { |
hlipka | 0:ae5037e3d6e0 | 104 | _right=new DigitalOut(rightCS); |
hlipka | 0:ae5037e3d6e0 | 105 | _right->write(1-ENABLE); |
hlipka | 0:ae5037e3d6e0 | 106 | } |
hlipka | 0:ae5037e3d6e0 | 107 | else |
hlipka | 0:ae5037e3d6e0 | 108 | _right=NULL; |
hlipka | 0:ae5037e3d6e0 | 109 | _enable->write(0); |
hlipka | 0:ae5037e3d6e0 | 110 | wait_ms(80); |
hlipka | 0:ae5037e3d6e0 | 111 | } |
hlipka | 0:ae5037e3d6e0 | 112 | |
hlipka | 0:ae5037e3d6e0 | 113 | void KS0108LCD8bit::init() { |
hlipka | 0:ae5037e3d6e0 | 114 | sendCmd(0x3f, _left); |
hlipka | 0:ae5037e3d6e0 | 115 | wait_ms(10); |
hlipka | 0:ae5037e3d6e0 | 116 | sendCmd(0xc0, _left); |
hlipka | 0:ae5037e3d6e0 | 117 | |
hlipka | 0:ae5037e3d6e0 | 118 | if (NULL!=_right) |
hlipka | 0:ae5037e3d6e0 | 119 | { |
hlipka | 0:ae5037e3d6e0 | 120 | sendCmd(0x3f, _right); |
hlipka | 0:ae5037e3d6e0 | 121 | wait_ms(10); |
hlipka | 0:ae5037e3d6e0 | 122 | sendCmd(0xc0, _right); |
hlipka | 0:ae5037e3d6e0 | 123 | } |
hlipka | 0:ae5037e3d6e0 | 124 | wait_ms(50); |
hlipka | 0:ae5037e3d6e0 | 125 | clear(); |
hlipka | 0:ae5037e3d6e0 | 126 | } |
hlipka | 0:ae5037e3d6e0 | 127 | |
hlipka | 1:65f72ed914fa | 128 | void KS0108LCD8bit::sendCmd(const unsigned char cmd, DigitalOut *cs) { |
hlipka | 0:ae5037e3d6e0 | 129 | _rs->write(0); |
hlipka | 0:ae5037e3d6e0 | 130 | wait_us(1); |
hlipka | 0:ae5037e3d6e0 | 131 | sendByte(cmd, cs); |
hlipka | 0:ae5037e3d6e0 | 132 | wait_us(10); |
hlipka | 0:ae5037e3d6e0 | 133 | } |
hlipka | 0:ae5037e3d6e0 | 134 | |
hlipka | 1:65f72ed914fa | 135 | void KS0108LCD8bit::sendData(const unsigned char cmd, DigitalOut *cs) { |
hlipka | 0:ae5037e3d6e0 | 136 | _rs->write(1); |
hlipka | 0:ae5037e3d6e0 | 137 | wait_us(1); |
hlipka | 0:ae5037e3d6e0 | 138 | sendByte(cmd, cs); |
hlipka | 0:ae5037e3d6e0 | 139 | wait_us(10); |
hlipka | 0:ae5037e3d6e0 | 140 | } |
hlipka | 0:ae5037e3d6e0 | 141 | |
hlipka | 1:65f72ed914fa | 142 | void KS0108LCD8bit::sendByte(const unsigned char byte, DigitalOut *cs) { |
hlipka | 0:ae5037e3d6e0 | 143 | // display reads flags with rising flank of E |
hlipka | 0:ae5037e3d6e0 | 144 | _enable->write(0); |
hlipka | 0:ae5037e3d6e0 | 145 | cs->write(ENABLE); |
hlipka | 0:ae5037e3d6e0 | 146 | _data->write(byte); |
hlipka | 0:ae5037e3d6e0 | 147 | |
hlipka | 0:ae5037e3d6e0 | 148 | wait_us(2); |
hlipka | 0:ae5037e3d6e0 | 149 | _enable->write(1); |
hlipka | 0:ae5037e3d6e0 | 150 | |
hlipka | 0:ae5037e3d6e0 | 151 | // display reads data with falling flank of E |
hlipka | 0:ae5037e3d6e0 | 152 | wait_us(2); |
hlipka | 0:ae5037e3d6e0 | 153 | _enable->write(0); |
hlipka | 0:ae5037e3d6e0 | 154 | |
hlipka | 0:ae5037e3d6e0 | 155 | wait_us(30); |
hlipka | 0:ae5037e3d6e0 | 156 | cs->write(1-ENABLE); |
hlipka | 0:ae5037e3d6e0 | 157 | } |