Merge remote-tracking branch 'origin/master' into usbhub

ChangeLog

@@ -10266,4 +10266,6 @@
 	* sched/semaphore/sem_wait.c:  Missing comma on debug statement caused
 	  compile error with DEBUG on.  Why hasn't that been noted before?
 	  (2015-04-23).
+	* drivers/lcd and include/nuttx/drivers: RA8875 LCD driver contributed
+	  by Marten Svanfeldt (2015-04-24).
 

drivers/lcd/Kconfig

@@ -718,6 +718,60 @@ config LCD_ILI9341_IFACE1_RGB565
 endchoice
 endif
 
+config LCD_RA8875
+	bool "RA8875 LCD Display Controller"
+	default n
+	---help---
+		LCD controller driver for RA8875 by RAiO Technologies Inc.
+
+if LCD_RA8875
+
+choice
+	prompt "MCU Interface width"
+	default LCD_RA8875_8BIT
+	---help---
+		Bit-width of MCU interface (8 or 16)
+
+config LCD_RA8875_8BIT
+	bool "8 bit"
+
+config LCD_RA8875_16BIT
+	bool "16 bit"
+
+endchoice # MCU Interface width
+
+choice
+	prompt "Colors"
+	default LCD_RA8875_65K
+	---help---
+		Number of colors/color depth
+
+config LCD_RA8875_256
+	bool "256 / 8 bit"
+
+config LCD_RA8875_65K
+	bool "65k / 16 bit"
+
+endchoice # Colors
+
+config LCD_RA8875_EXTENDED
+	bool "Extended drawing interfaces"
+	default n
+	depends on BUILD_FLAT
+	---help---
+		Build in some non-standard, custom drawing interfaces for the RA8875
+		including the following: ra8875_drawrectangle(), ra8875_drawline(),
+		ra8875_drawtriangle(), and ra8875_drawcircle().  NOTE that these
+		will not be accessible by applications in protected or kernel build
+		configurations.
+
+		NOTE: The non-standard ra8875_clear(), ra8875_drawrectangle(),
+		ra8875_drawline() interfaces are always built and available for use
+		because within the OS because these are used internally by the
+		driver anyway.
+
+endif # LCD_RA8875
+
 comment "Alphanumeric/Segment LCD Devices"
 
 config LCD_LCD1602

drivers/lcd/Make.defs

@@ -87,6 +87,10 @@ ifeq ($(CONFIG_LCD_ILI9341),y)
   CSRCS += ili9341.c
 endif
 
+ifeq ($(CONFIG_LCD_RA8875),y)
+  CSRCS += ra8875.c
+endif
+
 # Include LCD driver build support
 
 DEPPATH += --dep-path lcd

drivers/lcd/README.txt

@@ -116,7 +116,8 @@ Re-usable LCD drivers reside in the drivers/lcd directory:
     There are some more different models, they are basically controlled
     by similar logics, thus this driver can be extended.  Example usage:
 
-      configs/maple
+  ra8875.c.  RAiO Technologies RA8875 LCD controller.  Contributed by
+    Marten Svanfeldt.
 
   OLEDs:
   -----

drivers/lcd/ra8875.h

