2020-12-22 18:55:19 +01:00
|
|
|
/****************************************************************************
|
|
|
|
* drivers/lcd/st7789.c
|
|
|
|
*
|
|
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
|
|
* this work for additional information regarding copyright ownership. The
|
|
|
|
* ASF licenses this file to you under the Apache License, Version 2.0 (the
|
|
|
|
* "License"); you may not use this file except in compliance with the
|
|
|
|
* License. You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
|
|
* License for the specific language governing permissions and limitations
|
|
|
|
* under the License.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Included Files
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
|
|
|
|
#include <sys/types.h>
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include <string.h>
|
2021-05-18 08:59:14 +02:00
|
|
|
#include <assert.h>
|
2020-12-22 18:55:19 +01:00
|
|
|
#include <errno.h>
|
|
|
|
#include <debug.h>
|
|
|
|
|
|
|
|
#include <nuttx/arch.h>
|
|
|
|
#include <nuttx/spi/spi.h>
|
|
|
|
#include <nuttx/lcd/lcd.h>
|
|
|
|
#include <nuttx/lcd/st7789.h>
|
|
|
|
|
|
|
|
#include "st7789.h"
|
|
|
|
|
|
|
|
#ifdef CONFIG_LCD_ST7789
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Pre-processor Definitions
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/* Verify that all configuration requirements have been met */
|
|
|
|
|
|
|
|
#ifndef CONFIG_LCD_ST7789_SPIMODE
|
|
|
|
# define CONFIG_LCD_ST7789_SPIMODE SPIDEV_MODE0
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* SPI frequency */
|
|
|
|
|
|
|
|
#ifndef CONFIG_LCD_ST7789_FREQUENCY
|
|
|
|
# define CONFIG_LCD_ST7789_FREQUENCY 1000000
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Check contrast selection */
|
|
|
|
|
|
|
|
#if !defined(CONFIG_LCD_MAXCONTRAST)
|
|
|
|
# define CONFIG_LCD_MAXCONTRAST 1
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Check power setting */
|
|
|
|
|
|
|
|
#if !defined(CONFIG_LCD_MAXPOWER) || CONFIG_LCD_MAXPOWER < 1
|
|
|
|
# define CONFIG_LCD_MAXPOWER 1
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if CONFIG_LCD_MAXPOWER > 255
|
|
|
|
# error "CONFIG_LCD_MAXPOWER must be less than 256 to fit in uint8_t"
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Check orientation */
|
|
|
|
|
|
|
|
#if defined(CONFIG_LCD_PORTRAIT)
|
|
|
|
# if defined(CONFIG_LCD_LANDSCAPE) || defined(CONFIG_LCD_RLANDSCAPE) ||\
|
|
|
|
defined(CONFIG_LCD_RPORTRAIT)
|
|
|
|
# error "Cannot define both portrait and any other orientations"
|
|
|
|
# endif
|
|
|
|
#elif defined(CONFIG_LCD_RPORTRAIT)
|
|
|
|
# if defined(CONFIG_LCD_LANDSCAPE) || defined(CONFIG_LCD_RLANDSCAPE)
|
|
|
|
# error "Cannot define both rportrait and any other orientations"
|
|
|
|
# endif
|
|
|
|
#elif defined(CONFIG_LCD_LANDSCAPE)
|
|
|
|
# ifdef CONFIG_LCD_RLANDSCAPE
|
|
|
|
# error "Cannot define both landscape and any other orientations"
|
|
|
|
# endif
|
|
|
|
#elif !defined(CONFIG_LCD_RLANDSCAPE)
|
|
|
|
# define CONFIG_LCD_LANDSCAPE 1
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Display Resolution */
|
|
|
|
|
2021-03-14 11:37:52 +01:00
|
|
|
#if !defined(CONFIG_LCD_ST7789_XRES)
|
|
|
|
# define CONFIG_LCD_ST7789_XRES 240
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if !defined(CONFIG_LCD_ST7789_YRES)
|
|
|
|
# define CONFIG_LCD_ST7789_YRES 320
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#define ST7789_LUT_SIZE CONFIG_LCD_ST7789_YRES
|
2020-12-22 18:55:19 +01:00
|
|
|
|
|
|
|
#if defined(CONFIG_LCD_LANDSCAPE) || defined(CONFIG_LCD_RLANDSCAPE)
|
2021-03-14 11:37:52 +01:00
|
|
|
# define ST7789_XRES CONFIG_LCD_ST7789_YRES
|
|
|
|
# define ST7789_YRES CONFIG_LCD_ST7789_XRES
|
2021-03-15 16:32:54 +01:00
|
|
|
# define ST7789_XOFFSET CONFIG_LCD_ST7789_YOFFSET
|
|
|
|
# define ST7789_YOFFSET CONFIG_LCD_ST7789_XOFFSET
|
2020-12-22 18:55:19 +01:00
|
|
|
#else
|
2021-03-14 11:37:52 +01:00
|
|
|
# define ST7789_XRES CONFIG_LCD_ST7789_XRES
|
|
|
|
# define ST7789_YRES CONFIG_LCD_ST7789_YRES
|
2021-03-15 16:32:54 +01:00
|
|
|
# define ST7789_XOFFSET CONFIG_LCD_ST7789_XOFFSET
|
|
|
|
# define ST7789_YOFFSET CONFIG_LCD_ST7789_YOFFSET
|
2020-12-22 18:55:19 +01:00
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Color depth and format */
|
|
|
|
|
|
|
|
#ifdef CONFIG_LCD_ST7789_BPP
|
|
|
|
# if (CONFIG_LCD_ST7789_BPP == 12)
|
|
|
|
# define ST7789_BPP 12
|
|
|
|
# define ST7789_COLORFMT FB_FMT_RGB12_444
|
|
|
|
# define ST7789_BYTESPP 2
|
|
|
|
# elif (CONFIG_LCD_ST7789_BPP == 16)
|
|
|
|
# define ST7789_BPP 16
|
|
|
|
# define ST7789_COLORFMT FB_FMT_RGB16_565
|
|
|
|
# define ST7789_BYTESPP 2
|
|
|
|
# else
|
|
|
|
# define ST7789_BPP 16
|
|
|
|
# define ST7789_COLORFMT FB_FMT_RGB16_565
|
|
|
|
# define ST7789_BYTESPP 2
|
|
|
|
# warning "Invalid color depth. Falling back to 16bpp"
|
|
|
|
# endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Private Types
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/* This structure describes the state of this driver */
|
|
|
|
|
|
|
|
struct st7789_dev_s
|
|
|
|
{
|
|
|
|
/* Publicly visible device structure */
|
|
|
|
|
|
|
|
struct lcd_dev_s dev;
|
|
|
|
|
|
|
|
/* Private LCD-specific information follows */
|
|
|
|
|
|
|
|
FAR struct spi_dev_s *spi; /* SPI device */
|
|
|
|
uint8_t bpp; /* Selected color depth */
|
|
|
|
uint8_t power; /* Current power setting */
|
|
|
|
|
|
|
|
/* 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 therefore 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.
|
|
|
|
*/
|
|
|
|
|
|
|
|
uint16_t runbuffer[ST7789_LUT_SIZE];
|
|
|
|
};
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Private Function Protototypes
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/* Misc. Helpers */
|
|
|
|
|
|
|
|
static void st7789_select(FAR struct spi_dev_s *spi, int bits);
|
|
|
|
static void st7789_deselect(FAR struct spi_dev_s *spi);
|
|
|
|
|
|
|
|
static inline void st7789_sendcmd(FAR struct st7789_dev_s *dev, uint8_t cmd);
|
|
|
|
static void st7789_sleep(FAR struct st7789_dev_s *dev, bool sleep);
|
2021-03-15 16:32:54 +01:00
|
|
|
static void st7789_setorientation(FAR struct st7789_dev_s *dev);
|
2020-12-22 18:55:19 +01:00
|
|
|
static void st7789_display(FAR struct st7789_dev_s *dev, bool on);
|
|
|
|
static void st7789_setarea(FAR struct st7789_dev_s *dev,
|
|
|
|
uint16_t x0, uint16_t y0,
|
|
|
|
uint16_t x1, uint16_t y1);
|
|
|
|
static void st7789_bpp(FAR struct st7789_dev_s *dev, int bpp);
|
|
|
|
static void st7789_wrram(FAR struct st7789_dev_s *dev,
|
|
|
|
FAR const uint16_t *buff, size_t size);
|
2021-03-14 11:37:52 +01:00
|
|
|
#ifndef CONFIG_LCD_NOGETRUN
|
2020-12-22 18:55:19 +01:00
|
|
|
static void st7789_rdram(FAR struct st7789_dev_s *dev,
|
|
|
|
FAR uint16_t *buff, size_t size);
|
2021-03-14 11:37:52 +01:00
|
|
|
#endif
|
2020-12-22 18:55:19 +01:00
|
|
|
static void st7789_fill(FAR struct st7789_dev_s *dev, uint16_t color);
|
|
|
|
|
|
|
|
/* LCD Data Transfer Methods */
|
|
|
|
|
2022-06-17 12:17:18 +02:00
|
|
|
static int st7789_putrun(FAR struct lcd_dev_s *dev,
|
|
|
|
fb_coord_t row, fb_coord_t col,
|
2020-12-22 18:55:19 +01:00
|
|
|
FAR const uint8_t *buffer, size_t npixels);
|
2022-06-17 12:17:18 +02:00
|
|
|
static int st7789_putarea(FAR struct lcd_dev_s *dev,
|
|
|
|
fb_coord_t row_start, fb_coord_t row_end,
|
2021-07-02 06:19:34 +02:00
|
|
|
fb_coord_t col_start, fb_coord_t col_end,
|
|
|
|
FAR const uint8_t *buffer);
|
2020-12-22 18:55:19 +01:00
|
|
|
#ifndef CONFIG_LCD_NOGETRUN
|
2022-06-17 12:17:18 +02:00
|
|
|
static int st7789_getrun(FAR struct lcd_dev_s *dev,
|
|
|
|
fb_coord_t row, fb_coord_t col,
|
2020-12-22 18:55:19 +01:00
|
|
|
FAR uint8_t *buffer, size_t npixels);
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* LCD Configuration */
|
|
|
|
|
|
|
|
static int st7789_getvideoinfo(FAR struct lcd_dev_s *dev,
|
|
|
|
FAR struct fb_videoinfo_s *vinfo);
|
|
|
|
static int st7789_getplaneinfo(FAR struct lcd_dev_s *dev,
|
|
|
|
unsigned int planeno,
|
|
|
|
FAR struct lcd_planeinfo_s *pinfo);
|
|
|
|
|
|
|
|
/* LCD Specific Controls */
|
|
|
|
|
|
|
|
static int st7789_getpower(FAR struct lcd_dev_s *dev);
|
|
|
|
static int st7789_setpower(FAR struct lcd_dev_s *dev, int power);
|
|
|
|
static int st7789_getcontrast(FAR struct lcd_dev_s *dev);
|
|
|
|
static int st7789_setcontrast(FAR struct lcd_dev_s *dev,
|
|
|
|
unsigned int contrast);
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Private Data
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static struct st7789_dev_s g_lcddev;
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Private Functions
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_select
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Select the SPI, locking and re-configuring if necessary
|
|
|
|
*
|
|
|
|
* Input Parameters:
|
|
|
|
* spi - Reference to the SPI driver structure
|
|
|
|
* bits - Number of SPI bits
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
* Assumptions:
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static void st7789_select(FAR struct spi_dev_s *spi, int bits)
|
|
|
|
{
|
|
|
|
/* Select ST7789 chip (locking the SPI bus in case there are multiple
|
|
|
|
* devices competing for the SPI bus
|
|
|
|
*/
|
|
|
|
|
|
|
|
SPI_LOCK(spi, true);
|
|
|
|
SPI_SELECT(spi, SPIDEV_DISPLAY(0), true);
|
|
|
|
|
|
|
|
/* Now make sure that the SPI bus is configured for the ST7789 (it
|
|
|
|
* might have gotten configured for a different device while unlocked)
|
|
|
|
*/
|
|
|
|
|
|
|
|
SPI_SETMODE(spi, CONFIG_LCD_ST7789_SPIMODE);
|
|
|
|
SPI_SETBITS(spi, bits);
|
|
|
|
SPI_SETFREQUENCY(spi, CONFIG_LCD_ST7789_FREQUENCY);
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_deselect
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* De-select the SPI
|
|
|
|
*
|
|
|
|
* Input Parameters:
|
|
|
|
* spi - Reference to the SPI driver structure
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* None
|
|
|
|
*
|
|
|
|
* Assumptions:
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static void st7789_deselect(FAR struct spi_dev_s *spi)
|
|
|
|
{
|
|
|
|
/* De-select ST7789 chip and relinquish the SPI bus. */
|
|
|
|
|
|
|
|
SPI_SELECT(spi, SPIDEV_DISPLAY(0), false);
|
|
|
|
SPI_LOCK(spi, false);
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_sendcmd
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Send a command to the driver.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static inline void st7789_sendcmd(FAR struct st7789_dev_s *dev, uint8_t cmd)
|
|
|
|
{
|
2021-09-17 08:49:19 +02:00
|
|
|
st7789_select(dev->spi, 8);
|
2020-12-22 18:55:19 +01:00
|
|
|
SPI_CMDDATA(dev->spi, SPIDEV_DISPLAY(0), true);
|
|
|
|
SPI_SEND(dev->spi, cmd);
|
|
|
|
SPI_CMDDATA(dev->spi, SPIDEV_DISPLAY(0), false);
|
|
|
|
st7789_deselect(dev->spi);
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_sleep
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Sleep or wake up the driver.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static void st7789_sleep(FAR struct st7789_dev_s *dev, bool sleep)
|
|
|
|
{
|
|
|
|
st7789_sendcmd(dev, sleep ? ST7789_SLPIN : ST7789_SLPOUT);
|
|
|
|
up_mdelay(120);
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_display
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Turn on or off the display.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static void st7789_display(FAR struct st7789_dev_s *dev, bool on)
|
|
|
|
{
|
|
|
|
st7789_sendcmd(dev, on ? ST7789_DISPON : ST7789_DISPOFF);
|
|
|
|
st7789_sendcmd(dev, ST7789_INVON);
|
|
|
|
}
|
|
|
|
|
2021-03-15 16:32:54 +01:00
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_setorientation
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Set screen orientation.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static void st7789_setorientation(FAR struct st7789_dev_s *dev)
|
|
|
|
{
|
|
|
|
/* No need to change the orientation in PORTRAIT mode */
|
|
|
|
|
|
|
|
#if !defined(CONFIG_LCD_PORTRAIT)
|
|
|
|
st7789_sendcmd(dev, ST7789_MADCTL);
|
|
|
|
st7789_select(dev->spi, 8);
|
|
|
|
|
|
|
|
# if defined(CONFIG_LCD_RLANDSCAPE)
|
|
|
|
/* RLANDSCAPE : MY=1 MV=1 */
|
|
|
|
|
|
|
|
SPI_SEND(dev->spi, 0xa0);
|
|
|
|
|
|
|
|
# elif defined(CONFIG_LCD_LANDSCAPE)
|
|
|
|
/* LANDSCAPE : MX=1 MV=1 */
|
|
|
|
|
|
|
|
SPI_SEND(dev->spi, 0x70);
|
|
|
|
|
|
|
|
# elif defined(CONFIG_LCD_RPORTRAIT)
|
|
|
|
/* RPORTRAIT : MX=1 MY=1 */
|
|
|
|
|
|
|
|
SPI_SEND(dev->spi, 0xc0);
|
|
|
|
# endif
|
|
|
|
|
|
|
|
st7789_deselect(dev->spi);
|
|
|
|
#endif
|
|
|
|
}
|
|
|
|
|
2020-12-22 18:55:19 +01:00
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_setarea
|
|
|
|
*
|
|
|
|
* Description:
|
2021-02-25 14:34:37 +01:00
|
|
|
* Set the rectangular area for an upcoming read or write from RAM.
|
2020-12-22 18:55:19 +01:00
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static void st7789_setarea(FAR struct st7789_dev_s *dev,
|
|
|
|
uint16_t x0, uint16_t y0,
|
|
|
|
uint16_t x1, uint16_t y1)
|
|
|
|
{
|
|
|
|
/* Set row address */
|
|
|
|
|
|
|
|
st7789_sendcmd(dev, ST7789_RASET);
|
2021-09-17 08:49:19 +02:00
|
|
|
st7789_select(dev->spi, 8);
|
|
|
|
SPI_SEND(dev->spi, (y0 + ST7789_YOFFSET) >> 8);
|
|
|
|
SPI_SEND(dev->spi, (y0 + ST7789_YOFFSET) & 0xff);
|
|
|
|
SPI_SEND(dev->spi, (y1 + ST7789_YOFFSET) >> 8);
|
|
|
|
SPI_SEND(dev->spi, (y1 + ST7789_YOFFSET) & 0xff);
|
2020-12-22 18:55:19 +01:00
|
|
|
st7789_deselect(dev->spi);
|
|
|
|
|
|
|
|
/* Set column address */
|
|
|
|
|
|
|
|
st7789_sendcmd(dev, ST7789_CASET);
|
2021-09-17 08:49:19 +02:00
|
|
|
st7789_select(dev->spi, 8);
|
|
|
|
SPI_SEND(dev->spi, (x0 + ST7789_XOFFSET) >> 8);
|
|
|
|
SPI_SEND(dev->spi, (x0 + ST7789_XOFFSET) & 0xff);
|
|
|
|
SPI_SEND(dev->spi, (x1 + ST7789_XOFFSET) >> 8);
|
|
|
|
SPI_SEND(dev->spi, (x1 + ST7789_XOFFSET) & 0xff);
|
2020-12-22 18:55:19 +01:00
|
|
|
st7789_deselect(dev->spi);
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_bpp
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Set the color depth of the device.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static void st7789_bpp(FAR struct st7789_dev_s *dev, int bpp)
|
|
|
|
{
|
|
|
|
uint8_t depth;
|
|
|
|
|
|
|
|
/* Don't send any command if the depth hasn't changed. */
|
|
|
|
|
|
|
|
if (dev->bpp != bpp)
|
|
|
|
{
|
|
|
|
/* REVISIT: Works only for 12 and 16 bpp! */
|
|
|
|
|
|
|
|
depth = bpp >> 2 | 1;
|
|
|
|
st7789_sendcmd(dev, ST7789_COLMOD);
|
|
|
|
st7789_select(dev->spi, 8);
|
|
|
|
SPI_SEND(dev->spi, depth);
|
|
|
|
st7789_deselect(dev->spi);
|
|
|
|
|
|
|
|
/* Cache the new BPP */
|
|
|
|
|
|
|
|
dev->bpp = bpp;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_wrram
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Write to the driver's RAM.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static void st7789_wrram(FAR struct st7789_dev_s *dev,
|
|
|
|
FAR const uint16_t *buff, size_t size)
|
|
|
|
{
|
|
|
|
st7789_sendcmd(dev, ST7789_RAMWR);
|
|
|
|
|
|
|
|
st7789_select(dev->spi, ST7789_BYTESPP * 8);
|
|
|
|
SPI_SNDBLOCK(dev->spi, buff, size);
|
|
|
|
st7789_deselect(dev->spi);
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_rdram
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Read from the driver's RAM.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
2021-03-14 11:37:52 +01:00
|
|
|
#ifndef CONFIG_LCD_NOGETRUN
|
2020-12-22 18:55:19 +01:00
|
|
|
static void st7789_rdram(FAR struct st7789_dev_s *dev,
|
|
|
|
FAR uint16_t *buff, size_t size)
|
|
|
|
{
|
|
|
|
st7789_sendcmd(dev, ST7789_RAMRD);
|
|
|
|
|
|
|
|
st7789_select(dev->spi, ST7789_BYTESPP * 8);
|
|
|
|
SPI_RECVBLOCK(dev->spi, buff, size);
|
|
|
|
st7789_deselect(dev->spi);
|
|
|
|
}
|
2021-03-14 11:37:52 +01:00
|
|
|
#endif
|
2020-12-22 18:55:19 +01:00
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_fill
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Fill the display with the specified color.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static void st7789_fill(FAR struct st7789_dev_s *dev, uint16_t color)
|
|
|
|
{
|
|
|
|
int i;
|
|
|
|
|
|
|
|
st7789_setarea(dev, 0, 0, ST7789_XRES - 1, ST7789_YRES - 1);
|
|
|
|
|
|
|
|
st7789_sendcmd(dev, ST7789_RAMWR);
|
|
|
|
st7789_select(dev->spi, ST7789_BYTESPP *8);
|
|
|
|
|
|
|
|
for (i = 0; i < ST7789_XRES * ST7789_YRES; i++)
|
|
|
|
{
|
|
|
|
SPI_SEND(dev->spi, color);
|
|
|
|
}
|
|
|
|
|
|
|
|
st7789_deselect(dev->spi);
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_putrun
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* This method can be used to write a partial raster line to the LCD:
|
|
|
|
*
|
2022-06-17 12:17:18 +02:00
|
|
|
* dev - The lcd device
|
2020-12-22 18:55:19 +01:00
|
|
|
* 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)
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
2022-06-17 12:17:18 +02:00
|
|
|
static int st7789_putrun(FAR struct lcd_dev_s *dev,
|
|
|
|
fb_coord_t row, fb_coord_t col,
|
2020-12-22 18:55:19 +01:00
|
|
|
FAR const uint8_t *buffer, size_t npixels)
|
|
|
|
{
|
2022-06-17 12:17:18 +02:00
|
|
|
FAR struct st7789_dev_s *priv = (FAR struct st7789_dev_s *)dev;
|
2020-12-22 18:55:19 +01:00
|
|
|
FAR const uint16_t *src = (FAR const uint16_t *)buffer;
|
|
|
|
|
|
|
|
ginfo("row: %d col: %d npixels: %d\n", row, col, npixels);
|
|
|
|
DEBUGASSERT(buffer && ((uintptr_t)buffer & 1) == 0);
|
|
|
|
|
|
|
|
st7789_setarea(priv, col, row, col + npixels - 1, row);
|
|
|
|
st7789_wrram(priv, src, npixels);
|
|
|
|
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
2021-07-02 06:19:34 +02:00
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_putarea
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* This method can be used to write a partial area to the LCD:
|
|
|
|
*
|
2022-06-17 12:17:18 +02:00
|
|
|
* dev - The lcd device
|
2021-07-02 06:19:34 +02:00
|
|
|
* row_start - Starting row to write to (range: 0 <= row < yres)
|
|
|
|
* row_end - Ending row to write to (range: row_start <= row < yres)
|
|
|
|
* col_start - Starting column to write to (range: 0 <= col <= xres)
|
|
|
|
* col_end - Ending column to write to
|
|
|
|
* (range: col_start <= col_end < xres)
|
|
|
|
* buffer - The buffer containing the area to be written to the LCD
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
2022-06-17 12:17:18 +02:00
|
|
|
static int st7789_putarea(FAR struct lcd_dev_s *dev,
|
|
|
|
fb_coord_t row_start, fb_coord_t row_end,
|
2021-07-02 06:19:34 +02:00
|
|
|
fb_coord_t col_start, fb_coord_t col_end,
|
|
|
|
FAR const uint8_t *buffer)
|
|
|
|
{
|
2022-06-17 12:17:18 +02:00
|
|
|
FAR struct st7789_dev_s *priv = (FAR struct st7789_dev_s *)dev;
|
2021-07-02 06:19:34 +02:00
|
|
|
FAR const uint16_t *src = (FAR const uint16_t *)buffer;
|
|
|
|
|
|
|
|
ginfo("row_start: %d row_end: %d col_start: %d col_end: %d\n",
|
|
|
|
row_start, row_end, col_start, col_end);
|
|
|
|
|
|
|
|
DEBUGASSERT(buffer && ((uintptr_t)buffer & 1) == 0);
|
|
|
|
|
|
|
|
st7789_setarea(priv, col_start, row_start, col_end, row_end);
|
|
|
|
st7789_wrram(priv, src,
|
|
|
|
(row_end - row_start + 1) * (col_end - col_start + 1));
|
|
|
|
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
2020-12-22 18:55:19 +01:00
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_getrun
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* This method can be used to read a partial raster line from the LCD:
|
|
|
|
*
|
2022-06-17 12:17:18 +02:00
|
|
|
* dev - The lcd device
|
2020-12-22 18:55:19 +01:00
|
|
|
* 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)
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
#ifndef CONFIG_LCD_NOGETRUN
|
2022-06-17 12:17:18 +02:00
|
|
|
static int st7789_getrun(FAR struct lcd_dev_s *dev,
|
|
|
|
fb_coord_t row, fb_coord_t col,
|
|
|
|
FAR uint8_t *buffer, size_t npixels)
|
2020-12-22 18:55:19 +01:00
|
|
|
{
|
2022-06-17 12:17:18 +02:00
|
|
|
FAR struct st7789_dev_s *priv = (FAR struct st7789_dev_s *)dev;
|
2020-12-22 18:55:19 +01:00
|
|
|
FAR uint16_t *dest = (FAR uint16_t *)buffer;
|
|
|
|
|
|
|
|
ginfo("row: %d col: %d npixels: %d\n", row, col, npixels);
|
|
|
|
DEBUGASSERT(buffer && ((uintptr_t)buffer & 1) == 0);
|
|
|
|
|
|
|
|
st7789_setarea(priv, col, row, col + npixels - 1, row);
|
|
|
|
st7789_rdram(priv, dest, npixels);
|
|
|
|
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_getvideoinfo
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Get information about the LCD video controller configuration.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static int st7789_getvideoinfo(FAR struct lcd_dev_s *dev,
|
|
|
|
FAR struct fb_videoinfo_s *vinfo)
|
|
|
|
{
|
|
|
|
DEBUGASSERT(dev && vinfo);
|
|
|
|
lcdinfo("fmt: %d xres: %d yres: %d nplanes: 1\n",
|
|
|
|
ST7789_COLORFMT, ST7789_XRES, ST7789_YRES);
|
|
|
|
|
|
|
|
vinfo->fmt = ST7789_COLORFMT; /* Color format: RGB16-565: RRRR RGGG GGGB BBBB */
|
|
|
|
vinfo->xres = ST7789_XRES; /* Horizontal resolution in pixel columns */
|
|
|
|
vinfo->yres = ST7789_YRES; /* Vertical resolution in pixel rows */
|
|
|
|
vinfo->nplanes = 1; /* Number of color planes supported */
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_getplaneinfo
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Get information about the configuration of each LCD color plane.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static int st7789_getplaneinfo(FAR struct lcd_dev_s *dev,
|
|
|
|
unsigned int planeno,
|
|
|
|
FAR struct lcd_planeinfo_s *pinfo)
|
|
|
|
{
|
|
|
|
FAR struct st7789_dev_s *priv = (FAR struct st7789_dev_s *)dev;
|
|
|
|
|
|
|
|
DEBUGASSERT(dev && pinfo && planeno == 0);
|
|
|
|
lcdinfo("planeno: %d bpp: %d\n", planeno, ST7789_BPP);
|
|
|
|
|
|
|
|
pinfo->putrun = st7789_putrun; /* Put a run into LCD memory */
|
2021-07-02 06:19:34 +02:00
|
|
|
pinfo->putarea = st7789_putarea; /* Put an area into LCD */
|
2020-12-22 18:55:19 +01:00
|
|
|
#ifndef CONFIG_LCD_NOGETRUN
|
|
|
|
pinfo->getrun = st7789_getrun; /* Get a run from LCD memory */
|
|
|
|
#endif
|
|
|
|
pinfo->buffer = (FAR uint8_t *)priv->runbuffer; /* Run scratch buffer */
|
|
|
|
pinfo->bpp = priv->bpp; /* Bits-per-pixel */
|
2022-06-26 15:21:57 +02:00
|
|
|
pinfo->dev = dev; /* The lcd device */
|
2020-12-22 18:55:19 +01:00
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_getpower
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static int st7789_getpower(FAR struct lcd_dev_s *dev)
|
|
|
|
{
|
|
|
|
FAR struct st7789_dev_s *priv = (FAR struct st7789_dev_s *)dev;
|
|
|
|
|
|
|
|
lcdinfo("power: %d\n", priv->power);
|
|
|
|
return priv->power;
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_setpower
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static int st7789_setpower(FAR struct lcd_dev_s *dev, int power)
|
|
|
|
{
|
|
|
|
FAR struct st7789_dev_s *priv = (FAR struct st7789_dev_s *)dev;
|
|
|
|
|
|
|
|
lcdinfo("power: %d\n", power);
|
|
|
|
DEBUGASSERT((unsigned)power <= CONFIG_LCD_MAXPOWER);
|
|
|
|
|
|
|
|
/* Set new power level */
|
|
|
|
|
|
|
|
if (power > 0)
|
|
|
|
{
|
|
|
|
/* Turn on the display */
|
|
|
|
|
|
|
|
st7789_display(priv, true);
|
|
|
|
|
|
|
|
/* Save the power */
|
|
|
|
|
|
|
|
priv->power = power;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
/* Turn off the display */
|
|
|
|
|
|
|
|
st7789_display(priv, false);
|
|
|
|
|
|
|
|
/* Save the power */
|
|
|
|
|
|
|
|
priv->power = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
return OK;
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_getcontrast
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Get the current contrast setting (0-CONFIG_LCD_MAXCONTRAST).
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static int st7789_getcontrast(FAR struct lcd_dev_s *dev)
|
|
|
|
{
|
|
|
|
lcdinfo("Not implemented\n");
|
|
|
|
return -ENOSYS;
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_setcontrast
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Set LCD panel contrast (0-CONFIG_LCD_MAXCONTRAST).
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
static int st7789_setcontrast(FAR struct lcd_dev_s *dev,
|
|
|
|
unsigned int contrast)
|
|
|
|
{
|
|
|
|
lcdinfo("contrast: %d\n", contrast);
|
|
|
|
return -ENOSYS;
|
|
|
|
}
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Public Functions
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: st7789_initialize
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* Initialize the ST7789 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 == sleep mode).
|
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
*
|
|
|
|
* On success, this function returns a reference to the LCD object for
|
|
|
|
* the specified LCD. NULL is returned on any failure.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
FAR struct lcd_dev_s *st7789_lcdinitialize(FAR struct spi_dev_s *spi)
|
|
|
|
{
|
|
|
|
FAR struct st7789_dev_s *priv = &g_lcddev;
|
|
|
|
|
|
|
|
/* Initialize the driver data structure */
|
|
|
|
|
|
|
|
priv->dev.getvideoinfo = st7789_getvideoinfo;
|
|
|
|
priv->dev.getplaneinfo = st7789_getplaneinfo;
|
|
|
|
priv->dev.getpower = st7789_getpower;
|
|
|
|
priv->dev.setpower = st7789_setpower;
|
|
|
|
priv->dev.getcontrast = st7789_getcontrast;
|
|
|
|
priv->dev.setcontrast = st7789_setcontrast;
|
|
|
|
priv->spi = spi;
|
|
|
|
|
|
|
|
/* Init the hardware and clear the display */
|
|
|
|
|
|
|
|
st7789_sleep(priv, false);
|
|
|
|
st7789_bpp(priv, ST7789_BPP);
|
2021-03-15 16:32:54 +01:00
|
|
|
st7789_setorientation(priv);
|
2020-12-22 18:55:19 +01:00
|
|
|
st7789_display(priv, true);
|
|
|
|
st7789_fill(priv, 0xffff);
|
|
|
|
|
|
|
|
return &priv->dev;
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif /* CONFIG_LCD_ST7789 */
|