ab60d0d3fb
The commit664d45dcbaupdated the behavior of the framebuffer's putarea callback enabling it to be used to draw a particular area of the display. Previously, putarea was only used to draw the entire area of the display. Any different area was drawn, row by row, by putrun. Also, before checking for which callback to call, the framebuffer driver adjusted the buffer reference that was going to be used for calling the driver's callback to point to the init of the relevant data. After that commit, the framebuffer's buffer reference passed to the driver's putarea now contains the data to draw the entire display. Unlike the previous version of that implementation, only the putrun's callback buffer was being referenced from the address that contains the data that actually is being drawn. This commit fixes it by adjusting the reference for the run buffer passed to the putrun/putarea callback. It always starts from the beginning of the relevant data that is actually being drawn. That is necessary because lcddev (which uses the same LCD display driver callbacks) actually don't allocate a buffer containing the data to draw the whole display, so the same putarea implementation of the LCD drivers would'n be able to work for both lcddev and framebuffer. Also it's necessary to pass the stride argument to the LCD drivers in order to enable them to do partial writes by calculating the buffer offset while sending row-by-row. The stride is equal the width multiplied by the bytes per pixel (may add some padding) for framebuffer and is equal to the lenght of the row being drawn (multiplied by the same BPP) for lcddev. Why this approach? Other possible approaches would be: 1) modify lcddev driver to translate received buffer data to a buffer similar to the framebuffer. That wouldn't be efficient considering memory allocation. 2) Create a new callback function. While possible, it'd be confusing to create a different callback to draw the whole screen and another to draw only an area of the screen. Also, these callbacks would differ themselves only from the way the buffer is filled. 3) Simply reverting664d45dcbawould break the usage of the putarea callback to draw an area of the display, which would also be inefficient. This approach is based on the Zephyr's implementation of the ST7789 driver: the buffer starts from the beginiing of the region that would be drawn. The display device driver's putarea implementation should check if the operation refers to a full screen/full row and implement (if possible) a single operation to send the data to be drawn more efficiently. Finally, this approach requires that the drivers which implement the putarea callback and expects the entire framebuffer buffer to be modified. They don't need to calculate where the data begins as the new buffer represents the data from the address that is actually being drawn. This includes adjusting the LCD drivers GC9A01 and ST7789 and the driver for APA102-based LED matrix display.
809 lines
25 KiB
C
809 lines
25 KiB
C
/****************************************************************************
|
|
* 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>
|
|
#include <assert.h>
|
|
#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 */
|
|
|
|
#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
|
|
|
|
#if defined(CONFIG_LCD_LANDSCAPE) || defined(CONFIG_LCD_RLANDSCAPE)
|
|
# define ST7789_XRES CONFIG_LCD_ST7789_YRES
|
|
# define ST7789_YRES CONFIG_LCD_ST7789_XRES
|
|
# define ST7789_XOFFSET CONFIG_LCD_ST7789_YOFFSET
|
|
# define ST7789_YOFFSET CONFIG_LCD_ST7789_XOFFSET
|
|
#else
|
|
# define ST7789_XRES CONFIG_LCD_ST7789_XRES
|
|
# define ST7789_YRES CONFIG_LCD_ST7789_YRES
|
|
# define ST7789_XOFFSET CONFIG_LCD_ST7789_XOFFSET
|
|
# define ST7789_YOFFSET CONFIG_LCD_ST7789_YOFFSET
|
|
#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);
|
|
static void st7789_setorientation(FAR struct st7789_dev_s *dev);
|
|
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 uint8_t *buff, size_t size, size_t skip,
|
|
size_t count);
|
|
#ifndef CONFIG_LCD_NOGETRUN
|
|
static void st7789_rdram(FAR struct st7789_dev_s *dev,
|
|
FAR uint16_t *buff, size_t size);
|
|
#endif
|
|
static void st7789_fill(FAR struct st7789_dev_s *dev, uint16_t color);
|
|
|
|
/* LCD Data Transfer Methods */
|
|
|
|
static int st7789_putrun(FAR struct lcd_dev_s *dev,
|
|
fb_coord_t row, fb_coord_t col,
|
|
FAR const uint8_t *buffer, size_t npixels);
|
|
static int st7789_putarea(FAR struct lcd_dev_s *dev,
|
|
fb_coord_t row_start, fb_coord_t row_end,
|
|
fb_coord_t col_start, fb_coord_t col_end,
|
|
FAR const uint8_t *buffer, fb_coord_t stride);
|
|
#ifndef CONFIG_LCD_NOGETRUN
|
|
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);
|
|
#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)
|
|
{
|
|
st7789_select(dev->spi, 8);
|
|
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);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* 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
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: st7789_setarea
|
|
*
|
|
* Description:
|
|
* Set the rectangular area for an upcoming read or write from RAM.
|
|
*
|
|
****************************************************************************/
|
|
|
|
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);
|
|
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);
|
|
st7789_deselect(dev->spi);
|
|
|
|
/* Set column address */
|
|
|
|
st7789_sendcmd(dev, ST7789_CASET);
|
|
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);
|
|
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. It is possible to write multiples of size
|
|
* while skipping some values.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void st7789_wrram(FAR struct st7789_dev_s *dev,
|
|
FAR const uint8_t *buff, size_t size, size_t skip,
|
|
size_t count)
|
|
{
|
|
size_t i;
|
|
|
|
st7789_sendcmd(dev, ST7789_RAMWR);
|
|
|
|
st7789_select(dev->spi, 8);
|
|
|
|
for (i = 0; i < count; i++)
|
|
{
|
|
SPI_SNDBLOCK(dev->spi, buff + (i * (size + skip)), size);
|
|
}
|
|
|
|
st7789_deselect(dev->spi);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: st7789_rdram
|
|
*
|
|
* Description:
|
|
* Read from the driver's RAM.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef CONFIG_LCD_NOGETRUN
|
|
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);
|
|
}
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* 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:
|
|
*
|
|
* dev - The lcd device
|
|
* 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 st7789_putrun(FAR struct lcd_dev_s *dev,
|
|
fb_coord_t row, fb_coord_t col,
|
|
FAR const uint8_t *buffer, size_t npixels)
|
|
{
|
|
FAR struct st7789_dev_s *priv = (FAR struct st7789_dev_s *)dev;
|
|
|
|
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, buffer, npixels, 0, 1);
|
|
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: st7789_putarea
|
|
*
|
|
* Description:
|
|
* This method can be used to write a partial area to the LCD:
|
|
*
|
|
* dev - The lcd device
|
|
* 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
|
|
* stride - Length of a line in bytes. This parameter may be necessary
|
|
* to allow the LCD driver to calculate the offset for partial
|
|
* writes when the buffer needs to be splited for row-by-row
|
|
* writing.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static int st7789_putarea(FAR struct lcd_dev_s *dev,
|
|
fb_coord_t row_start, fb_coord_t row_end,
|
|
fb_coord_t col_start, fb_coord_t col_end,
|
|
FAR const uint8_t *buffer, fb_coord_t stride)
|
|
{
|
|
FAR struct st7789_dev_s *priv = (FAR struct st7789_dev_s *)dev;
|
|
size_t cols = col_end - col_start + 1;
|
|
size_t rows = row_end - row_start + 1;
|
|
size_t row_size = cols * (priv->bpp >> 3);
|
|
|
|
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);
|
|
|
|
/* If the stride is the same of the row, a single SPI transfer is enough.
|
|
* That is always true for lcddev. For framebuffer, that indicates a full
|
|
* screen or full row update.
|
|
*/
|
|
|
|
if (stride == row_size)
|
|
{
|
|
/* simpler case, we can just send the whole buffer */
|
|
|
|
ginfo("Using full screen/full row mode\n");
|
|
st7789_wrram(priv, buffer, rows * row_size, 0, 1);
|
|
}
|
|
else
|
|
{
|
|
/* We have to go row by row */
|
|
|
|
ginfo("Falling-back to row by row mode\n");
|
|
st7789_wrram(priv, buffer, row_size, stride - row_size, rows);
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: st7789_getrun
|
|
*
|
|
* Description:
|
|
* This method can be used to read a partial raster line from the LCD:
|
|
*
|
|
* dev - The lcd device
|
|
* 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
|
|
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)
|
|
{
|
|
FAR struct st7789_dev_s *priv = (FAR struct st7789_dev_s *)dev;
|
|
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 */
|
|
pinfo->putarea = st7789_putarea; /* Put an area into LCD */
|
|
#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 */
|
|
pinfo->dev = dev; /* The lcd device */
|
|
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);
|
|
st7789_setorientation(priv);
|
|
st7789_display(priv, true);
|
|
st7789_fill(priv, 0xffff);
|
|
|
|
return &priv->dev;
|
|
}
|
|
|
|
#endif /* CONFIG_LCD_ST7789 */
|