Izmijenjeno u odnosu na SoftwareSPI
Fork of N5110 by
N5110.cpp@9:7701f0126ba7, 2014-05-20 (annotated)
- Committer:
- eencae
- Date:
- Tue May 20 19:43:52 2014 +0000
- Revision:
- 9:7701f0126ba7
- Parent:
- 8:40abe5736eca
- Child:
- 10:6f3abb40202b
printString() has been modified. Rather than sending the string to the display using the printChar(), it now writes the character bitmap data to the screen buffer and refreshes the display. This means that pixels and strings can now be used together.
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
eencae | 5:6ea180eef702 | 1 | /** |
eencae | 5:6ea180eef702 | 2 | @file N5110.cpp |
eencae | 5:6ea180eef702 | 3 | |
eencae | 5:6ea180eef702 | 4 | @brief Member functions implementations |
eencae | 5:6ea180eef702 | 5 | |
eencae | 5:6ea180eef702 | 6 | */ |
eencae | 0:d563e74f0ae9 | 7 | #include "mbed.h" |
eencae | 0:d563e74f0ae9 | 8 | #include "N5110.h" |
eencae | 0:d563e74f0ae9 | 9 | |
eencae | 2:e93021cfb0a9 | 10 | |
eencae | 1:df68f34cd32d | 11 | N5110::N5110(PinName pwrPin, PinName scePin, PinName rstPin, PinName dcPin, PinName mosiPin, PinName sclkPin, PinName ledPin) |
eencae | 0:d563e74f0ae9 | 12 | { |
eencae | 0:d563e74f0ae9 | 13 | |
eencae | 0:d563e74f0ae9 | 14 | spi = new SPI(mosiPin,NC,sclkPin); // create new SPI instance and initialise |
eencae | 0:d563e74f0ae9 | 15 | initSPI(); |
eencae | 0:d563e74f0ae9 | 16 | |
eencae | 6:adb79338d40f | 17 | // set up pins as required |
eencae | 0:d563e74f0ae9 | 18 | led = new PwmOut(ledPin); |
eencae | 0:d563e74f0ae9 | 19 | pwr = new DigitalOut(pwrPin); |
eencae | 0:d563e74f0ae9 | 20 | sce = new DigitalOut(scePin); |
eencae | 0:d563e74f0ae9 | 21 | rst = new DigitalOut(rstPin); |
eencae | 0:d563e74f0ae9 | 22 | dc = new DigitalOut(dcPin); |
eencae | 0:d563e74f0ae9 | 23 | |
eencae | 0:d563e74f0ae9 | 24 | } |
eencae | 0:d563e74f0ae9 | 25 | |
eencae | 6:adb79338d40f | 26 | // initialise function - powers up and sends the initialisation commands |
eencae | 0:d563e74f0ae9 | 27 | void N5110::init() |
eencae | 0:d563e74f0ae9 | 28 | { |
eencae | 6:adb79338d40f | 29 | turnOn(); // power up |
eencae | 6:adb79338d40f | 30 | wait_ms(10); // small delay seems to prevent spurious pixels during mbed reset |
eencae | 6:adb79338d40f | 31 | reset(); // reset LCD - must be done within 100 ms |
eencae | 0:d563e74f0ae9 | 32 | |
eencae | 0:d563e74f0ae9 | 33 | // function set - extended |
eencae | 0:d563e74f0ae9 | 34 | sendCommand(0x20 | CMD_FS_ACTIVE_MODE | CMD_FS_HORIZONTAL_MODE | CMD_FS_EXTENDED_MODE); |
eencae | 6:adb79338d40f | 35 | // Don't completely understand these parameters - they seem to work as they are |
eencae | 6:adb79338d40f | 36 | // Consult the datasheet if you need to change them |
eencae | 1:df68f34cd32d | 37 | sendCommand(CMD_VOP_7V38); // operating voltage - these values are from Chris Yan's Library |
eencae | 0:d563e74f0ae9 | 38 | sendCommand(CMD_TC_TEMP_2); // temperature control |
eencae | 0:d563e74f0ae9 | 39 | sendCommand(CMD_BI_MUX_48); // bias |
eencae | 0:d563e74f0ae9 | 40 | |
eencae | 0:d563e74f0ae9 | 41 | // function set - basic |
eencae | 0:d563e74f0ae9 | 42 | sendCommand(0x20 | CMD_FS_ACTIVE_MODE | CMD_FS_HORIZONTAL_MODE | CMD_FS_BASIC_MODE); |
eencae | 1:df68f34cd32d | 43 | normalMode(); // normal video mode by default |
eencae | 0:d563e74f0ae9 | 44 | sendCommand(CMD_DC_NORMAL_MODE); // black on white |
eencae | 0:d563e74f0ae9 | 45 | |
eencae | 0:d563e74f0ae9 | 46 | // RAM is undefined at power-up so clear |
eencae | 0:d563e74f0ae9 | 47 | clearRAM(); |
eencae | 0:d563e74f0ae9 | 48 | |
eencae | 0:d563e74f0ae9 | 49 | } |
eencae | 1:df68f34cd32d | 50 | |
eencae | 1:df68f34cd32d | 51 | // sets normal video mode (black on white) |
eencae | 1:df68f34cd32d | 52 | void N5110::normalMode() { |
eencae | 1:df68f34cd32d | 53 | sendCommand(CMD_DC_NORMAL_MODE); |
eencae | 1:df68f34cd32d | 54 | |
eencae | 1:df68f34cd32d | 55 | } |
eencae | 1:df68f34cd32d | 56 | |
eencae | 1:df68f34cd32d | 57 | // sets normal video mode (white on black) |
eencae | 1:df68f34cd32d | 58 | void N5110::inverseMode() { |
eencae | 1:df68f34cd32d | 59 | sendCommand(CMD_DC_INVERT_VIDEO); |
eencae | 1:df68f34cd32d | 60 | } |
eencae | 0:d563e74f0ae9 | 61 | |
eencae | 0:d563e74f0ae9 | 62 | // function to power up the LCD and backlight |
eencae | 0:d563e74f0ae9 | 63 | void N5110::turnOn() |
eencae | 0:d563e74f0ae9 | 64 | { |
eencae | 0:d563e74f0ae9 | 65 | // set brightness of LED - 0.0 to 1.0 - default is 50% |
eencae | 0:d563e74f0ae9 | 66 | setBrightness(0.5); |
eencae | 0:d563e74f0ae9 | 67 | pwr->write(1); // apply power |
eencae | 0:d563e74f0ae9 | 68 | } |
eencae | 0:d563e74f0ae9 | 69 | |
eencae | 0:d563e74f0ae9 | 70 | // function to power down LCD |
eencae | 0:d563e74f0ae9 | 71 | void N5110::turnOff() |
eencae | 0:d563e74f0ae9 | 72 | { |
eencae | 0:d563e74f0ae9 | 73 | setBrightness(0.0); // turn backlight off |
eencae | 0:d563e74f0ae9 | 74 | clearRAM(); // clear RAM to ensure specified current consumption |
eencae | 6:adb79338d40f | 75 | // send command to ensure we are in basic model |
eencae | 0:d563e74f0ae9 | 76 | sendCommand(0x20 | CMD_FS_ACTIVE_MODE | CMD_FS_HORIZONTAL_MODE | CMD_FS_BASIC_MODE); |
eencae | 6:adb79338d40f | 77 | // clear the display |
eencae | 0:d563e74f0ae9 | 78 | sendCommand(CMD_DC_CLEAR_DISPLAY); |
eencae | 6:adb79338d40f | 79 | // enter the extended mode and power down |
eencae | 0:d563e74f0ae9 | 80 | sendCommand(0x20 | CMD_FS_POWER_DOWN_MODE | CMD_FS_HORIZONTAL_MODE | CMD_FS_EXTENDED_MODE); |
eencae | 6:adb79338d40f | 81 | // small delay and then turn off the power pin |
eencae | 6:adb79338d40f | 82 | wait_ms(10); |
eencae | 0:d563e74f0ae9 | 83 | pwr->write(0); |
eencae | 0:d563e74f0ae9 | 84 | |
eencae | 0:d563e74f0ae9 | 85 | } |
eencae | 0:d563e74f0ae9 | 86 | |
eencae | 0:d563e74f0ae9 | 87 | // function to change LED backlight brightness |
eencae | 0:d563e74f0ae9 | 88 | void N5110::setBrightness(float brightness) |
eencae | 0:d563e74f0ae9 | 89 | { |
eencae | 0:d563e74f0ae9 | 90 | // check whether brightness is within range |
eencae | 0:d563e74f0ae9 | 91 | if (brightness < 0.0) |
eencae | 0:d563e74f0ae9 | 92 | brightness = 0.0; |
eencae | 0:d563e74f0ae9 | 93 | if (brightness > 1.0) |
eencae | 0:d563e74f0ae9 | 94 | brightness = 1.0; |
eencae | 0:d563e74f0ae9 | 95 | // set PWM duty cycle |
eencae | 0:d563e74f0ae9 | 96 | led->write(brightness); |
eencae | 0:d563e74f0ae9 | 97 | } |
eencae | 0:d563e74f0ae9 | 98 | |
eencae | 0:d563e74f0ae9 | 99 | |
eencae | 0:d563e74f0ae9 | 100 | // pulse the active low reset line |
eencae | 0:d563e74f0ae9 | 101 | void N5110::reset() |
eencae | 0:d563e74f0ae9 | 102 | { |
eencae | 0:d563e74f0ae9 | 103 | rst->write(0); // reset the LCD |
eencae | 0:d563e74f0ae9 | 104 | rst->write(1); |
eencae | 0:d563e74f0ae9 | 105 | } |
eencae | 0:d563e74f0ae9 | 106 | |
eencae | 0:d563e74f0ae9 | 107 | // function to initialise SPI peripheral |
eencae | 0:d563e74f0ae9 | 108 | void N5110::initSPI() |
eencae | 0:d563e74f0ae9 | 109 | { |
eencae | 0:d563e74f0ae9 | 110 | spi->format(8,1); // 8 bits, Mode 1 - polarity 0, phase 1 - base value of clock is 0, data captured on falling edge/propagated on rising edge |
eencae | 0:d563e74f0ae9 | 111 | spi->frequency(4000000); // maximum of screen is 4 MHz |
eencae | 0:d563e74f0ae9 | 112 | } |
eencae | 0:d563e74f0ae9 | 113 | |
eencae | 6:adb79338d40f | 114 | // send a command to the display |
eencae | 0:d563e74f0ae9 | 115 | void N5110::sendCommand(unsigned char command) |
eencae | 0:d563e74f0ae9 | 116 | { |
eencae | 0:d563e74f0ae9 | 117 | dc->write(0); // set DC low for command |
eencae | 0:d563e74f0ae9 | 118 | sce->write(0); // set CE low to begin frame |
eencae | 0:d563e74f0ae9 | 119 | spi->write(command); // send command |
eencae | 0:d563e74f0ae9 | 120 | dc->write(1); // turn back to data by default |
eencae | 0:d563e74f0ae9 | 121 | sce->write(1); // set CE high to end frame (expected for transmission of single byte) |
eencae | 0:d563e74f0ae9 | 122 | |
eencae | 0:d563e74f0ae9 | 123 | } |
eencae | 0:d563e74f0ae9 | 124 | |
eencae | 6:adb79338d40f | 125 | // send data to the display at the current XY address |
eencae | 6:adb79338d40f | 126 | // dc is set to 1 (i.e. data) after sending a command and so should |
eencae | 6:adb79338d40f | 127 | // be the default mode. |
eencae | 0:d563e74f0ae9 | 128 | void N5110::sendData(unsigned char data) |
eencae | 0:d563e74f0ae9 | 129 | { |
eencae | 0:d563e74f0ae9 | 130 | sce->write(0); // set CE low to begin frame |
eencae | 0:d563e74f0ae9 | 131 | spi->write(data); |
eencae | 0:d563e74f0ae9 | 132 | sce->write(1); // set CE high to end frame (expected for transmission of single byte) |
eencae | 0:d563e74f0ae9 | 133 | } |
eencae | 0:d563e74f0ae9 | 134 | |
eencae | 0:d563e74f0ae9 | 135 | // this function writes 0 to the 504 bytes to clear the RAM |
eencae | 0:d563e74f0ae9 | 136 | void N5110::clearRAM() |
eencae | 0:d563e74f0ae9 | 137 | { |
eencae | 0:d563e74f0ae9 | 138 | int i; |
eencae | 0:d563e74f0ae9 | 139 | sce->write(0); //set CE low to begin frame |
eencae | 0:d563e74f0ae9 | 140 | for(i = 0; i < 504; i++) { // 48 x 84 bits = 504 bytes |
eencae | 0:d563e74f0ae9 | 141 | spi->write(0x00); // send 0's |
eencae | 0:d563e74f0ae9 | 142 | } |
eencae | 0:d563e74f0ae9 | 143 | sce->write(1); // set CE high to end frame |
eencae | 0:d563e74f0ae9 | 144 | |
eencae | 0:d563e74f0ae9 | 145 | } |
eencae | 0:d563e74f0ae9 | 146 | |
eencae | 6:adb79338d40f | 147 | // function to set the XY address in RAM for subsequenct data write |
eencae | 0:d563e74f0ae9 | 148 | void N5110::setXYAddress(int x, int y) |
eencae | 0:d563e74f0ae9 | 149 | { |
eencae | 0:d563e74f0ae9 | 150 | // check whether address is in range |
eencae | 0:d563e74f0ae9 | 151 | if (x > 83) |
eencae | 0:d563e74f0ae9 | 152 | x=83; |
eencae | 0:d563e74f0ae9 | 153 | if (y > 5) |
eencae | 0:d563e74f0ae9 | 154 | y=5; |
eencae | 3:f90dd1042d17 | 155 | if (x < 0) |
eencae | 3:f90dd1042d17 | 156 | x=0; |
eencae | 3:f90dd1042d17 | 157 | if (y < 0) |
eencae | 3:f90dd1042d17 | 158 | y=0; |
eencae | 0:d563e74f0ae9 | 159 | |
eencae | 3:f90dd1042d17 | 160 | sendCommand(0x80 | x); // send addresses to display with relevant mask |
eencae | 0:d563e74f0ae9 | 161 | sendCommand(0x40 | y); |
eencae | 0:d563e74f0ae9 | 162 | } |
eencae | 0:d563e74f0ae9 | 163 | |
eencae | 6:adb79338d40f | 164 | // These functions are used to set, clear and get the value of pixels in the display |
eencae | 6:adb79338d40f | 165 | // Pixels are addressed in the range of 0 to 47 (y) and 0 to 83 (x). The refresh() |
eencae | 6:adb79338d40f | 166 | // function must be called after set and clear in order to update the display |
eencae | 0:d563e74f0ae9 | 167 | void N5110::setPixel(int x, int y) |
eencae | 0:d563e74f0ae9 | 168 | { |
eencae | 6:adb79338d40f | 169 | // calculate bank and shift 1 to required position in the data byte |
eencae | 0:d563e74f0ae9 | 170 | buffer[x][y/8] |= (1 << y%8); |
eencae | 0:d563e74f0ae9 | 171 | } |
eencae | 0:d563e74f0ae9 | 172 | |
eencae | 0:d563e74f0ae9 | 173 | void N5110::clearPixel(int x, int y) |
eencae | 0:d563e74f0ae9 | 174 | { |
eencae | 0:d563e74f0ae9 | 175 | // calculate bank and shift 1 to required position (using bit clear) |
eencae | 0:d563e74f0ae9 | 176 | buffer[x][y/8] &= ~(1 << y%8); |
eencae | 0:d563e74f0ae9 | 177 | } |
eencae | 0:d563e74f0ae9 | 178 | |
eencae | 7:3010f24e0a81 | 179 | int N5110::getPixel(int x, int y) |
eencae | 0:d563e74f0ae9 | 180 | { |
eencae | 0:d563e74f0ae9 | 181 | // return relevant bank and mask required bit |
eencae | 7:3010f24e0a81 | 182 | return (int) buffer[x][y/8] & (1 << y%8); |
eencae | 0:d563e74f0ae9 | 183 | |
eencae | 0:d563e74f0ae9 | 184 | } |
eencae | 0:d563e74f0ae9 | 185 | |
eencae | 6:adb79338d40f | 186 | // function to refresh the display |
eencae | 6:adb79338d40f | 187 | void N5110::refresh() |
eencae | 0:d563e74f0ae9 | 188 | { |
eencae | 0:d563e74f0ae9 | 189 | int i,j; |
eencae | 7:3010f24e0a81 | 190 | |
eencae | 7:3010f24e0a81 | 191 | setXYAddress(0,0); // important to set address back to 0,0 before refreshing display |
eencae | 7:3010f24e0a81 | 192 | // address auto increments after printing string, so buffer[0][0] will not coincide |
eencae | 7:3010f24e0a81 | 193 | // with top-left pixel after priting string |
eencae | 7:3010f24e0a81 | 194 | |
eencae | 0:d563e74f0ae9 | 195 | sce->write(0); //set CE low to begin frame |
eencae | 0:d563e74f0ae9 | 196 | |
eencae | 0:d563e74f0ae9 | 197 | for(j = 0; j < 6; j++) { // be careful to use correct order (j,i) for horizontal addressing |
eencae | 0:d563e74f0ae9 | 198 | for(i = 0; i < 84; i++) { |
eencae | 0:d563e74f0ae9 | 199 | spi->write(buffer[i][j]); // send buffer |
eencae | 0:d563e74f0ae9 | 200 | } |
eencae | 0:d563e74f0ae9 | 201 | } |
eencae | 0:d563e74f0ae9 | 202 | sce->write(1); // set CE high to end frame |
eencae | 0:d563e74f0ae9 | 203 | |
eencae | 0:d563e74f0ae9 | 204 | } |
eencae | 0:d563e74f0ae9 | 205 | |
eencae | 6:adb79338d40f | 206 | // fills the buffer with random bytes. Can be used to test the display. |
eencae | 6:adb79338d40f | 207 | // The rand() function isn't seeded so it probably creates the same pattern everytime |
eencae | 0:d563e74f0ae9 | 208 | void N5110::randomiseBuffer() |
eencae | 0:d563e74f0ae9 | 209 | { |
eencae | 0:d563e74f0ae9 | 210 | int i,j; |
eencae | 0:d563e74f0ae9 | 211 | for(j = 0; j < 6; j++) { // be careful to use correct order (j,i) for horizontal addressing |
eencae | 0:d563e74f0ae9 | 212 | for(i = 0; i < 84; i++) { |
eencae | 0:d563e74f0ae9 | 213 | buffer[i][j] = rand()%256; // generate random byte |
eencae | 0:d563e74f0ae9 | 214 | } |
eencae | 0:d563e74f0ae9 | 215 | } |
eencae | 0:d563e74f0ae9 | 216 | |
eencae | 0:d563e74f0ae9 | 217 | } |
eencae | 0:d563e74f0ae9 | 218 | |
eencae | 0:d563e74f0ae9 | 219 | // function to print 5x7 font |
eencae | 0:d563e74f0ae9 | 220 | void N5110::printChar(char c) |
eencae | 0:d563e74f0ae9 | 221 | { |
eencae | 6:adb79338d40f | 222 | int i; |
eencae | 0:d563e74f0ae9 | 223 | // loop through 5 columns |
eencae | 6:adb79338d40f | 224 | for (i = 0; i < 5 ; i++ ) { |
eencae | 6:adb79338d40f | 225 | sendData(font5x7[(c - 32)*5 + i]); |
eencae | 0:d563e74f0ae9 | 226 | // array is offset by 32 relative to ASCII, each character is 5 pixels wide |
eencae | 6:adb79338d40f | 227 | // the X address is automatically incremented after each data write |
eencae | 0:d563e74f0ae9 | 228 | } |
eencae | 1:df68f34cd32d | 229 | sendData(0); // send an empty byte to introduce space between characters |
eencae | 0:d563e74f0ae9 | 230 | |
eencae | 0:d563e74f0ae9 | 231 | } |
eencae | 0:d563e74f0ae9 | 232 | |
eencae | 0:d563e74f0ae9 | 233 | // function to print string at specified position |
eencae | 0:d563e74f0ae9 | 234 | void N5110::printString(const char * str,int x,int y) |
eencae | 0:d563e74f0ae9 | 235 | { |
eencae | 0:d563e74f0ae9 | 236 | int n = 0 ; // counter for number of characters in string |
eencae | 0:d563e74f0ae9 | 237 | // loop through string and print character |
eencae | 0:d563e74f0ae9 | 238 | while(*str) { |
eencae | 0:d563e74f0ae9 | 239 | |
eencae | 9:7701f0126ba7 | 240 | // This is the old version - strings are printed using the printChar function |
eencae | 9:7701f0126ba7 | 241 | //setXYAddress(x+6*n,y); // leave 1 pixel (6 = 5 + 1) between each character |
eencae | 9:7701f0126ba7 | 242 | //printChar(*str); // print the char - can probably do *str++ and remove next line |
eencae | 9:7701f0126ba7 | 243 | |
eencae | 9:7701f0126ba7 | 244 | // the new version writes the character bitmap data to the buffer, so that |
eencae | 9:7701f0126ba7 | 245 | // text and pixels can be displayed at the same time |
eencae | 9:7701f0126ba7 | 246 | for (int i = 0; i < 5 ; i++ ) { |
eencae | 9:7701f0126ba7 | 247 | buffer[x+i+n*6][y] = font5x7[(*str - 32)*5 + i]; |
eencae | 9:7701f0126ba7 | 248 | } |
eencae | 9:7701f0126ba7 | 249 | |
eencae | 0:d563e74f0ae9 | 250 | str++; // go to next character in string |
eencae | 0:d563e74f0ae9 | 251 | n++; // increment index |
eencae | 0:d563e74f0ae9 | 252 | } |
eencae | 9:7701f0126ba7 | 253 | |
eencae | 9:7701f0126ba7 | 254 | refresh(); // this sends the buffer to the display and sets address (cursor) back to 0,0 |
eencae | 0:d563e74f0ae9 | 255 | |
eencae | 0:d563e74f0ae9 | 256 | } |
eencae | 0:d563e74f0ae9 | 257 | |
eencae | 6:adb79338d40f | 258 | // function to clear the screen |
eencae | 0:d563e74f0ae9 | 259 | void N5110::clear() |
eencae | 0:d563e74f0ae9 | 260 | { |
eencae | 6:adb79338d40f | 261 | clearBuffer(); // clear the buffer then call the refresh function |
eencae | 6:adb79338d40f | 262 | refresh(); |
eencae | 0:d563e74f0ae9 | 263 | } |
eencae | 0:d563e74f0ae9 | 264 | |
eencae | 6:adb79338d40f | 265 | // function to clear the buffer |
eencae | 0:d563e74f0ae9 | 266 | void N5110::clearBuffer() |
eencae | 0:d563e74f0ae9 | 267 | { |
eencae | 0:d563e74f0ae9 | 268 | int i,j; |
eencae | 6:adb79338d40f | 269 | for (i=0; i<84; i++) { // loop through the banks and set the buffer to 0 |
eencae | 0:d563e74f0ae9 | 270 | for (j=0; j<6; j++) { |
eencae | 0:d563e74f0ae9 | 271 | buffer[i][j]=0; |
eencae | 0:d563e74f0ae9 | 272 | } |
eencae | 0:d563e74f0ae9 | 273 | } |
eencae | 8:40abe5736eca | 274 | } |
eencae | 8:40abe5736eca | 275 | |
eencae | 8:40abe5736eca | 276 | // function to plot array on display |
eencae | 8:40abe5736eca | 277 | void N5110::plotArray(float array[]) { |
eencae | 8:40abe5736eca | 278 | |
eencae | 8:40abe5736eca | 279 | int i; |
eencae | 8:40abe5736eca | 280 | |
eencae | 8:40abe5736eca | 281 | for (i=0; i<84; i++) { // loop through array |
eencae | 8:40abe5736eca | 282 | // elements are normalised from 0.0 to 1.0, so multiply |
eencae | 8:40abe5736eca | 283 | // by 47 to convert to pixel range, and subtract from 47 |
eencae | 8:40abe5736eca | 284 | // since top-left is 0,0 in the display geometry |
eencae | 9:7701f0126ba7 | 285 | setPixel(i,47 - int(array[i]*47.0)); |
eencae | 8:40abe5736eca | 286 | } |
eencae | 8:40abe5736eca | 287 | |
eencae | 8:40abe5736eca | 288 | refresh(); |
eencae | 8:40abe5736eca | 289 | |
eencae | 8:40abe5736eca | 290 | |
eencae | 0:d563e74f0ae9 | 291 | } |