tr
N5110.h@25:444e55e2e419, 2017-02-07 (annotated)
- Committer:
- eencae
- Date:
- Tue Feb 07 11:22:45 2017 +0000
- Revision:
- 25:444e55e2e419
- Parent:
- 24:342bdb6679a1
- Child:
- 26:36be85c20ef4
Fixed docs.
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
eencae | 1:df68f34cd32d | 1 | /** |
eencae | 25:444e55e2e419 | 2 | *@file N5110.h |
eencae | 25:444e55e2e419 | 3 | */ |
eencae | 25:444e55e2e419 | 4 | |
eencae | 25:444e55e2e419 | 5 | #ifndef N5110_H |
eencae | 25:444e55e2e419 | 6 | #define N5110_H |
eencae | 25:444e55e2e419 | 7 | |
eencae | 25:444e55e2e419 | 8 | #include "mbed.h" |
eencae | 1:df68f34cd32d | 9 | |
eencae | 25:444e55e2e419 | 10 | // Command Bytes - taken from Chris Yan's library |
eencae | 25:444e55e2e419 | 11 | // More information can be found in the display datasheet |
eencae | 25:444e55e2e419 | 12 | // H = 0 - Basic instructions |
eencae | 25:444e55e2e419 | 13 | #define CMD_DC_CLEAR_DISPLAY 0x08 |
eencae | 25:444e55e2e419 | 14 | #define CMD_DC_NORMAL_MODE 0x0C |
eencae | 25:444e55e2e419 | 15 | #define CMD_DC_FILL_DISPLAY 0x09 |
eencae | 25:444e55e2e419 | 16 | #define CMD_DC_INVERT_VIDEO 0x0D |
eencae | 25:444e55e2e419 | 17 | #define CMD_FS_HORIZONTAL_MODE 0x00 |
eencae | 25:444e55e2e419 | 18 | #define CMD_FS_VERTICAL_MODE 0x02 |
eencae | 25:444e55e2e419 | 19 | #define CMD_FS_BASIC_MODE 0x00 |
eencae | 25:444e55e2e419 | 20 | #define CMD_FS_EXTENDED_MODE 0x01 |
eencae | 25:444e55e2e419 | 21 | #define CMD_FS_ACTIVE_MODE 0x00 |
eencae | 25:444e55e2e419 | 22 | #define CMD_FS_POWER_DOWN_MODE 0x04 |
eencae | 25:444e55e2e419 | 23 | // H = 1 - Extended instructions |
eencae | 25:444e55e2e419 | 24 | #define CMD_TC_TEMP_0 0x04 |
eencae | 25:444e55e2e419 | 25 | #define CMD_TC_TEMP_1 0x05 |
eencae | 25:444e55e2e419 | 26 | #define CMD_TC_TEMP_2 0x06 |
eencae | 25:444e55e2e419 | 27 | #define CMD_TC_TEMP_3 0x07 |
eencae | 25:444e55e2e419 | 28 | #define CMD_BI_MUX_24 0x15 |
eencae | 25:444e55e2e419 | 29 | #define CMD_BI_MUX_48 0x13 |
eencae | 25:444e55e2e419 | 30 | #define CMD_BI_MUX_100 0x10 |
eencae | 25:444e55e2e419 | 31 | #define CMD_VOP_6V06 0xB2 |
eencae | 25:444e55e2e419 | 32 | #define CMD_VOP_7V38 0xC8 |
eencae | 25:444e55e2e419 | 33 | |
eencae | 25:444e55e2e419 | 34 | // number of pixels on display |
eencae | 25:444e55e2e419 | 35 | #define WIDTH 84 |
eencae | 25:444e55e2e419 | 36 | #define HEIGHT 48 |
eencae | 25:444e55e2e419 | 37 | #define BANKS 6 |
eencae | 25:444e55e2e419 | 38 | |
eencae | 25:444e55e2e419 | 39 | /** N5110 Class |
eencae | 24:342bdb6679a1 | 40 | @brief Library for interfacing with Nokia 5110 LCD display (https://www.sparkfun.com/products/10168) using the hardware SPI on the mbed. |
eencae | 24:342bdb6679a1 | 41 | @brief The display is powered from a GPIO pin meaning it can be controlled via software. The LED backlight is also software-controllable (via PWM pin). |
eencae | 24:342bdb6679a1 | 42 | @brief Can print characters and strings to the display using the included 5x7 font. |
eencae | 24:342bdb6679a1 | 43 | @brief The library also implements a screen buffer so that individual pixels on the display (84 x 48) can be set, cleared and read. |
eencae | 24:342bdb6679a1 | 44 | @brief The library can print primitive shapes (lines, circles, rectangles) |
eencae | 24:342bdb6679a1 | 45 | @brief Acknowledgements to Chris Yan's Nokia_5110 Library. |
eencae | 24:342bdb6679a1 | 46 | |
eencae | 24:342bdb6679a1 | 47 | @brief Revision 1.3 |
eencae | 24:342bdb6679a1 | 48 | |
eencae | 24:342bdb6679a1 | 49 | @author Craig A. Evans |
eencae | 24:342bdb6679a1 | 50 | @date 7th February 2017 |
eencae | 24:342bdb6679a1 | 51 | |
eencae | 24:342bdb6679a1 | 52 | @code |
eencae | 24:342bdb6679a1 | 53 | |
eencae | 24:342bdb6679a1 | 54 | #include "mbed.h" |
eencae | 24:342bdb6679a1 | 55 | #include "N5110.h" |
eencae | 24:342bdb6679a1 | 56 | |
eencae | 24:342bdb6679a1 | 57 | // VCC,SCE,RST,D/C,MOSI,SCLK,LED |
eencae | 24:342bdb6679a1 | 58 | //N5110 lcd(p7,p8,p9,p10,p11,p13,p21); // LPC1768 - pwr from GPIO |
eencae | 24:342bdb6679a1 | 59 | N5110 lcd(PTC9,PTC0,PTC7,PTD2,PTD1,PTC11); // K64F - pwr from 3V3 |
eencae | 24:342bdb6679a1 | 60 | |
eencae | 24:342bdb6679a1 | 61 | int main() |
eencae | 24:342bdb6679a1 | 62 | { |
eencae | 24:342bdb6679a1 | 63 | // first need to initialise display |
eencae | 24:342bdb6679a1 | 64 | lcd.init(); |
eencae | 24:342bdb6679a1 | 65 | |
eencae | 24:342bdb6679a1 | 66 | while(1) { |
eencae | 24:342bdb6679a1 | 67 | |
eencae | 24:342bdb6679a1 | 68 | // these are default settings so not strictly needed |
eencae | 24:342bdb6679a1 | 69 | lcd.normalMode(); // normal colour mode |
eencae | 24:342bdb6679a1 | 70 | lcd.setBrightness(0.5); // put LED backlight on 50% |
eencae | 24:342bdb6679a1 | 71 | |
eencae | 24:342bdb6679a1 | 72 | lcd.clear(); // clear buffer at start of every loop |
eencae | 24:342bdb6679a1 | 73 | // can directly print strings at specified co-ordinates (must be less than 84 pixels to fit on display) |
eencae | 24:342bdb6679a1 | 74 | lcd.printString("Hello, World!",0,0); |
eencae | 24:342bdb6679a1 | 75 | |
eencae | 24:342bdb6679a1 | 76 | char buffer[14]; // each character is 6 pixels wide, screen is 84 pixels (84/6 = 14) |
eencae | 24:342bdb6679a1 | 77 | // so can display a string of a maximum 14 characters in length |
eencae | 24:342bdb6679a1 | 78 | // or create formatted strings - ensure they aren't more than 14 characters long |
eencae | 24:342bdb6679a1 | 79 | int temperature = 27; |
eencae | 24:342bdb6679a1 | 80 | int length = sprintf(buffer,"T = %2d C",temperature); // print formatted data to buffer |
eencae | 24:342bdb6679a1 | 81 | // it is important the format specifier ensures the length will fit in the buffer |
eencae | 24:342bdb6679a1 | 82 | if (length <= 14) // if string will fit on display (assuming printing at x=0) |
eencae | 24:342bdb6679a1 | 83 | lcd.printString(buffer,0,1); // display on screen |
eencae | 24:342bdb6679a1 | 84 | |
eencae | 24:342bdb6679a1 | 85 | float pressure = 1012.3; // same idea with floats |
eencae | 24:342bdb6679a1 | 86 | length = sprintf(buffer,"P = %.2f mb",pressure); |
eencae | 24:342bdb6679a1 | 87 | if (length <= 14) |
eencae | 24:342bdb6679a1 | 88 | lcd.printString(buffer,0,2); |
eencae | 24:342bdb6679a1 | 89 | |
eencae | 24:342bdb6679a1 | 90 | // can also print individual characters at specified place |
eencae | 24:342bdb6679a1 | 91 | lcd.printChar('X',5,3); |
eencae | 24:342bdb6679a1 | 92 | |
eencae | 24:342bdb6679a1 | 93 | // draw a line across the display at y = 40 pixels (origin top-left) |
eencae | 24:342bdb6679a1 | 94 | for (int i = 0; i < WIDTH; i++) { |
eencae | 24:342bdb6679a1 | 95 | lcd.setPixel(i,40); |
eencae | 24:342bdb6679a1 | 96 | } |
eencae | 24:342bdb6679a1 | 97 | // need to refresh display after setting pixels or writing strings |
eencae | 24:342bdb6679a1 | 98 | lcd.refresh(); |
eencae | 24:342bdb6679a1 | 99 | wait(5.0); |
eencae | 24:342bdb6679a1 | 100 | |
eencae | 24:342bdb6679a1 | 101 | // can check status of pixel using getPixel(x,y); |
eencae | 24:342bdb6679a1 | 102 | lcd.clear(); // clear buffer |
eencae | 24:342bdb6679a1 | 103 | lcd.setPixel(2,2); // set random pixel in buffer |
eencae | 24:342bdb6679a1 | 104 | lcd.refresh(); |
eencae | 24:342bdb6679a1 | 105 | wait(1.0); |
eencae | 24:342bdb6679a1 | 106 | |
eencae | 24:342bdb6679a1 | 107 | int pixel_to_test = lcd.getPixel(2,2); |
eencae | 24:342bdb6679a1 | 108 | |
eencae | 24:342bdb6679a1 | 109 | printf("2,2 Pixel value = %i\n",pixel_to_test); |
eencae | 24:342bdb6679a1 | 110 | |
eencae | 24:342bdb6679a1 | 111 | if ( pixel_to_test ) { |
eencae | 24:342bdb6679a1 | 112 | lcd.printString("2,2 is set",0,4); |
eencae | 24:342bdb6679a1 | 113 | } |
eencae | 24:342bdb6679a1 | 114 | |
eencae | 24:342bdb6679a1 | 115 | // this one shouldn't be set |
eencae | 24:342bdb6679a1 | 116 | pixel_to_test = lcd.getPixel(3,3); |
eencae | 24:342bdb6679a1 | 117 | |
eencae | 24:342bdb6679a1 | 118 | printf("3,3 Pixel value = %i\n",pixel_to_test); |
eencae | 24:342bdb6679a1 | 119 | |
eencae | 24:342bdb6679a1 | 120 | if ( pixel_to_test == 0 ) { |
eencae | 24:342bdb6679a1 | 121 | lcd.printString("3,3 is clear",0,5); |
eencae | 24:342bdb6679a1 | 122 | } |
eencae | 24:342bdb6679a1 | 123 | |
eencae | 24:342bdb6679a1 | 124 | lcd.refresh(); |
eencae | 24:342bdb6679a1 | 125 | wait(4.0); |
eencae | 24:342bdb6679a1 | 126 | |
eencae | 24:342bdb6679a1 | 127 | lcd.clear(); // clear buffer |
eencae | 24:342bdb6679a1 | 128 | lcd.inverseMode(); // invert colours |
eencae | 24:342bdb6679a1 | 129 | lcd.setBrightness(1.0); // put LED backlight on full |
eencae | 24:342bdb6679a1 | 130 | |
eencae | 24:342bdb6679a1 | 131 | float array[84]; |
eencae | 24:342bdb6679a1 | 132 | |
eencae | 24:342bdb6679a1 | 133 | for (int i = 0; i < 84; i++) { |
eencae | 24:342bdb6679a1 | 134 | array[i] = 0.5 + 0.5*sin(i*2*3.14/84); |
eencae | 24:342bdb6679a1 | 135 | } |
eencae | 24:342bdb6679a1 | 136 | |
eencae | 24:342bdb6679a1 | 137 | // can also plot graphs - 84 elements only |
eencae | 24:342bdb6679a1 | 138 | // values must be in range 0.0 - 1.0 |
eencae | 24:342bdb6679a1 | 139 | lcd.plotArray(array); |
eencae | 24:342bdb6679a1 | 140 | lcd.refresh(); |
eencae | 24:342bdb6679a1 | 141 | wait(5.0); |
eencae | 24:342bdb6679a1 | 142 | |
eencae | 24:342bdb6679a1 | 143 | lcd.clear(); |
eencae | 24:342bdb6679a1 | 144 | lcd.normalMode(); // normal colour mode back |
eencae | 24:342bdb6679a1 | 145 | lcd.setBrightness(0.5); // put LED backlight on 50% |
eencae | 24:342bdb6679a1 | 146 | |
eencae | 24:342bdb6679a1 | 147 | // example of drawing lines |
eencae | 24:342bdb6679a1 | 148 | for (int x = 0; x < WIDTH ; x+=10) { |
eencae | 24:342bdb6679a1 | 149 | // x0,y0,x1,y1,type 0-white,1-black,2-dotted |
eencae | 24:342bdb6679a1 | 150 | lcd.drawLine(0,0,x,HEIGHT,2); |
eencae | 24:342bdb6679a1 | 151 | } |
eencae | 24:342bdb6679a1 | 152 | lcd.refresh(); // refresh after drawing shapes |
eencae | 24:342bdb6679a1 | 153 | wait(5.0); |
eencae | 24:342bdb6679a1 | 154 | |
eencae | 24:342bdb6679a1 | 155 | |
eencae | 24:342bdb6679a1 | 156 | lcd.clear(); |
eencae | 24:342bdb6679a1 | 157 | // example of how to draw circles |
eencae | 24:342bdb6679a1 | 158 | lcd.drawCircle(WIDTH/2,HEIGHT/2,20,1); // x,y,radius,black fill |
eencae | 24:342bdb6679a1 | 159 | lcd.drawCircle(WIDTH/2,HEIGHT/2,10,2); // x,y,radius,white fill |
eencae | 24:342bdb6679a1 | 160 | lcd.drawCircle(WIDTH/2,HEIGHT/2,30,0); // x,y,radius,transparent with outline |
eencae | 24:342bdb6679a1 | 161 | lcd.refresh(); // refresh after drawing shapes |
eencae | 24:342bdb6679a1 | 162 | wait(5.0); |
eencae | 24:342bdb6679a1 | 163 | |
eencae | 24:342bdb6679a1 | 164 | lcd.clear(); |
eencae | 24:342bdb6679a1 | 165 | // example of how to draw rectangles |
eencae | 24:342bdb6679a1 | 166 | // origin x,y,width,height,type |
eencae | 24:342bdb6679a1 | 167 | lcd.drawRect(10,10,50,30,1); // filled black rectangle |
eencae | 24:342bdb6679a1 | 168 | lcd.drawRect(15,15,20,10,2); // filled white rectange (no outline) |
eencae | 24:342bdb6679a1 | 169 | lcd.drawRect(2,2,70,40,0); // transparent, just outline |
eencae | 24:342bdb6679a1 | 170 | lcd.refresh(); // refresh after drawing shapes |
eencae | 24:342bdb6679a1 | 171 | wait(5.0); |
eencae | 24:342bdb6679a1 | 172 | |
eencae | 24:342bdb6679a1 | 173 | } |
eencae | 24:342bdb6679a1 | 174 | } |
eencae | 24:342bdb6679a1 | 175 | |
eencae | 24:342bdb6679a1 | 176 | @endcode |
eencae | 0:d563e74f0ae9 | 177 | */ |
eencae | 1:df68f34cd32d | 178 | class N5110 |
eencae | 1:df68f34cd32d | 179 | { |
eencae | 0:d563e74f0ae9 | 180 | |
eencae | 1:df68f34cd32d | 181 | public: |
eencae | 23:eb7e6632fc9e | 182 | /** Create a N5110 object connected to the specified pins |
eencae | 23:eb7e6632fc9e | 183 | * |
eencae | 23:eb7e6632fc9e | 184 | * @param pwr Pin connected to Vcc on the LCD display (pin 1) |
eencae | 23:eb7e6632fc9e | 185 | * @param sce Pin connected to chip enable (pin 3) |
eencae | 23:eb7e6632fc9e | 186 | * @param rst Pin connected to reset (pin 4) |
eencae | 23:eb7e6632fc9e | 187 | * @param dc Pin connected to data/command select (pin 5) |
eencae | 23:eb7e6632fc9e | 188 | * @param mosi Pin connected to data input (MOSI) (pin 6) |
eencae | 23:eb7e6632fc9e | 189 | * @param sclk Pin connected to serial clock (SCLK) (pin 7) |
eencae | 23:eb7e6632fc9e | 190 | * @param led Pin connected to LED backlight (must be PWM) (pin 8) |
eencae | 23:eb7e6632fc9e | 191 | * |
eencae | 23:eb7e6632fc9e | 192 | */ |
eencae | 23:eb7e6632fc9e | 193 | N5110(PinName pwrPin, PinName scePin, PinName rstPin, PinName dcPin, PinName mosiPin, PinName sclkPin, PinName ledPin); |
eencae | 17:780a542d5f8b | 194 | |
eencae | 23:eb7e6632fc9e | 195 | /** Create a N5110 object connected to the specified pins (Vcc to +3V3) |
eencae | 23:eb7e6632fc9e | 196 | * |
eencae | 23:eb7e6632fc9e | 197 | * @param sce Pin connected to chip enable (pin 3) |
eencae | 23:eb7e6632fc9e | 198 | * @param rst Pin connected to reset (pin 4) |
eencae | 23:eb7e6632fc9e | 199 | * @param dc Pin connected to data/command select (pin 5) |
eencae | 23:eb7e6632fc9e | 200 | * @param mosi Pin connected to data input (MOSI) (pin 6) |
eencae | 23:eb7e6632fc9e | 201 | * @param sclk Pin connected to serial clock (SCLK) (pin 7) |
eencae | 23:eb7e6632fc9e | 202 | * @param led Pin connected to LED backlight (must be PWM) (pin 8) |
eencae | 23:eb7e6632fc9e | 203 | * |
eencae | 23:eb7e6632fc9e | 204 | */ |
eencae | 23:eb7e6632fc9e | 205 | N5110(PinName scePin, PinName rstPin, PinName dcPin, PinName mosiPin, PinName sclkPin, PinName ledPin); |
eencae | 17:780a542d5f8b | 206 | |
eencae | 23:eb7e6632fc9e | 207 | /** Initialise display |
eencae | 23:eb7e6632fc9e | 208 | * |
eencae | 23:eb7e6632fc9e | 209 | * Powers up the display and turns on backlight (50% brightness default). |
eencae | 23:eb7e6632fc9e | 210 | * Sets the display up in horizontal addressing mode and with normal video mode. |
eencae | 23:eb7e6632fc9e | 211 | */ |
eencae | 23:eb7e6632fc9e | 212 | void init(); |
eencae | 23:eb7e6632fc9e | 213 | |
eencae | 23:eb7e6632fc9e | 214 | /** Turn off |
eencae | 23:eb7e6632fc9e | 215 | * |
eencae | 23:eb7e6632fc9e | 216 | * Powers down the display and turns of the backlight. |
eencae | 23:eb7e6632fc9e | 217 | * Needs to be reinitialised before being re-used. |
eencae | 23:eb7e6632fc9e | 218 | */ |
eencae | 23:eb7e6632fc9e | 219 | void turnOff(); |
eencae | 17:780a542d5f8b | 220 | |
eencae | 24:342bdb6679a1 | 221 | /** Clear |
eencae | 23:eb7e6632fc9e | 222 | * |
eencae | 24:342bdb6679a1 | 223 | * Clears the screen buffer. |
eencae | 23:eb7e6632fc9e | 224 | */ |
eencae | 23:eb7e6632fc9e | 225 | void clear(); |
eencae | 17:780a542d5f8b | 226 | |
eencae | 23:eb7e6632fc9e | 227 | /** Turn on normal video mode (default) |
eencae | 23:eb7e6632fc9e | 228 | * Black on white |
eencae | 23:eb7e6632fc9e | 229 | */ |
eencae | 23:eb7e6632fc9e | 230 | void normalMode(); |
eencae | 17:780a542d5f8b | 231 | |
eencae | 23:eb7e6632fc9e | 232 | /** Turn on inverse video mode (default) |
eencae | 23:eb7e6632fc9e | 233 | * White on black |
eencae | 23:eb7e6632fc9e | 234 | */ |
eencae | 23:eb7e6632fc9e | 235 | void inverseMode(); |
eencae | 17:780a542d5f8b | 236 | |
eencae | 23:eb7e6632fc9e | 237 | /** Set Brightness |
eencae | 23:eb7e6632fc9e | 238 | * |
eencae | 23:eb7e6632fc9e | 239 | * Sets brightness of LED backlight. |
eencae | 23:eb7e6632fc9e | 240 | * @param brightness - float in range 0.0 to 1.0 |
eencae | 23:eb7e6632fc9e | 241 | */ |
eencae | 23:eb7e6632fc9e | 242 | void setBrightness(float brightness); |
eencae | 17:780a542d5f8b | 243 | |
eencae | 23:eb7e6632fc9e | 244 | /** Print String |
eencae | 23:eb7e6632fc9e | 245 | * |
eencae | 24:342bdb6679a1 | 246 | * Prints a string of characters to the screen buffer. String is cut-off after the 83rd pixel. |
eencae | 23:eb7e6632fc9e | 247 | * @param x - the column number (0 to 83) |
eencae | 23:eb7e6632fc9e | 248 | * @param y - the row number (0 to 5) - the display is split into 6 banks - each bank can be considered a row |
eencae | 23:eb7e6632fc9e | 249 | */ |
eencae | 23:eb7e6632fc9e | 250 | void printString(const char * str,int x,int y); |
eencae | 17:780a542d5f8b | 251 | |
eencae | 23:eb7e6632fc9e | 252 | /** Print Character |
eencae | 23:eb7e6632fc9e | 253 | * |
eencae | 24:342bdb6679a1 | 254 | * Sends a character to the screen buffer. Printed at the specified location. Character is cut-off after the 83rd pixel. |
eencae | 23:eb7e6632fc9e | 255 | * @param c - the character to print. Can print ASCII as so printChar('C'). |
eencae | 23:eb7e6632fc9e | 256 | * @param x - the column number (0 to 83) |
eencae | 23:eb7e6632fc9e | 257 | * @param y - the row number (0 to 5) - the display is split into 6 banks - each bank can be considered a row |
eencae | 23:eb7e6632fc9e | 258 | */ |
eencae | 23:eb7e6632fc9e | 259 | void printChar(char c,int x,int y); |
eencae | 17:780a542d5f8b | 260 | |
eencae | 23:eb7e6632fc9e | 261 | /** Set a Pixel |
eencae | 23:eb7e6632fc9e | 262 | * |
eencae | 24:342bdb6679a1 | 263 | * This function sets a pixel in the screen buffer. |
eencae | 23:eb7e6632fc9e | 264 | * @param x - the x co-ordinate of the pixel (0 to 83) |
eencae | 23:eb7e6632fc9e | 265 | * @param y - the y co-ordinate of the pixel (0 to 47) |
eencae | 23:eb7e6632fc9e | 266 | */ |
eencae | 23:eb7e6632fc9e | 267 | void setPixel(int x, int y); |
eencae | 17:780a542d5f8b | 268 | |
eencae | 23:eb7e6632fc9e | 269 | /** Clear a Pixel |
eencae | 23:eb7e6632fc9e | 270 | * |
eencae | 24:342bdb6679a1 | 271 | * This function clears pixel in the screen buffer |
eencae | 23:eb7e6632fc9e | 272 | * @param x - the x co-ordinate of the pixel (0 to 83) |
eencae | 23:eb7e6632fc9e | 273 | * @param y - the y co-ordinate of the pixel (0 to 47) |
eencae | 23:eb7e6632fc9e | 274 | */ |
eencae | 23:eb7e6632fc9e | 275 | void clearPixel(int x, int y); |
eencae | 17:780a542d5f8b | 276 | |
eencae | 23:eb7e6632fc9e | 277 | /** Get a Pixel |
eencae | 23:eb7e6632fc9e | 278 | * |
eencae | 24:342bdb6679a1 | 279 | * This function gets the status of a pixel in the screen buffer. |
eencae | 23:eb7e6632fc9e | 280 | * @param x - the x co-ordinate of the pixel (0 to 83) |
eencae | 23:eb7e6632fc9e | 281 | * @param y - the y co-ordinate of the pixel (0 to 47) |
eencae | 23:eb7e6632fc9e | 282 | * @returns |
eencae | 23:eb7e6632fc9e | 283 | * 0 - pixel is clear |
eencae | 24:342bdb6679a1 | 284 | * 1 - pixel is set |
eencae | 23:eb7e6632fc9e | 285 | */ |
eencae | 23:eb7e6632fc9e | 286 | int getPixel(int x, int y); |
eencae | 17:780a542d5f8b | 287 | |
eencae | 23:eb7e6632fc9e | 288 | /** Refresh display |
eencae | 23:eb7e6632fc9e | 289 | * |
eencae | 24:342bdb6679a1 | 290 | * This functions sends the screen buffer to the display. |
eencae | 23:eb7e6632fc9e | 291 | */ |
eencae | 23:eb7e6632fc9e | 292 | void refresh(); |
eencae | 17:780a542d5f8b | 293 | |
eencae | 23:eb7e6632fc9e | 294 | /** Randomise buffer |
eencae | 23:eb7e6632fc9e | 295 | * |
eencae | 23:eb7e6632fc9e | 296 | * This function fills the buffer with random data. Can be used to test the display. |
eencae | 23:eb7e6632fc9e | 297 | * A call to refresh() must be made to update the display to reflect the change in pixels. |
eencae | 23:eb7e6632fc9e | 298 | * The seed is not set and so the generated pattern will probably be the same each time. |
eencae | 23:eb7e6632fc9e | 299 | * TODO: Randomise the seed - maybe using the noise on the AnalogIn pins. |
eencae | 23:eb7e6632fc9e | 300 | */ |
eencae | 23:eb7e6632fc9e | 301 | void randomiseBuffer(); |
eencae | 17:780a542d5f8b | 302 | |
eencae | 23:eb7e6632fc9e | 303 | /** Plot Array |
eencae | 23:eb7e6632fc9e | 304 | * |
eencae | 24:342bdb6679a1 | 305 | * This function plots a one-dimensional array in the buffer. |
eencae | 23:eb7e6632fc9e | 306 | * @param array[] - y values of the plot. Values should be normalised in the range 0.0 to 1.0. First 84 plotted. |
eencae | 23:eb7e6632fc9e | 307 | */ |
eencae | 23:eb7e6632fc9e | 308 | void plotArray(float array[]); |
eencae | 1:df68f34cd32d | 309 | |
eencae | 23:eb7e6632fc9e | 310 | /** Draw Circle |
eencae | 23:eb7e6632fc9e | 311 | * |
eencae | 24:342bdb6679a1 | 312 | * This function draws a circle at the specified origin with specified radius in the screen buffer |
eencae | 23:eb7e6632fc9e | 313 | * Uses the midpoint circle algorithm. |
eencae | 23:eb7e6632fc9e | 314 | * @see http://en.wikipedia.org/wiki/Midpoint_circle_algorithm |
eencae | 23:eb7e6632fc9e | 315 | * @param x0 - x-coordinate of centre |
eencae | 23:eb7e6632fc9e | 316 | * @param y0 - y-coordinate of centre |
eencae | 23:eb7e6632fc9e | 317 | * @param radius - radius of circle in pixels |
eencae | 23:eb7e6632fc9e | 318 | * @param fill - 0 transparent (w/outline), 1 filled black, 2 filled white (wo/outline) |
eencae | 23:eb7e6632fc9e | 319 | */ |
eencae | 23:eb7e6632fc9e | 320 | void drawCircle(int x0,int y0,int radius,int fill); |
eencae | 17:780a542d5f8b | 321 | |
eencae | 23:eb7e6632fc9e | 322 | /** Draw Line |
eencae | 23:eb7e6632fc9e | 323 | * |
eencae | 23:eb7e6632fc9e | 324 | * This function draws a line between the specified points using linear interpolation. |
eencae | 23:eb7e6632fc9e | 325 | * @param x0 - x-coordinate of first point |
eencae | 23:eb7e6632fc9e | 326 | * @param y0 - y-coordinate of first point |
eencae | 23:eb7e6632fc9e | 327 | * @param x1 - x-coordinate of last point |
eencae | 23:eb7e6632fc9e | 328 | * @param y1 - y-coordinate of last point |
eencae | 23:eb7e6632fc9e | 329 | * @param type - 0 white,1 black,2 dotted |
eencae | 23:eb7e6632fc9e | 330 | */ |
eencae | 23:eb7e6632fc9e | 331 | void drawLine(int x0,int y0,int x1,int y1,int type); |
eencae | 17:780a542d5f8b | 332 | |
eencae | 23:eb7e6632fc9e | 333 | /** Draw Rectangle |
eencae | 23:eb7e6632fc9e | 334 | * |
eencae | 23:eb7e6632fc9e | 335 | * This function draws a rectangle. |
eencae | 23:eb7e6632fc9e | 336 | * @param x0 - x-coordinate of origin (top-left) |
eencae | 23:eb7e6632fc9e | 337 | * @param y0 - y-coordinate of origin (top-left) |
eencae | 23:eb7e6632fc9e | 338 | * @param width - width of rectangle |
eencae | 23:eb7e6632fc9e | 339 | * @param height - height of rectangle |
eencae | 23:eb7e6632fc9e | 340 | * @param fill - 0 transparent (w/outline), 1 filled black, 2 filled white (wo/outline) |
eencae | 23:eb7e6632fc9e | 341 | */ |
eencae | 23:eb7e6632fc9e | 342 | void drawRect(int x0,int y0,int width,int height,int fill); |
eencae | 17:780a542d5f8b | 343 | |
eencae | 1:df68f34cd32d | 344 | private: |
eencae | 13:908644099648 | 345 | |
eencae | 24:342bdb6679a1 | 346 | // objects |
eencae | 23:eb7e6632fc9e | 347 | SPI* spi; |
eencae | 23:eb7e6632fc9e | 348 | PwmOut* led; |
eencae | 23:eb7e6632fc9e | 349 | DigitalOut* pwr; |
eencae | 23:eb7e6632fc9e | 350 | DigitalOut* sce; |
eencae | 23:eb7e6632fc9e | 351 | DigitalOut* rst; |
eencae | 23:eb7e6632fc9e | 352 | DigitalOut* dc; |
eencae | 0:d563e74f0ae9 | 353 | |
eencae | 24:342bdb6679a1 | 354 | // methods |
eencae | 24:342bdb6679a1 | 355 | void setXYAddress(int x, int y); |
eencae | 24:342bdb6679a1 | 356 | void initSPI(); |
eencae | 24:342bdb6679a1 | 357 | void turnOn(); |
eencae | 24:342bdb6679a1 | 358 | void reset(); |
eencae | 24:342bdb6679a1 | 359 | void clearRAM(); |
eencae | 24:342bdb6679a1 | 360 | void sendCommand(unsigned char command); |
eencae | 24:342bdb6679a1 | 361 | void sendData(unsigned char data); |
eencae | 24:342bdb6679a1 | 362 | |
eencae | 24:342bdb6679a1 | 363 | // variables |
eencae | 24:342bdb6679a1 | 364 | unsigned char buffer[84][6]; // screen buffer - the 6 is for the banks - each one is 8 bits; |
eencae | 24:342bdb6679a1 | 365 | |
eencae | 0:d563e74f0ae9 | 366 | }; |
eencae | 0:d563e74f0ae9 | 367 | |
eencae | 0:d563e74f0ae9 | 368 | const unsigned char font5x7[480] = { |
eencae | 23:eb7e6632fc9e | 369 | 0x00, 0x00, 0x00, 0x00, 0x00,// (space) |
eencae | 23:eb7e6632fc9e | 370 | 0x00, 0x00, 0x5F, 0x00, 0x00,// ! |
eencae | 23:eb7e6632fc9e | 371 | 0x00, 0x07, 0x00, 0x07, 0x00,// " |
eencae | 23:eb7e6632fc9e | 372 | 0x14, 0x7F, 0x14, 0x7F, 0x14,// # |
eencae | 23:eb7e6632fc9e | 373 | 0x24, 0x2A, 0x7F, 0x2A, 0x12,// $ |
eencae | 23:eb7e6632fc9e | 374 | 0x23, 0x13, 0x08, 0x64, 0x62,// % |
eencae | 23:eb7e6632fc9e | 375 | 0x36, 0x49, 0x55, 0x22, 0x50,// & |
eencae | 23:eb7e6632fc9e | 376 | 0x00, 0x05, 0x03, 0x00, 0x00,// ' |
eencae | 23:eb7e6632fc9e | 377 | 0x00, 0x1C, 0x22, 0x41, 0x00,// ( |
eencae | 23:eb7e6632fc9e | 378 | 0x00, 0x41, 0x22, 0x1C, 0x00,// ) |
eencae | 23:eb7e6632fc9e | 379 | 0x08, 0x2A, 0x1C, 0x2A, 0x08,// * |
eencae | 23:eb7e6632fc9e | 380 | 0x08, 0x08, 0x3E, 0x08, 0x08,// + |
eencae | 23:eb7e6632fc9e | 381 | 0x00, 0x50, 0x30, 0x00, 0x00,// , |
eencae | 23:eb7e6632fc9e | 382 | 0x08, 0x08, 0x08, 0x08, 0x08,// - |
eencae | 23:eb7e6632fc9e | 383 | 0x00, 0x60, 0x60, 0x00, 0x00,// . |
eencae | 23:eb7e6632fc9e | 384 | 0x20, 0x10, 0x08, 0x04, 0x02,// / |
eencae | 23:eb7e6632fc9e | 385 | 0x3E, 0x51, 0x49, 0x45, 0x3E,// 0 |
eencae | 23:eb7e6632fc9e | 386 | 0x00, 0x42, 0x7F, 0x40, 0x00,// 1 |
eencae | 23:eb7e6632fc9e | 387 | 0x42, 0x61, 0x51, 0x49, 0x46,// 2 |
eencae | 23:eb7e6632fc9e | 388 | 0x21, 0x41, 0x45, 0x4B, 0x31,// 3 |
eencae | 23:eb7e6632fc9e | 389 | 0x18, 0x14, 0x12, 0x7F, 0x10,// 4 |
eencae | 23:eb7e6632fc9e | 390 | 0x27, 0x45, 0x45, 0x45, 0x39,// 5 |
eencae | 23:eb7e6632fc9e | 391 | 0x3C, 0x4A, 0x49, 0x49, 0x30,// 6 |
eencae | 23:eb7e6632fc9e | 392 | 0x01, 0x71, 0x09, 0x05, 0x03,// 7 |
eencae | 23:eb7e6632fc9e | 393 | 0x36, 0x49, 0x49, 0x49, 0x36,// 8 |
eencae | 23:eb7e6632fc9e | 394 | 0x06, 0x49, 0x49, 0x29, 0x1E,// 9 |
eencae | 23:eb7e6632fc9e | 395 | 0x00, 0x36, 0x36, 0x00, 0x00,// : |
eencae | 23:eb7e6632fc9e | 396 | 0x00, 0x56, 0x36, 0x00, 0x00,// ; |
eencae | 23:eb7e6632fc9e | 397 | 0x00, 0x08, 0x14, 0x22, 0x41,// < |
eencae | 23:eb7e6632fc9e | 398 | 0x14, 0x14, 0x14, 0x14, 0x14,// = |
eencae | 23:eb7e6632fc9e | 399 | 0x41, 0x22, 0x14, 0x08, 0x00,// > |
eencae | 23:eb7e6632fc9e | 400 | 0x02, 0x01, 0x51, 0x09, 0x06,// ? |
eencae | 23:eb7e6632fc9e | 401 | 0x32, 0x49, 0x79, 0x41, 0x3E,// @ |
eencae | 23:eb7e6632fc9e | 402 | 0x7E, 0x11, 0x11, 0x11, 0x7E,// A |
eencae | 23:eb7e6632fc9e | 403 | 0x7F, 0x49, 0x49, 0x49, 0x36,// B |
eencae | 23:eb7e6632fc9e | 404 | 0x3E, 0x41, 0x41, 0x41, 0x22,// C |
eencae | 23:eb7e6632fc9e | 405 | 0x7F, 0x41, 0x41, 0x22, 0x1C,// D |
eencae | 23:eb7e6632fc9e | 406 | 0x7F, 0x49, 0x49, 0x49, 0x41,// E |
eencae | 23:eb7e6632fc9e | 407 | 0x7F, 0x09, 0x09, 0x01, 0x01,// F |
eencae | 23:eb7e6632fc9e | 408 | 0x3E, 0x41, 0x41, 0x51, 0x32,// G |
eencae | 23:eb7e6632fc9e | 409 | 0x7F, 0x08, 0x08, 0x08, 0x7F,// H |
eencae | 23:eb7e6632fc9e | 410 | 0x00, 0x41, 0x7F, 0x41, 0x00,// I |
eencae | 23:eb7e6632fc9e | 411 | 0x20, 0x40, 0x41, 0x3F, 0x01,// J |
eencae | 23:eb7e6632fc9e | 412 | 0x7F, 0x08, 0x14, 0x22, 0x41,// K |
eencae | 23:eb7e6632fc9e | 413 | 0x7F, 0x40, 0x40, 0x40, 0x40,// L |
eencae | 23:eb7e6632fc9e | 414 | 0x7F, 0x02, 0x04, 0x02, 0x7F,// M |
eencae | 23:eb7e6632fc9e | 415 | 0x7F, 0x04, 0x08, 0x10, 0x7F,// N |
eencae | 23:eb7e6632fc9e | 416 | 0x3E, 0x41, 0x41, 0x41, 0x3E,// O |
eencae | 23:eb7e6632fc9e | 417 | 0x7F, 0x09, 0x09, 0x09, 0x06,// P |
eencae | 23:eb7e6632fc9e | 418 | 0x3E, 0x41, 0x51, 0x21, 0x5E,// Q |
eencae | 23:eb7e6632fc9e | 419 | 0x7F, 0x09, 0x19, 0x29, 0x46,// R |
eencae | 23:eb7e6632fc9e | 420 | 0x46, 0x49, 0x49, 0x49, 0x31,// S |
eencae | 23:eb7e6632fc9e | 421 | 0x01, 0x01, 0x7F, 0x01, 0x01,// T |
eencae | 23:eb7e6632fc9e | 422 | 0x3F, 0x40, 0x40, 0x40, 0x3F,// U |
eencae | 23:eb7e6632fc9e | 423 | 0x1F, 0x20, 0x40, 0x20, 0x1F,// V |
eencae | 23:eb7e6632fc9e | 424 | 0x7F, 0x20, 0x18, 0x20, 0x7F,// W |
eencae | 23:eb7e6632fc9e | 425 | 0x63, 0x14, 0x08, 0x14, 0x63,// X |
eencae | 23:eb7e6632fc9e | 426 | 0x03, 0x04, 0x78, 0x04, 0x03,// Y |
eencae | 23:eb7e6632fc9e | 427 | 0x61, 0x51, 0x49, 0x45, 0x43,// Z |
eencae | 23:eb7e6632fc9e | 428 | 0x00, 0x00, 0x7F, 0x41, 0x41,// [ |
eencae | 23:eb7e6632fc9e | 429 | 0x02, 0x04, 0x08, 0x10, 0x20,// "\" |
eencae | 23:eb7e6632fc9e | 430 | 0x41, 0x41, 0x7F, 0x00, 0x00,// ] |
eencae | 23:eb7e6632fc9e | 431 | 0x04, 0x02, 0x01, 0x02, 0x04,// ^ |
eencae | 23:eb7e6632fc9e | 432 | 0x40, 0x40, 0x40, 0x40, 0x40,// _ |
eencae | 23:eb7e6632fc9e | 433 | 0x00, 0x01, 0x02, 0x04, 0x00,// ` |
eencae | 23:eb7e6632fc9e | 434 | 0x20, 0x54, 0x54, 0x54, 0x78,// a |
eencae | 23:eb7e6632fc9e | 435 | 0x7F, 0x48, 0x44, 0x44, 0x38,// b |
eencae | 23:eb7e6632fc9e | 436 | 0x38, 0x44, 0x44, 0x44, 0x20,// c |
eencae | 23:eb7e6632fc9e | 437 | 0x38, 0x44, 0x44, 0x48, 0x7F,// d |
eencae | 23:eb7e6632fc9e | 438 | 0x38, 0x54, 0x54, 0x54, 0x18,// e |
eencae | 23:eb7e6632fc9e | 439 | 0x08, 0x7E, 0x09, 0x01, 0x02,// f |
eencae | 23:eb7e6632fc9e | 440 | 0x08, 0x14, 0x54, 0x54, 0x3C,// g |
eencae | 23:eb7e6632fc9e | 441 | 0x7F, 0x08, 0x04, 0x04, 0x78,// h |
eencae | 23:eb7e6632fc9e | 442 | 0x00, 0x44, 0x7D, 0x40, 0x00,// i |
eencae | 23:eb7e6632fc9e | 443 | 0x20, 0x40, 0x44, 0x3D, 0x00,// j |
eencae | 23:eb7e6632fc9e | 444 | 0x00, 0x7F, 0x10, 0x28, 0x44,// k |
eencae | 23:eb7e6632fc9e | 445 | 0x00, 0x41, 0x7F, 0x40, 0x00,// l |
eencae | 23:eb7e6632fc9e | 446 | 0x7C, 0x04, 0x18, 0x04, 0x78,// m |
eencae | 23:eb7e6632fc9e | 447 | 0x7C, 0x08, 0x04, 0x04, 0x78,// n |
eencae | 23:eb7e6632fc9e | 448 | 0x38, 0x44, 0x44, 0x44, 0x38,// o |
eencae | 23:eb7e6632fc9e | 449 | 0x7C, 0x14, 0x14, 0x14, 0x08,// p |
eencae | 23:eb7e6632fc9e | 450 | 0x08, 0x14, 0x14, 0x18, 0x7C,// q |
eencae | 23:eb7e6632fc9e | 451 | 0x7C, 0x08, 0x04, 0x04, 0x08,// r |
eencae | 23:eb7e6632fc9e | 452 | 0x48, 0x54, 0x54, 0x54, 0x20,// s |
eencae | 23:eb7e6632fc9e | 453 | 0x04, 0x3F, 0x44, 0x40, 0x20,// t |
eencae | 23:eb7e6632fc9e | 454 | 0x3C, 0x40, 0x40, 0x20, 0x7C,// u |
eencae | 23:eb7e6632fc9e | 455 | 0x1C, 0x20, 0x40, 0x20, 0x1C,// v |
eencae | 23:eb7e6632fc9e | 456 | 0x3C, 0x40, 0x30, 0x40, 0x3C,// w |
eencae | 23:eb7e6632fc9e | 457 | 0x44, 0x28, 0x10, 0x28, 0x44,// x |
eencae | 23:eb7e6632fc9e | 458 | 0x0C, 0x50, 0x50, 0x50, 0x3C,// y |
eencae | 23:eb7e6632fc9e | 459 | 0x44, 0x64, 0x54, 0x4C, 0x44,// z |
eencae | 23:eb7e6632fc9e | 460 | 0x00, 0x08, 0x36, 0x41, 0x00,// { |
eencae | 23:eb7e6632fc9e | 461 | 0x00, 0x00, 0x7F, 0x00, 0x00,// | |
eencae | 23:eb7e6632fc9e | 462 | 0x00, 0x41, 0x36, 0x08, 0x00,// } |
eencae | 23:eb7e6632fc9e | 463 | 0x08, 0x08, 0x2A, 0x1C, 0x08,// -> |
eencae | 23:eb7e6632fc9e | 464 | 0x08, 0x1C, 0x2A, 0x08, 0x08 // <- |
eencae | 0:d563e74f0ae9 | 465 | }; |
eencae | 0:d563e74f0ae9 | 466 | |
eencae | 14:520a02fc12aa | 467 | #endif |