功能简介

特性	无特性，不解释
显示尺寸	1.69英寸
分辨率	240 × 280
'	无特性，不解释
'	无特性，不解释
接口	USB	UART	I2C

说明

产品简介

ESP32-S3-Touch-LCD-1.69是一款微雪(Waveshare)设计的低成本，高性能的微控制器开发板。在较小的板型下，板载了1.69英寸电容触摸LCD屏、锂电池充电芯片、六轴传感器（三轴加速度计与三轴陀螺仪）、RTC等外设，方便开发并嵌入应用到产品中。

产品特性

搭载高性能 Xtensa® 32位LX7双核处理器，主频高达 240 MHz
支持 2.4 GHz Wi-Fi (802.11 b/g/n) 和 Bluetooth® 5 (LE)，板载天线
内置 512KB 的 SRAM 和 384KB ROM，叠封 8MB PSRAM 和外接 16MB Flash
板载 1.69 英寸电容触摸 LCD 屏，240×280 分辨率，262K 彩色，能清晰地显示彩色图片

硬件说明

板载贴片天线，使用0R短接可选外部天线，如图中
板载 PCF85063 RTC时钟芯片、RTC电池接口，方便计时定时功能，如图中
板载 QMI8658C 六轴惯性测量单元(IMU)，包含一个3轴陀螺仪和一个3轴加速度计，如图中
板载 ETA6098 高效锂电池充电芯片、M1.25 锂电池接口，方便接入锂电池充放电长期使用，如图中
板载蜂鸣器可做听觉外设使用，如图中
板载TYPE-C接口，连接ESP32-S3 USB，用于烧录程序和日志打印，如图中
板载BOOT、RST功能按钮，方便复位进入下载模式，如图中
板载功能电路按钮，可自定义为上电按钮，可识别单击、双击、长按动作，如图中

产品尺寸

环境搭建

ESP-IDF下使用

以下开发系统默认为Windows，推荐使用VSCode插件进行开发

ESP-IDF

推荐使用VSC插件进行开发

使用VSCode插件开发

安装VSCode

打开VSCode官网的下载页面，选择对应系统和系统位数进行下载
运行安装包后，其余均可以默认安装，但这里为了后续的体验建议，建议在此处勾选框中的1、2、3项
- 第一二项开启后，可以直接通过鼠标右键文件或者目录打开VSCode，可以提高后续的使用体验.
- 第三项开启后，选择打开方式时，可以直接选择VSCode

安装Espressif IDF插件

注：当前插件最新版本为V1.6.0，为体验一致，用户可以选择与我们一样的版本

打开VSCode,使用快捷键Shift+Ctrl+X，进入插件管理器
在搜索栏中，输入Espressif IDF，选择对应的插件点击 install即可
使用快捷键F1，输入
```
esp-idf: configure esp-idf extension
```
选择express（此教程针对第一次安装的用户，故只讲述初次的通用安装教程）
打开后显示该界面
选择下载服务器，我们推荐国内用户使用Espressif作为你的下载服务器
选择想要现在的ESP-IDF版本，我们选择最新的V5.0.1(注意ESP-IDF从V4.4版本后才开始支持ESP32-S3)
下面两个分别为ESP-IDF容器安装地址和ESP-IDF所需的工具安装地址，
- 注意：如果之前有安装过ESP-IDF，或者失败过的，请务必彻底删除文件或者创建全新的无中文路径
配置完成后，点击 install 进行下载
进入下载页面，其会自动安装对应工具与环境，稍等片刻即可
安装完成后，会进入以下界面，说明安装完成

使用官方例程

ESP官方为我们提供大量的例程,并且写详细的使用方法与效果，点击此处查看

创建例程

使用快捷键F1，输入
```
esp-idf:show examples projects
```
选择你当前的IDF版本
以Hello world例程为例
①选择对应例程
②其readme会说明该例程适用于什么芯片（下文有介绍例程怎么使用与文件结构，这里略）
③点击创建例程
选择放置例程的路径，要求无例程同名文件夹

修改COM口

此处显示使用对应的COM口，点击可以修改对应COM口
我们的CH343的COM为COM5，所以我们选择COM5，请根据自己CH343对应COM口进行选择
选择使用的工程或者例程
然后我们的COM口就修改好了

修改驱动对象

此处显示的是使用的驱动对象，点击可以修改对应驱动对象
选择使用的工程或者例程
点击后需要稍等片刻
选择我们需要驱动的对象，也就是我们的主芯片为ESP32S3
选择openocd的路径，这里对我们没有影响，所以我们随便选择一个即可

其余状态栏简介

