ESP32-S3-Touch-LCD-2.1 使用教程

产品概述

产品参数

参数名称参数
接口USB Type-C / UART Type-C
主控芯片ESP32-S3
屏幕类型TFT
屏幕控制芯片Display :ST7701
Touch :CST820
板载设备姿态传感器 :QMI8658
RTC时钟 :PCF85063
Micro SD
Buzzer
电池充电管理模块
产品尺寸75.00±0.1(R) mm

接口说明

  • 12PIN 杜邦线接口
序号引脚丝印功能说明
1GNDGND电源地
2VBus5VUSB供电
3D-USB 差分线(GPIO19)USB 差分线或用做GPIO
4D+USB 差分线(GPIO20)USB 差分线或用做GPIO
5GNDGND电源地
63V33V3对外输出3.3V
7SCLSCL(GPIO7)I2C 时钟线,不可用作普通GPIO
8SDASDA(GPIO15)I2C 数据线,不可用作普通GPIO
9TXDTXD(GPIO43)UART 数据发送或用作普通GPIO
10RXDRXD(GPIO44)UART 数据接收或用作普通GPIO
11NCNC无引脚连接
12IO0GPIO0空闲引脚引出
  • I2C 接口
引脚丝印功能说明
GNDGND电源地
3V33V3对外输出3.3V
SCLSCL(GPIO7)I2C 时钟线,不可用作普通GPIO
SDASDA(GPIO15)I2C 数据线,不可用作普通GPIO
  • UART 接口
引脚丝印功能说明
GNDGND电源地
3V33V3对外输出3.3V
TXDTXD(GPIO43)UART 数据发送或用作普通GPIO
RXDRXD(GPIO44)UART 数据接收或用作普通GPIO

板载功能使用

内部硬件连接


LCD

LCD引脚ESP32S3
LCD_BLGPIO6
LCD_RSTEXIO1
LCD_SDAGPIO1
LCD_SCLGPIO2
LCD_CSEXIO3
PCLKGPIO41
DEGPIO40
VSYNCGPIO39
HSYNCGPIO38
B0NC
B1GPIO5
B2GPIO45
B3GPIO48
B4GPIO47
B5GPIO21
G0GPIO14
G1GPIO13
G2GPIO12
G3GPIO11
G4GPIO10
G5GPIO9
R0NC
R1GPIO46
R2GPIO3
R3GPIO8
R4GPIO18
R5GPIO17
TP_SDAGPIO15
TP_SCLGPIO7
TP_INTGPIO16
TP_RSTEXIO2

SD Card

SD CardESP32S3
SD_D0 / MISOGPIO42
SD_CMD / MOSIGPIO1
SD_SCK / SCLKGPIO2
SD_D3 / CSEXIO4
SD_D1NC
SD_D2NC

QMI

QMI8658CESP32S3
IMU_SCLGPIO7
IMU_SDAGPIO15
IMU_INT1EXIO6
IMU_INT2EXIO5

RTC

PCF85063ATLESP32S3
RTC_SCLGPIO7
RTC_SDAGPIO15
RTC_INTEXIO7

Buzzer

BuzzerESP32S3
Buzzer_ControlEXIO8

Arduino 下使用

  • 请注意,Arduino 上的 ESP32 3.0.2 基于 ESP-IDF v5.1开发,与此前基于 ESP-IDF V4.X 有较大差异,在进行以下操作后,原先程序可以正常运行的程序可能需要进行一些调整才可使用
  • 请注意,电脑用户名必须是英文,用户名为中文会导致编译出错

搭建环境

  • 安装 Arduino IDE
  • 安装完成后打开 Arduino IDE
  • 进入首选项 file -》 Preferences...
  • 添加 JSON 链接
https://espressif.github.io/arduino-esp32/package_esp32_index.json


  • 将项目文件夹修改为 C:\Users\Waveshare\AppData\Local\Arduino15\packages(其中 Waveshare 为计算机用户名)
  • 进入开发板管理器,搜索 esp32 ,在下方的 esp32 by Espressif Systems 中选择 3.0.2 版本并点击安装(若不能正常安装可使用手机热点尝试)


  • 安装完成重启 Arduino IDE 即可使用

安装库文件

  • 请注意此前是否已经安装过该库,若已安装请存档原有的库,防止运行其他程序时出现错误失败
  • 进入示例文件夹 ESP32_S3_Touch_LCD_2.1\LVGL_Arduino ,双击 LVGL_Arduino.ino 打开示例
  • 搜索lvgl库并安装(此操作为了在 Arduino 环境中搭建库文件夹,若之前已经安装过其他库,即存在以下指的文件夹则不用执行这一步)


  • 进入库文件存放路径 c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries(其中 Waveshare 为计算机用户名,环境不同路径不一样,在首选项中看项目文件夹路径,路径下的libraries就是了)


  • 删除刚才下载的 lvgl 库(若前面没有安装则忽略这一步)
  • 安装示例文件中的三个库,在示例路径中新建一个Lib 文件夹


  • 在本页面的下方将提供的 1 个库文件lvgl库)下载并解压,存放到刚才新建的Lib路径
  • 复制提供的库到 c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries(其中 Waveshare 为计算机用户名) 下


  • 继续安装 NTPClient 库


  • 安装 SensorLib 库


  • 完成库安装

示例程序

  • 重新打开示例
  • 选择型号 ESP32S3 Dev Module 与端口


  • 设置板子参数


  • 编译并烧录示例
  • 烧录成功可观察到两个页面
  • 页面 1 分别显示的参数如下
参数功能说明
SD Card显示 SD 卡的大小请注意,仅支持 16GB 及以下的 SD 卡
Flash Size显示 Flash 大小当前板载 16MB Flash
Angular deflection显示板子角度偏移显示三个方向的偏移
RTC Timr显示 RTC 时间显示当前 RTC 时间

RTC 时间与当前时间不一致,是因为掉电状态下并不能留存数据,如需要保持 RTC 时间正常,则需连接 RTC 电池并更新 RTC 时间

Wireless number显示扫描到的WIFI和蓝牙个数扫描结束会在末尾显示 Scan Finish
  • 页面 2 为蜂鸣器控制页面