nuttx/configs/shenzhou/src/stm32_ssd1289.c

586 lines
18 KiB
C

/************************************************************************************
* configs/shenzhou/src/stm32_ssd1289.c
*
* This logic supports the connection of an SSD1289-based LCD to the Shenzhou IV
* board.
*
* Copyright (C) 2012 Gregory Nutt. All rights reserved.
* Authors: Gregory Nutt <gnutt@nuttx.org>
*
* 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.
*
************************************************************************************/
/************************************************************************************
* 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/board.h>
#include <nuttx/spi/spi.h>
#include <nuttx/lcd/lcd.h>
#include <nuttx/lcd/ssd1289.h>
#include <arch/board/board.h>
#include "up_arch.h"
#include "stm32.h"
#include "shenzhou.h"
#ifdef CONFIG_LCD_SSD1289
/************************************************************************************
* Pre-processor Definitions
************************************************************************************/
/* Configuration ********************************************************************/
#undef CONFIG_LCD_FASTCONFIG
#define CONFIG_LCD_FASTCONFIG 1
/************************************************************************************
* Private Type Definition
************************************************************************************/
/* This structure describes the state of this driver */
struct stm32_lower_s
{
struct ssd1289_lcd_s dev; /* This is externally visible the driver state */
FAR struct lcd_dev_s *drvr; /* The saved instance of the LCD driver */
bool output; /* True: Configured for output */
};
/**************************************************************************************
* Private Function Prototypes
**************************************************************************************/
/* Helpers */
#ifdef CONFIG_LCD_REGDEBUG
static void stm32_lcdshow(FAR struct stm32_lower_s *priv, FAR const char *msg);
#else
# define stm32_lcdshow(p,m)
#endif
static void stm32_wrdata(FAR struct stm32_lower_s *priv, uint16_t data);
#ifndef CONFIG_LCD_NOGETRUN
static inline uint16_t stm32_rddata(FAR struct stm32_lower_s *priv);
#endif
/* Low Level LCD access */
static void stm32_select(FAR struct ssd1289_lcd_s *dev);
static void stm32_deselect(FAR struct ssd1289_lcd_s *dev);
static void stm32_index(FAR struct ssd1289_lcd_s *dev, uint8_t index);
#ifndef CONFIG_LCD_NOGETRUN
static uint16_t stm32_read(FAR struct ssd1289_lcd_s *dev);
#endif
static void stm32_write(FAR struct ssd1289_lcd_s *dev, uint16_t data);
static void stm32_backlight(FAR struct ssd1289_lcd_s *dev, int power);
/* Initialization */
static void stm32_lcdinput(FAR struct stm32_lower_s *priv);
static void stm32_lcdoutput(FAR struct stm32_lower_s *priv);
/************************************************************************************
* Private Data
************************************************************************************/
/* TFT LCD
*
* -- ---- -------------- -----------------------------------------------------------
* PN NAME SIGNAL NOTES
* -- ---- -------------- -----------------------------------------------------------
* 37 PB2 DATA_LE To TFT LCD (CN13, ping 28)
* 96 PB9 F_CS To both the TFT LCD (CN13, pin 30) and to the W25X16 SPI FLASH
* 34 PC5 TP_INT JP6. To TFT LCD (CN13) module (CN13, pin 26)
* 65 PC8 LCD_CS Active low: Pulled high (CN13, pin 19)
* 66 PC9 TP_CS Active low: Pulled high (CN13, pin 31)
* 78 PC10 SPI3_SCK To TFT LCD (CN13, pin 29)
* 79 PC11 SPI3_MISO To TFT LCD (CN13, pin 25)
* 80 PC12 SPI3_MOSI To TFT LCD (CN13, pin 27)
* 58 PD11 SD_CS Active low: Pulled high (See also TFT LCD CN13, pin 32)
* 60 PD13 LCD_RS To TFT LCD (CN13, pin 20)
* 61 PD14 LCD_WR To TFT LCD (CN13, pin 21). Schematic is wrong LCD_WR is PB14.
* 62 PD15 LCD_RD To TFT LCD (CN13, pin 22)
* 97 PE0 DB00 To TFT LCD (CN13, pin 3)
* 98 PE1 DB01 To TFT LCD (CN13, pin 4)
* 1 PE2 DB02 To TFT LCD (CN13, pin 5)
* 2 PE3 DB03 To TFT LCD (CN13, pin 6)
* 3 PE4 DB04 To TFT LCD (CN13, pin 7)
* 4 PE5 DB05 To TFT LCD (CN13, pin 8)
* 5 PE6 DB06 To TFT LCD (CN13, pin 9)
* 38 PE7 DB07 To TFT LCD (CN13, pin 10)
* 39 PE8 DB08 To TFT LCD (CN13, pin 11)
* 40 PE9 DB09 To TFT LCD (CN13, pin 12)
* 41 PE10 DB10 To TFT LCD (CN13, pin 13)
* 42 PE11 DB11 To TFT LCD (CN13, pin 16)
* 43 PE12 DB12 To TFT LCD (CN13, pin 15)
* 44 PE13 DB13 To TFT LCD (CN13, pin 16)
* 45 PE14 DB14 To TFT LCD (CN13, pin 17)
* 46 PE15 DB15 To TFT LCD (CN13, pin 18)
*
* NOTE: The backlight signl NC_BL (CN13, pin 24) is pulled high and not under
* software control
*
* On LCD module:
* -- -------------- -------------------------------------------------------------------
* PN SIGNAL NOTES
* -- -------------- -------------------------------------------------------------------
* 3 DB01 To LCD DB1
* 4 DB00 To LCD DB0
* 5 DB03 To LCD DB3
* 6 DB02 To LCD DB2
* 7 DB05 To LCD DB5
* 8 DB04 To LCD DB4
* 9 DB07 To LCD DB7
* 10 DB06 To LCD DB6
* 11 DB09 To LCD DB9
* 12 DB08 To LCD DB8
* 13 DB11 To LCD DB11
* 14 DB10 To LCD DB10
* 15 DB13 To LCD DB13
* 16 DB12 To LCD DB12
* 17 DB15 To LCD DB15
* 18 DB14 To LCD DB14
* 19 RS To LCD RS
* 20 /LCD_CS To LCD CS
* 21 /RD To LCD RD
* 22 /WR To LCD WR
* 23 BL_EN (Not referenced)
* 24 /RESET
* 25 /INT To Touch IC /INT
* 26 MISO To Touch IC DOUT; To AT45DB161B SO; To SD card DAT0
* 27 LE To 74HC573 that controls LCD 8-bit/16-bit mode
* 28 MOSI To Touch IC DIN; To AT45DB161B SI; To SD card CMD
* 29 /DF_CS To AT45DB161B Data Flash /CS
* 30 SCLK To Touch IC DCLK; To AT45DB161B SCK; To SD card CLK
* 31 /SD_CS To SD card /CS
* 31 /TP_CS To Touch IC CS
*/
/* LCD GPIO configurations */
#ifndef CONFIG_LCD_FASTCONFIG
static const uint32_t g_lcdout[16] =
{
GPIO_LCD_D0OUT, GPIO_LCD_D1OUT, GPIO_LCD_D2OUT, GPIO_LCD_D3OUT,
GPIO_LCD_D4OUT, GPIO_LCD_D5OUT, GPIO_LCD_D6OUT, GPIO_LCD_D7OUT,
GPIO_LCD_D8OUT, GPIO_LCD_D9OUT, GPIO_LCD_D10OUT, GPIO_LCD_D11OUT,
GPIO_LCD_D12OUT, GPIO_LCD_D13OUT, GPIO_LCD_D14OUT, GPIO_LCD_D15OUT
};
static const uint32_t g_lcdin[16] =
{
GPIO_LCD_D0IN, GPIO_LCD_D1IN, GPIO_LCD_D2IN, GPIO_LCD_D3IN,
GPIO_LCD_D4IN, GPIO_LCD_D5IN, GPIO_LCD_D6IN, GPIO_LCD_D7IN,
GPIO_LCD_D8IN, GPIO_LCD_D9IN, GPIO_LCD_D10IN, GPIO_LCD_D11IN,
GPIO_LCD_D12IN, GPIO_LCD_D13IN, GPIO_LCD_D14IN, GPIO_LCD_D15IN
};
#endif
static const uint32_t g_lcdconfig[] =
{
GPIO_LCD_RS, GPIO_LCD_CS, GPIO_LCD_RD, GPIO_LCD_WR,
GPIO_LCD_LE,
};
#define NLCD_CONFIG (sizeof(g_lcdconfig)/sizeof(uint32_t))
/* Driver state structure (only supports one LCD) */
static struct stm32_lower_s g_lcdlower =
{
{
.select = stm32_select,
.deselect = stm32_deselect,
.index = stm32_index,
#ifndef CONFIG_LCD_NOGETRUN
.read = stm32_read,
#endif
.write = stm32_write,
.backlight = stm32_backlight
},
.drvr = NULL,
.output = false
};
/************************************************************************************
* Private Functions
************************************************************************************/
/************************************************************************************
* Name: stm32_lcdshow
*
* Description:
* Show the state of the interface
*
************************************************************************************/
#ifdef CONFIG_LCD_REGDEBUG
static void stm32_lcdshow(FAR struct stm32_lower_s *priv, FAR const char *msg)
{
_info("%s:\n", msg);
_info(" CRTL RS: %d CS: %d RD: %d WR: %d LE: %d\n",
getreg32(LCD_RS_READ), getreg32(LCD_CS_READ), getreg32(LCD_RD_READ),
getreg32(LCD_WR_READ), getreg32(LCD_LE_READ));
_info(" DATA CR: %08x %08x\n", getreg32(LCD_CRL), getreg32(LCD_CRH));
if (priv->output)
{
_info(" OUTPUT: %08x\n", getreg32(LCD_ODR));
}
else
{
_info(" INPUT: %08x\n", getreg32(LCD_IDR));
}
}
#endif
/************************************************************************************
* Name: stm32_wrdata
*
* Description:
* Latch data on D0-D15 and toggle the WR line.
*
************************************************************************************/
static void stm32_wrdata(FAR struct stm32_lower_s *priv, uint16_t data)
{
/* Make sure D0-D15 are configured as outputs */
stm32_lcdoutput(priv);
/* Latch the 16-bit LCD data and toggle the WR line */
putreg32(1, LCD_WR_CLEAR);
putreg32((uint32_t)data, LCD_ODR);
/* Total WR pulse with should be 50ns wide. */
putreg32(1, LCD_WR_SET);
}
/************************************************************************************
* Name: stm32_rddata
*
* Description:
* Latch data on D0-D15 and toggle the WR line.
*
************************************************************************************/
#ifndef CONFIG_LCD_NOGETRUN
static inline uint16_t stm32_rddata(FAR struct stm32_lower_s *priv)
{
uint16_t regval;
/* Make sure D0-D15 are configured as inputs */
stm32_lcdinput(priv);
/* Toggle the RD line to latch the 16-bit LCD data */
putreg32(1, LCD_RD_CLEAR);
/* Data should appear 250ns after RD. Total RD pulse width should be 500nS */
__asm__ __volatile__(" nop\n nop\n nop\n nop\n");
regval = (uint16_t)getreg32(LCD_IDR);
putreg32(1, LCD_RD_SET);
return regval;
}
#endif
/************************************************************************************
* Name: stm32_select
*
* Description:
* Select the LCD device
*
************************************************************************************/
static void stm32_select(FAR struct ssd1289_lcd_s *dev)
{
/* Select the LCD by setting the LCD_CS low */
putreg32(1, LCD_CS_CLEAR);
}
/************************************************************************************
* Name: stm32_deselect
*
* Description:
* De-select the LCD device
*
************************************************************************************/
static void stm32_deselect(FAR struct ssd1289_lcd_s *dev)
{
/* De-select the LCD by setting the LCD_CS high */
putreg32(1, LCD_CS_SET);
}
/************************************************************************************
* Name: stm32_index
*
* Description:
* Set the index register
*
************************************************************************************/
static void stm32_index(FAR struct ssd1289_lcd_s *dev, uint8_t index)
{
FAR struct stm32_lower_s *priv = (FAR struct stm32_lower_s *)dev;
/* Clear the RS signal to select the index address */
putreg32(1, LCD_RS_CLEAR);
/* And write the index */
stm32_wrdata(priv, (uint16_t)index);
}
/************************************************************************************
* Name: stm32_read
*
* Description:
* Read LCD data (GRAM data or register contents)
*
************************************************************************************/
#ifndef CONFIG_LCD_NOGETRUN
static uint16_t stm32_read(FAR struct ssd1289_lcd_s *dev)
{
FAR struct stm32_lower_s *priv = (FAR struct stm32_lower_s *)dev;
/* Set the RS signal to select the data address */
putreg32(1, LCD_RS_SET);
/* Read and return the data */
return stm32_rddata(priv);
}
#endif
/************************************************************************************
* Name: stm32_write
*
* Description:
* Write LCD data (GRAM data or register contents)
*
************************************************************************************/
static void stm32_write(FAR struct ssd1289_lcd_s *dev, uint16_t data)
{
FAR struct stm32_lower_s *priv = (FAR struct stm32_lower_s *)dev;
/* Set the RS signal to select the data address */
putreg32(1, LCD_RS_SET);
/* And write the data */
stm32_wrdata(priv, data);
}
/************************************************************************************
* Name: stm32_backlight
*
* Description:
* Write LCD data (GRAM data or register contents)
*
************************************************************************************/
static void stm32_backlight(FAR struct ssd1289_lcd_s *dev, int power)
{
/* There is no software control over the backlight */
}
/************************************************************************************
* Name: stm32_lcdinput
*
* Description:
* Config data lines for input operations.
*
************************************************************************************/
static void stm32_lcdinput(FAR struct stm32_lower_s *priv)
{
#ifndef CONFIG_LCD_FASTCONFIG
int i;
#endif
/* Check if we are already configured for input */
if (priv->output)
{
/* Configure GPIO data lines as inputs */
#ifdef CONFIG_LCD_FASTCONFIG
putreg32(LCD_INPUT, LCD_CRL);
putreg32(LCD_INPUT, LCD_CRH);
#else
for (i = 0; i < 16; i++)
{
stm32_configgpio(g_lcdin[i]);
}
#endif
/* No longer configured for output */
priv->output = false;
}
}
/************************************************************************************
* Name: stm32_lcdoutput
*
* Description:
* Config data lines for output operations.
*
************************************************************************************/
static void stm32_lcdoutput(FAR struct stm32_lower_s *priv)
{
#ifndef CONFIG_LCD_FASTCONFIG
int i;
#endif
/* Check if we are already configured for output */
if (!priv->output)
{
/* Configure GPIO data lines as outputs */
#ifdef CONFIG_LCD_FASTCONFIG
putreg32(LCD_OUTPUT, LCD_CRL);
putreg32(LCD_OUTPUT, LCD_CRH);
#else
for (i = 0; i < 16; i++)
{
stm32_configgpio(g_lcdout[i]);
}
#endif
/* Now we are configured for output */
priv->output = true;
}
}
/************************************************************************************
* Public Functions
************************************************************************************/
/************************************************************************************
* Name: board_lcd_initialize
*
* 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 board_lcd_initialize(void)
{
FAR struct stm32_lower_s *priv = &g_lcdlower;
int i;
/* Only initialize the driver once */
if (!priv->drvr)
{
lcdinfo("Initializing\n");
/* Configure GPIO pins */
stm32_lcdoutput(priv);
for (i = 0; i < NLCD_CONFIG; i++)
{
stm32_configgpio(g_lcdconfig[i]);
}
/* Configure and enable the LCD */
priv->drvr = ssd1289_lcdinitialize(&priv->dev);
if (!priv->drvr)
{
lcderr("ERROR: ssd1289_lcdinitialize failed\n");
return -ENODEV;
}
}
/* Turn the display off */
priv->drvr->setpower(priv->drvr, 0);
return OK;
}
/************************************************************************************
* Name: board_lcd_getdev
*
* Description:
* Return a a reference to the LCD object for the specified LCD. This allows
* suport for multiple LCD devices.
*
************************************************************************************/
FAR struct lcd_dev_s *board_lcd_getdev(int lcddev)
{
FAR struct stm32_lower_s *priv = &g_lcdlower;
DEBUGASSERT(lcddev == 0);
return priv->drvr;
}
/************************************************************************************
* Name: board_lcd_uninitialize
*
* Description:
* Unitialize the LCD support
*
************************************************************************************/
void board_lcd_uninitialize(void)
{
FAR struct stm32_lower_s *priv = &g_lcdlower;
/* Turn the display off */
priv->drvr->setpower(priv->drvr, 0);
}
#endif /* CONFIG_LCD_SSD1289 */