mirror of
https://github.com/apache/nuttx.git
synced 2026-05-18 00:34:10 +08:00
boards/arm/stm32f401rc-rs485: Add support to ST7735 LCD
This commit adds support for the LCD based on ST7735 controller on the STM32F401RC-RS485 board and updates the board documentation accordingly. Signed-off-by: Rodrigo Sim <rcsim10@gmail.com>
This commit is contained in:
Rodrigo Sim
Xiang Xiao
@@ -848,9 +848,6 @@ features such as scheduling and multi-sensor handling.
|
||||
- ``value1`` corresponds to pressure in hPa (hectopascals).
|
||||
- ``value2`` corresponds to temperature in tenths of degrees Celsius (e.g., 224.00 = 22.4°C).
|
||||
|
||||
Hardware Connections
|
||||
--------------------
|
||||
|
||||
Connect the BMP180 sensor to the STM32 board using the I2C interface.
|
||||
|
||||
+--------+------+
|
||||
@@ -860,3 +857,87 @@ Connect the BMP180 sensor to the STM32 board using the I2C interface.
|
||||
+--------+------+
|
||||
| SCL | PB8 |
|
||||
+--------+------+
|
||||
|
||||
ST7735
|
||||
======
|
||||
|
||||
This example shows how to bring up and use a ST7735-based TFT LCD display in NuttX.
|
||||
|
||||
How to add support for the ST7735 display to a new board in NuttX:
|
||||
|
||||
1. **LCD Initialization:**
|
||||
Implement LCD initialization/uninitialization in `stm32_lcd_st7735.c`
|
||||
to handle the display. You can copy this from another board that
|
||||
supports ST7735.
|
||||
|
||||
2. **Update CMakeLists.txt and Make.defs:**
|
||||
Add `stm32_lcd_st7735.c` if `CONFIG_LCD_ST7735` is enabled.
|
||||
|
||||
3. **SPI Initialization:**
|
||||
Ensure SPI is configured in `stm32_spi.c` for the ST7735.
|
||||
|
||||
4. **Board Setup:**
|
||||
Configure GPIO pins for RESET, DC, and CS.
|
||||
|
||||
You can wire the display to your board this way:
|
||||
|
||||
+------------+---------+
|
||||
| LCD | PIN |
|
||||
+============+=========+
|
||||
| CS | PB7 |
|
||||
+------------+---------+
|
||||
| DC | PB8 |
|
||||
+------------+---------+
|
||||
| RESET | PB6 |
|
||||
+------------+---------+
|
||||
| SDA (MOSI) | PA7 |
|
||||
+------------+---------+
|
||||
| SCK (SCLK) | PA5 |
|
||||
+------------+---------+
|
||||
|
||||
.. note::
|
||||
|
||||
The ST7735 uses the SPI interface.
|
||||
``SDA`` corresponds to SPI ``MOSI`` (Master Out Slave In),
|
||||
and ``SCK`` corresponds to SPI ``SCLK`` (Serial Clock).
|
||||
|
||||
Enable the following options using ``make menuconfig``:
|
||||
--------------------------------------------------------
|
||||
|
||||
::
|
||||
|
||||
CONFIG_DRIVERS_VIDEO=y
|
||||
CONFIG_EXAMPLES_FB=y
|
||||
CONFIG_LCD=y
|
||||
CONFIG_LCD_FRAMEBUFFER=y
|
||||
CONFIG_LCD_ST7735=y
|
||||
CONFIG_SPI_CMDDATA=y
|
||||
CONFIG_STM32_SPI1=y
|
||||
CONFIG_VIDEO_FB=y
|
||||
|
||||
NSH usage
|
||||
---------
|
||||
|
||||
::
|
||||
|
||||
NuttShell (NSH) NuttX-12.9.0
|
||||
nsh> fb
|
||||
VideoInfo:
|
||||
fmt: 11
|
||||
xres: 160
|
||||
yres: 128
|
||||
nplanes: 1
|
||||
PlaneInfo (plane 0):
|
||||
fbmem: 0x20003598
|
||||
fblen: 40960
|
||||
stride: 320
|
||||
display: 0
|
||||
bpp: 16
|
||||
Mapped FB: 0x20003598
|
||||
0: ( 0, 0) (160,128)
|
||||
1: ( 14, 11) (132,106)
|
||||
2: ( 28, 22) (104, 84)
|
||||
3: ( 42, 33) ( 76, 62)
|
||||
4: ( 56, 44) ( 48, 40)
|
||||
5: ( 70, 55) ( 20, 18)
|
||||
Test finished
|
||||
|
||||
@@ -69,6 +69,15 @@ if(CONFIG_DEV_GPIO)
|
||||
list(APPEND SRCS stm32_gpio.c)
|
||||
endif()
|
||||
|
||||
if(CONFIG_VIDEO_FB)
|
||||
if(CONFIG_LCD_SSD1306)
|
||||
list(APPEND SRCS stm32_lcd_ssd1306.c)
|
||||
endif()
|
||||
if(CONFIG_LCD_ST7735)
|
||||
list(APPEND SRCS stm32_lcd_st7735.c)
|
||||
endif()
|
||||
endif()
|
||||
|
||||
target_sources(board PRIVATE ${SRCS})
|
||||
|
||||
if(CONFIG_ARCH_CHIP_STM32F401RC)
|
||||
|
||||
@@ -25,9 +25,12 @@ include $(TOPDIR)/Make.defs
|
||||
CSRCS = stm32_boot.c stm32_bringup.c stm32_spi.c
|
||||
|
||||
ifeq ($(CONFIG_VIDEO_FB),y)
|
||||
ifeq ($(CONFIG_LCD_SSD1306),y)
|
||||
CSRCS += stm32_lcd_ssd1306.c
|
||||
endif
|
||||
ifeq ($(CONFIG_LCD_SSD1306),y)
|
||||
CSRCS += stm32_lcd_ssd1306.c
|
||||
endif
|
||||
ifeq ($(CONFIG_LCD_ST7735),y)
|
||||
CSRCS += stm32_lcd_st7735.c
|
||||
endif
|
||||
endif
|
||||
|
||||
ifeq ($(CONFIG_ARCH_LEDS),y)
|
||||
|
||||
@@ -66,14 +66,14 @@ int board_lcd_initialize(void)
|
||||
|
||||
/* Initialize the RESET and DC pins */
|
||||
|
||||
stm32_configgpio(GPIO_OLED_RESET);
|
||||
stm32_configgpio(GPIO_OLED_DC);
|
||||
stm32_configgpio(GPIO_LCD_RESET);
|
||||
stm32_configgpio(GPIO_LCD_DC);
|
||||
|
||||
/* Reset the OLED display */
|
||||
|
||||
stm32_gpiowrite(GPIO_OLED_RESET, 0);
|
||||
stm32_gpiowrite(GPIO_LCD_RESET, 0);
|
||||
up_mdelay(1);
|
||||
stm32_gpiowrite(GPIO_OLED_RESET, 1);
|
||||
stm32_gpiowrite(GPIO_LCD_RESET, 1);
|
||||
up_mdelay(120);
|
||||
|
||||
ret = board_ssd1306_initialize(OLED_SPI_PORT);
|
||||
|
||||
@@ -0,0 +1,121 @@
|
||||
/****************************************************************************
|
||||
* boards/arm/stm32/stm32f401rc-rs485/src/stm32_lcd_st7735.c
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*
|
||||
* 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 <stdio.h>
|
||||
#include <stdbool.h>
|
||||
#include <debug.h>
|
||||
#include <errno.h>
|
||||
|
||||
#include <nuttx/arch.h>
|
||||
#include <nuttx/board.h>
|
||||
#include <nuttx/spi/spi.h>
|
||||
#include <nuttx/lcd/lcd.h>
|
||||
#include <nuttx/lcd/st7735.h>
|
||||
|
||||
#include "arm_internal.h"
|
||||
#include "stm32_gpio.h"
|
||||
#include "stm32_spi.h"
|
||||
#include "stm32f401rc-rs485.h"
|
||||
|
||||
/****************************************************************************
|
||||
* Pre-processor Definitions
|
||||
****************************************************************************/
|
||||
|
||||
#define LCD_SPI_PORTNO 1
|
||||
|
||||
/****************************************************************************
|
||||
* 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)
|
||||
{
|
||||
stm32_configgpio(GPIO_LCD_RESET);
|
||||
stm32_configgpio(GPIO_LCD_DC);
|
||||
|
||||
g_spidev = stm32_spibus_initialize(LCD_SPI_PORTNO);
|
||||
if (!g_spidev)
|
||||
{
|
||||
lcderr("ERROR: Failed to initialize SPI port %d\n", LCD_SPI_PORTNO);
|
||||
return -ENODEV;
|
||||
}
|
||||
|
||||
stm32_gpiowrite(GPIO_LCD_RESET, 0);
|
||||
up_mdelay(1);
|
||||
stm32_gpiowrite(GPIO_LCD_RESET, 1);
|
||||
up_mdelay(120);
|
||||
|
||||
g_lcd = st7735_lcdinitialize(g_spidev);
|
||||
|
||||
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.
|
||||
*
|
||||
****************************************************************************/
|
||||
|
||||
struct lcd_dev_s *board_lcd_getdev(int devno)
|
||||
{
|
||||
return g_lcd;
|
||||
}
|
||||
|
||||
/****************************************************************************
|
||||
* Name: board_lcd_uninitialize
|
||||
*
|
||||
* Description:
|
||||
* Uninitialize the LCD support
|
||||
*
|
||||
****************************************************************************/
|
||||
|
||||
void board_lcd_uninitialize(void)
|
||||
{
|
||||
/* Turn the display off */
|
||||
|
||||
g_lcd->setpower(g_lcd, 0);
|
||||
}
|
||||
@@ -57,8 +57,8 @@
|
||||
|
||||
void weak_function stm32_spidev_initialize(void)
|
||||
{
|
||||
#ifdef CONFIG_LCD_SSD1306
|
||||
stm32_configgpio(GPIO_OLED_CS); /* OLED chip select */
|
||||
#if defined(CONFIG_LCD_SSD1306) || defined(CONFIG_LCD_ST7735)
|
||||
stm32_configgpio(GPIO_LCD_CS); /* LCD chip select */
|
||||
#endif
|
||||
|
||||
#ifdef CONFIG_LCD_MAX7219
|
||||
@@ -103,10 +103,10 @@ void stm32_spi1select(struct spi_dev_s *dev,
|
||||
spiinfo("devid: %d CS: %s\n",
|
||||
(int)devid, selected ? "assert" : "de-assert");
|
||||
|
||||
#ifdef CONFIG_LCD_SSD1306
|
||||
#if defined(CONFIG_LCD_SSD1306) || defined(CONFIG_LCD_ST7735)
|
||||
if (devid == SPIDEV_DISPLAY(0))
|
||||
{
|
||||
stm32_gpiowrite(GPIO_OLED_CS, !selected);
|
||||
stm32_gpiowrite(GPIO_LCD_CS, !selected);
|
||||
}
|
||||
#endif
|
||||
|
||||
@@ -186,14 +186,14 @@ uint8_t stm32_spi3status(struct spi_dev_s *dev, uint32_t devid)
|
||||
#ifdef CONFIG_STM32_SPI1
|
||||
int stm32_spi1cmddata(struct spi_dev_s *dev, uint32_t devid, bool cmd)
|
||||
{
|
||||
#if defined(CONFIG_LCD_SSD1306)
|
||||
#if defined(CONFIG_LCD_SSD1306) || defined(CONFIG_LCD_ST7735)
|
||||
if (devid == SPIDEV_DISPLAY(0))
|
||||
{
|
||||
/* This is the Data/Command control pad which determines whether the
|
||||
* data bits are data or a command.
|
||||
*/
|
||||
|
||||
stm32_gpiowrite(GPIO_OLED_DC, !cmd);
|
||||
stm32_gpiowrite(GPIO_LCD_DC, !cmd);
|
||||
|
||||
return OK;
|
||||
}
|
||||
|
||||
@@ -94,14 +94,14 @@
|
||||
#define GPIO_BTN_SW5 \
|
||||
(GPIO_INPUT |GPIO_FLOAT |GPIO_EXTI | GPIO_PORTB | GPIO_PIN15)
|
||||
|
||||
/* OLED SSD1309 */
|
||||
/* LCD SSD1309 or ST7735 */
|
||||
|
||||
#if defined(CONFIG_LCD_SSD1306)
|
||||
# define GPIO_OLED_RESET (GPIO_OUTPUT|GPIO_PUSHPULL|GPIO_SPEED_50MHz|\
|
||||
#if defined(CONFIG_LCD_SSD1306) || defined(CONFIG_LCD_ST7735)
|
||||
# define GPIO_LCD_RESET (GPIO_OUTPUT|GPIO_PUSHPULL|GPIO_SPEED_50MHz|\
|
||||
GPIO_OUTPUT_CLEAR|GPIO_PORTB|GPIO_PIN6)
|
||||
# define GPIO_OLED_CS (GPIO_OUTPUT|GPIO_PUSHPULL|GPIO_SPEED_50MHz|\
|
||||
# define GPIO_LCD_CS (GPIO_OUTPUT|GPIO_PUSHPULL|GPIO_SPEED_50MHz|\
|
||||
GPIO_OUTPUT_SET|GPIO_PORTB|GPIO_PIN7)
|
||||
# define GPIO_OLED_DC (GPIO_OUTPUT|GPIO_PUSHPULL|GPIO_SPEED_50MHz|\
|
||||
# define GPIO_LCD_DC (GPIO_OUTPUT|GPIO_PUSHPULL|GPIO_SPEED_50MHz|\
|
||||
GPIO_OUTPUT_CLEAR|GPIO_PORTB|GPIO_PIN8)
|
||||
#endif
|
||||
|
||||
|
||||
Reference in New Issue
Block a user