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/TFT.h
- Committer:
- Geremia
- Date:
- 2015-02-19
- Revision:
- 10:668cf78ff93a
- Parent:
- 8:26757296c79d
- Child:
- 11:b842b8e332cb
File content as of revision 10:668cf78ff93a:
#ifndef MBED_TFT_H #define MBED_TFT_H #include "GraphicsDisplay.h" #include "PAR8.h" #include "PAR16.h" #include "SPI8.h" #include "SPI16.h" #include "Protocols.h" /** A common base class for color TFT Display */ class TFT : public GraphicsDisplay { public: /** Create a monochrome LCD Parallel interface * @param name The name used by the parent class to access the interface */ TFT(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); /** Create a monochrome LCD SPI interface * @param name The name used by the parent class to access the interface */ TFT(proto_t displayproto, int Hz, PinName mosi, PinName miso, PinName sclk, PinName CS, PinName reset, PinName DC, 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); /** Set scroll area boundaries * 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 * * @param startY boundary offset from top (or left if rotated), 0 for fullscreen scroll * @param areasize size of the scroll area, 480 for fullscreen scroll of a 320x480 display */ void setscrollarea (int startY, int areasize); /** Scroll up(or left) the scrollarea * * @param lines number of lines to scroll, 1= scrollup 1, areasize-1= scrolldown 1 */ void scroll (int lines); /** Reset the scrollarea 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 X size in pixels (native, orientation independent) * @returns screen height in pixels. */ int sizeY(); unsigned int tftID; protected: ////// functions needed by parent class /////////////////////////////////////// ////// -------------------------------- /////////////////////////////////////// /** Send 8bit command to display controller * * @param cmd: byte to send * @note if protocol is SPI16, it will insert NOP cmd before, so if cmd is a 2byte cmd, the second cmd will be broken. Use wr_cmd16 for 2bytes cmds */ void wr_cmd8(unsigned char cmd); /** Send 8bit data to display controller * * @param data: byte to send * */ void wr_data8(unsigned char data); /** Send 2x8bit data to display controller * * @param data: halfword to send * */ void wr_data16(unsigned short data); /** 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) * * @returns 16bit color */ virtual unsigned short rd_gram(); /** Read 4x8bit register data (with dummy cycle) * @param reg the register to read * @returns data as uint * */ virtual unsigned int rd_reg_data32(unsigned char reg); /** Read 3x8bit ExtendedCommands register data * @param reg the register to read * @param SPIreadenablecmd vendor/device specific cmd to read EXTC registers * @returns data as uint * @note EXTC regs (0xB0 to 0xFF) are read/write registers but needs special cmd to be read in SPI mode */ virtual unsigned int rd_extcreg_data32(unsigned char reg, unsigned char SPIreadenablecmd); /** HW reset sequence (without display init commands) */ void hw_reset(); /** 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; bool mipistd; 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; int topfixedareasize; int scrollareasize; bool useNOP; bool usefastwindow; bool fastwindowready; }; #endif