/* ---------------------------------------------------------------------------- | |
* 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 <board.h> | |
#include <utility/assert.h> | |
//------------------------------------------------------------------------------ | |
// 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; | |
} | |