UniGraphic-Fork for ST7920-LCD-controller and SH1106. Tested with 128x64 LCD with SPI and 128x64-OLED with IIC
Dependents: UniGraphic-St7920-Test AfficheurUTILECO
Fork of UniGraphic by
Fork of the UniGraphic-Library for monochrome LCDs with ST7920 controller and 128x64-IIC-OLED-Display with SH1106-Controller
Had to adapt LCD for following reasons:
- Give access to screenbuffer buffer[] to parent class
- pixel() and pixel_read() as they are hardware-dependent
- added reset-pin to IIC-Interface
GraphicDisplay:: sends buffer to LCD when auto_update is set to true.
Testprogram for ST7920 can be found here:
https://developer.mbed.org/users/charly/code/UniGraphic-St7920-Test/
Display/TFT932x.h@21:ae0a4eedfc90, 2015-03-31 (annotated)
- Committer:
- Geremia
- Date:
- Tue Mar 31 21:14:48 2015 +0000
- Revision:
- 21:ae0a4eedfc90
- Parent:
- 20:14daa48ffd4c
- Child:
- 25:daacdcf34e52
Add BUS_8 and BUS_16 (slow as expected)
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
Geremia | 20:14daa48ffd4c | 1 | #ifndef MBED_TFT932x_H |
Geremia | 20:14daa48ffd4c | 2 | #define MBED_TFT932x_H |
Geremia | 20:14daa48ffd4c | 3 | |
Geremia | 20:14daa48ffd4c | 4 | #include "GraphicsDisplay.h" |
Geremia | 20:14daa48ffd4c | 5 | #include "PAR8.h" |
Geremia | 20:14daa48ffd4c | 6 | #include "PAR16.h" |
Geremia | 21:ae0a4eedfc90 | 7 | #include "BUS8.h" |
Geremia | 21:ae0a4eedfc90 | 8 | #include "BUS16.h" |
Geremia | 20:14daa48ffd4c | 9 | #include "SPI8.h" |
Geremia | 20:14daa48ffd4c | 10 | #include "SPI16.h" |
Geremia | 20:14daa48ffd4c | 11 | #include "Protocols.h" |
Geremia | 20:14daa48ffd4c | 12 | |
Geremia | 20:14daa48ffd4c | 13 | |
Geremia | 20:14daa48ffd4c | 14 | /** A custom base class for ILI932x color TFT Display (except ILI9327 which is MIPI standard) |
Geremia | 20:14daa48ffd4c | 15 | */ |
Geremia | 20:14daa48ffd4c | 16 | class TFT932x : public GraphicsDisplay |
Geremia | 20:14daa48ffd4c | 17 | { |
Geremia | 20:14daa48ffd4c | 18 | |
Geremia | 20:14daa48ffd4c | 19 | public: |
Geremia | 20:14daa48ffd4c | 20 | |
Geremia | 21:ae0a4eedfc90 | 21 | /** Create TFT Parallel Port interface |
Geremia | 20:14daa48ffd4c | 22 | * @param name The name used by the parent class to access the interface |
Geremia | 20:14daa48ffd4c | 23 | */ |
Geremia | 21:ae0a4eedfc90 | 24 | TFT932x(proto_t displayproto, PortName port, PinName CS, PinName reset, PinName DC, PinName WR, PinName RD, const int lcdsize_x, const int lcdsize_y, const char* name); |
Geremia | 20:14daa48ffd4c | 25 | |
Geremia | 21:ae0a4eedfc90 | 26 | /** Create TFT Parallel Bus interface |
Geremia | 21:ae0a4eedfc90 | 27 | * @param name The name used by the parent class to access the interface |
Geremia | 21:ae0a4eedfc90 | 28 | */ |
Geremia | 21:ae0a4eedfc90 | 29 | TFT932x(proto_t displayproto, PinName* buspins, PinName CS, PinName reset, PinName DC, PinName WR, PinName RD, const int lcdsize_x, const int lcdsize_y, const char* name); |
Geremia | 21:ae0a4eedfc90 | 30 | |
Geremia | 21:ae0a4eedfc90 | 31 | /** Create TFT SPI interface |
Geremia | 20:14daa48ffd4c | 32 | * @note ILI9325D has different SPI protocol, not supported here |
Geremia | 20:14daa48ffd4c | 33 | * @param name The name used by the parent class to access the interface |
Geremia | 20:14daa48ffd4c | 34 | */ |
Geremia | 20:14daa48ffd4c | 35 | TFT932x(proto_t displayproto, int Hz, PinName mosi, PinName miso, PinName sclk, PinName CS, PinName reset, const int lcdsize_x, const int lcdsize_y, const char* name); |
Geremia | 20:14daa48ffd4c | 36 | |
Geremia | 20:14daa48ffd4c | 37 | /////// functions that come for free, but can be overwritten/////////////////////////////////////////////////// |
Geremia | 20:14daa48ffd4c | 38 | /////// ----------------------------------------------------/////////////////////////////////////////////////// |
Geremia | 20:14daa48ffd4c | 39 | |
Geremia | 20:14daa48ffd4c | 40 | /** Draw a pixel in the specified color. |
Geremia | 20:14daa48ffd4c | 41 | * @param x is the horizontal offset to this pixel. |
Geremia | 20:14daa48ffd4c | 42 | * @param y is the vertical offset to this pixel. |
Geremia | 20:14daa48ffd4c | 43 | * @param color defines the color for the pixel. |
Geremia | 20:14daa48ffd4c | 44 | */ |
Geremia | 20:14daa48ffd4c | 45 | virtual void pixel(int x, int y, unsigned short color); |
Geremia | 20:14daa48ffd4c | 46 | |
Geremia | 20:14daa48ffd4c | 47 | /** Set the window, which controls where items are written to the screen. |
Geremia | 20:14daa48ffd4c | 48 | * When something hits the window width, it wraps back to the left side |
Geremia | 20:14daa48ffd4c | 49 | * and down a row. If the initial write is outside the window, it will |
Geremia | 20:14daa48ffd4c | 50 | * be captured into the window when it crosses a boundary. |
Geremia | 20:14daa48ffd4c | 51 | * @param x is the left edge in pixels. |
Geremia | 20:14daa48ffd4c | 52 | * @param y is the top edge in pixels. |
Geremia | 20:14daa48ffd4c | 53 | * @param w is the window width in pixels. |
Geremia | 20:14daa48ffd4c | 54 | * @param h is the window height in pixels. |
Geremia | 20:14daa48ffd4c | 55 | */ |
Geremia | 20:14daa48ffd4c | 56 | virtual void window(int x, int y, int w, int h); |
Geremia | 20:14daa48ffd4c | 57 | |
Geremia | 20:14daa48ffd4c | 58 | /** Read pixel color at location |
Geremia | 20:14daa48ffd4c | 59 | * @param x is the horizontal offset to this pixel. |
Geremia | 20:14daa48ffd4c | 60 | * @param y is the vertical offset to this pixel. |
Geremia | 20:14daa48ffd4c | 61 | * @returns 16bit color. |
Geremia | 20:14daa48ffd4c | 62 | */ |
Geremia | 20:14daa48ffd4c | 63 | virtual unsigned short pixelread(int x, int y); |
Geremia | 20:14daa48ffd4c | 64 | |
Geremia | 20:14daa48ffd4c | 65 | /** Set the window from which gram is read from. Autoincrements row/column |
Geremia | 20:14daa48ffd4c | 66 | * @param x is the left edge in pixels. |
Geremia | 20:14daa48ffd4c | 67 | * @param y is the top edge in pixels. |
Geremia | 20:14daa48ffd4c | 68 | * @param w is the window width in pixels. |
Geremia | 20:14daa48ffd4c | 69 | * @param h is the window height in pixels. |
Geremia | 20:14daa48ffd4c | 70 | */ |
Geremia | 20:14daa48ffd4c | 71 | virtual void window4read(int x, int y, int w, int h); |
Geremia | 20:14daa48ffd4c | 72 | |
Geremia | 20:14daa48ffd4c | 73 | /** Push a single pixel into the window and increment position. |
Geremia | 20:14daa48ffd4c | 74 | * You must first call window() then push pixels. |
Geremia | 20:14daa48ffd4c | 75 | * @param color is the pixel color. |
Geremia | 20:14daa48ffd4c | 76 | */ |
Geremia | 20:14daa48ffd4c | 77 | virtual void window_pushpixel(unsigned short color); |
Geremia | 20:14daa48ffd4c | 78 | |
Geremia | 20:14daa48ffd4c | 79 | /** Push some pixels of the same color into the window and increment position. |
Geremia | 20:14daa48ffd4c | 80 | * You must first call window() then push pixels. |
Geremia | 20:14daa48ffd4c | 81 | * @param color is the pixel color. |
Geremia | 20:14daa48ffd4c | 82 | * @param count: how many |
Geremia | 20:14daa48ffd4c | 83 | */ |
Geremia | 20:14daa48ffd4c | 84 | virtual void window_pushpixel(unsigned short color, unsigned int count); |
Geremia | 20:14daa48ffd4c | 85 | |
Geremia | 20:14daa48ffd4c | 86 | /** Push array of pixel colors into the window and increment position. |
Geremia | 20:14daa48ffd4c | 87 | * You must first call window() then push pixels. |
Geremia | 20:14daa48ffd4c | 88 | * @param color is the pixel color. |
Geremia | 20:14daa48ffd4c | 89 | */ |
Geremia | 20:14daa48ffd4c | 90 | virtual void window_pushpixelbuf(unsigned short* color, unsigned int lenght); |
Geremia | 20:14daa48ffd4c | 91 | |
Geremia | 20:14daa48ffd4c | 92 | /** Framebuffer is not used for TFT |
Geremia | 20:14daa48ffd4c | 93 | */ |
Geremia | 20:14daa48ffd4c | 94 | virtual void copy_to_lcd(){ }; |
Geremia | 20:14daa48ffd4c | 95 | |
Geremia | 20:14daa48ffd4c | 96 | /** display inverted colors |
Geremia | 20:14daa48ffd4c | 97 | * |
Geremia | 20:14daa48ffd4c | 98 | * @param o = 0 normal, 1 invert |
Geremia | 20:14daa48ffd4c | 99 | */ |
Geremia | 20:14daa48ffd4c | 100 | void invert(unsigned char o); |
Geremia | 20:14daa48ffd4c | 101 | |
Geremia | 20:14daa48ffd4c | 102 | /** clear the entire screen |
Geremia | 20:14daa48ffd4c | 103 | * The inherited one sets windomax then fill with background color |
Geremia | 20:14daa48ffd4c | 104 | * We override it to speedup |
Geremia | 20:14daa48ffd4c | 105 | */ |
Geremia | 20:14daa48ffd4c | 106 | virtual void cls(); |
Geremia | 20:14daa48ffd4c | 107 | |
Geremia | 20:14daa48ffd4c | 108 | /** Set the orientation of the screen |
Geremia | 20:14daa48ffd4c | 109 | * x,y: 0,0 is always top left |
Geremia | 20:14daa48ffd4c | 110 | * |
Geremia | 20:14daa48ffd4c | 111 | * @param o direction to use the screen (0-3) |
Geremia | 20:14daa48ffd4c | 112 | * 0 = default 0° portrait view |
Geremia | 20:14daa48ffd4c | 113 | * 1 = +90° landscape view |
Geremia | 20:14daa48ffd4c | 114 | * 2 = +180° portrait view |
Geremia | 20:14daa48ffd4c | 115 | * 3 = -90° landscape view |
Geremia | 20:14daa48ffd4c | 116 | * |
Geremia | 20:14daa48ffd4c | 117 | */ |
Geremia | 20:14daa48ffd4c | 118 | virtual void set_orientation(int o); |
Geremia | 20:14daa48ffd4c | 119 | |
Geremia | 20:14daa48ffd4c | 120 | /** Set ChipSelect high or low |
Geremia | 20:14daa48ffd4c | 121 | * @param enable true/false |
Geremia | 20:14daa48ffd4c | 122 | */ |
Geremia | 20:14daa48ffd4c | 123 | virtual void BusEnable(bool enable); |
Geremia | 20:14daa48ffd4c | 124 | |
Geremia | 20:14daa48ffd4c | 125 | /** Enable fast window (default disabled) |
Geremia | 20:14daa48ffd4c | 126 | * used to speedup functions that plots single pixels, like circle, oblique lines or just sparse pixels |
Geremia | 20:14daa48ffd4c | 127 | * @param enable true/false |
Geremia | 20:14daa48ffd4c | 128 | * @note most but not all controllers support this, even if datasheet tells they should |
Geremia | 20:14daa48ffd4c | 129 | */ |
Geremia | 20:14daa48ffd4c | 130 | void FastWindow(bool enable); |
Geremia | 20:14daa48ffd4c | 131 | |
Geremia | 20:14daa48ffd4c | 132 | /** Enable scroll |
Geremia | 20:14daa48ffd4c | 133 | * scroll is done in hw but only on the native vertical axis |
Geremia | 20:14daa48ffd4c | 134 | * TFTs are mainly native protrait view, so horizontal scroll if rotated in landscape view |
Geremia | 20:14daa48ffd4c | 135 | * @note ILI932x does not allow partial screen scrolling, only full screen is selectable |
Geremia | 20:14daa48ffd4c | 136 | * @param startY unused, always 0 for ILI932x |
Geremia | 20:14daa48ffd4c | 137 | * @param areasize unused, always screensize_Y for ILI932x |
Geremia | 20:14daa48ffd4c | 138 | */ |
Geremia | 20:14daa48ffd4c | 139 | void setscrollarea (int startY=0, int areasize=0); |
Geremia | 20:14daa48ffd4c | 140 | |
Geremia | 20:14daa48ffd4c | 141 | /** Scroll up(or left) the scrollarea |
Geremia | 20:14daa48ffd4c | 142 | * |
Geremia | 20:14daa48ffd4c | 143 | * @param lines number of lines to scroll, 1= scrollup 1, areasize-1= scrolldown 1 |
Geremia | 20:14daa48ffd4c | 144 | */ |
Geremia | 20:14daa48ffd4c | 145 | void scroll (int lines); |
Geremia | 20:14daa48ffd4c | 146 | |
Geremia | 20:14daa48ffd4c | 147 | /** Disable scroll and display un-scrolled screen |
Geremia | 20:14daa48ffd4c | 148 | * |
Geremia | 20:14daa48ffd4c | 149 | */ |
Geremia | 20:14daa48ffd4c | 150 | void scrollreset(); |
Geremia | 20:14daa48ffd4c | 151 | |
Geremia | 20:14daa48ffd4c | 152 | /** get display X size in pixels (native, orientation independent) |
Geremia | 20:14daa48ffd4c | 153 | * @returns X size in pixels |
Geremia | 20:14daa48ffd4c | 154 | */ |
Geremia | 20:14daa48ffd4c | 155 | int sizeX(); |
Geremia | 20:14daa48ffd4c | 156 | |
Geremia | 20:14daa48ffd4c | 157 | /** get display Y size in pixels (native, orientation independent) |
Geremia | 20:14daa48ffd4c | 158 | * @returns Y size in pixels |
Geremia | 20:14daa48ffd4c | 159 | */ |
Geremia | 20:14daa48ffd4c | 160 | int sizeY(); |
Geremia | 20:14daa48ffd4c | 161 | |
Geremia | 20:14daa48ffd4c | 162 | unsigned int tftID; |
Geremia | 20:14daa48ffd4c | 163 | |
Geremia | 20:14daa48ffd4c | 164 | |
Geremia | 20:14daa48ffd4c | 165 | |
Geremia | 20:14daa48ffd4c | 166 | |
Geremia | 20:14daa48ffd4c | 167 | protected: |
Geremia | 20:14daa48ffd4c | 168 | |
Geremia | 20:14daa48ffd4c | 169 | |
Geremia | 20:14daa48ffd4c | 170 | ////// functions needed by parent class /////////////////////////////////////// |
Geremia | 20:14daa48ffd4c | 171 | ////// -------------------------------- /////////////////////////////////////// |
Geremia | 20:14daa48ffd4c | 172 | |
Geremia | 20:14daa48ffd4c | 173 | /** ILI932x specific, does a dummy read cycle, number of bits is protocol dependent |
Geremia | 20:14daa48ffd4c | 174 | * for PAR protocols: a signle RD bit toggle |
Geremia | 20:14daa48ffd4c | 175 | * for SPI8: 8clocks |
Geremia | 20:14daa48ffd4c | 176 | * for SPI16: 16 clocks |
Geremia | 20:14daa48ffd4c | 177 | */ |
Geremia | 20:14daa48ffd4c | 178 | virtual void dummyread (); |
Geremia | 20:14daa48ffd4c | 179 | |
Geremia | 20:14daa48ffd4c | 180 | /** ILI932x specific, select register for a successive write or read |
Geremia | 20:14daa48ffd4c | 181 | * |
Geremia | 20:14daa48ffd4c | 182 | * @param reg register to be selected |
Geremia | 20:14daa48ffd4c | 183 | * @param forread false = a write next (default), true = a read next |
Geremia | 20:14daa48ffd4c | 184 | * @note forread only used by SPI protocols |
Geremia | 20:14daa48ffd4c | 185 | */ |
Geremia | 20:14daa48ffd4c | 186 | virtual void reg_select(unsigned char reg, bool forread =false); |
Geremia | 20:14daa48ffd4c | 187 | |
Geremia | 20:14daa48ffd4c | 188 | /** ILI932x specific, write register with data |
Geremia | 20:14daa48ffd4c | 189 | * |
Geremia | 20:14daa48ffd4c | 190 | * @param reg register to write |
Geremia | 20:14daa48ffd4c | 191 | * @param data 16bit data |
Geremia | 20:14daa48ffd4c | 192 | */ |
Geremia | 20:14daa48ffd4c | 193 | virtual void reg_write(unsigned char reg, unsigned short data); |
Geremia | 20:14daa48ffd4c | 194 | |
Geremia | 20:14daa48ffd4c | 195 | /** ILI932x specific, read register |
Geremia | 20:14daa48ffd4c | 196 | * |
Geremia | 20:14daa48ffd4c | 197 | * @param reg register to be read |
Geremia | 20:14daa48ffd4c | 198 | * @returns 16bit register value |
Geremia | 20:14daa48ffd4c | 199 | */ |
Geremia | 20:14daa48ffd4c | 200 | virtual unsigned short reg_read(unsigned char reg); |
Geremia | 20:14daa48ffd4c | 201 | |
Geremia | 20:14daa48ffd4c | 202 | /** Send 16bit pixeldata to display controller |
Geremia | 20:14daa48ffd4c | 203 | * |
Geremia | 20:14daa48ffd4c | 204 | * @param data: halfword to send |
Geremia | 20:14daa48ffd4c | 205 | * |
Geremia | 20:14daa48ffd4c | 206 | */ |
Geremia | 20:14daa48ffd4c | 207 | virtual void wr_gram(unsigned short data); |
Geremia | 20:14daa48ffd4c | 208 | |
Geremia | 20:14daa48ffd4c | 209 | /** Send same 16bit pixeldata to display controller multiple times |
Geremia | 20:14daa48ffd4c | 210 | * |
Geremia | 20:14daa48ffd4c | 211 | * @param data: halfword to send |
Geremia | 20:14daa48ffd4c | 212 | * @param count: how many |
Geremia | 20:14daa48ffd4c | 213 | * |
Geremia | 20:14daa48ffd4c | 214 | */ |
Geremia | 20:14daa48ffd4c | 215 | virtual void wr_gram(unsigned short data, unsigned int count); |
Geremia | 20:14daa48ffd4c | 216 | |
Geremia | 20:14daa48ffd4c | 217 | /** Send array of pixeldata shorts to display controller |
Geremia | 20:14daa48ffd4c | 218 | * |
Geremia | 20:14daa48ffd4c | 219 | * @param data: unsigned short pixeldata array |
Geremia | 20:14daa48ffd4c | 220 | * @param lenght: lenght (in shorts) |
Geremia | 20:14daa48ffd4c | 221 | * |
Geremia | 20:14daa48ffd4c | 222 | */ |
Geremia | 20:14daa48ffd4c | 223 | virtual void wr_grambuf(unsigned short* data, unsigned int lenght); |
Geremia | 20:14daa48ffd4c | 224 | |
Geremia | 20:14daa48ffd4c | 225 | /** Read 16bit pixeldata from display controller (with dummy cycle) |
Geremia | 20:14daa48ffd4c | 226 | * |
Geremia | 20:14daa48ffd4c | 227 | * @note autoconverts 18to16bit based on display identify info |
Geremia | 20:14daa48ffd4c | 228 | * @returns 16bit color |
Geremia | 20:14daa48ffd4c | 229 | */ |
Geremia | 20:14daa48ffd4c | 230 | virtual unsigned short rd_gram(); |
Geremia | 20:14daa48ffd4c | 231 | |
Geremia | 20:14daa48ffd4c | 232 | /** HW reset sequence (without display init commands) |
Geremia | 20:14daa48ffd4c | 233 | */ |
Geremia | 20:14daa48ffd4c | 234 | void hw_reset(); |
Geremia | 20:14daa48ffd4c | 235 | |
Geremia | 20:14daa48ffd4c | 236 | /** Try to get read gram pixel format, could be 16bit or 18bit, RGB or BGR |
Geremia | 20:14daa48ffd4c | 237 | * autoset internal flags so pixelread() will always return correct value. |
Geremia | 20:14daa48ffd4c | 238 | */ |
Geremia | 20:14daa48ffd4c | 239 | virtual void auto_gram_read_format(); |
Geremia | 20:14daa48ffd4c | 240 | |
Geremia | 20:14daa48ffd4c | 241 | /** Try to identify display ID |
Geremia | 20:14daa48ffd4c | 242 | * @note support ILI9341,94xx, MIPI standard. May be be overridden in Init class for other specific IC |
Geremia | 20:14daa48ffd4c | 243 | */ |
Geremia | 20:14daa48ffd4c | 244 | virtual void identify(); |
Geremia | 20:14daa48ffd4c | 245 | |
Geremia | 20:14daa48ffd4c | 246 | unsigned int scrollbugfix; |
Geremia | 20:14daa48ffd4c | 247 | |
Geremia | 20:14daa48ffd4c | 248 | |
Geremia | 20:14daa48ffd4c | 249 | |
Geremia | 20:14daa48ffd4c | 250 | private: |
Geremia | 20:14daa48ffd4c | 251 | |
Geremia | 20:14daa48ffd4c | 252 | Protocols* proto; |
Geremia | 20:14daa48ffd4c | 253 | const int screensize_X; |
Geremia | 20:14daa48ffd4c | 254 | const int screensize_Y; |
Geremia | 20:14daa48ffd4c | 255 | // pixel location |
Geremia | 20:14daa48ffd4c | 256 | int cur_x; |
Geremia | 20:14daa48ffd4c | 257 | int cur_y; |
Geremia | 20:14daa48ffd4c | 258 | // window location |
Geremia | 20:14daa48ffd4c | 259 | int win_x1; |
Geremia | 20:14daa48ffd4c | 260 | int win_x2; |
Geremia | 20:14daa48ffd4c | 261 | int win_y1; |
Geremia | 20:14daa48ffd4c | 262 | int win_y2; |
Geremia | 20:14daa48ffd4c | 263 | int orientation; |
Geremia | 20:14daa48ffd4c | 264 | bool dummycycles; |
Geremia | 20:14daa48ffd4c | 265 | bool usefastwindow; |
Geremia | 20:14daa48ffd4c | 266 | bool fastwindowready; |
Geremia | 20:14daa48ffd4c | 267 | bool fastwindowready4read; |
Geremia | 20:14daa48ffd4c | 268 | bool is18bit; |
Geremia | 20:14daa48ffd4c | 269 | bool isBGR; |
Geremia | 20:14daa48ffd4c | 270 | |
Geremia | 20:14daa48ffd4c | 271 | }; |
Geremia | 20:14daa48ffd4c | 272 | |
Geremia | 20:14daa48ffd4c | 273 | #endif |