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
- Committer:
- dreschpe
- Date:
- 2015-10-18
- Revision:
- 25:daacdcf34e52
- Parent:
- 21:ae0a4eedfc90
- Child:
- 27:acb2594b8aa4
File content as of revision 25:daacdcf34e52:
#ifndef MBED_TFT932x_H #define MBED_TFT932x_H #include "GraphicsDisplay.h" #if DEVICE_PORTINOUT #include "PAR8.h" #include "PAR16.h" #endif #include "BUS8.h" #include "BUS16.h" #include "SPI8.h" #include "SPI16.h" #include "Protocols.h" /** A custom base class for ILI932x color TFT Display (except ILI9327 which is MIPI standard) */ class TFT932x : public GraphicsDisplay { public: #if DEVICE_PORTINOUT /** Create TFT Parallel Port interface * @param name The name used by the parent class to access the interface */ 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); #endif /** Create TFT Parallel Bus interface * @param name The name used by the parent class to access the interface */ 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); /** Create TFT SPI interface * @note ILI9325D has different SPI protocol, not supported here * @param name The name used by the parent class to access the interface */ 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); /////// functions that come for free, but can be overwritten/////////////////////////////////////////////////// /////// ----------------------------------------------------/////////////////////////////////////////////////// /** Draw a pixel in the specified color. * @param x is the horizontal offset to this pixel. * @param y is the vertical offset to this pixel. * @param color defines the color for the pixel. */ virtual void pixel(int x, int y, unsigned short color); /** Set the window, which controls where items are written to the screen. * When something hits the window width, it wraps back to the left side * and down a row. If the initial write is outside the window, it will * be captured into the window when it crosses a boundary. * @param x is the left edge in pixels. * @param y is the top edge in pixels. * @param w is the window width in pixels. * @param h is the window height in pixels. */ virtual void window(int x, int y, int w, int h); /** Read pixel color at location * @param x is the horizontal offset to this pixel. * @param y is the vertical offset to this pixel. * @returns 16bit color. */ virtual unsigned short pixelread(int x, int y); /** Set the window from which gram is read from. Autoincrements row/column * @param x is the left edge in pixels. * @param y is the top edge in pixels. * @param w is the window width in pixels. * @param h is the window height in pixels. */ virtual void window4read(int x, int y, int w, int h); /** Push a single pixel into the window and increment position. * You must first call window() then push pixels. * @param color is the pixel color. */ virtual void window_pushpixel(unsigned short color); /** Push some pixels of the same color into the window and increment position. * You must first call window() then push pixels. * @param color is the pixel color. * @param count: how many */ virtual void window_pushpixel(unsigned short color, unsigned int count); /** Push array of pixel colors into the window and increment position. * You must first call window() then push pixels. * @param color is the pixel color. */ virtual void window_pushpixelbuf(unsigned short* color, unsigned int lenght); /** Framebuffer is not used for TFT */ virtual void copy_to_lcd(){ }; /** display inverted colors * * @param o = 0 normal, 1 invert */ void invert(unsigned char o); /** clear the entire screen * The inherited one sets windomax then fill with background color * We override it to speedup */ virtual void cls(); /** Set the orientation of the screen * x,y: 0,0 is always top left * * @param o direction to use the screen (0-3) * 0 = default 0° portrait view * 1 = +90° landscape view * 2 = +180° portrait view * 3 = -90° landscape view * */ virtual void set_orientation(int o); /** Set ChipSelect high or low * @param enable true/false */ virtual void BusEnable(bool enable); /** Enable fast window (default disabled) * used to speedup functions that plots single pixels, like circle, oblique lines or just sparse pixels * @param enable true/false * @note most but not all controllers support this, even if datasheet tells they should */ void FastWindow(bool enable); /** Enable scroll * scroll is done in hw but only on the native vertical axis * TFTs are mainly native protrait view, so horizontal scroll if rotated in landscape view * @note ILI932x does not allow partial screen scrolling, only full screen is selectable * @param startY unused, always 0 for ILI932x * @param areasize unused, always screensize_Y for ILI932x */ void setscrollarea (int startY=0, int areasize=0); /** Scroll up(or left) the scrollarea * * @param lines number of lines to scroll, 1= scrollup 1, areasize-1= scrolldown 1 */ void scroll (int lines); /** Disable scroll and display un-scrolled screen * */ void scrollreset(); /** get display X size in pixels (native, orientation independent) * @returns X size in pixels */ int sizeX(); /** get display Y size in pixels (native, orientation independent) * @returns Y size in pixels */ int sizeY(); unsigned int tftID; protected: ////// functions needed by parent class /////////////////////////////////////// ////// -------------------------------- /////////////////////////////////////// /** ILI932x specific, does a dummy read cycle, number of bits is protocol dependent * for PAR protocols: a signle RD bit toggle * for SPI8: 8clocks * for SPI16: 16 clocks */ virtual void dummyread (); /** ILI932x specific, select register for a successive write or read * * @param reg register to be selected * @param forread false = a write next (default), true = a read next * @note forread only used by SPI protocols */ virtual void reg_select(unsigned char reg, bool forread =false); /** ILI932x specific, write register with data * * @param reg register to write * @param data 16bit data */ virtual void reg_write(unsigned char reg, unsigned short data); /** ILI932x specific, read register * * @param reg register to be read * @returns 16bit register value */ virtual unsigned short reg_read(unsigned char reg); /** Send 16bit pixeldata to display controller * * @param data: halfword to send * */ virtual void wr_gram(unsigned short data); /** Send same 16bit pixeldata to display controller multiple times * * @param data: halfword to send * @param count: how many * */ virtual void wr_gram(unsigned short data, unsigned int count); /** Send array of pixeldata shorts to display controller * * @param data: unsigned short pixeldata array * @param lenght: lenght (in shorts) * */ virtual void wr_grambuf(unsigned short* data, unsigned int lenght); /** Read 16bit pixeldata from display controller (with dummy cycle) * * @note autoconverts 18to16bit based on display identify info * @returns 16bit color */ virtual unsigned short rd_gram(); /** HW reset sequence (without display init commands) */ void hw_reset(); /** Try to get read gram pixel format, could be 16bit or 18bit, RGB or BGR * autoset internal flags so pixelread() will always return correct value. */ virtual void auto_gram_read_format(); /** Try to identify display ID * @note support ILI9341,94xx, MIPI standard. May be be overridden in Init class for other specific IC */ virtual void identify(); unsigned int scrollbugfix; private: Protocols* proto; const int screensize_X; const int screensize_Y; // pixel location int cur_x; int cur_y; // window location int win_x1; int win_x2; int win_y1; int win_y2; int orientation; bool dummycycles; bool usefastwindow; bool fastwindowready; bool fastwindowready4read; bool is18bit; bool isBGR; }; #endif