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