363 lines
15 KiB
C
363 lines
15 KiB
C
/* ----------------------------------------------------------------------------
|
|
* 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;
|
|
}
|
|
|