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@1:65f72ed914fa, 2010-11-16 (annotated)

Committer:
hlipka
Date:
Tue Nov 16 20:49:18 2010 +0000
Revision:
1:65f72ed914fa
Parent:
0:ae5037e3d6e0
Child:
2:5ac5bab7daaf
minor revision: made use of \const\ in the API

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