incubator-nuttx/drivers/lcd/ra8875.h

278 lines
12 KiB
C

/****************************************************************************
* 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 */