From a7a3d8bec7532c4a0837654a2c3676ff00d484d1 Mon Sep 17 00:00:00 2001 From: Peter Bee Date: Thu, 16 Sep 2021 12:24:34 +0800 Subject: [PATCH] boards/esp32c3: add ESP32C3 LCD drivers Add board driver for ST7735, ST7789 and GC9A01 Signed-off-by: Peter Bee --- boards/risc-v/esp32c3/esp32c3-devkit/Kconfig | 12 ++ .../esp32c3/esp32c3-devkit/src/Makefile | 12 ++ .../esp32c3-devkit/src/esp32c3_board_spi.c | 16 ++ .../esp32c3-devkit/src/esp32c3_bringup.c | 31 ++++ .../esp32c3-devkit/src/esp32c3_gc9a01.c | 148 ++++++++++++++++++ .../esp32c3-devkit/src/esp32c3_st7735.c | 148 ++++++++++++++++++ .../esp32c3-devkit/src/esp32c3_st7789.c | 148 ++++++++++++++++++ 7 files changed, 515 insertions(+) create mode 100644 boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_gc9a01.c create mode 100644 boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_st7735.c create mode 100644 boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_st7789.c diff --git a/boards/risc-v/esp32c3/esp32c3-devkit/Kconfig b/boards/risc-v/esp32c3/esp32c3-devkit/Kconfig index 0ab22836c8..4fb1a559e0 100644 --- a/boards/risc-v/esp32c3/esp32c3-devkit/Kconfig +++ b/boards/risc-v/esp32c3/esp32c3-devkit/Kconfig @@ -94,4 +94,16 @@ config ESP32C3_SPIFLASH_TEST_ADDRESS ---help--- SPI Flash encryption test read/write address. +if LCD_ST7735 || LCD_ST7789 || LCD_GC9A01 + +config ESP32C3_LCD_RSTPIN + int "LCD reset pin" + default 9 + +config ESP32C3_LCD_BLPIN + int "LCD backlight pin" + default 18 + +endif # LCD_ST7735 || LCD_ST7789 || LCD_GC9A01 + endif # ARCH_BOARD_ESP32C3_DEVKIT diff --git a/boards/risc-v/esp32c3/esp32c3-devkit/src/Makefile b/boards/risc-v/esp32c3/esp32c3-devkit/src/Makefile index 15876c7bcd..f46c6cb997 100644 --- a/boards/risc-v/esp32c3/esp32c3-devkit/src/Makefile +++ b/boards/risc-v/esp32c3/esp32c3-devkit/src/Makefile @@ -82,6 +82,18 @@ ifeq ($(CONFIG_ADC),y) CSRCS += esp32c3_adc.c endif +ifeq ($(CONFIG_LCD_ST7735),y) +CSRCS += esp32c3_st7735.c +endif + +ifeq ($(CONFIG_LCD_ST7789),y) +CSRCS += esp32c3_st7789.c +endif + +ifeq ($(CONFIG_LCD_GC9A01),y) +CSRCS += esp32c3_gc9a01.c +endif + ifeq ($(CONFIG_BOARDCTL_IOCTL),y) CSRCS += esp32c3_ioctl.c endif diff --git a/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_board_spi.c b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_board_spi.c index ce1a2ade59..a5c336da31 100644 --- a/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_board_spi.c +++ b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_board_spi.c @@ -30,6 +30,8 @@ #include +#include "esp32c3_gpio.h" + /**************************************************************************** * Private Functions ****************************************************************************/ @@ -61,6 +63,20 @@ uint8_t esp32c3_spi2_status(FAR struct spi_dev_s *dev, uint32_t devid) int esp32c3_spi2_cmddata(FAR struct spi_dev_s *dev, uint32_t devid, bool cmd) { +#if defined(CONFIG_LCD_ST7735) || defined(CONFIG_LCD_ST7789) || \ + defined(CONFIG_LCD_GC9A01) + if (devid == SPIDEV_DISPLAY(0)) + { + /* This is the Data/Command control pad which determines whether the + * data bits are data or a command. + */ + + esp32c3_gpiowrite(CONFIG_ESP32C3_SPI2_MISOPIN, !cmd); + + return OK; + } + +#endif spiinfo("devid: %" PRIu32 " CMD: %s\n", devid, cmd ? "command" : "data"); diff --git a/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_bringup.c b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_bringup.c index 31fef60819..95bd386e74 100644 --- a/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_bringup.c +++ b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_bringup.c @@ -46,6 +46,15 @@ # include "esp32c3_spi.h" #endif +#ifdef CONFIG_LCD_DEV +# include +# include +#endif + +#ifdef CONFIG_VIDEO_FB +# include +#endif + #ifdef CONFIG_ESP32C3_RT_TIMER # include "esp32c3_rt_timer.h" #endif @@ -189,6 +198,28 @@ int esp32c3_bringup(void) } #endif +#ifdef CONFIG_VIDEO_FB + ret = fb_register(0, 0); + if (ret < 0) + { + syslog(LOG_ERR, "ERROR: Failed to initialize Frame Buffer Driver.\n"); + } +#elif defined(CONFIG_LCD) + ret = board_lcd_initialize(); + if (ret < 0) + { + syslog(LOG_ERR, "ERROR: Failed to initialize LCD.\n"); + } +#endif + +#ifdef CONFIG_LCD_DEV + ret = lcddev_register(0); + if (ret < 0) + { + syslog(LOG_ERR, "ERROR: lcddev_register() failed: %d\n", ret); + } +#endif + #if defined(CONFIG_I2C_DRIVER) /* Configure I2C peripheral interfaces */ diff --git a/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_gc9a01.c b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_gc9a01.c new file mode 100644 index 0000000000..06d3435dea --- /dev/null +++ b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_gc9a01.c @@ -0,0 +1,148 @@ +/**************************************************************************** + * boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_gc9a01.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 + +#include +#include +#include +#include + +#include +#include +#include +#include +#include + +#include "esp32c3_spi.h" +#include "esp32c3_gpio.h" + +/**************************************************************************** + * Pre-processor Definitions + ****************************************************************************/ + +#define LCD_SPI_PORTNO ESP32C3_SPI2 +#define LCD_DC CONFIG_ESP32C3_SPI2_MISOPIN +#define LCD_RST CONFIG_ESP32C3_LCD_RSTPIN +#define LCD_BL CONFIG_ESP32C3_LCD_BLPIN + +#ifndef CONFIG_SPI_CMDDATA +# error "The GC9A01 driver requires CONFIG_SPI_CMDATA in the config" +#endif + +#ifndef CONFIG_ESP32C3_SPI_SWCS +# error "The GC9A01 driver requires CONFIG_ESP32C3_SPI_SWCS in the config" +#endif + +/**************************************************************************** + * Private Data + ****************************************************************************/ + +static struct spi_dev_s *g_spidev; +static struct lcd_dev_s *g_lcd = NULL; + +/**************************************************************************** + * 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) +{ + g_spidev = esp32c3_spibus_initialize(LCD_SPI_PORTNO); + if (!g_spidev) + { + lcderr("ERROR: Failed to initialize SPI port %d\n", LCD_SPI_PORTNO); + return -ENODEV; + } + + /* SPI RX is not used. Same pin is used as LCD Data/Command control */ + + esp32c3_configgpio(LCD_DC, OUTPUT); + esp32c3_gpiowrite(LCD_DC, true); + + /* Pull LCD_RESET high */ + + esp32c3_configgpio(LCD_RST, OUTPUT); + esp32c3_gpiowrite(LCD_RST, false); + up_mdelay(50); + esp32c3_gpiowrite(LCD_RST, true); + up_mdelay(50); + + /* Set full brightness */ + + esp32c3_configgpio(LCD_BL, OUTPUT); + esp32c3_gpiowrite(LCD_BL, true); + + return OK; +} + +/**************************************************************************** + * Name: board_lcd_getdev + * + * Description: + * Return a a reference to the LCD object for the specified LCD. This + * allows support for multiple LCD devices. + * + ****************************************************************************/ + +FAR struct lcd_dev_s *board_lcd_getdev(int devno) +{ + g_lcd = gc9a01_lcdinitialize(g_spidev); + if (!g_lcd) + { + lcderr("ERROR: Failed to bind SPI port %d to LCD %d\n", LCD_SPI_PORTNO, + devno); + } + else + { + lcdinfo("SPI port %d bound to LCD %d\n", LCD_SPI_PORTNO, devno); + return g_lcd; + } + + return NULL; +} + +/**************************************************************************** + * Name: board_lcd_uninitialize + * + * Description: + * Uninitialize the LCD support + * + ****************************************************************************/ + +void board_lcd_uninitialize(void) +{ + /* Turn the display off */ + + g_lcd->setpower(g_lcd, 0); +} diff --git a/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_st7735.c b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_st7735.c new file mode 100644 index 0000000000..b12b928f8e --- /dev/null +++ b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_st7735.c @@ -0,0 +1,148 @@ +/**************************************************************************** + * boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_st7735.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 + +#include +#include +#include +#include + +#include +#include +#include +#include +#include + +#include "esp32c3_spi.h" +#include "esp32c3_gpio.h" + +/**************************************************************************** + * Pre-processor Definitions + ****************************************************************************/ + +#define LCD_SPI_PORTNO ESP32C3_SPI2 +#define LCD_DC CONFIG_ESP32C3_SPI2_MISOPIN +#define LCD_RST CONFIG_ESP32C3_LCD_RSTPIN +#define LCD_BL CONFIG_ESP32C3_LCD_BLPIN + +#ifndef CONFIG_SPI_CMDDATA +# error "The ST7735 driver requires CONFIG_SPI_CMDATA in the config" +#endif + +#ifndef CONFIG_ESP32C3_SPI_SWCS +# error "The ST7735 driver requires CONFIG_ESP32C3_SPI_SWCS in the config" +#endif + +/**************************************************************************** + * Private Data + ****************************************************************************/ + +static struct spi_dev_s *g_spidev; +static struct lcd_dev_s *g_lcd = NULL; + +/**************************************************************************** + * 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) +{ + g_spidev = esp32c3_spibus_initialize(LCD_SPI_PORTNO); + if (!g_spidev) + { + lcderr("ERROR: Failed to initialize SPI port %d\n", LCD_SPI_PORTNO); + return -ENODEV; + } + + /* SPI RX is not used. Same pin is used as LCD Data/Command control */ + + esp32c3_configgpio(LCD_DC, OUTPUT); + esp32c3_gpiowrite(LCD_DC, true); + + /* Pull LCD_RESET high */ + + esp32c3_configgpio(LCD_RST, OUTPUT); + esp32c3_gpiowrite(LCD_RST, false); + up_mdelay(1); + esp32c3_gpiowrite(LCD_RST, true); + up_mdelay(120); + + /* Set full brightness */ + + esp32c3_configgpio(LCD_BL, OUTPUT); + esp32c3_gpiowrite(LCD_BL, true); + + return OK; +} + +/**************************************************************************** + * Name: board_lcd_getdev + * + * Description: + * Return a a reference to the LCD object for the specified LCD. This + * allows support for multiple LCD devices. + * + ****************************************************************************/ + +FAR struct lcd_dev_s *board_lcd_getdev(int devno) +{ + g_lcd = st7735_lcdinitialize(g_spidev); + if (!g_lcd) + { + lcderr("ERROR: Failed to bind SPI port %d to LCD %d\n", LCD_SPI_PORTNO, + devno); + } + else + { + lcdinfo("SPI port %d bound to LCD %d\n", LCD_SPI_PORTNO, devno); + return g_lcd; + } + + return NULL; +} + +/**************************************************************************** + * Name: board_lcd_uninitialize + * + * Description: + * Uninitialize the LCD support + * + ****************************************************************************/ + +void board_lcd_uninitialize(void) +{ + /* Turn the display off */ + + g_lcd->setpower(g_lcd, 0); +} diff --git a/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_st7789.c b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_st7789.c new file mode 100644 index 0000000000..de5b92c9bd --- /dev/null +++ b/boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_st7789.c @@ -0,0 +1,148 @@ +/**************************************************************************** + * boards/risc-v/esp32c3/esp32c3-devkit/src/esp32c3_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 + +#include +#include +#include +#include + +#include +#include +#include +#include +#include + +#include "esp32c3_spi.h" +#include "esp32c3_gpio.h" + +/**************************************************************************** + * Pre-processor Definitions + ****************************************************************************/ + +#define LCD_SPI_PORTNO ESP32C3_SPI2 +#define LCD_DC CONFIG_ESP32C3_SPI2_MISOPIN +#define LCD_RST CONFIG_ESP32C3_LCD_RSTPIN +#define LCD_BL CONFIG_ESP32C3_LCD_BLPIN + +#ifndef CONFIG_SPI_CMDDATA +# error "The ST7789 driver requires CONFIG_SPI_CMDATA in the config" +#endif + +#ifndef CONFIG_ESP32C3_SPI_SWCS +# error "The ST7789 driver requires CONFIG_ESP32C3_SPI_SWCS in the config" +#endif + +/**************************************************************************** + * Private Data + ****************************************************************************/ + +static struct spi_dev_s *g_spidev; +static struct lcd_dev_s *g_lcd = NULL; + +/**************************************************************************** + * 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) +{ + g_spidev = esp32c3_spibus_initialize(LCD_SPI_PORTNO); + if (!g_spidev) + { + lcderr("ERROR: Failed to initialize SPI port %d\n", LCD_SPI_PORTNO); + return -ENODEV; + } + + /* SPI RX is not used. Same pin is used as LCD Data/Command control */ + + esp32c3_configgpio(LCD_DC, OUTPUT); + esp32c3_gpiowrite(LCD_DC, true); + + /* Pull LCD_RESET high */ + + esp32c3_configgpio(LCD_RST, OUTPUT); + esp32c3_gpiowrite(LCD_RST, false); + up_mdelay(1); + esp32c3_gpiowrite(LCD_RST, true); + up_mdelay(10); + + /* Set full brightness */ + + esp32c3_configgpio(LCD_BL, OUTPUT); + esp32c3_gpiowrite(LCD_BL, true); + + return OK; +} + +/**************************************************************************** + * Name: board_lcd_getdev + * + * Description: + * Return a a reference to the LCD object for the specified LCD. This + * allows support for multiple LCD devices. + * + ****************************************************************************/ + +FAR struct lcd_dev_s *board_lcd_getdev(int devno) +{ + g_lcd = st7789_lcdinitialize(g_spidev); + if (!g_lcd) + { + lcderr("ERROR: Failed to bind SPI port %d to LCD %d\n", LCD_SPI_PORTNO, + devno); + } + else + { + lcdinfo("SPI port %d bound to LCD %d\n", LCD_SPI_PORTNO, devno); + return g_lcd; + } + + return NULL; +} + +/**************************************************************************** + * Name: board_lcd_uninitialize + * + * Description: + * Uninitialize the LCD support + * + ****************************************************************************/ + +void board_lcd_uninitialize(void) +{ + /* Turn the display off */ + + g_lcd->setpower(g_lcd, 0); +}