Add skeleton LCD driver

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@2662 42af7a65-404d-4744-a932-0658087f49c3

1 files changed, 1069 insertions, 0 deletions

diff --git a/nuttx/drivers/lcd/skeleton.c b/nuttx/drivers/lcd/skeleton.c
new file mode 100755
index 000000000..971d8d885
--- /dev/null
+++ b/nuttx/drivers/lcd/skeleton.c
@@ -0,0 +1,1069 @@
+/**************************************************************************************
+ * configs/sam3u-ek/src/up_lcd.c
+ * arch/arm/src/board/up_lcd.c
+ *
+ *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ * 3. Neither the name NuttX nor the names of its contributors may be
+ *    used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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.
+ *
+ **************************************************************************************/
+
+/**************************************************************************************
+ * The SAM3U-EK developement board features a TFT/Transmissive color LCD module with
+ * touch-screen, FTM280C12D, with integratd driver IC HX8346. The LCD display size
+ * is 2.8 inches, with a native resolution of 240 x 320 pixels.
+ *
+ *   LCD Module Pin Out:                         AT91SAM3U PIO:
+ *  -------------------------------------------- --------------------------------------
+ *   Pin Symbol Function                         LCD            PeriphA  PeriphB Extra
+ *  ---- ------ -------------------------------- -------------- -------- ------- ------
+ *   1   GND    Ground                           N/A            ---      ---     ---
+ *   2   CS     Chip Select                      PC16           NCS2     PWML3   AD12BAD5
+ *   3   RS     Register select signal           PB8 (see A1)   CTS0     A1      AD3
+ *   4   WR     Write operation signal           PB23 (NWE)     NWR0/NEW PCK1    ---
+ *   5   RD     Read operation signal            PB19 (NRD)     NRD      PWML2   ---
+ *   6   DB0    Data bus                         PB9            D0       DTR0    ---
+ *   7   DB1    Data bus                         PB10           D1       DSR0    ---
+ *   8   DB2    Data bus                         PB11           D2       DCD0    ---
+ *   9   DB3    Data bus                         PB12           D3       RI0     ---
+ *   10  DB4    Data bus                         PB13           D4       PWMH0   ---
+ *   11  DB5    Data bus                         PB14           D5       PWMH1   ---
+ *   12  DB6    Data bus                         PB15           D6       PWMH2   ---
+ *   13  DB7    Data bus                         PB16           D7       PMWH3   ---
+ *   14  DB8    Data bus                         PB25           D8       PWML0   ---
+ *   15  DB9    Data bus                         PB26           D9       PWML1   ---
+ *   16  DB10   Data bus                         PB27           D10      PWML2   ---
+ *   17  DB11   Data bus                         PB28           D11      PWML3   ---
+ *   18  DB12   Data bus                         PB29           D12      ---     ---
+ *   19  DB13   Data bus                         PB30           D13      ---     ---
+ *   20  DB14   Data bus                         PB31           D14      ---     ---
+ *   21  DB15   Data bus                         PB6            TIOA1    D15     AD1
+ *   22  NC     No connection                    N/A            ---      ---     ---
+ *   23  NC     No connection                    N/A            ---      ---     ---
+ *   24  RESET  Reset signal                     N/A            ---      ---     ---
+ *   25  GND    Ground                           N/A            ---      ---     ---
+ *   26  X+     Touch panel X_RIGHT              PA15           SPCK     PWMH2   ---
+ *   27  Y+     Touch panel Y_UP                 PA14           MOSI     ---     ---
+ *   28  X-     Touch panel X_LEFT               PA13           MISO     ---     ---
+ *   29  Y-     Touch panel Y_DOWN               PC14           A3       NPCS2   ---
+ *   30  GND    Ground                           N/A            ---      ---     ---
+ *   31  VDD1   Power supply for digital IO Pad  N/A            ---      ---     ---
+ *   32  VDD2   Power supply for analog circuit  N/A            ---      ---     ---
+ *   33  A1     Power supply for backlight       PB8 (see RS)   CTS0     A1      AD3
+ *   34  A2     Power supply for backlight       N/A            ---      ---     ---
+ *   35  A3     Power supply for backlight       N/A            ---      ---     ---
+ *   36  A4     Power supply for backlight       N/A            ---      ---     ---
+ *   37  NC     No connection                    N/A            ---      ---     ---
+ *   38  NC     No connection                    N/A            ---      ---     ---
+ *   39  K      Backlight ground                 N/A            ---      ---     ---
+ *
+ * The LCD module gets its reset from NRST. As explained previously, this NRST is
+ * shared with the JTAG port and the push button BP1. The LCD chip select signal is
+ * connected to NCS2 (a dedicated jumper can disable it, making NCS2 available for
+ * other custom usage).
+ *
+ * The SAM3U4E communicates with the LCD through PIOB where a 16-bit parallel
+ * “8080-like” protocol data bus has to be implemented by software.
+ *
+ * LCD backlight is made of 4 white chip LEDs in parallel, driven by an AAT3194
+ * charge pump, MN4. The AAT3194 is controlled by the SAM3U4E through a single line
+ * Simple Serial Control (S2Cwire) interface, which permits to enable, disable, and
+ * set the LED drive current (LED brightness control) from a 32-level logarithmic
+ * scale. Four resistors R93/R94/R95/R96 are implemented for optional current
+ * limitation.
+ *
+ * The LCD module integrates a 4-wire touch screen panel controlled by
+ * MN5, ADS7843, which is a slave device on the SAM3U4E SPI bus. The ADS7843 touch
+ * ADC auxiliary inputs IN3/IN4 are connected to test points for optional function
+ * extension.
+ *
+ **************************************************************************************/
+
+/**************************************************************************************
+ * Included Files
+ **************************************************************************************/
+
+#include <nuttx/config.h>
+
+#include <sys/types.h>
+#include <stdint.h>
+#include <stdbool.h>
+#include <string.h>
+#include <errno.h>
+#include <debug.h>
+
+#include <nuttx/arch.h>
+#include <nuttx/lcd.h>
+#include <nuttx/rgbcolors.h>
+
+#include <arch/irq.h>
+
+#include "up_arch.h"
+#include "sam3u_pmc.h"
+#include "sam3u_smc.h"
+#include "sam3u_internal.h"
+#include "sam3uek_internal.h"
+
+/**************************************************************************************
+ * Pre-processor Definitions
+ **************************************************************************************/
+
+/* Configuration **********************************************************************/
+
+/* Define the following to enable register-level debug output */
+
+#undef CONFIG_LCD_REGDEBUG
+
+/* Verbose debug must also be enabled */
+
+#ifndef CONFIG_DEBUG
+#  undef CONFIG_DEBUG_VERBOSE
+#  undef CONFIG_DEBUG_GRAPHICS
+#endif
+
+#ifndef CONFIG_DEBUG_VERBOSE
+#  undef CONFIG_LCD_REGDEBUG
+#endif
+
+/* CONFIG_LCD_MAXCONTRAST -- must be defined and less than 32 */
+
+#if !defined(CONFIG_LCD_MAXCONTRAST) || CONFIG_LCD_MAXCONTRAST < 1 || CONFIG_LCD_MAXCONTRAST > 31
+#  error "CONFIG_LCD_MAXCONTRAST must be defined in the range 1 to 31"
+#endif
+
+/* Debug ******************************************************************************/
+
+#ifdef CONFIG_LCD_REGDEBUG
+# define regdbg(format, arg...)  vdbg(format, ##arg)
+#else
+# define regdbg(x...)
+#endif
+
+/* Graphics Capbilities ***************************************************************/
+
+/* LCD resolution: 320 (columns) by 240 (rows).  The physical dimensions of the device
+ * are really 240 (columns) by 320 (rows), but unless CONFIG_SAM3U_240x320 is defined,
+ * we swap rows and columns in setcursor to make things behave nicer (there IS a
+ * performance hit for this swap!).
+ */
+
+#ifdef CONFIG_SAM3U_240x320
+#  define SAM3UEK_XRES         240
+#  define SAM3UEK_YRES         320
+#else
+#  define SAM3UEK_XRES         320
+#  define SAM3UEK_YRES         240
+#endif
+
+/* Color depth and format. BPP=16 R=6, G=6, B=5: RRRR RBBB BBBG GGGG */
+
+#define SAM3UEK_BPP          16
+#define SAM3UEK_RGBFMT       FB_FMT_RGB16_565
+
+/* HX834x Definitions  ****************************************************************/
+
+/* HX834x register select */
+
+#define HX843X_LCD_RS        (1 << 1)
+
+/* HX8347 ID code */
+
+#define HX8347_CHIPID        0x47
+
+/* HX8347 LCD Registers */
+
+#define HX8347_R00H          0x00
+#define HX8347_R01H          0x01
+#define HX8347_R02H          0x02
+#define HX8347_R03H          0x03
+#define HX8347_R04H          0x04
+#define HX8347_R05H          0x05
+#define HX8347_R06H          0x06
+#define HX8347_R07H          0x07
+#define HX8347_R08H          0x08
+#define HX8347_R09H          0x09
+#define HX8347_R0AH          0x0a
+#define HX8347_R0CH          0x0c
+#define HX8347_R0DH          0x0d
+#define HX8347_R0EH          0x0e
+#define HX8347_R0FH          0x0f
+#define HX8347_R10H          0x10
+#define HX8347_R11H          0x11
+#define HX8347_R12H          0x12
+#define HX8347_R13H          0x13
+#define HX8347_R14H          0x14
+#define HX8347_R15H          0x15
+#define HX8347_R16H          0x16
+#define HX8347_R18H          0x18
+#define HX8347_R19H          0x19
+#define HX8347_R1AH          0x1a
+#define HX8347_R1BH          0x1b
+#define HX8347_R1CH          0x1c
+#define HX8347_R1DH          0x1d
+#define HX8347_R1EH          0x1e
+#define HX8347_R1FH          0x1f
+#define HX8347_R20H          0x20
+#define HX8347_R21H          0x21
+#define HX8347_R22H          0x22
+#define HX8347_R23H          0x23
+#define HX8347_R24H          0x24
+#define HX8347_R25H          0x25
+#define HX8347_R26H          0x26
+#define HX8347_R27H          0x27
+#define HX8347_R28H          0x28
+#define HX8347_R29H          0x29
+#define HX8347_R2AH          0x2a
+#define HX8347_R2BH          0x2b
+#define HX8347_R2CH          0x2c
+#define HX8347_R2DH          0x2d
+#define HX8347_R35H          0x35
+#define HX8347_R36H          0x36
+#define HX8347_R37H          0x37
+#define HX8347_R38H          0x38
+#define HX8347_R39H          0x39
+#define HX8347_R3AH          0x3a
+#define HX8347_R3BH          0x3b
+#define HX8347_R3CH          0x3c
+#define HX8347_R3DH          0x3d
+#define HX8347_R3EH          0x3e
+#define HX8347_R40H          0x40
+#define HX8347_R41H          0x41
+#define HX8347_R42H          0x42
+#define HX8347_R43H          0x43
+#define HX8347_R44H          0x44
+#define HX8347_R45H          0x45
+#define HX8347_R46H          0x46
+#define HX8347_R47H          0x47
+#define HX8347_R48H          0x48
+#define HX8347_R49H          0x49
+#define HX8347_R4AH          0x4a
+#define HX8347_R4BH          0x4b
+#define HX8347_R4CH          0x4c
+#define HX8347_R4DH          0x4d
+#define HX8347_R4EH          0x4e
+#define HX8347_R4FH          0x4f
+#define HX8347_R50H          0x50
+#define HX8347_R51H          0x51
+#define HX8347_R64H          0x64
+#define HX8347_R65H          0x65
+#define HX8347_R66H          0x66
+#define HX8347_R67H          0x67
+#define HX8347_R70H          0x70
+#define HX8347_R72H          0x72
+#define HX8347_R90H          0x90
+#define HX8347_R91H          0x91
+#define HX8347_R93H          0x93
+#define HX8347_R94H          0x94
+#define HX8347_R95H          0x95
+
+/**************************************************************************************
+ * Private Type Definition
+ **************************************************************************************/
+
+/* This structure describes the state of this driver */
+
+struct sam3u_dev_s
+{
+  /* Publically visible device structure */
+
+  struct lcd_dev_s dev;
+
+  /* Private device state */
+
+  uint8_t power;    /* The current power setting */
+};
+
+/**************************************************************************************
+ * Private Function Protototypes
+ **************************************************************************************/
+
+/* Low-level HX834x Register access */
+
+static void sam3u_putreg(uint16_t reg,  uint16_t data);
+static uint16_t sam3u_getreg(uint16_t reg);
+
+/* Misc. LCD Helper Functions */
+
+static void sam3u_setcursor(fb_coord_t row, fb_coord_t col);
+static inline void sam3u_wrsetup(void);
+static inline void sam3u_wrram(uint16_t color);
+static inline uint16_t sam3u_rdram(void);
+static void sam3u_lcdon(void);
+static void sam3u_lcdoff(void);
+
+#ifdef CONFIG_DEBUG_GRAPHICS
+static void sam3u_dumpreg(uint8_t startreg, uint8_t endreg);
+#else
+#  define sam3u_dumpreg(startreg,endreg)
+#endif
+
+/* LCD Data Transfer Methods */
+
+static int sam3u_putrun(fb_coord_t row, fb_coord_t col, FAR const uint8_t *buffer,
+             size_t npixels);
+static int sam3u_getrun(fb_coord_t row, fb_coord_t col, FAR uint8_t *buffer,
+             size_t npixels);
+
+/* LCD Configuration */
+
+static int sam3u_getvideoinfo(FAR struct lcd_dev_s *dev,
+             FAR struct fb_videoinfo_s *vinfo);
+static int sam3u_getplaneinfo(FAR struct lcd_dev_s *dev, unsigned int planeno,
+             FAR struct lcd_planeinfo_s *pinfo);
+
+/* LCD RGB Mapping */
+
+#ifdef CONFIG_FB_CMAP
+#  error "RGB color mapping not supported by this driver"
+#endif
+
+/* Cursor Controls */
+
+#ifdef CONFIG_FB_HWCURSOR
+#  error "Cursor control not supported by this driver"
+#endif
+
+/* LCD Specific Controls */
+
+static int sam3u_getpower(struct lcd_dev_s *dev);
+static int sam3u_setpower(struct lcd_dev_s *dev, int power);
+static int sam3u_getcontrast(struct lcd_dev_s *dev);
+static int sam3u_setcontrast(struct lcd_dev_s *dev, unsigned int contrast);
+
+/**************************************************************************************
+ * Private Data
+ **************************************************************************************/
+
+/* This is working memory allocated by the LCD driver for each LCD device
+ * and for each color plane.  This memory will hold one raster line of data.
+ * The size of the allocated run buffer must therefor be at least
+ * (bpp * xres / 8).  Actual alignment of the buffer must conform to the
+ * bitwidth of the underlying pixel type.
+ *
+ * If there are multiple planes, they may share the same working buffer
+ * because different planes will not be operate on concurrently.  However,
+ * if there are multiple LCD devices, they must each have unique run buffers.
+ */
+
+static uint16_t g_runbuffer[SAM3UEK_XRES];
+
+/* This structure describes the overall LCD video controller */
+
+static const struct fb_videoinfo_s g_videoinfo =
+{
+  .fmt     = SAM3UEK_RGBFMT,      /* Color format: RGB16-565: RRRR RGGG GGGB BBBB */
+  .xres    = SAM3UEK_XRES,        /* Horizontal resolution in pixel columns */
+  .yres    = SAM3UEK_YRES,        /* Vertical resolution in pixel rows */
+  .nplanes = 1,                   /* Number of color planes supported */
+};
+
+/* This is the standard, NuttX Plane information object */
+
+static const struct lcd_planeinfo_s g_planeinfo = 
+{
+  .putrun = sam3u_putrun,          /* Put a run into LCD memory */
+  .getrun = sam3u_getrun,          /* Get a run from LCD memory */
+  .buffer = (uint8_t*)g_runbuffer, /* Run scratch buffer */
+  .bpp    = SAM3UEK_BPP,           /* Bits-per-pixel */
+};
+
+/* This is the standard, NuttX LCD driver object */
+
+static struct sam3u_dev_s g_lcddev_s = 
+{
+  .dev =
+  {
+    /* LCD Configuration */
+ 
+    .getvideoinfo = sam3u_getvideoinfo,
+    .getplaneinfo = sam3u_getplaneinfo,
+
+    /* LCD RGB Mapping -- Not supported */
+    /* Cursor Controls -- Not supported */
+
+    /* LCD Specific Controls */
+
+    .getpower     = sam3u_getpower,
+    .setpower     = sam3u_setpower,
+    .getcontrast  = sam3u_getcontrast,
+    .setcontrast  = sam3u_setcontrast,
+  },
+};
+
+/**************************************************************************************
+ * Private Functions
+ **************************************************************************************/
+
+/**************************************************************************************
+ * Name:  sam3u_putreg
+ *
+ * Description:
+ *   Write to a HX834x register
+ *
+ **************************************************************************************/
+
+static void sam3u_putreg(uint16_t reg,  uint16_t data)
+{
+  regdbg("base: %08x RS: %04x data: %04x\n", LCD_BASE, LCD_BASE + HX843X_LCD_RS, data);
+  putreg16(reg, LCD_BASE);
+  putreg16(data, LCD_BASE + HX843X_LCD_RS);
+}
+
+/**************************************************************************************
+ * Name:  sam3u_getreg
+ *
+ * Description:
+ *   Read from a HX834x register
+ *
+ **************************************************************************************/
+
+static uint16_t sam3u_getreg(uint16_t reg)
+{
+  uint16_t data;
+  putreg16(reg, LCD_BASE);
+  data = getreg16(LCD_BASE + HX843X_LCD_RS);
+  regdbg("base: %08x RS: %04x data: %04x\n", LCD_BASE, LCD_BASE + HX843X_LCD_RS, data);
+  return data;
+}
+
+/**************************************************************************************
+ * Name:  sam3u_setcursor
+ *
+ * Description:
+ *   Set the LCD cursor position.
+ *
+ **************************************************************************************/
+
+static void sam3u_setcursor(fb_coord_t row, fb_coord_t col)
+{
+  uint8_t  x1;
+  uint8_t  x2;
+  uint8_t  y1;
+  uint8_t  y2;
+
+  /* Get the upper and lower x and y positions */
+
+  x1  = (uint8_t)col;
+  x2  = (uint8_t)((uint16_t)col >> 8);
+
+  y1  = (uint8_t)row;
+  y2  = (uint8_t)((uint16_t)row >> 8);
+
+  /* Then set the cursor position */
+
+  sam3u_putreg(HX8347_R02H, x2);        /* column high */
+  sam3u_putreg(HX8347_R03H, x1);        /* column low */
+  sam3u_putreg(HX8347_R06H, y2);        /* row high */
+  sam3u_putreg(HX8347_R07H, y1);        /* row low */
+}
+
+/**************************************************************************************
+ * Name:  sam3u_wrsetup
+ *
+ * Description:
+ *   Set up for a GRAM write operation.
+ *
+ **************************************************************************************/
+
+static inline void sam3u_wrsetup(void)
+{
+  putreg16(HX8347_R22H, LCD_BASE);
+}
+
+/**************************************************************************************
+ * Name: sam3u_wrram
+ *
+ * Description:
+ *   Write to the 16-bit GRAM register
+ *
+ **************************************************************************************/
+
+static inline void sam3u_wrram(uint16_t color)
+{
+  putreg16(color, LCD_BASE + HX843X_LCD_RS);
+}
+
+/**************************************************************************************
+ * Name: sam3u_rdram
+ *
+ * Description:
+ *   Read from the 16-bit GRAM register
+ *
+ **************************************************************************************/
+
+static inline uint16_t sam3u_rdram(void)
+{
+  return getreg16(LCD_BASE + HX843X_LCD_RS);
+}
+
+/**************************************************************************************
+ * Name:  sam3u_lcdon
+ *
+ * Description:
+ *   Turn the LCD on
+ *
+ **************************************************************************************/
+
+static void sam3u_lcdon(void)
+{
+  /* Display ON Setting */
+
+  gvdbg("ON\n");
+  sam3u_putreg(HX8347_R90H, 0x7f);      /* SAP=0111 1111 */
+  sam3u_putreg(HX8347_R26H, 0x04);      /* GON=0 DTE=0 D=01 */
+  up_mdelay(100);
+  sam3u_putreg(HX8347_R26H, 0x24);      /* GON=1 DTE=0 D=01 */
+  sam3u_putreg(HX8347_R26H, 0x2c);      /* GON=1 DTE=0 D=11 */
+  up_mdelay(100);
+  sam3u_putreg(HX8347_R26H, 0x3c);      /* GON=1 DTE=1 D=11 */
+}
+
+/**************************************************************************************
+ * Name:  sam3u_lcdoff
+ *
+ * Description:
+ *   Turn the LCD off
+ *
+ **************************************************************************************/
+
+static void sam3u_lcdoff(void)
+{
+  gvdbg("OFF\n");
+  sam3u_putreg(HX8347_R90H, 0x00);      /* SAP=0000 0000 */
+  sam3u_putreg(HX8347_R26H, 0x00);      /* GON=0 DTE=0 D=00 */
+}
+
+/**************************************************************************************
+ * Name:  sam3u_dumpreg
+ *
+ * Description:
+ *   Dump a range of LCD registers.
+ *
+ **************************************************************************************/
+
+#ifdef CONFIG_DEBUG_GRAPHICS
+static void sam3u_dumpreg(uint8_t startreg, uint8_t endreg)
+{
+  uint16_t value;
+  uint8_t  addr;
+
+  for (addr = startreg; addr <= endreg; addr++)
+    {
+      value = sam3u_getreg(addr);
+      gdbg(" %02x: %04x\n", addr, value);
+    }
+}
+#endif
+
+/**************************************************************************************
+ * Name:  sam3u_putrun
+ *
+ * Description:
+ *   This method can be used to write a partial raster line to the LCD:
+ *
+ *   row     - Starting row to write to (range: 0 <= row < yres)
+ *   col     - Starting column to write to (range: 0 <= col <= xres-npixels)
+ *   buffer  - The buffer containing the run to be written to the LCD
+ *   npixels - The number of pixels to write to the LCD
+ *             (range: 0 < npixels <= xres-col)
+ *
+ **************************************************************************************/
+
+static int sam3u_putrun(fb_coord_t row, fb_coord_t col, FAR const uint8_t *buffer,
+                        size_t npixels)
+{
+  uint16_t *run = (uint16_t*)buffer;
+  unsigned int i;
+
+  /* Buffer must be provided and aligned to a 16-bit address boundary */
+
+  gvdbg("row: %d col: %d npixels: %d\n", row, col, npixels);
+  DEBUGASSERT(buffer && ((uintptr_t)buffer & 1) == 0);
+
+#ifdef CONFIG_SAM3U_240x320
+  /* Set up to write the run. */
+
+  sam3u_setcursor(row, col);
+  sam3u_wrsetup();
+
+  /* Write the run to GRAM. */
+
+  for (i = 0; i < npixels; i++)
+    {
+      /* Write the pixel pixel to GRAM */
+
+      sam3u_wrram(*run++);
+    }
+#else
+  /* Write the run to GRAM.  Because rows and colums are swapped, we need to reset
+   * the cursor position for every pixel.  We could do this much faster if we
+   * adapted to the strange device aspect ratio.
+   */
+
+  col = 319-col;
+  for (i = 0; i < npixels; i++)
+    {
+      /* Set up to write the next pixel. Swapping x and y orientations so that the image
+       * comes out with the 320x240 aspect ratio (not the native 240x320).  That is:
+       *
+       *   row: 0-239 maps to x: 0-239
+       *   col: 0-319 maps to y: 319-0
+       */
+
+      sam3u_setcursor(col--, row);
+      sam3u_wrsetup();
+
+      /* Write the pixel pixel to GRAM */
+
+      sam3u_wrram(*run++);
+    }
+#endif
+  return OK;
+}
+
+/**************************************************************************************
+ * Name:  sam3u_getrun
+ *
+ * Description:
+ *   This method can be used to read a partial raster line from the LCD:
+ *
+ *  row     - Starting row to read from (range: 0 <= row < yres)
+ *  col     - Starting column to read read (range: 0 <= col <= xres-npixels)
+ *  buffer  - The buffer in which to return the run read from the LCD
+ *  npixels - The number of pixels to read from the LCD
+ *            (range: 0 < npixels <= xres-col)
+ *
+ **************************************************************************************/
+
+static int sam3u_getrun(fb_coord_t row, fb_coord_t col, FAR uint8_t *buffer,
+                        size_t npixels)
+{
+  uint16_t *run = (uint16_t*)buffer;
+  unsigned int i;
+
+  /* Buffer must be provided and aligned to a 16-bit address boundary */
+
+  gvdbg("row: %d col: %d npixels: %d\n", row, col, npixels);
+  DEBUGASSERT(buffer && ((uintptr_t)buffer & 1) == 0);
+
+#ifdef CONFIG_SAM3U_240x320
+  /* Set up to read the run */
+
+  sam3u_setcursor(row, col);
+
+  /* Read the run from GRAM. */
+
+  for (i = 0; i < npixels; i++)
+    {
+      /* Read the next pixel */
+
+      *run++ = sam3u_rdram();
+    }
+#else
+  /* Read the run from GRAM  Because rows and colums are swapped, we need to reset
+   * the cursor position for every pixel.  We could do this much faster if we
+   * adapted to the strange device aspect ratio.
+   */
+
+  col = 319 - col;
+  for (i = 0; i < npixels; i++)
+    {
+      /* Read the next pixel.. Swapping x and y orientations so that the image
+       * comes out with the 320x240 aspect ratio (not the native 240x320).  That is:
+       *
+       *   row: 0-239 maps to x: 0-239
+       *   col: 0-319 maps to y: 319-0
+       */
+
+      sam3u_setcursor(col--, row);
+      *run++ = sam3u_rdram();
+    }
+#endif
+  return OK;
+}
+
+/**************************************************************************************
+ * Name:  sam3u_getvideoinfo
+ *
+ * Description:
+ *   Get information about the LCD video controller configuration.
+ *
+ **************************************************************************************/
+
+static int sam3u_getvideoinfo(FAR struct lcd_dev_s *dev,
+                              FAR struct fb_videoinfo_s *vinfo)
+{
+  DEBUGASSERT(dev && vinfo);
+  gvdbg("fmt: %d xres: %d yres: %d nplanes: %d\n",
+         g_videoinfo.fmt, g_videoinfo.xres, g_videoinfo.yres, g_videoinfo.nplanes);
+  memcpy(vinfo, &g_videoinfo, sizeof(struct fb_videoinfo_s));
+  return OK;
+}
+
+/**************************************************************************************
+ * Name:  sam3u_getplaneinfo
+ *
+ * Description:
+ *   Get information about the configuration of each LCD color plane.
+ *
+ **************************************************************************************/
+
+static int sam3u_getplaneinfo(FAR struct lcd_dev_s *dev, unsigned int planeno,
+                              FAR struct lcd_planeinfo_s *pinfo)
+{
+  DEBUGASSERT(dev && pinfo && planeno == 0);
+  gvdbg("planeno: %d bpp: %d\n", planeno, g_planeinfo.bpp);
+  memcpy(pinfo, &g_planeinfo, sizeof(struct lcd_planeinfo_s));
+  return OK;
+}
+
+/**************************************************************************************
+ * Name:  sam3u_getpower
+ *
+ * Description:
+ *   Get the LCD panel power status (0: full off - CONFIG_LCD_MAXPOWER: full on. On
+ *   backlit LCDs, this setting may correspond to the backlight setting.
+ *
+ **************************************************************************************/
+
+static int sam3u_getpower(struct lcd_dev_s *dev)
+{
+  struct sam3u_dev_s *priv = (struct sam3u_dev_s *)dev;
+  DEBUGASSERT(dev);
+  gvdbg("power: %d\n", priv->power);
+  return priv->power;
+}
+
+/**************************************************************************************
+ * Name:  sam3u_setpower
+ *
+ * Description:
+ *   Enable/disable LCD panel power (0: full off - CONFIG_LCD_MAXPOWERL: full on). On
+ *   backlit LCDs, this setting may correspond to the backlight setting.
+ *
+ *   LCD backlight is made of 4 white chip LEDs in parallel, driven by an AAT3194 charge
+ *   pump, MN4. The AAT3194 is controlled by the SAM3U4E through a single line. Simple
+ *   Serial Control (S2Cwire) interface, which permits to enable, disable, and set the
+ *   LED drive current (LED brightness control) from a 32-level logarithmic scale. Four
+ *   resistors R93/R94/R95/R96 are implemented for optional current limitation.
+ *
+ **************************************************************************************/
+
+static int sam3u_setpower(struct lcd_dev_s *dev, int power)
+{
+  struct sam3u_dev_s *priv = (struct sam3u_dev_s *)dev;
+  unsigned int i;
+
+  gvdbg("power: %d\n", power);
+  DEBUGASSERT(power <= CONFIG_LCD_MAXPOWER);
+
+  /* Switch off backlight */
+
+  sam3u_gpiowrite(GPIO_LCD_BKL, false);
+
+  /* For for at least 500uS to drain the charge pump */
+
+  up_udelay(500);
+
+  /* Set new backlight level by pumping "level" times */
+
+  for (i = 0; i < power; i++)
+    {
+      sam3u_gpiowrite(GPIO_LCD_BKL, false);
+      sam3u_gpiowrite(GPIO_LCD_BKL, false);
+      sam3u_gpiowrite(GPIO_LCD_BKL, false);
+      sam3u_gpiowrite(GPIO_LCD_BKL, true);;
+      sam3u_gpiowrite(GPIO_LCD_BKL, true);;
+      sam3u_gpiowrite(GPIO_LCD_BKL, true);;
+    }
+
+  /* This delay seems to be required... perhaps because of the big current jump? */
+
+  if (power != LCD_FULL_OFF)
+    {
+      up_mdelay(100);
+    }
+
+  priv->power = power;
+  return OK;
+}
+
+/**************************************************************************************
+ * Name:  sam3u_getcontrast
+ *
+ * Description:
+ *   Get the current contrast setting (0-CONFIG_LCD_MAXCONTRAST).
+ *
+ **************************************************************************************/
+
+static int sam3u_getcontrast(struct lcd_dev_s *dev)
+{
+  gvdbg("Not implemented\n");
+  return -ENOSYS;
+}
+
+/**************************************************************************************
+ * Name:  sam3u_getcontrast
+ *
+ * Description:
+ *   Set LCD panel contrast (0-CONFIG_LCD_MAXCONTRAST).
+ *
+ **************************************************************************************/
+
+static int sam3u_setcontrast(struct lcd_dev_s *dev, unsigned int contrast)
+{
+  gvdbg("contrast: %d\n", contrast);
+  return -ENOSYS;
+}
+
+/**************************************************************************************
+ * Public Functions
+ **************************************************************************************/
+
+/**************************************************************************************
+ * Name:  up_lcdinitialize
+ *
+ * Description:
+ *   Initialize the LCD video hardware.  The initial state of the LCD is fully
+ *   initialized, display memory cleared, and the LCD ready to use, but with the power
+ *   setting at 0 (full off).
+ *
+ **************************************************************************************/
+
+int up_lcdinitialize(void)
+{
+#ifdef CONFIG_DEBUG_GRAPHICS
+  uint16_t hxregval;
+#endif
+  uint32_t regval;
+  unsigned int i;
+
+  gvdbg("Initializing\n");
+
+  /* Enable LCD EXTCS2 pins */
+
+  sam3u_configgpio(GPIO_LCD_NCS2);
+  sam3u_configgpio(GPIO_LCD_RS);
+  sam3u_configgpio(GPIO_LCD_NWE);
+  sam3u_configgpio(GPIO_LCD_NRD);
+
+  sam3u_configgpio(GPIO_LCD_D0);
+  sam3u_configgpio(GPIO_LCD_D1);
+  sam3u_configgpio(GPIO_LCD_D2);
+  sam3u_configgpio(GPIO_LCD_D3);
+  sam3u_configgpio(GPIO_LCD_D4);
+  sam3u_configgpio(GPIO_LCD_D5);
+  sam3u_configgpio(GPIO_LCD_D6);
+  sam3u_configgpio(GPIO_LCD_D7);
+  sam3u_configgpio(GPIO_LCD_D8);
+  sam3u_configgpio(GPIO_LCD_D9);
+  sam3u_configgpio(GPIO_LCD_D10);
+  sam3u_configgpio(GPIO_LCD_D11);
+  sam3u_configgpio(GPIO_LCD_D12);
+  sam3u_configgpio(GPIO_LCD_D13);
+  sam3u_configgpio(GPIO_LCD_D14);
+  sam3u_configgpio(GPIO_LCD_D15);
+
+#ifdef CONFIG_LCD_REGDEBUG
+  sam3u_dumpgpio(GPIO_PORT_PIOB, "PORTB");
+  sam3u_dumpgpio(GPIO_PORT_PIOC, "PORTC");
+#endif
+
+  /* Configure LCD Backlight Pin */
+
+  sam3u_configgpio(GPIO_LCD_D15);
+
+  /* Enable SMC peripheral clock */
+
+  putreg32((1 << SAM3U_PID_SMC), SAM3U_PMC_PCER);
+  regdbg("PMC PCSR: %08x SMC: %08x\n", getreg32(SAM3U_PMC_PCSR), (1 << SAM3U_PID_SMC));
+
+  /* Configure SMC CS2 */
+
+  regval = (4 << SMCCS_SETUP_NWESETUP_SHIFT) | (2 << SMCCS_SETUP_NCSWRSETUP_SHIFT) |
+           (4 << SMCCS_SETUP_NRDSETUP_SHIFT) | (2 << SMCCS_SETUP_NCSRDSETUP_SHIFT);
+  putreg32(regval, SAM3U_SMCCS_SETUP(2));
+
+  regval = (5 << SMCCS_PULSE_NWEPULSE_SHIFT) | (18 << SMCCS_PULSE_NCSWRPULSE_SHIFT) |
+           (5 << SMCCS_PULSE_RDPULSE_SHIFT)  | (18 << SMCCS_PULSE_NCSRDPULSE_SHIFT);
+  putreg32(regval, SAM3U_SMCCS_PULSE(2));
+
+  regval = (22 << SMCCS_CYCLE_NWECYCLE_SHIFT) | (22 << SMCCS_CYCLE_NRDCYCLE_SHIFT);
+  putreg32(regval, SAM3U_SMCCS_CYCLE(2));
+
+  regval  = getreg32(SAM3U_SMCCS_MODE(2));
+  regval &= ~(SMCCS_MODE_DBW_MASK | SMCCS_MODE_PMEN);
+  regval |= (SMCCS_MODE_READMODE)  | (SMCCS_MODE_WRITEMODE) | (SMCCS_MODE_DBW_16BITS);
+  putreg32(regval, SAM3U_SMCCS_MODE(2));
+
+  regdbg("SMC SETUP[%08x]: %08x PULSE[%08x]: %08x\n",
+         SAM3U_SMCCS_SETUP(2), getreg32(SAM3U_SMCCS_SETUP(2)),
+         SAM3U_SMCCS_PULSE(2), getreg32(SAM3U_SMCCS_PULSE(2)));
+  regdbg("    CYCLE[%08x]: %08x MODE[%08x]:  %08x\n",
+         SAM3U_SMCCS_CYCLE(2), getreg32(SAM3U_SMCCS_CYCLE(2)),
+         SAM3U_SMCCS_MODE(2),  getreg32(SAM3U_SMCCS_MODE(2)));
+
+  /* Check HX8347 Chip ID */
+
+#ifdef CONFIG_DEBUG_GRAPHICS
+  hxregval = sam3u_getreg(HX8347_R67H);
+  gvdbg("Chip ID: %04x\n", hxregval);
+  if (hxregval != HX8347_CHIPID)
+    {
+      gdbg("Bad chip ID: %04x Expected: %04x\n", hxregval, HX8347_CHIPID);
+      return -ENODEV;
+    }
+#endif
+
+  /* Initialize LCD controller (HX8347) -- Magic code from Atmel LCD example */
+
+  /* Start internal OSC */
+
+  sam3u_putreg(HX8347_R19H, 0x49);      /* OSCADJ=10 0000 OSD_EN=1 60Hz */
+  sam3u_putreg(HX8347_R93H, 0x0C);      /* RADJ=1100 */
+
+  /* Power on flow */
+
+  sam3u_putreg(HX8347_R44H, 0x4D);      /* VCM=100 1101 */
+  sam3u_putreg(HX8347_R45H, 0x11);      /* VDV=1 0001 */
+  sam3u_putreg(HX8347_R20H, 0x40);      /* BT=0100 */
+  sam3u_putreg(HX8347_R1DH, 0x07);      /* VC1=111 */
+  sam3u_putreg(HX8347_R1EH, 0x00);      /* VC3=000 */
+  sam3u_putreg(HX8347_R1FH, 0x04);      /* VRH=0100 */
+  sam3u_putreg(HX8347_R1CH, 0x04);      /* AP=100 */
+  sam3u_putreg(HX8347_R1BH, 0x10);      /* GASENB=0 PON=1 DK=0 XDK=0 DDVDH_TRI=0 STB=0 */
+  up_mdelay(50);
+  sam3u_putreg(HX8347_R43H, 0x80);      /* Set VCOMG=1 */
+  up_mdelay(50);
+
+  /* Gamma for CMO 2.8 */
+
+  sam3u_putreg(HX8347_R46H, 0x95);
+  sam3u_putreg(HX8347_R47H, 0x51);
+  sam3u_putreg(HX8347_R48H, 0x00);
+  sam3u_putreg(HX8347_R49H, 0x36);
+  sam3u_putreg(HX8347_R4AH, 0x11);
+  sam3u_putreg(HX8347_R4BH, 0x66);
+  sam3u_putreg(HX8347_R4CH, 0x14);
+  sam3u_putreg(HX8347_R4DH, 0x77);
+  sam3u_putreg(HX8347_R4EH, 0x13);
+  sam3u_putreg(HX8347_R4FH, 0x4c);
+  sam3u_putreg(HX8347_R50H, 0x46);
+  sam3u_putreg(HX8347_R51H, 0x46);
+
+  /* 240x320 window setting */
+
+  sam3u_putreg(HX8347_R02H, 0x00);      /* Column address start2 */
+  sam3u_putreg(HX8347_R03H, 0x00);      /* Column address start1 */
+  sam3u_putreg(HX8347_R04H, 0x00);      /* Column address end2 */
+  sam3u_putreg(HX8347_R05H, 0xef);      /* Column address end1 */
+  sam3u_putreg(HX8347_R06H, 0x00);      /* Row address start2 */
+  sam3u_putreg(HX8347_R07H, 0x00);      /* Row address start1 */
+  sam3u_putreg(HX8347_R08H, 0x01);      /* Row address end2 */
+  sam3u_putreg(HX8347_R09H, 0x3f);      /* Row address end1 */
+
+  /* Display Setting */
+  
+  sam3u_putreg(HX8347_R01H, 0x06);      /* IDMON=0 INVON=1 NORON=1 PTLON=0 */
+  sam3u_putreg(HX8347_R16H, 0xc8);      /* MY=1 MX=1 MV=0 BGR=1 */
+  sam3u_putreg(HX8347_R23H, 0x95);      /* N_DC=1001 0101 */
+  sam3u_putreg(HX8347_R24H, 0x95);      /* P_DC=1001 0101 */
+  sam3u_putreg(HX8347_R25H, 0xff);      /* I_DC=1111 1111 */
+  sam3u_putreg(HX8347_R27H, 0x06);      /* N_BP=0000 0110 */
+  sam3u_putreg(HX8347_R28H, 0x06);      /* N_FP=0000 0110 */
+  sam3u_putreg(HX8347_R29H, 0x06);      /* P_BP=0000 0110 */
+  sam3u_putreg(HX8347_R2AH, 0x06);      /* P_FP=0000 0110 */
+  sam3u_putreg(HX8347_R2CH, 0x06);      /* I_BP=0000 0110 */
+  sam3u_putreg(HX8347_R2DH, 0x06);      /* I_FP=0000 0110 */
+  sam3u_putreg(HX8347_R3AH, 0x01);      /* N_RTN=0000 N_NW=001 */
+  sam3u_putreg(HX8347_R3BH, 0x01);      /* P_RTN=0000 P_NW=001 */
+  sam3u_putreg(HX8347_R3CH, 0xf0);      /* I_RTN=1111 I_NW=000 */
+  sam3u_putreg(HX8347_R3DH, 0x00);      /* DIV=00 */
+  sam3u_putreg(HX8347_R3EH, 0x38);      /* SON=38h */
+  sam3u_putreg(HX8347_R40H, 0x0f);      /* GDON=0Fh */
+  sam3u_putreg(HX8347_R41H, 0xf0);      /* GDOF=F0h */
+
+  /* Set LCD backlight to FULL off */
+
+  sam3u_setpower(&g_lcddev_s.dev, LCD_FULL_OFF);
+
+  /* Fill the display memory with the color BLACK */
+
+  sam3u_setcursor(0, 0);
+  sam3u_wrsetup();
+  for (i = 0; i < (SAM3UEK_XRES * SAM3UEK_YRES); i++)
+    {
+        sam3u_wrram(RGB16_BLACK);
+    }
+
+  /* Turn the LCD on (but with the backlight off) */
+
+  sam3u_lcdon();
+  return OK;
+}
+
+/**************************************************************************************
+ * Name:  up_lcdgetdev
+ *
+ * Description:
+ *   Return a a reference to the LCD object for the specified LCD.  This allows
+ *   support for multiple LCD devices.
+ *
+ **************************************************************************************/
+
+FAR struct lcd_dev_s *up_lcdgetdev(int lcddev)
+{
+  gvdbg("lcddev: %d\n", lcddev);
+  return lcddev == 0 ? &g_lcddev_s.dev : NULL;
+}
+
+/**************************************************************************************
+ * Name:  up_lcduninitialize
+ *
+ * Description:
+ *   Unitialize the framebuffer support.
+ *
+ **************************************************************************************/
+
+void up_lcduninitialize(void)
+{
+  /* Turn the LCD off */
+
+  sam3u_lcdoff();
+
+  /* Set LCD backlight to FULL off */
+
+  sam3u_setpower(&g_lcddev_s.dev, LCD_FULL_OFF);
+
+  /* Disable SMC peripheral clock */
+
+  putreg32((1 << SAM3U_PID_SMC), SAM3U_PMC_PCDR);
+}
+
+