Hendrik Lipka / LcdWindow

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.

Dependents:   Mbell

ks0108_8bit.cpp@9:2fe93daa2106, 2011-02-22 (annotated)

Committer:
hlipka
Date:
Tue Feb 22 22:57:44 2011 +0000
Revision:
9:2fe93daa2106
Parent:
3:e5d5e2fe4bf6 
fixed semaphore handling - should now be really thread safe (can be called from interrupts)

Who changed what in which revision?

UserRevisionLine numberNew 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 9:2fe93daa2106 42 if (!_guard->take())
hlipka 9:2fe93daa2106 43 return;
hlipka 0:ae5037e3d6e0 44 clearHalf(_left);
hlipka 0:ae5037e3d6e0 45 if (NULL!=_right)
hlipka 0:ae5037e3d6e0 46 clearHalf(_right);
hlipka 3:e5d5e2fe4bf6 47 _guard->release();
hlipka 0:ae5037e3d6e0 48 }
hlipka 0:ae5037e3d6e0 49
hlipka 0:ae5037e3d6e0 50 void KS0108LCD8bit::clearHalf(DigitalOut* cs) {
hlipka 0:ae5037e3d6e0 51 for (int x=0;x<8;x++)
hlipka 0:ae5037e3d6e0 52 {
hlipka 2:5ac5bab7daaf 53 sendCmd(0xb8|x,cs);
hlipka 2:5ac5bab7daaf 54 wait_us(1);
hlipka 0:ae5037e3d6e0 55 for (int y=0;y<64;y++)
hlipka 0:ae5037e3d6e0 56 {
hlipka 0:ae5037e3d6e0 57 sendCmd(0x40|y,cs);
hlipka 0:ae5037e3d6e0 58 wait_us(1);
hlipka 0:ae5037e3d6e0 59 sendData(0,cs);
hlipka 0:ae5037e3d6e0 60 wait_us(1);
hlipka 0:ae5037e3d6e0 61 }
hlipka 0:ae5037e3d6e0 62 }
hlipka 0:ae5037e3d6e0 63 }
hlipka 0:ae5037e3d6e0 64
hlipka 2:5ac5bab7daaf 65 void KS0108LCD8bit::character(int column, int row, int c){
hlipka 0:ae5037e3d6e0 66 DigitalOut* cs=NULL;
hlipka 2:5ac5bab7daaf 67 int icolumn=column;
hlipka 2:5ac5bab7daaf 68 if (icolumn>7)
hlipka 0:ae5037e3d6e0 69 {
hlipka 0:ae5037e3d6e0 70 cs=_right;
hlipka 2:5ac5bab7daaf 71 icolumn-=8;
hlipka 0:ae5037e3d6e0 72 }
hlipka 0:ae5037e3d6e0 73 else
hlipka 0:ae5037e3d6e0 74 {
hlipka 0:ae5037e3d6e0 75 cs=_left;
hlipka 0:ae5037e3d6e0 76 }
hlipka 0:ae5037e3d6e0 77 if (NULL==cs)
hlipka 0:ae5037e3d6e0 78 return;
hlipka 0:ae5037e3d6e0 79
hlipka 9:2fe93daa2106 80 if (!_guard->take())
hlipka 9:2fe93daa2106 81 return;
hlipka 2:5ac5bab7daaf 82 sendCmd(0xb8|row,cs); // set x page
hlipka 0:ae5037e3d6e0 83
hlipka 2:5ac5bab7daaf 84 unsigned int y=icolumn*8;
hlipka 0:ae5037e3d6e0 85 sendCmd(0x40|y,cs); // set start line
hlipka 0:ae5037e3d6e0 86
hlipka 0:ae5037e3d6e0 87 // send character data
hlipka 0:ae5037e3d6e0 88 for (int i=0;i<8;i++)
hlipka 0:ae5037e3d6e0 89 {
hlipka 0:ae5037e3d6e0 90 sendData(font_data[c][i],cs);
hlipka 0:ae5037e3d6e0 91 }
hlipka 0:ae5037e3d6e0 92
hlipka 3:e5d5e2fe4bf6 93 _guard->release();
hlipka 0:ae5037e3d6e0 94 }
hlipka 0:ae5037e3d6e0 95
hlipka 0:ae5037e3d6e0 96 KS0108LCD8bit::KS0108LCD8bit
hlipka 2:5ac5bab7daaf 97 (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 98 :TextLCDBase(columns, rows) {
hlipka 0:ae5037e3d6e0 99 _data=data;
hlipka 0:ae5037e3d6e0 100 _rs=new DigitalOut(rs);
hlipka 0:ae5037e3d6e0 101 _enable=new DigitalOut(enable);
hlipka 0:ae5037e3d6e0 102 _left=new DigitalOut(leftCS);
hlipka 0:ae5037e3d6e0 103 _left->write(1-ENABLE);
hlipka 0:ae5037e3d6e0 104 if (NC!=rightCS)
hlipka 0:ae5037e3d6e0 105 {
hlipka 0:ae5037e3d6e0 106 _right=new DigitalOut(rightCS);
hlipka 0:ae5037e3d6e0 107 _right->write(1-ENABLE);
hlipka 0:ae5037e3d6e0 108 }
hlipka 0:ae5037e3d6e0 109 else
hlipka 0:ae5037e3d6e0 110 _right=NULL;
hlipka 0:ae5037e3d6e0 111 _enable->write(0);
hlipka 0:ae5037e3d6e0 112 wait_ms(80);
hlipka 0:ae5037e3d6e0 113 }
hlipka 0:ae5037e3d6e0 114
hlipka 0:ae5037e3d6e0 115 void KS0108LCD8bit::init() {
hlipka 0:ae5037e3d6e0 116 sendCmd(0x3f, _left);
hlipka 0:ae5037e3d6e0 117 wait_ms(10);
hlipka 0:ae5037e3d6e0 118 sendCmd(0xc0, _left);
hlipka 0:ae5037e3d6e0 119
hlipka 0:ae5037e3d6e0 120 if (NULL!=_right)
hlipka 0:ae5037e3d6e0 121 {
hlipka 0:ae5037e3d6e0 122 sendCmd(0x3f, _right);
hlipka 0:ae5037e3d6e0 123 wait_ms(10);
hlipka 0:ae5037e3d6e0 124 sendCmd(0xc0, _right);
hlipka 0:ae5037e3d6e0 125 }
hlipka 0:ae5037e3d6e0 126 wait_ms(50);
hlipka 0:ae5037e3d6e0 127 clear();
hlipka 0:ae5037e3d6e0 128 }
hlipka 0:ae5037e3d6e0 129
hlipka 1:65f72ed914fa 130 void KS0108LCD8bit::sendCmd(const unsigned char cmd, DigitalOut *cs) {
hlipka 0:ae5037e3d6e0 131 _rs->write(0);
hlipka 0:ae5037e3d6e0 132 wait_us(1);
hlipka 0:ae5037e3d6e0 133 sendByte(cmd, cs);
hlipka 0:ae5037e3d6e0 134 wait_us(10);
hlipka 0:ae5037e3d6e0 135 }
hlipka 0:ae5037e3d6e0 136
hlipka 1:65f72ed914fa 137 void KS0108LCD8bit::sendData(const unsigned char cmd, DigitalOut *cs) {
hlipka 0:ae5037e3d6e0 138 _rs->write(1);
hlipka 0:ae5037e3d6e0 139 wait_us(1);
hlipka 0:ae5037e3d6e0 140 sendByte(cmd, cs);
hlipka 0:ae5037e3d6e0 141 wait_us(10);
hlipka 0:ae5037e3d6e0 142 }
hlipka 0:ae5037e3d6e0 143
hlipka 1:65f72ed914fa 144 void KS0108LCD8bit::sendByte(const unsigned char byte, DigitalOut *cs) {
hlipka 0:ae5037e3d6e0 145 // display reads flags with rising flank of E
hlipka 0:ae5037e3d6e0 146 _enable->write(0);
hlipka 0:ae5037e3d6e0 147 cs->write(ENABLE);
hlipka 0:ae5037e3d6e0 148 _data->write(byte);
hlipka 0:ae5037e3d6e0 149
hlipka 0:ae5037e3d6e0 150 wait_us(2);
hlipka 0:ae5037e3d6e0 151 _enable->write(1);
hlipka 0:ae5037e3d6e0 152
hlipka 0:ae5037e3d6e0 153 // display reads data with falling flank of E
hlipka 0:ae5037e3d6e0 154 wait_us(2);
hlipka 0:ae5037e3d6e0 155 _enable->write(0);
hlipka 0:ae5037e3d6e0 156
hlipka 0:ae5037e3d6e0 157 wait_us(30);
hlipka 0:ae5037e3d6e0 158 cs->write(1-ENABLE);
hlipka 0:ae5037e3d6e0 159 }