@@ -0,0 +1,276 @@
+/**************************************************************************************
+ * drivers/lcd/ra8875.h
+ * Definitions for the RAiO Technologies RA8875 LCD controller
+ *
+ *   Copyright (C) 2015 Intuitive Aerial AB. All rights reserved.
+ *   Author: Marten Svanfeldt <marten@intuitiveaerial.com>
+ *
+ * References: RA8875, Rev 1.6, Apr 2013, RAiO Technologies Inc
+ *
+ * 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.
+ *
+ **************************************************************************************/
+
+#ifndef __DRIVERS_LCD_RA8875_H
+#define __DRIVERS_LCD_RA8875_H
+
+/**************************************************************************************
+ * Included Files
+ **************************************************************************************/
+
+#include <nuttx/config.h>
+
+#ifdef CONFIG_LCD_RA8875
+
+/**************************************************************************************
+ * Pre-processor Definitions
+ **************************************************************************************/
+
+/* RA8875 Register Addresses (All with RS=1) */
+
+/* System and Configuration Addresses */
+
+#define RA8875_PWRR       0x01  /* Power and display control */
+#define RA8875_MRWC       0x02  /* Memory Read/Write Control/command */
+#define RA8875_PCSR       0x04  /* Pixel Clock Setting Register */
+#define RA8875_SROC       0x05  /* Serial Flash/ROM Configuration */
+#define RA8875_SFCLR      0x06  /* Serial Flash/ROM CLK Setting */
+#define RA8875_SYSR       0x10  /* System configuration Register */
+#define RA8875_GPI        0x12  /* General Purpose Input */
+#define RA8875_GPO        0x13  /* General Purpose Output */
+#define RA8875_HDWR       0x14  /* LCD Horizontal Display Width Register */
+#define RA8875_HNDFTR     0x15  /* LCD Horizontal Non-Display Period Fine Tuning Register */
+#define RA8875_HNDR       0x16  /* LCD Horizontal Non-Display Period Register */
+#define RA8875_HSTR       0x17  /* HSYNC Start Position Register */
+#define RA8875_HPWR       0x18  /* HSYNC Pulse Width Register */
+#define RA8875_VDHR0      0x19  /* LCD Vertical Display Height Register 0 */
+#define RA8875_VDHR1      0x1A  /* LCD Vertical Display Height Register 1 */
+#define RA8875_VNDR0      0x1B  /* LCD Vertical Non-Display Period Register 0 */
+#define RA8875_VNDR1      0x1C  /* LCD Vertical Non-Display Period Register 1 */
+#define RA8875_VSTR0      0x1D  /* VSYNC Start Position Register 0 */
+#define RA8875_VSTR1      0x1E  /* VSYNC Start Position Register 1 */
+#define RA8875_VPWR       0x1F  /* VSYNC Pulse Width Register */
+
+/* LCD Display Control Registers */
+
+#define RA8875_DPCR       0x20  /* Display Configuration Registers */
+
+/* Active Window and Scroll Window Settings */
+
+#define RA8875_HSAW0      0x30  /* Horizontal Start Point of Active Window 0 */
+#define RA8875_HSAW1      0x31  /* Horizontal Start Point of Active Window 1 */
+#define RA8875_VSAW0      0x32  /* Vertical Start Point of Active Window 0 */
+#define RA8875_VSAW1      0x33  /* Vertical Start Point of Active Window 1 */
+#define RA8875_HEAW0      0x34  /* Horizontal End Point of Active Window 0 */
+#define RA8875_HEAW1      0x35  /* Horizontal End Point of Active Window 1 */
+#define RA8875_VEAW0      0x36  /* Vertical End Point of Active Window 0 */
+#define RA8875_VEAW1      0x37  /* Vertical End Point of Active Window 1 */
+
+/* Cursor Setting Registers */
+
+#define RA8875_MWCR0      0x40  /* Memory Write Control Register 0 */
+#define RA8875_MWCR1      0x41  /* Memory Write Control Register 1 */
+#define RA8875_BTCR       0x44  /* Blink Time Control Register */
+#define RA8875_MRDC       0x45  /* Memory Read Cursor Direction */
+#define RA8875_CURH0      0x46  /* Memory Write Cursor Horizontal Position Register 0 */
+#define RA8875_CURH1      0x47  /* Memory Write Cursor Horizontal Position Register 1 */
+#define RA8875_CURV0      0x48  /* Memory Write Cursor Vertical Position Register 0 */
+#define RA8875_CURV1      0x49  /* Memory Write Cursor Vertical Position Register 1 */
+#define RA8875_RCURH0     0x4A  /* Memory Read Cursor Horizontal Position Register 0 */
+#define RA8875_RCURH1     0x4B  /* Memory Read Cursor Horizontal Position Register 1 */
+#define RA8875_RCURV0     0x4C  /* Memory Read Cursor Vertical Position Register 0 */
+#define RA8875_RCURV1     0x4D  /* Memory Read Cursor Vertical Position Register 1 */
+
+/* BTE Control Registers */
+
+#define RA8875_LTPR0      0x50  /* Layer Transparency Register 0 */
+#define RA8875_BGCR0      0x60  /* Background Color Register 0 */
+#define RA8875_BGCR1      0x61  /* Background Color Register 1 */
+#define RA8875_BGCR2      0x62  /* Background Color Register 2 */
+#define RA8875_FGCR0      0x63  /* Foreground Color Register 0 */
+#define RA8875_FGCR1      0x64  /* Foreground Color Register 1 */
+#define RA8875_FGCR2      0x65  /* Foreground Color Register 2 */
+
+/* PWM Control Registers */
+
+#define RA8875_P1CR       0x8A  /* PWM1 Control Register */
+#define RA8875_P1DCR      0x8B  /* PWM1 Duty Cycle Register */
+
+#define RA8875_MCLR       0x8E  /* Memory Clear Control Register */
+
+/* PLL Setting Registers */
+
+#define RA8875_PLLC1      0x88  /* PLL Control Register 1 */
+#define RA8875_PLLC2      0x89  /* PLL Control Register 2 */
+
+/* Drawing Control Registers */
+
+#define RA8875_DCR        0x90  /* Draw Line/Circle/Square Control Register */
+#define RA8875_DLHSR0     0x91  /* Draw Horizontal Start Address Register 0 */
+#define RA8875_DLHSR1     0x92  /* Draw Horizontal Start Address Register 1 */
+#define RA8875_DLVSR0     0x93  /* Draw Vertical Start Address Register 0 */
+#define RA8875_DLVSR1     0x94  /* Draw Vertical Start Address Register 1 */
+#define RA8875_DLHER0     0x95  /* Draw Horizontal End Address Register 0 */
+#define RA8875_DLHER1     0x96  /* Draw Horizontal End Address Register 1 */
+#define RA8875_DLVER0     0x97  /* Draw Vertical End Address Register 0 */
+#define RA8875_DLVER1     0x98  /* Draw Vertical End Address Register 1 */
+#define RA8875_DCHR0      0x99  /* Draw Circle Center Horizontal Address Register 0 */
+#define RA8875_DCHR1      0x9A  /* Draw Circle Center Horizontal Address Register 1 */
+#define RA8875_DCVR0      0x9B  /* Draw Circle Center Vertical Address Register 0 */
+#define RA8875_DCVR1      0x9C  /* Draw Circle Center Vertical Address Register 1 */
+#define RA8875_DCRR       0x9D  /* Draw Circle Radius Register */
+#define RA8875_DTPH0      0xA9  /* Draw Triangle Point 2 Horizontal Address Register 0 */
+#define RA8875_DTPH1      0xAA  /* Draw Triangle Point 2 Horizontal Address Register 1 */
+#define RA8875_DTPV0      0xAB  /* Draw Triangle Point 2 Vertical Address Register 0 */
+#define RA8875_DTPV1      0xAC  /* Draw Triangle Point 2 Vertical Address Register 1 */
+
+/* Bit definitions */
+/* Power and display control */
+
+#define RA8875_PWRR_DISPLAY_OFF         (0)
+#define RA8875_PWRR_DISPLAY_ON          (1<<7)
+#define RA8875_PWRR_SLEEP               (1<<1)
+#define RA8875_PWRR_SWRESET             (1<<0)
+
+/* Pixel Clock Setting Register */
+
+#define RA8875_PCSR_PCLK_INV            (1<<7)
+#define RA8875_PCSR_PERIOD_MASK         (3)
+#  define RA8875_PCSR_PERIOD_SYS        (0)
+#  define RA8875_PCSR_PERIOD_2SYS       (1)
+#  define RA8875_PCSR_PERIOD_4SYS       (2)
+#  define RA8875_PCSR_PERIOD_8SYS       (3)
+
+/* System configuration Register */
+
+#define RA8875_SYSR_COLOR_SHIFT         (2)
+#define RA8875_SYSR_COLOR_MASK          (3<<RA8875_SYSR_COLOR_SHIFT)
+#  define RA8875_SYSR_COLOR_256         (0<<RA8875_SYSR_COLOR_SHIFT)
+#  define RA8875_SYSR_COLOR_65K         (3<<RA8875_SYSR_COLOR_SHIFT)
+#define RA8875_SYSR_MCUIF_MASK          (3)
+#  define RA8875_SYSR_MCUIF_8BIT        (0)
+#  define RA8875_SYSR_MCUIF_16BIT       (3)
+
+/* LCD Horizontal Display Width Register */
+
+#define RA8875_HDWR_WIDTH(p)            ((p)/8 - 1)
+
+/* LCD Vertical Display Height Register 0 */
+
+#define RA8875_VDHR0_HEIGHT(p)          (((p) - 1)&0xff)
+
+/* LCD Vertical Display Height Register 1 */
+
+#define RA8875_VDHR1_HEIGHT(p)          (((p) - 1)>>8)
+
+/* Display Configuration Registers */
+
+#define RA8875_DPCR_LAYERS_ONE          (0)
+#define RA8875_DPCR_LAYERS_TWO          (1<<7)
+#define RA8875_DPCR_HSCAN_INC           (0)
+#define RA8875_DPCR_HSCAN_DEC           (1<<3)
+#define RA8875_DPCR_VSCAN_INC           (0)
+#define RA8875_DPCR_VSCAN_DEC           (1<<2)
+
+/* Memory Write Control Register 0 */
+
+#define RA8875_MWCR0_MODE_GRAPHICS      (0)
+#define RA8875_MWCR0_MODE_TEXT          (1<<7)
+#define RA8875_MWCR0_CURSOR_INVISIBLE   (0)
+#define RA8875_MWCR0_CURSOR_VISIBLE     (1<<6)
+#define RA8875_MWCR0_CURSOR_NORMAL      (0)
+#define RA8875_MWCR0_CURSOR_BLINK       (1<<5)
+#define RA8875_MWCR0_MEMDIR_SHIFT       (2)
+#define RA8875_MWCR0_MEMDIR_MASK        (3<<RA8875_MWCR0_MEMDIR_SHIFT)
+#  define RA8875_MWCR0_MEMDIR_LEFTRIGHT (0<<RA8875_MWCR0_MEMDIR_SHIFT)
+#  define RA8875_MWCR0_MEMDIR_RIGHTLEFT (1<<RA8875_MWCR0_MEMDIR_SHIFT)
+#  define RA8875_MWCR0_MEMDIR_TOPDOWN   (2<<RA8875_MWCR0_MEMDIR_SHIFT)
+#  define RA8875_MWCR0_MEMDIR_DOWNTOP   (3<<RA8875_MWCR0_MEMDIR_SHIFT)
+#define RA8875_MWCR0_WINC_ENABLE        (0)
+#define RA8875_MWCR0_WINC_DISABLE       (1<<1)
+#define RA8875_MWCR0_RINC_ENABLE        (0)
+#define RA8875_MWCR0_RINC_DISABLE       (1<<0)
+
+/* Memory Write Control Register 1 */
+
+#define RA8875_MWCR1_LAYER_1            (0)
+#define RA8875_MWCR1_LAYER_2            (1)
+
+/* Memory Read Cursor Direction */
+
+#define RA8875_MRCD_MEMDIR_SHIFT        (0)
+#define RA8875_MRCD_MEMDIR_MASK         (3<<RA8875_MWCR0_MEMDIR_SHIFT)
+#  define RA8875_MRCD_MEMDIR_LEFTRIGHT  (0<<RA8875_MWCR0_MEMDIR_SHIFT)
+#  define RA8875_MRCD_MEMDIR_RIGHTLEFT  (1<<RA8875_MWCR0_MEMDIR_SHIFT)
+#  define RA8875_MRCD_MEMDIR_TOPDOWN    (2<<RA8875_MWCR0_MEMDIR_SHIFT)
+#  define RA8875_MRCD_MEMDIR_DOWNTOP    (3<<RA8875_MWCR0_MEMDIR_SHIFT)
+
+/* Layer Transparency Register 0 */
+
+#define RA8875_LTPR0_MODE_MASK          (7)
+#  define RA8875_LTPR0_MODE_L1          (0)
+#  define RA8875_LTPR0_MODE_L2          (1)
+
+/* PWM1 Control Register */
+
+#define RA8875_P1CR_PWM_DISABLE         (0)
+#define RA8875_P1CR_PWM_ENABLE          (1<<7)
+#define RA8875_P1CR_DISABLE_LOW         (0)
+#define RA8875_P1CR_DISABLE_HIGH        (1<<6)
+#define RA8875_P1CR_FUNC_PWM            (0)
+#define RA8875_P1CR_FUNC_FIXED          (1<<4)
+#define RA8875_P1CR_CSDIV_MASK          (0xf)
+#  define RA8875_P1CR_CSDIV(p)          ((p) & 0xf)
+
+/* Memory Clear Control Register */
+
+#define RA8875_MCLR_CLEAR               (1<<7)
+#define RA8875_MCLR_FULL                (0)
+#define RA8875_MCLR_ACTIVE              (1<<6)
+
+/* PLL Control Register 1 */
+
+#define RA8875_PLLC1_PLLDIVM            (1<<7)
+#define RA8875_PLLC1_PLLDIVN(p)         ((p)&0x1f)
+
+/* PLL Control Register 2 */
+
+#define RA8875_PLLC2_PLLDIVK(p)         ((p)&0x7)
+
+/* Draw Line/Circle/Square Control Register */
+
+#define RA8875_DCR_LINE_START           (1<<7)
+#define RA8875_DCR_CIRCLE_START         (1<<6)
+#define RA8875_DCR_NOFILL               (0)
+#define RA8875_DCR_FILL                 (1<<5)
+#define RA8875_DCR_LINE                 (0)
+#define RA8875_DCR_SQUARE               (1<<4)
+#define RA8875_DCR_TRIANGLE             (1<<0)
+
+#endif /* CONFIG_LCD_RA8875 */
+#endif /* __DRIVERS_LCD_RA8875_H */

