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@2:5ac5bab7daaf, 2010-11-27 (annotated)

Committer:
hlipka
Date:
Sat Nov 27 22:54:13 2010 +0000
Revision:
2:5ac5bab7daaf
Parent:
1:65f72ed914fa
Child:
3:e5d5e2fe4bf6
Moved to \"Stream\"-based API (like TextLCD) which allows the usage of printf

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