Elecrow CrowPanel ESP32-S3 Rotary LCD 1.28"

Support for the Elecrow ESP32-S3 Rotary LCD 1.28" Board. More...

Detailed Description

Support for the Elecrow ESP32-S3 Rotary LCD 1.28" Board.

Overview

The Elecrow ESP32-S3 Rotary LCD 1.28" board is a compact development board built around the ESP32-S3 microcontroller with an integrated 1.28" round TFT LCD display, capacitive touch panel and a knurled rotary knob around the display.

The main features of the board are:

• ESP32-S3R8 SoC with 2.4 GHz WiFi (802.11 b/g/n) and Bluetooth 5/BLE
• 16 MB Flash
• 2 MB PSRAM
• 1.28-inch 240x240 round IPS LCD (GC9A01 driver)
• Capacitive touch panel (CST816D controller)
• BOOT button (active low, directly usable as user button)
• Display Button
• Rotary knob around the display (currently unsupported, no periph_qdec for ESP32 implemented yet)
• Red LED, 5x WS281x compatible NeoPixels

Hardware

MCU

Most features of the board are provided by the ESP32-S3 SoC. For detailed information about the ESP32-S3 SoC variant (family) and ESP32x SoCs, see section ESP32 SoC Series.

Board Configuration

The board integrates a 1.28-inch round IPS LCD driven by a GC9A01 display controller via SPI and a CST816D capacitive touch controller connected via I2C. A BOOT button on GPIO0 as well as the display button are directly usable as user buttons.

The default board configuration provides:

• 2 x ADC channel (available on the external flat flex connector)
• 1 x SPI (display)
• 2 x I2C (touch controller and external flat flex connector)
• 1 x UART (console)
• 1 x LED Red via PWM Channel

The following table shows the default board configuration sorted by peripheral function. This configuration can be overridden by application-specific configurations.

Function | GPIOs | Remarks | Configuration :-------------—|:----—|:---------------------------------------------—|:---------------------------------------— BTN0 | GPIO0 | | BTN1 | GPIO41 | Display Button | ADC_LINE(0) | GPIO4 | Flat Flex Connector | ADC Channels ADC_LINE(1) | GPIO12 | Flat Flex Connector | ADC Channels RGB-LED | GPIO48 | supported by the ws281x module | LED Red | GPIO40 | Integrated Red LED | SPI_DEV(0) CLK | GPIO10 | LCD SCLK, GC9A01 | SPI Interfaces SPI_DEV(0) MOSI | GPIO11 | LCD SDA, GC9A01 | SPI Interfaces SPI_DEV(0) MISO | UNDEF | The LCD has no MISO output and can not be read. | SPI_DEV(0) CS0 | GPIO9 | LCD CS, GC9A01 | SPI Interfaces LCD DC | GPIO3 | GC9A01 data/command | LCD RST | GPIO14 | GC9A01 reset | LCD BL | GPIO46 | Backlight control (active high) | I2C_DEV(0) SCL | GPIO7 | Touch + IMU | I2C Interfaces I2C_DEV(0) SDA | GPIO6 | Touch + IMU | I2C Interfaces I2C_DEV(1) SCL | GPIO39 | Flat Flex Connector | I2C Interfaces I2C_DEV(1) SDA | GPIO38 | Flat Flex Connector | I2C Interfaces Touch IRQ | GPIO5 | CST816D interrupt | Touch RST | GPIO13 | CST816D reset | UART_DEV(0) TxD | GPIO43 | Console (fixed) | UART interfaces UART_DEV(0) RxD | GPIO44 | Console (fixed) | UART interfaces

For detailed information about the peripheral configurations of ESP32-S3 boards, see section Common Peripherals.

Powering Peripherals

The LCD and touch controller are power gated with a MOSFET, controlled by GPIO1. To use it, the GPIO pin has to be set high. When using the GC9A01 or CST816S modules, the power is automatically activated.

Likewise, the +5V outputs on the external connectors for UART and I2C are power gated by a MOSFET controlled by GPIO2. The +5V pin on the flat flex connector has a direct connection and is not switched. If the power pin on the UART and I2C connectors is used by your application, make sure to set the POWER_EXTERNAL_5V_PIN GPIO.

Board Pinout

The board schematic and additional documentation can be found on the Elecrow Wiki.

Flashing the Device

Flashing RIOT is quite easy. The board has a custom USB cable with a JST connector with to be used for the reset/boot/flash logic. Just connect the board to your host computer and run:

BOARD=elecrow-esp32s3-rotary-lcd-128 make flash ...

For detailed information about ESP32-S3 as well as configuring and compiling RIOT for ESP32-S3 boards, see RIOT-OS on ESP32 SoC Series Boards.

Files
file	board.h
	Board specific definitions for the Elecrow CrowPanel ESP32-S3 1.28-inch rotary round display board (Touch version)
file	gpio_params.h
	Board specific configuration of direct mapped GPIOs for the Elecrow CrowPanel ESP32-S3 1.28-inch rotary round display board (Touch version)
file	periph_conf.h
	Configuration of CPU peripherals for the Elecrow CrowPanel ESP32-S3 1.28-inch rotary round display board (Touch version)