/* ---------------------------------------------------------------------------- * ATMEL Microcontroller Software Support * ---------------------------------------------------------------------------- * Copyright (c) 2008, Atmel Corporation * * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, * this list of conditions and the disclaimer below. * * Atmel's name may not be used to endorse or promote products derived from * this software without specific prior written permission. * * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE * DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * ---------------------------------------------------------------------------- */ //------------------------------------------------------------------------------ // Headers //------------------------------------------------------------------------------ #include "lcd.h" #include #include //------------------------------------------------------------------------------ // Exported functions //------------------------------------------------------------------------------ //------------------------------------------------------------------------------ /// Enables the LCD controller, after waiting for the specified number of /// frames. /// \param frames Number of frames before the LCD is enabled. //------------------------------------------------------------------------------ void LCD_Enable(unsigned int frames) { ASSERT((frames & 0xFFFFFF80) == 0, "LCD_Enable: Wrong frames value.\n\r"); AT91C_BASE_LCDC->LCDC_PWRCON = AT91C_LCDC_PWR | (frames << 1); } //------------------------------------------------------------------------------ /// Disables the LCD controller, after waiting for the specified number of /// frames. /// \param frames Number of frames before the LCD is shut down. //------------------------------------------------------------------------------ void LCD_Disable(unsigned int frames) { ASSERT((frames & 0xFFFFFF80) == 0, "LCD_Disable: Wrong frames value.\n\r"); AT91C_BASE_LCDC->LCDC_PWRCON = frames << 1; } //------------------------------------------------------------------------------ /// Enables the DMA of the LCD controller. //------------------------------------------------------------------------------ void LCD_EnableDma() { AT91C_BASE_LCDC->LCDC_DMACON = AT91C_LCDC_DMAEN; } //------------------------------------------------------------------------------ /// Disables the DMA of the LCD controller. //------------------------------------------------------------------------------ void LCD_DisableDma() { AT91C_BASE_LCDC->LCDC_DMACON = 0; } //------------------------------------------------------------------------------ /// Configures the internal clock of the LCD controller given the master clock of /// the system and the desired pixel clock in MHz. /// \param masterClock Master clock frequency. /// \param pixelClock Pixel clock frequency. //------------------------------------------------------------------------------ void LCD_SetPixelClock(unsigned int masterClock, unsigned int pixelClock) { AT91C_BASE_LCDC->LCDC_LCDCON1 = ((masterClock / (2 * pixelClock)) - 1) << 12; } //------------------------------------------------------------------------------ /// Sets the type of display used with the LCD controller. /// \param displayType Type of display used. //------------------------------------------------------------------------------ void LCD_SetDisplayType(unsigned int displayType) { unsigned int value; ASSERT((displayType & ~AT91C_LCDC_DISTYPE) == 0, "LCD_SetDisplayType: Wrong display type value.\n\r"); value = AT91C_BASE_LCDC->LCDC_LCDCON2; value &= ~AT91C_LCDC_DISTYPE; value |= displayType; AT91C_BASE_LCDC->LCDC_LCDCON2 = value; } //------------------------------------------------------------------------------ /// Sets the scan mode used by the LCD (either single scan or double-scan). /// \param scanMode Scan mode to use. //------------------------------------------------------------------------------ void LCD_SetScanMode(unsigned int scanMode) { unsigned int value; ASSERT((scanMode & ~AT91C_LCDC_SCANMOD) == 0, "LCD_SetScanMode: Wrong scan mode value.\n\r"); value = AT91C_BASE_LCDC->LCDC_LCDCON2; value &= ~AT91C_LCDC_SCANMOD; value |= scanMode; AT91C_BASE_LCDC->LCDC_LCDCON2 = value; } //------------------------------------------------------------------------------ /// Sets the number of bits per pixel used by the LCD display. /// \param bitsPerPixel Number of bits per pixel to use. //------------------------------------------------------------------------------ void LCD_SetBitsPerPixel(unsigned int bitsPerPixel) { unsigned int value; ASSERT((bitsPerPixel & ~AT91C_LCDC_PIXELSIZE) == 0, "LCD_SetScanMode: Wrong bitsPerPixel value.\n\r"); value = AT91C_BASE_LCDC->LCDC_LCDCON2; value &= ~AT91C_LCDC_PIXELSIZE; value |= bitsPerPixel; AT91C_BASE_LCDC->LCDC_LCDCON2 = value; } //------------------------------------------------------------------------------ /// Sets the LCDD, LCDVSYNC, LCDHSYNC, LCDDOTCLK and LCDDEN signal polarities. /// \param lcdd LCDD signal polarity. /// \param lcdvsync LCDVSYNC signal polarity. /// \param lcdhsync LCDHSYNC signal polarity. /// \param lcddotclk LCDDOTCLK signal polarity. /// \param lcdden LCDDEN signal polarity. //------------------------------------------------------------------------------ void LCD_SetPolarities( unsigned int lcdd, unsigned int lcdvsync, unsigned int lcdhsync, unsigned int lcddotclk, unsigned int lcdden) { unsigned int value; ASSERT((lcdd & ~AT91C_LCDC_INVVD) == 0, "LCD_SetPolarities: Wrong lcdd value.\n\r"); ASSERT((lcdvsync & ~AT91C_LCDC_INVFRAME) == 0, "LCD_SetPolarities: Wrong lcdvsync value.\n\r"); ASSERT((lcdhsync & ~AT91C_LCDC_INVLINE) == 0, "LCD_SetPolarities: Wrong lcdhsync value.\n\r"); ASSERT((lcddotclk & ~AT91C_LCDC_INVCLK) == 0, "LCD_SetPolarities: Wrong lcddotclk value.\n\r"); ASSERT((lcdden & ~AT91C_LCDC_INVDVAL) == 0, "LCD_SetPolarities: Wrong lcdden value.\n\r"); value = AT91C_BASE_LCDC->LCDC_LCDCON2; value &= 0xFFFFE0FF; value |= lcdd | lcdvsync | lcdhsync | lcddotclk | lcdden; AT91C_BASE_LCDC->LCDC_LCDCON2 = value; } //------------------------------------------------------------------------------ /// Sets the LCD clock mode, i.e. always active or active only during display /// period. /// \param clockMode Clock mode to use. //------------------------------------------------------------------------------ void LCD_SetClockMode(unsigned int clockMode) { unsigned int value; ASSERT((clockMode & ~AT91C_LCDC_CLKMOD) == 0, "LCD_SetScanMode: Wrong scan mode value.\n\r"); value = AT91C_BASE_LCDC->LCDC_LCDCON2; value &= ~AT91C_LCDC_CLKMOD; value |= clockMode; AT91C_BASE_LCDC->LCDC_LCDCON2 = value; } //------------------------------------------------------------------------------ /// Sets the format of the frame buffer memory. /// \param format Memory ordering format. //------------------------------------------------------------------------------ void LCD_SetMemoryFormat(unsigned int format) { unsigned int value; ASSERT((format & ~AT91C_LCDC_MEMOR) == 0, "LCD_SetMemoryFormat: Wrong memory format value.\n\r"); value = AT91C_BASE_LCDC->LCDC_LCDCON2; value &= ~AT91C_LCDC_MEMOR; value |= format; AT91C_BASE_LCDC->LCDC_LCDCON2 = value; } //------------------------------------------------------------------------------ /// Sets the size in pixel of the LCD display. /// \param width Width in pixel of the LCD display. /// \param height Height in pixel of the LCD display. //------------------------------------------------------------------------------ void LCD_SetSize(unsigned int width, unsigned int height) { ASSERT(((width - 1) & 0xFFFFF800) == 0, "LCD_SetSize: Wrong width value.\n\r"); ASSERT(((height - 1) & 0xFFFFF800) == 0, "LCD_SetSize: Wrong height value.\n\r"); AT91C_BASE_LCDC->LCDC_LCDFRCFG = ((width - 1) << 21) | (height - 1); } //------------------------------------------------------------------------------ /// Sets the vertical timings of the LCD controller. Only meaningful when /// using a TFT display. /// \param vfp Number of idle lines at the end of a frame. /// \param vbp Number of idle lines at the beginning of a frame. /// \param vpw Vertical synchronization pulse width in number of lines. /// \param vhdly Delay between LCDVSYNC edge and LCDHSYNC rising edge, in /// LCDDOTCLK cycles. //------------------------------------------------------------------------------ void LCD_SetVerticalTimings( unsigned int vfp, unsigned int vbp, unsigned int vpw, unsigned int vhdly) { ASSERT((vfp & 0xFFFFFF00) == 0, "LCD_SetVerticalTimings: Wrong vfp value.\n\r"); ASSERT((vbp & 0xFFFFFF00) == 0, "LCD_SetVerticalTimings: Wrong vbp value.\n\r"); ASSERT(((vpw-1) & 0xFFFFFFC0) == 0, "LCD_SetVerticalTimings: Wrong vpw value.\n\r"); ASSERT(((vhdly-1) & 0xFFFFFFF0) == 0, "LCD_SetVerticalTimings: Wrong vhdly value.\n\r"); AT91C_BASE_LCDC->LCDC_TIM1 = vfp | (vbp << 8) | ((vpw-1) << 16) | ((vhdly-1) << 24); } //------------------------------------------------------------------------------ /// Sets the horizontal timings of the LCD controller. Meaningful for both /// STN and TFT displays. /// \param hbp Number of idle LCDDOTCLK cycles at the beginning of a line. /// \param hpw Width of the LCDHSYNC pulse, in LCDDOTCLK cycles. /// \param hfp Number of idel LCDDOTCLK cycles at the end of a line. //------------------------------------------------------------------------------ void LCD_SetHorizontalTimings( unsigned int hbp, unsigned int hpw, unsigned int hfp) { ASSERT(((hbp-1) & 0xFFFFFF00) == 0, "LCD_SetHorizontalTimings: Wrong hbp value.\n\r"); ASSERT(((hpw-1) & 0xFFFFFFC0) == 0, "LCD_SetHorizontalTimings: Wrong hpw value.\n\r"); ASSERT(((hfp-1) & 0xFFFFFF00) == 0, "LCD_SetHorizontalTimings: Wrong hfp value.\n\r"); AT91C_BASE_LCDC->LCDC_TIM2 = (hbp-1) | ((hpw-1) << 8) | ((hfp-1) << 24); } //------------------------------------------------------------------------------ /// Sets the address of the frame buffer in the LCD controller DMA. When using /// dual-scan mode, this is the upper frame buffer. /// \param address Frame buffer address. //------------------------------------------------------------------------------ void LCD_SetFrameBufferAddress(void *address) { AT91C_BASE_LCDC->LCDC_BA1 = (unsigned int) address; } //------------------------------------------------------------------------------ /// Sets the size in pixels of a frame (height * width * bpp). /// \param frameSize Size of frame in pixels. //------------------------------------------------------------------------------ void LCD_SetFrameSize(unsigned int frameSize) { ASSERT((frameSize & 0xFF800000) == 0, "LCD_SetFrameSize: Wrong frameSize value.\n\r"); AT91C_BASE_LCDC->LCDC_FRMCFG = frameSize | (AT91C_BASE_LCDC->LCDC_FRMCFG & 0xFF000000); } //------------------------------------------------------------------------------ /// Sets the DMA controller burst length. /// \param burstLength Desired burst length. //------------------------------------------------------------------------------ void LCD_SetBurstLength(unsigned int burstLength) { ASSERT(((burstLength-1) & 0xFFFFFF80) == 0, "LCD_SetBurstLength: Wrong burstLength value.\n\r"); AT91C_BASE_LCDC->LCDC_FRMCFG &= 0x00FFFFFF; AT91C_BASE_LCDC->LCDC_FRMCFG |= ((burstLength-1) << 24); AT91C_BASE_LCDC->LCDC_FIFO = 2048 - (2 * burstLength + 3); } //------------------------------------------------------------------------------ /// Sets the prescaler value of the contrast control PWM. /// \param prescaler Desired prescaler value. //------------------------------------------------------------------------------ void LCD_SetContrastPrescaler(unsigned int prescaler) { ASSERT((prescaler & ~AT91C_LCDC_PS) == 0, "LCD_SetContrastPrescaler: Wrong prescaler value\n\r"); AT91C_BASE_LCDC->LCDC_CTRSTCON &= ~AT91C_LCDC_PS; AT91C_BASE_LCDC->LCDC_CTRSTCON |= prescaler; } //------------------------------------------------------------------------------ /// Sets the polarity of the contrast PWM. /// \param polarity PWM polarity //------------------------------------------------------------------------------ void LCD_SetContrastPolarity(unsigned int polarity) { ASSERT((polarity & ~AT91C_LCDC_POL) == 0, "LCD_SetContrastPolarity: Wrong polarity value\n\r"); AT91C_BASE_LCDC->LCDC_CTRSTCON &= ~AT91C_LCDC_POL; AT91C_BASE_LCDC->LCDC_CTRSTCON |= polarity; } //------------------------------------------------------------------------------ /// Sets the threshold value of the constrast PWM. /// \param value PWM threshold value. //------------------------------------------------------------------------------ void LCD_SetContrastValue(unsigned int value) { ASSERT((value & ~AT91C_LCDC_CVAL) == 0, "LCD_SetContrastValue: Wrong value.\n\r"); AT91C_BASE_LCDC->LCDC_CTRSTVAL = value; } //------------------------------------------------------------------------------ /// Enables the contrast PWM generator. //------------------------------------------------------------------------------ void LCD_EnableContrast() { AT91C_BASE_LCDC->LCDC_CTRSTCON |= AT91C_LCDC_ENA_PWMGEMENABLED; }