ESP32-S3-Touch-LCD-2.8-C
来自Waveshare Wiki
| |||||||||||||||||||||||||
| |||||||||||||||||||||||||
说明
产品概述
产品参数
参数名称 | 参数 |
接口 | USB Type-C / UART Type-C |
主控芯片 | ESP32-S3 |
屏幕类型 | TFT |
屏幕控制芯片 | Display :ST7701 |
Touch :GT911 | |
板载设备 | 姿态传感器 :QMI8658 |
RTC时钟 :PCF85063 | |
Micro SD | |
Buzzer | |
电池充电管理模块 | |
产品尺寸 | 73.06(H)x 50.54(V) mm |
接口说明
- 12PIN 杜邦线接口
序号 | 引脚丝印 | 功能 | 说明 |
1 | GND | GND | 电源地 |
2 | VBus | 5V | USB供电 |
3 | D- | USB 差分线(GPIO19) | USB 差分线或用做GPIO |
4 | D+ | USB 差分线(GPIO20) | USB 差分线或用做GPIO |
5 | GND | GND | 电源地 |
6 | 3V3 | 3V3 | 对外输出3.3V |
7 | SCL | SCL(GPIO7) | I2C 时钟线,不可用作普通GPIO |
8 | SDA | SDA(GPIO15) | I2C 数据线,不可用作普通GPIO |
9 | TXD | TXD(GPIO43) | UART 数据发送或用作普通GPIO |
10 | RXD | RXD(GPIO44) | UART 数据接收或用作普通GPIO |
11 | NC | NC | 无引脚连接 |
12 | IO0 | GPIO0 | 空闲引脚引出 |
- I2C 接口
引脚丝印 | 功能 | 说明 |
GND | GND | 电源地 |
3V3 | 3V3 | 对外输出3.3V |
SCL | SCL(GPIO7) | I2C 时钟线,不可用作普通GPIO |
SDA | SDA(GPIO15) | I2C 数据线,不可用作普通GPIO |
- UART 接口
引脚丝印 | 功能 | 说明 |
GND | GND | 电源地 |
3V3 | 3V3 | 对外输出3.3V |
TXD | TXD(GPIO43) | UART 数据发送或用作普通GPIO |
RXD | RXD(GPIO44) | UART 数据接收或用作普通GPIO |
板载功能使用
内部硬件连接
LCD
LCD引脚 | ESP32S3 |
LCD_BL | GPIO6 |
LCD_RST | EXIO1 |
LCD_SDA | GPIO1 |
LCD_SCL | GPIO2 |
LCD_CS | EXIO3 |
PCLK | GPIO41 |
DE | GPIO40 |
VSYNC | GPIO39 |
HSYNC | GPIO38 |
B0 | NC |
B1 | GPIO5 |
B2 | GPIO45 |
B3 | GPIO48 |
B4 | GPIO47 |
B5 | GPIO21 |
G0 | GPIO14 |
G1 | GPIO13 |
G2 | GPIO12 |
G3 | GPIO11 |
G4 | GPIO10 |
G5 | GPIO9 |
R0 | NC |
R1 | GPIO46 |
R2 | GPIO3 |
R3 | GPIO8 |
R4 | GPIO18 |
R5 | GPIO17 |
TP_SDA | GPIO15 |
TP_SCL | GPIO7 |
TP_INT | GPIO16 |
TP_RST | EXIO2 |
SD Card
SD Card | ESP32S3 |
SD_D0 / MISO | GPIO42 |
SD_CMD / MOSI | GPIO1 |
SD_SCK / SCLK | GPIO2 |
SD_D3 / CS | EXIO4 |
SD_D1 | NC |
SD_D2 | NC |
QMI
QMI8658C | ESP32S3 |
IMU_SCL | GPIO7 |
IMU_SDA | GPIO15 |
IMU_INT1 | EXIO6 |
IMU_INT2 | EXIO5 |
RTC
PCF85063ATL | ESP32S3 |
RTC_SCL | GPIO7 |
RTC_SDA | GPIO15 |
RTC_INT | EXIO7 |
Buzzer
Buzzer | ESP32S3 |
Buzzer_Control | EXIO8 |
Arduino 下使用
- 请注意,Arduino 上的 ESP32 3.0.2 基于 ESP-IDF v5.1开发,与此前基于 ESP-IDF V4.X 有较大差异,在进行以下操作后,原先程序可以正常运行的程序可能需要进行一些调整才可使用
- 请注意,电脑用户名必须是英文,用户名为中文会导致编译出错
搭建环境
- 安装 Arduino IDE
- 安装完成后打开 Arduino IDE
- 进入首选项
- 添加 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 即可使用
若安装失败则展开
- 安装 3.0.2 版本失败
- 下载资源文件
链接: https://pan.baidu.com/s/1u99HFx8lAyNLZzj7ja13lA 提取码: 0755
- 从资源管理器按路径 “c:\Users\Waveshare\AppData\Local\Arduino15\staging\packages” 进入(其中 Waveshare 为计算机用户名,需要开启显示隐藏文件)
- 将上方下载的文件解压至 packages 文件夹下
- 重新执行安装操作
- 安装完成重启 Arduino IDE 即可使用
环境修改与库文件安装
修改环境
- 进入路径 C:\Users\Waveshare\AppData\Local\Arduino15\packages\esp32\tools\esp32-arduino-libs\idf-release_v5.1-bd2b9390ef (其中 Waveshare 为计算机用户名)
- 存档当前文件夹下的 esp32s3 文件夹
- 请注意先存档原有 esp32s3 文件夹用于后续还原!!!!!(可以直接压缩该文件,同时拷贝一份到其他位置,当前为将原文件压缩为 esp32s3 - Original file.zip 文件)
- 删除原有文件( 请注意先存档原有 esp32s3 文件夹用于后续还原!!!!! )
- 拷贝提供的 esp32s3 文件到当前目录
- 完成ESP32S3配置修改
安装库文件
- 请注意此前是否已经安装过该库,若已安装请存档原有的库,防止运行其他程序时出现错误失败
- 进入示例文件夹 ESP32_S3_Touch_LCD_2.8\LVGL_Arduino ,双击 LVGL_Arduino.ino 打开示例
- 搜索lvgl库并安装(此操作为了在 Arduino 环境中搭建库文件夹,若之前已经安装过其他库,即存在以下指的文件夹则不用执行这一步)
- 进入库文件存放路径 c:\Users\Waveshare\AppData\Local\Arduino15\packages\libraries(其中 Waveshare 为计算机用户名)
- 删除刚才下载的 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 时间 |
- 页面 2 为播放 SD 卡根目录下的 mp3 音频的 UI 页面
资料
文档
程序
- 库文件
- 示例程序