include/nuttx/lcd/ra8875.h

@@ -0,0 +1,213 @@
+/**************************************************************************************
+ * include/nuttx/lcd/ra8875.h
+ * Definitions for the RAiO Technologies RA8875 LCD controller
+ *
+ *   Copyright (C) 2015 Intuitive Aerial AB. All rights reserved.
+ *   Author: Marten Svanfeldt <marten@intuitiveaerial.com>
+ *
+ * References: RA8875, Rev 1.6, Apr 2013, RAiO Technologies Inc
+ *
+ * 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.
+ *
+ **************************************************************************************/
+
+#ifndef __INCLUDE_NUTTX_LCD_RA8875_H
+#define __INCLUDE_NUTTX_LCD_RA8875_H
+
+/**************************************************************************************
+ * Included Files
+ **************************************************************************************/
+
+#include <nuttx/config.h>
+
+#ifdef CONFIG_LCD_RA8875
+
+/**************************************************************************************
+ * Pre-processor Definitions
+ **************************************************************************************/
+/* Configuration **********************************************************************/
+/* CONFIG_LCD_RA8875 - Enables support for the RA8875-based LCD.
+ * CONFIG_LCD_NOGETRUN
+ *   NX components need to know if it can read from the LCD or not. If reading from the
+ *   LCD is supported then some graphic operations can be improved. Default: Supported
+ * CONFIG_LCD_LANDSCAPE - Define for 320x240 display "landscape" support. Default is
+ *   this 320x240 "landscape" orientation.
+ * CONFIG_LCD_RLANDSCAPE - Define for 320x240 display "reverse landscape" support.
+ *   Default is this 320x240 "landscape" orientation
+ * CONFIG_LCD_PORTRAIT - Define for 240x320 display "portrait" orientation support.
+ *   Default is this 320x240 "landscape" orientation
+ * CONFIG_LCD_RPORTRAIT - Define for 240x320 display "reverse portrait" orientation
+ *   support.  Default is this 320x240 "landscape" orientation
+ */
+
+/**************************************************************************************
+ * Public Types
+ **************************************************************************************/
+
+/* This structure defines the interface to the LCD provided by the platform.  The
+ * nature of this interface is hidden from the RA8875 driver.
+ */
+
+struct ra8875_lcd_s
+{
+  void (*write_reg)(FAR struct ra8875_lcd_s *dev, uint8_t regnum, uint8_t data);
+  void (*write_reg16)(FAR struct ra8875_lcd_s *dev, uint8_t regnum, uint16_t data);
+
+  uint8_t (*read_reg)(FAR struct ra8875_lcd_s *dev, uint8_t regnum);
+  uint8_t (*read_status)(FAR struct ra8875_lcd_s *dev);
+
+  /* Interface for fast pixel access */
+
+  void (*pwrite_prepare)(FAR struct ra8875_lcd_s *dev, uint8_t regnum);
+  void (*pwrite_data8)(FAR struct ra8875_lcd_s *dev, uint8_t data);
+  void (*pwrite_data16)(FAR struct ra8875_lcd_s *dev, uint16_t data);
+  void (*pwrite_finish)(FAR struct ra8875_lcd_s *dev);
+
+  void (*pread_prepare)(FAR struct ra8875_lcd_s *dev, uint8_t regnum);
+  uint16_t (*pread_data16)(FAR struct ra8875_lcd_s *dev);
+  void (*pread_finish)(FAR struct ra8875_lcd_s *dev);
+
+  /* platform-specific data may follow */
+};
+
+/**************************************************************************************
+ * Public Data
+ **************************************************************************************/
+
+#ifdef __cplusplus
+#define EXTERN extern "C"
+extern "C"
+{
+#else
+#define EXTERN extern
+#endif
+
+/**************************************************************************************
+ * Public Function Prototypes
+ **************************************************************************************/
+
+/**************************************************************************************
+ * Name:  ra8875_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).
+ *
+ **************************************************************************************/
+
+FAR struct lcd_dev_s *ra8875_lcdinitialize(FAR struct ra8875_lcd_s *lcd);
+
+/**************************************************************************************
+ * Name:  ra8875_clear
+ *
+ * Description:
+ *   This is a non-standard LCD interface just for the RA8875.  Because
+ *   of the various rotations, clearing the display in the normal way by writing a
+ *   sequences of runs that covers the entire display can be very slow.  Here the
+ *   display is cleared by simply setting all video memory to the specified color.
+ *
+ *   NOTE: This function is not available to applications in the protected or kernel
+ *   build modes.
+ *
+ **************************************************************************************/
+
+void ra8875_clear(FAR struct lcd_dev_s *dev, uint16_t color);
+
+/**************************************************************************************
+ * Name:  ra8875_drawrectangle
+ *
+ * Description:
+ *   This is a non-standard function to draw a rectangle on the LCD.  This function is
+ *   also used internally as part of the ra8875_clear implementation.
+ *
+ *   NOTE: This non-standard function is not available to applications in the
+ *   protected or kernel build modes.
+ *
+ **************************************************************************************/
+
+void ra8875_drawrectangle(FAR struct lcd_dev_s *dev, uint16_t x, uint16_t y,
+                          uint16_t width, uint16_t height, uint16_t color, bool fill);
+
+/**************************************************************************************
+ * Name:  ra8875_drawline
+ *
+ * Description:
+ *   This is a non-standard function to draw a line on the LCD.  This function is
+ *   also used internally as part of the ra8875_rectandle implementation.
+ *
+ *   NOTE: This non-standard function is not available to applications in the
+ *   protected or kernel build modes.
+ *
+ **************************************************************************************/
+
+void ra8875_drawline(FAR struct lcd_dev_s *dev, uint16_t x1, uint16_t y1, uint16_t x2,
+                     uint16_t y2, uint16_t color);
+
+/**************************************************************************************
+ * Name:  ra8875_drawtriangle
+ *
+ * Description:
+ *   This is a non-standard function to draw a triangle on the LCD.  This function is
+ *   also used internally as part of the ra8875_rectandle implementation.
+ *
+ *   NOTE: This non-standard function is not available to applications in the
+ *   protected or kernel build modes.
+ *
+ **************************************************************************************/
+
+#ifdef CONFIG_LCD_RA8875_EXTENDED
+void ra8875_drawtriangle(FAR struct lcd_dev_s *dev, uint16_t x0, uint16_t y0,
+                         uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2,
+                         uint16_t color, bool fill);
+#endif
+
+/**************************************************************************************
+ * Name:  ra8875_drawcircle
+ *
+ * Description:
+ *   This is a non-standard function to draw a circle on the LCD.  This function is
+ *   also used internally as part of the ra8875_rectandle implementation.
+ *
+ *   NOTE: This non-standard function is not available to applications in the
+ *   protected or kernel build modes.
+ *
+ **************************************************************************************/
+
+#ifdef CONFIG_LCD_RA8875_EXTENDED
+void ra8875_drawcircle(FAR struct lcd_dev_s *dev, uint16_t x, uint16_t y,
+                       uint8_t radius, uint16_t color, bool fill);
+#endif
+
+#undef EXTERN
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* CONFIG_LCD_SRA8875 */
+#endif /* __INCLUDE_NUTTX_LCD_SRA8875_H */