/* ChibiOS/RT - Copyright (C) 2012 Joel Bodenmann aka Tectu This file is part of ChibiOS-LCD-Driver. ChibiOS-LCD-Driver is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. ChibiOS-LCD-Driver is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ /** * @file gdispSsd1289/gdisp_lld.c * @brief GDISP Graphics Driver subsystem low level driver source for the Ssd1289 display. * * @addtogroup GDISP * @{ */ #include "ch.h" #include "hal.h" #include "gdisp.h" #include "gdisp_fonts.h" #if HAL_USE_GDISP || defined(__DOXYGEN__) /*===========================================================================*/ /* Driver local definitions. */ /*===========================================================================*/ #ifdef UNUSED #elif defined(__GNUC__) # define UNUSED(x) UNUSED_ ## x __attribute__((unused)) #elif defined(__LCLINT__) # define UNUSED(x) /*@unused@*/ x #else # define UNUSED(x) x #endif /*===========================================================================*/ /* Driver exported variables. */ /*===========================================================================*/ #if !defined(__DOXYGEN__) GDISPDriver GDISP; #endif /*===========================================================================*/ /* Driver local variables. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver local functions. */ /*===========================================================================*/ #include "ssd1289_lld.c.h" /*===========================================================================*/ /* Driver interrupt handlers. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver exported functions. */ /*===========================================================================*/ /* Include the software emulation routines */ #include "gdisp_lld_inc_emulation.c.h" /* ---- Required Routines ---- */ /* The following 2 routines are required. All other routines are optional. */ /** * @brief Low level GDISP driver initialization. * * @notapi */ void gdisp_lld_init(void) { uint16_t deviceCode; #ifdef LCD_USE_FSMC /* FSMC setup. TODO: this only works for STM32F1 */ rccEnableAHB(RCC_AHBENR_FSMCEN, 0); int FSMC_Bank = 0; /* timing structure */ /* from datasheet: address setup: 0ns address hold: 0ns Data setup: 5ns Data hold: 5ns Data access: 250ns output hold: 100ns */ FSMC_Bank1->BTCR[FSMC_Bank+1] = FSMC_BTR1_ADDSET_1 | FSMC_BTR1_DATAST_1; /* Bank1 NOR/SRAM control register configuration */ FSMC_Bank1->BTCR[FSMC_Bank] = FSMC_BCR1_MWID_0 | FSMC_BCR1_WREN | FSMC_BCR1_MBKEN; #endif deviceCode = lld_lcdReadReg(0x0000); lld_lcdWriteReg(0x0000,0x0001); lld_lcdDelay(5); lld_lcdWriteReg(0x0003,0xA8A4); lld_lcdDelay(5); lld_lcdWriteReg(0x000C,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x000D,0x080C); lld_lcdDelay(5); lld_lcdWriteReg(0x000E,0x2B00); lld_lcdDelay(5); lld_lcdWriteReg(0x001E,0x00B0); lld_lcdDelay(5); lld_lcdWriteReg(0x0001,0x2B3F); lld_lcdDelay(5); lld_lcdWriteReg(0x0002,0x0600); lld_lcdDelay(5); lld_lcdWriteReg(0x0010,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0011,0x6070); lld_lcdDelay(5); lld_lcdWriteReg(0x0005,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0006,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0016,0xEF1C); lld_lcdDelay(5); lld_lcdWriteReg(0x0017,0x0003); lld_lcdDelay(5); lld_lcdWriteReg(0x0007,0x0133); lld_lcdDelay(5); lld_lcdWriteReg(0x000B,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x000F,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0041,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0042,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0048,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0049,0x013F); lld_lcdDelay(5); lld_lcdWriteReg(0x004A,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x004B,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0044,0xEF00); lld_lcdDelay(5); lld_lcdWriteReg(0x0045,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0046,0x013F); lld_lcdDelay(5); lld_lcdWriteReg(0x0030,0x0707); lld_lcdDelay(5); lld_lcdWriteReg(0x0031,0x0204); lld_lcdDelay(5); lld_lcdWriteReg(0x0032,0x0204); lld_lcdDelay(5); lld_lcdWriteReg(0x0033,0x0502); lld_lcdDelay(5); lld_lcdWriteReg(0x0034,0x0507); lld_lcdDelay(5); lld_lcdWriteReg(0x0035,0x0204); lld_lcdDelay(5); lld_lcdWriteReg(0x0036,0x0204); lld_lcdDelay(5); lld_lcdWriteReg(0x0037,0x0502); lld_lcdDelay(5); lld_lcdWriteReg(0x003A,0x0302); lld_lcdDelay(5); lld_lcdWriteReg(0x003B,0x0302); lld_lcdDelay(5); lld_lcdWriteReg(0x0023,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0024,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x0025,0x8000); lld_lcdDelay(5); lld_lcdWriteReg(0x004f,0x0000); lld_lcdDelay(5); lld_lcdWriteReg(0x004e,0x0000); lld_lcdDelay(5); /* Initialise the GDISP structure */ GDISP.Width = SCREEN_WIDTH; GDISP.Height = SCREEN_HEIGHT; GDISP.Orientation = portrait; GDISP.Powermode = powerOn; } /** * @brief Draws a pixel on the display. * * @param[in] x X location of the pixel * @param[in] y Y location of the pixel * @param[in] color The color of the pixel * * @notapi */ void gdisp_lld_drawpixel(coord_t x, coord_t y, color_t color) { #if GDISP_NEED_VALIDATION if (x >= GDISP.Width || y >= GDISP.Height) return; #endif lld_lcdSetCursor(x, y); lld_lcdWriteReg(0x0022, color); } /* ---- Optional Routines ---- */ /* All the below routines are optional. Defining them will increase speed but everything will work if they are not defined. If you are not using a routine - turn it off using the appropriate GDISP_HARDWARE_XXXX macro. Don't bother coding for obvious similar routines if there is no performance penalty as the emulation software makes a good job of using similar routines. eg. If gdisp_lld_fillarea() is defined there is little point in defining gdisp_lld_clear() unless the performance bonus is significant. For good performance it is suggested to implement gdisp_lld_fillarea() and gdisp_lld_blitarea(). */ #if GDISP_HARDWARE_POWERCONTROL || defined(__DOXYGEN__) /** * @brief Sets the power mode for the graphic device. * @note The power modes are powerOn, powerSleep and powerOff. * If powerSleep is not supported it is equivelent to powerOn. * * @param[in] powerMode The new power mode * * @notapi */ void gdisp_lld_setpowermode(gdisp_powermode_t powerMode) { if (GDISP.Powermode == powerMode) return; switch(powerMode) { case powerOff: lld_lcdWriteReg(0x0010, 0x0000); // leave sleep mode lld_lcdWriteReg(0x0007, 0x0000); // halt operation lld_lcdWriteReg(0x0000, 0x0000); // turn off oszillator lld_lcdWriteReg(0x0010, 0x0001); // enter sleepmode break; case powerOn: lld_lcdWriteReg(0x0010, 0x0000); // leave sleep mode if (GDISP.Powermode != powerSleep) gdisp_lld_init(); break; case powerSleep: lld_lcdWriteReg(0x0010, 0x0001); // enter sleep mode break; default: return; } GDISP.Powermode = powerMode; } #endif #if GDISP_HARDWARE_ORIENTATION || defined(__DOXYGEN__) /** * @brief Sets the orientation of the display. * @note This may be ignored if not supported by the device. * * @param[in] newOrientation The new orientation * * @notapi */ void gdisp_lld_setorientation(gdisp_orientation_t newOrientation) { if (GDISP.Orientation == newOrientation) return; switch(newOrientation) { case portrait: lld_lcdWriteReg(0x0001, 0x2B3F); /* ID = 11 AM = 0 */ lld_lcdWriteReg(0x0011, 0x6070); GDISP.Height = SCREEN_HEIGHT; GDISP.Width = SCREEN_WIDTH; break; case landscape: lld_lcdWriteReg(0x0001, 0x293F); /* ID = 11 AM = 1 */ lld_lcdWriteReg(0x0011, 0x6078); GDISP.Height = SCREEN_WIDTH; GDISP.Width = SCREEN_HEIGHT; break; case portraitInv: lld_lcdWriteReg(0x0001, 0x2B3F); /* ID = 01 AM = 0 */ lld_lcdWriteReg(0x0011, 0x6040); GDISP.Height = SCREEN_HEIGHT; GDISP.Width = SCREEN_WIDTH; break; case landscapeInv: lld_lcdWriteReg(0x0001, 0x293F); /* ID = 01 AM = 1 */ lld_lcdWriteReg(0x0011, 0x6048); GDISP.Height = SCREEN_WIDTH; GDISP.Width = SCREEN_HEIGHT; break; default: return; } GDISP.Orientation = newOrientation; } #endif #if GDISP_HARDWARE_CLEARS || defined(__DOXYGEN__) /** * @brief Clear the display. * @note Optional - The high level driver can emulate using software. * * @param[in] color The color of the pixel * * @notapi */ void gdisp_lld_clear(color_t color) { unsigned i; lld_lcdSetCursor(0, 0); lld_lcdWriteStreamStart(); for(i = 0; i < SCREEN_WIDTH * SCREEN_HEIGHT; i++) lld_lcdWriteData(color); lld_lcdWriteStreamStop(); } #endif #if GDISP_HARDWARE_LINES || defined(__DOXYGEN__) /** * @brief Draw a line. * @note Optional - The high level driver can emulate using software. * * @param[in] x0, y0 The start of the line * @param[in] x1, y1 The end of the line * @param[in] color The color of the line * * @notapi */ void gdisp_lld_drawline(coord_t x0, coord_t y0, coord_t x1, coord_t y1, color_t color) { /* NOT IMPLEMENTED */ } #endif #if GDISP_HARDWARE_BOX || defined(__DOXYGEN__) /** * @brief Draw a box. * @pre The GDISP unit must be in powerOn or powerSleep mode. * * @param[in] x0,y0 The start position * @param[in] cx,cy The size of the box (outside dimensions) * @param[in] color The color to use * @param[in] filled Should the box should be filled * * @notapi */ void gdisp_lld_drawbox(coord_t x, coord_t y, coord_t cx, coord_t cy, color_t color) { /* NOT IMPLEMENTED */ } #endif #if GDISP_HARDWARE_FILLS || defined(__DOXYGEN__) /** * @brief Fill an area with a color. * @note Optional - The high level driver can emulate using software. * * @param[in] x, y The start filled area * @param[in] cx, cy The width and height to be filled * @param[in] color The color of the fill * * @notapi */ void gdisp_lld_fillarea(coord_t x, coord_t y, coord_t cx, coord_t cy, color_t color) { #if GDISP_NEED_VALIDATION if (cx < 1 || cy < 1 || x >= GDISP.Width || y >= GDISP.Height) return; if (x+cx > GDISP.Width) cx = GDISP.Width - x; if (y+cy > GDISP.Height) cy = GDISP.Height - y; #endif unsigned i, area; area = cx*cy; lld_lcdSetViewPort(x, y, cx, cy); lld_lcdWriteStreamStart(); for(i = 0; i < area; i++) lld_lcdWriteData(color); lld_lcdWriteStreamStop(); lld_lcdResetViewPort(); } #endif #if GDISP_HARDWARE_BITFILLS || defined(__DOXYGEN__) /** * @brief Fill an area with a bitmap. * @note Optional - The high level driver can emulate using software. * * @param[in] x, y The start filled area * @param[in] cx, cy The width and height to be filled * @param[in] buffer The pixels to use to fill the area. * * @notapi */ void gdisp_lld_blitarea(coord_t x, coord_t y, coord_t cx, coord_t cy, pixel_t *buffer) { unsigned i, area; #if GDISP_NEED_VALIDATION if (cx < 1 || cy < 1 || x >= GDISP.Width || y >= GDISP.Height) return; if (x+cx > GDISP.Width) return; if (y+cy > GDISP.Height) cy = GDISP.Height - y; #endif area = cx*cy; lld_lcdSetViewPort(x, y, cx, cy); lld_lcdWriteStreamStart(); for(i = 0; i < area; i++) lld_lcdWriteData(*buffer++); lld_lcdWriteStreamStop(); lld_lcdResetViewPort(); } #endif /* Circular Drawing Functions */ #if (GDISP_NEED_CIRCLE && GDISP_HARDWARE_CIRCLES) || defined(__DOXYGEN__) /** * @brief Draw a circle. * @note Optional - The high level driver can emulate using software. * @note If GDISP_NEED_CLIPPING is defined this routine MUST behave * correctly if the circle is over the edges of the screen. * * @param[in] x, y The centre of the circle * @param[in] radius The radius of the circle * @param[in] color The color of the circle * * @notapi */ void gdisp_lld_drawcircle(coord_t x, coord_t y, coord_t radius, color_t color) { /* NOT IMPLEMENTED */ } #endif #if (GDISP_NEED_CIRCLE && GDISP_HARDWARE_CIRCLEFILLS) || defined(__DOXYGEN__) /** * @brief Create a filled circle. * @note Optional - The high level driver can emulate using software. * @note If GDISP_NEED_CLIPPING is defined this routine MUST behave * correctly if the circle is over the edges of the screen. * * @param[in] x, y The centre of the circle * @param[in] radius The radius of the circle * @param[in] color The color of the circle * * @notapi */ void gdisp_lld_fillcircle(coord_t x, coord_t y, coord_t radius, color_t color) { /* NOT IMPLEMENTED */ } #endif #if (GDISP_NEED_ELLIPSE && GDISP_HARDWARE_ELLIPSES) || defined(__DOXYGEN__) /** * @brief Draw an ellipse. * @note Optional - The high level driver can emulate using software. * @note If GDISP_NEED_CLIPPING is defined this routine MUST behave * correctly if the ellipse is over the edges of the screen. * * @param[in] x, y The centre of the ellipse * @param[in] a, b The dimensions of the ellipse * @param[in] color The color of the ellipse * * @notapi */ void gdisp_lld_drawellipse(coord_t x, coord_t y, coord_t a, coord_t b, color_t color) { /* NOT IMPLEMENTED */ } #endif #if (GDISP_NEED_ELLIPSE && GDISP_HARDWARE_ELLIPSEFILLS) || defined(__DOXYGEN__) /** * @brief Create a filled ellipse. * @note Optional - The high level driver can emulate using software. * @note If GDISP_NEED_CLIPPING is defined this routine MUST behave * correctly if the ellipse is over the edges of the screen. * * @param[in] x, y The centre of the ellipse * @param[in] a, b The dimensions of the ellipse * @param[in] color The color of the ellipse * * @notapi */ void gdisp_lld_fillellipse(coord_t x, coord_t y, coord_t a, coord_t b, color_t color) { /* NOT IMPLEMENTED */ } #endif #if (GDISP_NEED_TEXT && GDISP_HARDWARE_TEXT) || defined(__DOXYGEN__) /** * @brief Draw a character using a transparent background. * @note Optional - The high level driver can emulate using software. * * @param[in] x, y The top-left corner of the text * @param[in] c The character to print * @param[in] color The color of the character * * @notapi */ void gdisp_lld_drawchar(coord_t x, coord_t y, char c, font_t font, color_t color) { /* NOT IMPLEMENTED */ } #endif #if (GDISP_NEED_TEXT && GDISP_HARDWARE_TEXTFILLS) || defined(__DOXYGEN__) /** * @brief Draw a character using a filled background. * @note Optional - The high level driver can emulate using software. * * @param[in] x, y The top-left corner of the text * @param[in] c The character to print * @param[in] color The color of the character * @param[in] bgcolor The background color * * @notapi */ void gdisp_lld_fillchar(coord_t x, coord_t y, char c, font_t font, color_t color, color_t bgcolor) { /* NOT IMPLEMENTED */ } #endif #if (GDISP_NEED_PIXELREAD && GDISP_HARDWARE_PIXELREAD) || defined(__DOXYGEN__) /** * @brief Get the color of a particular pixel. * @note Optional. * @note If x,y is off the screen, the result is undefined. * * @param[in] x, y The start of the text * * @notapi */ color_t gdisp_lld_getpixelcolor(coord_t x, coord_t y) { color_t color; #if GDISP_NEED_VALIDATION if (x >= GDISP.Width || y >= GDISP.Height) return 0; #endif lld_lcdSetCursor(x, y); lld_lcdWriteStreamStart(); color = lld_lcdReadData(); color = lld_lcdReadData(); lld_lcdWriteStreamStop(); return color; } #endif #if (GDISP_NEED_SCROLL && GDISP_HARDWARE_SCROLL) || defined(__DOXYGEN__) /** * @brief Scroll vertically a section of the screen. * @note Optional. * @note If x,y + cx,cy is off the screen, the result is undefined. * @note If lines is >= cy, it is equivelent to a area fill with bgcolor. * * @param[in] x, y The start of the area to be scrolled * @param[in] cx, cy The size of the area to be scrolled * @param[in] lines The number of lines to scroll (Can be positive or negative) * @param[in] bgcolor The color to fill the newly exposed area. * * @notapi */ void gdisp_lld_verticalscroll(coord_t x, coord_t y, coord_t cx, coord_t cy, int lines, color_t bgcolor) { static color_t buf[((SCREEN_HEIGHT > SCREEN_WIDTH ) ? SCREEN_HEIGHT : SCREEN_WIDTH)]; coord_t row0, row1; unsigned i, gap, abslines; abslines = lines < 0 ? -lines : lines; #if GDISP_NEED_VALIDATION if (cx < 1 || cy < 1 || x >= GDISP.Width || y >= GDISP.Height) return; if (x+cx > GDISP.Width) cx = GDISP.Width - x; if (y+cy > GDISP.Height) cy = GDISP.Height - y; #endif if (!abslines) return; if (abslines >= cy) { abslines = cy; gap = 0; } else { gap = cy - abslines; for(i = 0; i < gap; i++) { if(lines > 0) { row0 = y + i + lines; row1 = y + i; } else { row0 = (y - i - 1) + lines; row1 = (y - i - 1); } /* read row0 into the buffer and then write at row1*/ lld_lcdSetViewPort(x, row0, cx, 1); lld_lcdReadStreamStart(); lld_lcdReadStream(buf, cx); lld_lcdReadStreamStop(); lld_lcdSetViewPort(x, row1, cx, 1); lld_lcdWriteStreamStart(); lld_lcdWriteStream(buf, cx); lld_lcdWriteStreamStop(); } } /* fill the remaining gap */ lld_lcdSetViewPort(x, lines > 0 ? (y+gap) : y, cx, abslines); lld_lcdWriteStreamStart(); gap = cx*abslines; for(i = 0; i < gap; i++) lld_lcdWriteData(color); lld_lcdWriteStreamStop(); lld_lcdResetViewPort(); } #endif #endif /* HAL_USE_GDISP */ /** @} */