①SDK 配置编辑器，ESP-IDF很多功能与配置可以在其内修改
②全部清理，清空所有编译文件，
③编译
④当前下载方式，默认为UART
⑤烧录当前固件，请在编译后进行
⑥打开串口监视器，用于查看串口信息
⑦编译，烧录，打开串口监视器一体按键（调试时最常用）

编译、烧录、串口监视

点击我们之前介绍的编译，烧录，打开串口监视器按键
编译可能需要较长时间才能完成，尤其是在第一次编译时。
- 在此过程中，ESP-IDF可能会占用大量CPU资源，因此可能会导致系统卡顿。
因为我们使用的是CH343为USB转串口芯片，并且板载自动下载电路，无需手动操作即可自动下载
下载成功后，自动进入串口监视器，可以看到芯片输出对应的信息并提示10S后重启

Arduino下使用

如果没用使用过arduino-esp32的基础建议仔细阅读官方文档，点击此处查看

安装Arduino IDE

打开官网软件下载页面,选择对应的系统和系统位数下载
可以选择直接下载，也可以选择捐赠并下载
运行安装程序，全部默认安装即可

在线安装arduino-esp32

打开首选项
添加对应的板管理链接，点击该按键

在第一个空白处，添加下文

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

保存设置
打开板管理器并搜索输入ESP32
等待下载
arduino-esp32下载完成

离线安装arduino-esp32

离线包（提取码：1r4i）
- 提取码：1r4i
将压缩包解压缩

将解压文件放在对应用户的arduino器件包目录

C:\Users\{用户名}\AppData\Local\Arduino15\packages\

以用户名为waveshare为例

C:\Users\waveshare\AppData\Local\Arduino15\packages\

关闭全部arduino窗口，确保arduino关闭
打开arduino，并打开板管理器,看到esp32-arduino已经安装即可

使用Arduino例程

选择例程，这里我们选择获取芯片ID的例程
选择我们的板子为 ESP32S3 Dev Moudule
选择我们的端口号，这里我们选择CH343的COM5
点击下载按键,此时会自动编译并下载
下载完成
打开串口监视器
看到循环输出的芯片ID

屏幕说明

LCD及其控制器

该款LCD使用的内置控制器为 ST7789V2，是一款 240 × RGB × 320 像素的 LCD 控制器,而本 LCD 本身的像素为 240(H) × RGB × 280(V)，因此LCD的内部RAM并未完全使用。
该LCD支持12位，16位以及18位每像素的输入颜色格式，即RGB444，RGB565，RGB666三种颜色格式，本例程使用RGB565的颜色格式，这也是常用的RGB格式
LCD使用四线SPI通信接口，这样可以大大的节省GPIO口，同时通信是速度也会比较快
本模组分辨率是240(H) × RGB × 280(V)，但是因为四角是圆角的（尺寸见参数），因此部分输入图像会有部分不显示。

SPI通信协议

注：与传统的SPI协议不同的地方是：由于是只需要显示，故而将从机发往主机的数据线进行了隐藏，该表格详见Datasheet Page 66。
RESX为复位，模块上电时拉低，通常情况下置1；
CSX为从机片选，仅当CS为低电平时，芯片才会被使能。
D/CX为芯片的数据/命令控制引脚，当DC = 0时写命令，当DC = 1时写数据
SDA为传输的数据，即RGB数据；
SCL为SPI通信时钟。
对于SPI通信而言，数据是有传输时序的，即时钟相位（CPHA）与时钟极性(CPOL)的组合：
CPHA的高低决定串行同步时钟是在第一时钟跳变沿还是第二个时钟跳变沿数据被采集，当CPHA = 0，在第一个跳变沿进行数据采集；
CPOL的高低决定串行同步时钟的空闲状态电平，CPOL = 0，为低电平。
从图中可以看出，当SCLK第一个下降沿时开始传输数据，一个时钟周期传输8bit数据，使用SPI0，按位传输,高位在前,低位在后。

触摸及其控制器

本款触摸屏是由表面钢化玻璃＋薄膜FILM材质组成，具有强度高，硬度强、透光率好，搭配的驱动芯片为CST816D自电容触控芯片，该芯片支持标准的 I2C 通讯协议标准，可实现 10Khz~400Khz 的可配通信速率。

I2C通信协议

芯片的 7bit 设备地址为 0x15，即设备写地址为 0x2A，读地址为 0x2B。
波形介绍
- 写入单个字节（往 0x1F 寄存器写入 0x01）
- 连续写入多个字节（往 0x1E、0x1F 分别写入 0x20、0x01）
- 读取单个字节（从 0x21 读取单个字节）
- 连续读取多个字节（从 0x21、0x22、0x23 读取 3 个字节）