/* ChibiOS/RT - Copyright (C) 2012 Joel Bodenmann aka Tectu This file is part of ChibiOS/GFX. ChibiOS/GFX 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/GFX 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 gdispNokia6610/gdisp_lld.c * @brief GDISP Graphics Driver subsystem low level driver source for the Nokia6610 display. * * @addtogroup GDISP * @{ */ #include "ch.h" #include "hal.h" #include "gdisp.h" #if HAL_USE_GDISP || defined(__DOXYGEN__) /* Include the emulation code for things we don't support */ #include "gdisp_emulation.c" /*===========================================================================*/ /* Driver local definitions. */ /*===========================================================================*/ /* Controller definitions */ #if defined(LCD_USE_GE8) #include "GE8.h" #elif defined(LCD_USE_GE12) #include "GE12.h" #else #error "gdispNokia6610: Either LCD_USE_GE8 or LCD_USE_GE12 must be defined depending on your controller" #endif #define SCREEN_HEIGHT 132 #define SCREEN_WIDTH 132 #define INITIAL_CONTRAST 38 /*===========================================================================*/ /* Driver exported variables. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver local variables. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver local functions. */ /*===========================================================================*/ #if defined(BOARD_OLIMEX_SAM7_EX256) #include "gdisp_lld_board_olimexsam7ex256.h" #else /* Include the user supplied board definitions */ #include "gdisp_lld_board.h" #endif static __inline void gdisp_lld_setviewport(coord_t x, coord_t y, coord_t cx, coord_t cy) { GDISP_LLD(write_cmd)(CASET); // Column address set GDISP_LLD(write_data)(x); GDISP_LLD(write_data)(x+cx-1); GDISP_LLD(write_cmd)(PASET); // Page address set GDISP_LLD(write_data)(y); GDISP_LLD(write_data)(y+cy-1); } /*===========================================================================*/ /* Driver interrupt handlers. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver exported functions. */ /*===========================================================================*/ /* ---- Required Routines ---- */ /* The following 2 routines are required. All other routines are optional. */ /** * @brief Low level GDISP driver initialization. * * @notapi */ bool_t GDISP_LLD(init)(void) { /* Initialise your display */ GDISP_LLD(init_board)(); // Hardware reset GDISP_LLD(setpin_reset)(TRUE); chThdSleepMilliseconds(20); GDISP_LLD(setpin_reset)(FALSE); chThdSleepMilliseconds(20); #if defined(LCD_USE_GE8) #if 1 GDISP_LLD(write_cmd)(DISCTL); // Display control GDISP_LLD(write_data)(0x00); // P1: 0x00 = 2 divisions, switching period=8 (default) GDISP_LLD(write_data)(0x20); // P2: 0x20 = nlines/4 - 1 = 132/4 - 1 = 32) GDISP_LLD(write_data)(0x00); // P3: 0x00 = no inversely highlighted lines GDISP_LLD(write_cmd)(COMSCN); // COM scan GDISP_LLD(write_data)(1); // P1: 0x01 = Scan 1->80, 160<-81 GDISP_LLD(write_cmd)(OSCON); // Internal oscilator ON GDISP_LLD(write_cmd)(SLPOUT); // Sleep out GDISP_LLD(write_cmd)(PWRCTR); // Power control GDISP_LLD(write_data)(0x0f); // reference voltage regulator on, circuit voltage follower on, BOOST ON // Interesting - all the code seems to say this should be done. But my display doesn't want it! //GDISP_LLD(write_cmd)(DISINV); // Inverse display GDISP_LLD(write_cmd)(DATCTL); // Data control GDISP_LLD(write_data)(0x48/*0x01*/); // P1: 0x01 = page address inverted, column address normal, address scan in column direction GDISP_LLD(write_data)(0x00); // P2: 0x00 = RGB sequence (default value) GDISP_LLD(write_data)(0x02); // P3: 0x02 = Grayscale -> 16 (selects 12-bit color, type A) GDISP_LLD(write_cmd)(VOLCTR); // Voltage control (contrast setting) GDISP_LLD(write_data)(INITIAL_CONTRAST); // P1 = Contrast GDISP_LLD(write_data)(3); // P2 = 3 resistance ratio (only value that works) chThdSleepMilliseconds(100); // allow power supply to stabilize GDISP_LLD(write_cmd)(DISON); // Turn on the display #else // Alternative GDISP_LLD(write_cmd)(DISCTL); // Display control GDISP_LLD(write_data)(0x00); // default GDISP_LLD(write_data)(0x20); // (32 + 1) * 4 = 132 lines (of which 130 are visible) GDISP_LLD(write_data)(0x0a); // default GDISP_LLD(write_cmd)(COMSCN); // COM scan GDISP_LLD(write_data)(0x00); // Scan 1-80 GDISP_LLD(write_cmd)(OSCON); // Internal oscilator ON chThdSleepMilliseconds(100); // wait aproximetly 100ms GDISP_LLD(write_cmd)(SLPOUT); // Sleep out GDISP_LLD(write_cmd)(VOLCTR); // Voltage control GDISP_LLD(write_data)(INITIAL_CONTRAST); // middle value of V1 GDISP_LLD(write_data)(0x03); // middle value of resistance value GDISP_LLD(write_cmd)(TMPGRD); // Temperature gradient GDISP_LLD(write_data)(0x00); // default GDISP_LLD(write_cmd)(PWRCTR); // Power control GDISP_LLD(write_data)(0x0f); // referance voltage regulator on, circuit voltage follower on, BOOST ON GDISP_LLD(write_cmd)(DISNOR); // Normal display GDISP_LLD(write_cmd)(DISINV); // Inverse display GDISP_LLD(write_cmd)(PTLOUT); // Partial area off // GDISP_LLD(write_cmd)(ASCSET); // Scroll area set // GDISP_LLD(write_data)(0); // GDISP_LLD(write_data)(0); // GDISP_LLD(write_data)(40); // GDISP_LLD(write_data)(3); // GDISP_LLD(write_cmd)(SCSTART); // Vertical scrool address start // GDISP_LLD(write_data)(0); GDISP_LLD(write_cmd)(DATCTL); // Data control GDISP_LLD(write_data)(0x00); // all inversions off, column direction GDISP_LLD(write_data)(0x03); // RGB sequence GDISP_LLD(write_data)(0x02); // Grayscale -> 16 GDISP_LLD(write_cmd)(PASET); // Page Address set GDISP_LLD(write_data)(0); GDISP_LLD(write_data)(131); GDISP_LLD(write_cmd)(CASET); // Page Column set GDISP_LLD(write_data)(0); GDISP_LLD(write_data)(131); GDISP_LLD(write_cmd)(DISON); // Turn on the display #endif #elif defined(LCD_USE_GE12) #if 1 GDISP_LLD(write_cmd)(SLEEPOUT); // Sleep out GDISP_LLD(write_cmd)(INVON); // Inversion on: seems to be required for this controller GDISP_LLD(write_cmd)(COLMOD); // Color Interface Pixel Format GDISP_LLD(write_data)(0x03); // 0x03 = 12 bits-per-pixel GDISP_LLD(write_cmd)(MADCTL); // Memory access controler GDISP_LLD(write_data)(0xC8); // 0xC0 = mirror x and y, reverse rgb GDISP_LLD(write_cmd)(SETCON); // Write contrast GDISP_LLD(write_data)(INITIAL_CONTRAST); // contrast - experiental value chThdSleepMilliseconds(20); GDISP_LLD(write_cmd)(DISPON); // Display On #else // Alternative // Hardware reset commented out GDISP_LLD(write_cmd)(SOFTRST); // Software Reset chThdSleepMilliseconds(20); GDISP_LLD(write_cmd)(INITESC); // Initial escape chThdSleepMilliseconds(20); GDISP_LLD(write_cmd)(REFSET); // Refresh set GDISP_LLD(write_data)(0); GDISP_LLD(write_cmd)(DISPCTRL); // Set Display control GDISP_LLD(write_data)(128); // Set the lenght of one selection term GDISP_LLD(write_data)(128); // Set N inversion -> no N inversion GDISP_LLD(write_data)(134); // Set frame frequence and bias rate -> 2 devision of frequency and 1/8 bias, 1/67 duty, 96x67 size GDISP_LLD(write_data)(84); // Set duty parameter GDISP_LLD(write_data)(69); // Set duty parameter GDISP_LLD(write_data)(82); // Set duty parameter GDISP_LLD(write_data)(67); // Set duty parameter GDISP_LLD(write_cmd)(GRAYSCALE0); // Grey scale 0 position set - 15 parameters GDISP_LLD(write_data)(1); // GCP1 - gray lavel to be output when the RAM data is "0001" GDISP_LLD(write_data)(2); // GCP2 - gray lavel to be output when the RAM data is "0010" GDISP_LLD(write_data)(4); // GCP3 - gray lavel to be output when the RAM data is "0011" GDISP_LLD(write_data)(8); // GCP4 - gray lavel to be output when the RAM data is "0100" GDISP_LLD(write_data)(16); // GCP5 - gray lavel to be output when the RAM data is "0101" GDISP_LLD(write_data)(30); // GCP6 - gray lavel to be output when the RAM data is "0110" GDISP_LLD(write_data)(40); // GCP7 - gray lavel to be output when the RAM data is "0111" GDISP_LLD(write_data)(50); // GCP8 - gray lavel to be output when the RAM data is "1000" GDISP_LLD(write_data)(60); // GCP9 - gray lavel to be output when the RAM data is "1001" GDISP_LLD(write_data)(70); // GCP10 - gray lavel to be output when the RAM data is "1010" GDISP_LLD(write_data)(80); // GCP11 - gray lavel to be output when the RAM data is "1011" GDISP_LLD(write_data)(90); // GCP12 - gray lavel to be output when the RAM data is "1100" GDISP_LLD(write_data)(100); // GCP13 - gray lavel to be output when the RAM data is "1101" GDISP_LLD(write_data)(110); // GCP14 - gray lavel to be output when the RAM data is "1110" GDISP_LLD(write_data)(127); // GCP15 - gray lavel to be output when the RAM data is "1111" GDISP_LLD(write_cmd)(GAMMA); // Gamma curve set - select gray scale - GRAYSCALE 0 or GREYSCALE 1 GDISP_LLD(write_data)(1); // Select grey scale 0 GDISP_LLD(write_cmd)(COMMONDRV); // Command driver output GDISP_LLD(write_data)(0); // Set COM1-COM41 side come first, normal mod GDISP_LLD(write_cmd)(NORMALMODE); // Set Normal mode (my) // GDISP_LLD(write_cmd)(INVERSIONOFF); // Inversion off GDISP_LLD(write_cmd)(COLADDRSET); // Column address set GDISP_LLD(write_data)(0); GDISP_LLD(write_data)(131); GDISP_LLD(write_cmd)(PAGEADDRSET); // Page address set GDISP_LLD(write_data)(0); GDISP_LLD(write_data)(131); GDISP_LLD(write_cmd)(ACCESSCTRL); // Memory access controler GDISP_LLD(write_data)(0x40); // horizontal //GDISP_LLD(write_data)(0x20); // vertical GDISP_LLD(write_cmd)(PWRCTRL); // Power control GDISP_LLD(write_data)(4); // Internal resistance, V1OUT -> high power mode, oscilator devision rate GDISP_LLD(write_cmd)(SLEEPOUT); // Sleep out GDISP_LLD(write_cmd)(VOLTCTRL); // Voltage control - voltage control and write contrast define LCD electronic volume //GDISP_LLD(write_data)(0x7f); // full voltage control //GDISP_LLD(write_data)(0x03); // must be "1" GDISP_LLD(write_cmd)(CONTRAST); // Write contrast GDISP_LLD(write_data)(INITIAL_CONTRAST); // contrast chThdSleepMilliseconds(20); GDISP_LLD(write_cmd)(TEMPGRADIENT); // Temperature gradient for(i=0; i<14; i++) GDISP_LLD(write_data)(0); GDISP_LLD(write_cmd)(BOOSTVON); // Booster voltage ON GDISP_LLD(write_cmd)(DISPLAYON); // Finally - Display On #endif #endif /* Turn on the back-light */ GDISP_LLD(setpin_backlight)(TRUE); /* Initialise the GDISP structure to match */ GDISP.Width = SCREEN_WIDTH; GDISP.Height = SCREEN_HEIGHT; GDISP.Orientation = portrait; GDISP.Powermode = powerOn; GDISP.Backlight = 100; GDISP.Contrast = INITIAL_CONTRAST; #if GDISP_NEED_VALIDATION || GDISP_NEED_CLIP GDISP.clipx0 = 0; GDISP.clipy0 = 0; GDISP.clipx1 = GDISP.Width; GDISP.clipy1 = GDISP.Height; #endif return TRUE; } /** * @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 || GDISP_NEED_CLIP if (x < GDISP.clipx0 || y < GDISP.clipy0 || x >= GDISP.clipx1 || y >= GDISP.clipy1) return; #endif gdisp_lld_setviewport(x, y, 1, 1); GDISP_LLD(write_cmd)(RAMWR); GDISP_LLD(write_data)(0); GDISP_LLD(write_data)((color>>8) & 0x0F); GDISP_LLD(write_data)(color & 0xFF); } /* ---- Optional Routines ---- */ #if GDISP_HARDWARE_FILLS || defined(__DOXYGEN__) /** * @brief Fill an area with a color. * * @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) { unsigned i, tuples; #if GDISP_NEED_VALIDATION || GDISP_NEED_CLIP if (x < GDISP.clipx0) { cx -= GDISP.clipx0 - x; x = GDISP.clipx0; } if (y < GDISP.clipy0) { cy -= GDISP.clipy0 - y; y = GDISP.clipy0; } if (cx <= 0 || cy <= 0 || x >= GDISP.clipx1 || y >= GDISP.clipy1) return; if (x+cx > GDISP.clipx1) cx = GDISP.clipx1 - x; if (y+cy > GDISP.clipy1) cy = GDISP.clipy1 - y; #endif tuples = (cx*cy+1)/2; // With an odd sized area we over-print by one pixel. // This extra pixel is ignored by the controller. gdisp_lld_setviewport(x, y, cx, cy); GDISP_LLD(write_cmd)(RAMWR); for(i=0; i < tuples; i++) { GDISP_LLD(write_data)((color >> 4) & 0xFF); GDISP_LLD(write_data)(((color << 4) & 0xF0)|((color >> 8) & 0x0F)); GDISP_LLD(write_data)(color & 0xFF); } } #endif #if GDISP_HARDWARE_BITFILLS || defined(__DOXYGEN__) /** * @brief Fill an area with a bitmap. * * @param[in] x, y The start filled area * @param[in] cx, cy The width and height to be filled * @param[in] srcx, srcy The bitmap position to start the fill from * @param[in] srccx The width of a line in the bitmap. * @param[in] buffer The pixels to use to fill the area. * * @notapi */ void GDISP_LLD(blitareaex)(coord_t x, coord_t y, coord_t cx, coord_t cy, coord_t srcx, coord_t srcy, coord_t srccx, const pixel_t *buffer) { coord_t endx, endy, lg; color_t c1, c2; #if GDISP_PACKED_PIXELS coord_t pos; const uint8_t *p; #endif #if GDISP_NEED_VALIDATION || GDISP_NEED_CLIP if (x < GDISP.clipx0) { cx -= GDISP.clipx0 - x; srcx += GDISP.clipx0 - x; x = GDISP.clipx0; } if (y < GDISP.clipy0) { cy -= GDISP.clipy0 - y; srcy += GDISP.clipy0 - y; y = GDISP.clipy0; } if (srcx+cx > srccx) cx = srccx - srcx; if (cx <= 0 || cy <= 0 || x >= GDISP.clipx1 || y >= GDISP.clipy1) return; if (x+cx > GDISP.clipx1) cx = GDISP.clipx1 - x; if (y+cy > GDISP.clipy1) cy = GDISP.clipy1 - y; #endif /* What are our end points */ endx = srcx + cx; endy = y + cy; gdisp_lld_setviewport(x, y, cx, cy); GDISP_LLD(write_cmd)(RAMWR); #if !GDISP_PACKED_PIXELS // Although this controller uses packed pixels we support unpacked pixel // formats in this blit by packing the data as we feed it to the controller. lg = srccx - cx; buffer += srcy * srccx + srcx; x = srcx; while (1) { /* Get a pixel */ c1 = *buffer++; if (++x >= endx) { if (++y >= endy) { /* Odd pixel at end */ GDISP_LLD(write_data)(0); GDISP_LLD(write_data)((c1 >> 8) & 0x0F); GDISP_LLD(write_data)(c1 & 0xFF); break; } x = srcx; buffer += lg; } /* Get the next pixel */ c2 = *buffer++; GDISP_LLD(write_data)((c1 >> 4) & 0xFF); GDISP_LLD(write_data)(((c1 << 4) & 0xF0)|((c2 >> 8) & 0x0F)); GDISP_LLD(write_data)(c2 & 0xFF); if (++x >= endx) { if (++y >= endy) break; x = srcx; buffer += lg; } } #else // Although this controller uses packed pixels, we may have to feed it into // the controller with different packing to the source bitmap #if !GDISP_PACKED_LINES srccx = (srccx + 1) & ~1; #endif pos = srcy*srccx; lg = (srccx - cx)/2*3; p = ((const uint8_t *)buffer) + ((pos+srcx)/2 * 3); x = srcx; while (1) { /* Get a pixel */ switch((pos+x)&1) { case 0: c1 = (((color_t)p[0]) << 4)|(((color_t)p[1])>>4); break; case 1: c1 = (((color_t)p[1]&0x0F) << 8)|((color_t)p[1]); break; } if (++x >= endx) { if (++y >= endy) { /* Odd pixel at end */ GDISP_LLD(write_data)(0); GDISP_LLD(write_data)((c1 >> 8) & 0x0F); GDISP_LLD(write_data)(c1 & 0xFF); break; } x = srcx; p += lg; pos += srccx; } /* Get the next pixel */ switch((pos+x)&1) { case 0: c2 = (((color_t)p[0]) << 4)|(((color_t)p[1])>>4); break; case 1: c2 = (((color_t)p[1]&0x0F) << 8)|((color_t)p[1]); break; } GDISP_LLD(write_data)((c1 >> 4) & 0xFF); GDISP_LLD(write_data)(((c1 << 4) & 0xF0)|((c2 >> 8) & 0x0F)); GDISP_LLD(write_data)(c2 & 0xFF); if (++x >= endx) { if (++y >= endy) break; x = srcx; p += lg; pos += srccx; } } #endif } #endif #if (GDISP_NEED_PIXELREAD && GDISP_HARDWARE_PIXELREAD) /** * @brief Get the color of a particular pixel. * @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) { /* NOT IMPLEMENTED */ /* Some board hardware might support this in the future. * The Olimex board doesn't. */ } #endif #if (GDISP_NEED_SCROLL && GDISP_HARDWARE_SCROLL) /** * @brief Scroll vertically a section of the screen. * @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) { /* NOT IMPLEMENTED */ /* The hardware seems capable of doing this. * It is just really complex so we leave it out for now. */ } #endif #if GDISP_HARDWARE_CONTROL || defined(__DOXYGEN__) /** * @brief Driver Control * @detail Unsupported control codes are ignored. * @note The value parameter should always be typecast to (void *). * @note There are some predefined and some specific to the low level driver. * @note GDISP_CONTROL_POWER - Takes a gdisp_powermode_t * GDISP_CONTROL_ORIENTATION - Takes a gdisp_orientation_t * GDISP_CONTROL_BACKLIGHT - Takes an int from 0 to 100. For a driver * that only supports off/on anything other * than zero is on. * GDISP_CONTROL_CONTRAST - Takes an int from 0 to 100. * GDISP_CONTROL_LLD - Low level driver control constants start at * this value. * * @param[in] what What to do. * @param[in] value The value to use (always cast to a void *). * * @notapi */ void GDISP_LLD(control)(unsigned what, void *value) { /* NOT IMPLEMENTED YET */ /* The hardware is capable of supporting... * GDISP_CONTROL_POWER * GDISP_CONTROL_ORIENTATION * GDISP_CONTROL_BACKLIGHT (at least on the Olimex board) * GDISP_CONTROL_CONTRAST * We don't currently implement any of it. */ switch(what) { case GDISP_CONTROL_POWER: if (GDISP.Powermode == (gdisp_powermode_t)value) return; switch((gdisp_powermode_t)value) { case powerOff: /* Code here */ break; case powerOn: /* Code here */ /* You may need this --- if (GDISP.Powermode != powerSleep) GDISP_LLD(init)(); */ break; case powerSleep: /* Code here */ break; default: return; } GDISP.Powermode = (gdisp_powermode_t)value; return; case GDISP_CONTROL_ORIENTATION: if (GDISP.Orientation == (gdisp_orientation_t)value) return; // WriteSpiData(0x48); // no mirror Y (temporary to satisfy Olimex bmptoarray utility) // WriteSpiData(0xC8); // restore to (mirror x and y, reverse rgb) switch((gdisp_orientation_t)value) { case portrait: /* Code here */ GDISP.Height = SCREEN_HEIGHT; GDISP.Width = SCREEN_WIDTH; break; case landscape: /* Code here */ GDISP.Height = SCREEN_WIDTH; GDISP.Width = SCREEN_HEIGHT; break; case portraitInv: /* Code here */ GDISP.Height = SCREEN_HEIGHT; GDISP.Width = SCREEN_WIDTH; break; case landscapeInv: /* Code here */ GDISP.Height = SCREEN_WIDTH; GDISP.Width = SCREEN_HEIGHT; break; default: return; } #if GDISP_NEED_CLIP || GDISP_NEED_VALIDATION GDISP.clipx0 = 0; GDISP.clipy0 = 0; GDISP.clipx1 = GDISP.Width; GDISP.clipy1 = GDISP.Height; #endif GDISP.Orientation = (gdisp_orientation_t)value; return; /* case GDISP_CONTROL_BACKLIGHT: */ case GDISP_CONTROL_CONTRAST: if ((unsigned)value > 100) value = (void *)100; #if defined(LCD_USE_GE8) GDISP_LLD(write_cmd)(VOLCTR); GDISP_LLD(write_data)((unsigned)value); GDISP_LLD(write_data)(3); #elif defined(LCD_USE_GE12) GDISP_LLD(write_cmd)(CONTRAST); GDISP_LLD(write_data)((unsigned)value); #endif GDISP.Contrast = (unsigned)value; return; } } #endif #endif /* HAL_USE_GDISP */ /** @} */