功能简介

特性	无特性，不解释
主控	ESP32-S3-N16R8
'	无特性，不解释
'	无特性，不解释
'	无特性，不解释
接口		Type C USB

产品介绍

产品简介

ESP32-S3-AMOLED-1.91 是一款由微雪 (Waveshare) 设计的低成本、高性能、扩展性强的ESP32_GUI开发板。具有触摸版本和不带触摸版本两个版本，均支持 2.4GHz WiFi 和 BLE 5，集成大容量 Flash 和 PSRAM，板载RTC、IMU、 1.91 英寸AMOLED屏，外露UART、GPIO、I2C、USB总线接口，同时我们还提供大量例程和技术支持，可供你快速开发自动化、物联网产品。

产品特性

搭载高性能 Xtensa 32 位 LX7 双核处理器，主频高达 240MHz
支持 2.4 GHz Wi-Fi (802.11 b/g/n) 和 Bluetooth 5 (LE)，板载天线
内置 512KB SRAM 和 384KB ROM，叠封 16MB Flash 和 8MB PSRAM
板载 1.91 英寸宽电容AMOLED屏，536 × 240 分辨率，65K 彩色
AMOLED屏显示使用 QSPI接口，提升速度的同时节省大量IO
触摸版本使用 I2C接口与触摸芯片进行通信，支持 5 点触控、中断输出
板载 IMU、SD卡座；外观采用开发板形式，外露大量GPIO，使之满足各种场合

资源简介

接口介绍

产品尺寸

使用说明

器件准备

ESP32-S3-AMOLED-1.91 x1
16GB SD卡 x1
USB线 type A公口转 Type C公口 x1

在操作前，建议先浏览目录，快速了解文档结构。为顺利操作，请仔细阅读FAQ，提前了解可能的问题。文档中所有资料均提供超链接，方便下载。

Arduino开发

本章介绍 Arduino 环境搭建，包括 Arduino IDE、ESP32板管理、相关库的安装，程序编译下载及示例程序测试，帮助用户掌握开发板，便于二次开发。

环境搭建

下载和安装 Arduino IDE

点击访问Arduino官网，选择对应的系统和系统位数下载。
运行安装程序，全部默认安装即可。

更多 Arduino IDE 使用说明，请见：Arduino 官方说明文档

安装 Arduino-ESP32

ESP32相关主板在Arduino IDE使用，须先安装“Arduino-ESP32板”库。
国内部分区域安装，可能会因网络因素无法“在线安装”，一般推荐“离线安装” 。
安装 Arduino-ESP32教程，详见：Arduino 板管理教程

安装库

在安装 Arduino 库时，通常有两种方式可供选择：在线安装 和 离线安装。
对于大多数库，用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而，一些开源库或自定义库未被同步到 Arduino 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。
库安装教程，详见：Arduino 库管理教程

ESP32-S3-AMOLED-1.91 库文件说明
库名称	说明	库安装要求	库版本说明
LVGL	图形库	“离线”安装

运行第一个 Arduino 程序

如果你刚入门学习ESP32和Arduino，还不知道如何创建、编译、烧录和运行Arduino ESP32程序，那么请展开看看，希望可以帮助到你！

新建工程

运行Arduino IDE，选择 File -> New Sketch
输入代码：

void setup() {
  // put your setup code here, to run once:
  Serial.begin(115200);
}

void loop() {
  // put your main code here, to run repeatedly:
  Serial.println("Hello, World!");
  delay(2000);
}

保存代码工程，选择 File -> Save As...；在弹出的菜单选择保存工程路径，并输入工程名，如 Hello_World，点击保存

编译和烧录程序

选择对应的开发板，以ESP32S3主板为例： Tools -> Board -> esp32 -> ESP32S3 Dev Module
选择对应的端口，另外若ESP32S3主板只有USB口，须打开（Enable）USB CDC，如下图所示：
编译并上传程序：
打开串口监视窗口，程序每隔2秒会打印“Hello World!”，运行情况如下所示：

示例程序

ESP32-S3-AMOLED-1.91 示例程序
示例程序	说明	依赖库
ADC_Test	基础例程：读取系统当前的电压值	-
IMU_Test	基础例程：打印IMU发出来的原始数据	-
LVGL_Test	基础例程：LVGL例程	LVGL
SDcard_Test	基础例程：加载显示SD卡的信息
WIFI_Test	基础例程：设置为STA模式，可接入WiFi获取IP地址

Arduino 工程设置：

ADC_Test

【硬件连接】

使用USB线把板子接入电脑

【运行效果】

程序烧录完成后，设备的运行效果如下：

通过打开串口监控可以看到，输出ADC的值和电压，如下图所示：
可以看到ADC采样值是2518左右，实际电压大于3.3V，是因为经过电池芯片的升压，想具体分析，可以查看原理图

IMU_Test

【硬件连接】

使用USB线把板子接入电脑

【运行效果】

程序烧录完成后，设备的运行效果如下：

点击串口监控设备，可以看到IMU发出来的原始数据(欧拉角需要自己转换)，如下图所示：
可以看到，每隔1秒输出一次，如果需要修改或者参考，可以直接进去qmi源文件修改。

LVGL_Test

【硬件连接】

使用USB线把板子接入电脑

【代码分析】

针对LVGL，lvgl_conf.h是LVGL的配置文件，下面主要针对一些常用的来进行说明，如下图：

还有一些LVGL的demo、文件系统都可以在conf配置文件里面设置。

【运行效果】

LVGL例程对RAM和ROM要求比较高，所以必须要按照环境搭建的要求来配置程序烧录完成后，设备的运行效果如下：

SD_Test

【硬件连接】

板子装上SD卡（必须先插入容量小于64G的SD卡），使用USB线把板子接入电脑

想了解更多关于Arduino ESP32库关于SD卡相关的使用？可访问：Arduino ESP32 库 SD 使用。

【运行效果】

程序烧录完成后，设备的运行效果如下：

可以看到输出一些SD卡的信息，practical_size是SD卡的实际容量

WIFI_Test

【硬件连接】

使用USB线把板子接入电脑

【代码修改】

该工程实现芯片处于STA模式下连接WIFI而且获取到IP地址，在编译、下载固件之前，需要修改一些代码，此处修改成所处环境可用的WIFI路由器名字和密码。

【运行效果】

程序烧录完成后，设备的运行效果如下：

芯片处于STA模式下成功连接WIFI并且获取到IP地址。

ESP-IDF开发

本章介绍 ESP-IDF 环境搭建，包括 Visual Studio、Espressif IDF插件的安装，程序编译下载及示例程序测试，帮助用户掌握开发板，便于二次开发。

环境搭建

下载和安装 Visual Studio

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

安装Espressif IDF插件

国内部分区域安装，一般推荐“在线安装”，若因网络因素无法在线安装，则使用“离线安装”。
安装Espressif IDF插件教程，详见：安装Espressif IDF插件教程

运行第一个 ESP-IDF 程序

如果你刚入门学习ESP32和ESP-IDF，还不知道如何创建、编译、烧录和运行ESP-IDF ESP32程序，那么请展开看看，希望可以帮助到你！

新建项目

创建例程

使用快捷键 F1 ，输入esp-idf:show examples projects
选择你当前的IDF版本
以Hello world例程为例

①选择对应例程
②其readme会说明该例程适用于什么芯片（下文有介绍例程怎么使用与文件结构，这里略）
③点击创建例程

选择放置例程的路径，要求无例程同名文件夹

修改COM口

此处显示使用对应的COM口，点击可以修改对应COM口
请根据设备对应COM口进行选择（可通过设备管理器查看）
若出现下载失败的情况请点击复位按键1秒以上或进入下载模式，等待 PC 端重新识别到设备后再次下载

修改驱动对象

选择我们需要驱动的对象，也就是我们的主芯片为ESP32S3
选择openocd的路径，这里对我们没有影响，所以我们随便选择一个即可

其余状态栏简介

①.ESP-IDF开发环境版本管理器，当我们的工程需要区分开发环境版本时，可以通过安装不同版本的ESP-IDF来分别管理，当工程使用特定版本时，可以通过使用它来切换
②.设备烧录COM口，选择以将编译好的程序烧录进芯片上
③.set-target 芯片型号选择，选择对应的芯片型号，如:ESP32-P4-Nano需要选择 esp32p4 为目标芯片
④.menuconfig，点击修改sdkconfig配置文件内容
⑤.fullclean 清理按钮，当工程编译报错或其他操作污染编译内容时，通过点击清理全部编译内容
⑥. Build 构建工程，当一个工程满足构建时，通过此按钮进行编译
⑦.当前下载方式，默认为UART
⑧.flash烧录按钮，当一个工程Build构建通过时，选择对应开发板COM口，点击此按钮可以将编译好的固件烧录至芯片
⑨.monitor开启烧录口监控，当一个工程Build-->flash后，可通过点击此按钮查看烧录、调试口输出的l0g，以便观察应用程序是否正常工作
⑩.Debug调试
⑪.Build Flash Monitor 一键按钮，用于连续执行Build-->Flash-->Monitor，常被称作小火苗

编译、烧录、串口监视

点击我们之前介绍的编译，烧录，打开串口监视器按键
编译可能需要较长时间才能完成，尤其是在第一次编译时。
在此过程中，ESP-IDF可能会占用大量CPU资源，因此可能会导致系统卡顿。
若是新工程首次烧录程序，将需要选择下载方式，选择 UART
后续也可在下载方式处进行修改（点击即可弹出选项）
因为板载自动下载电路，无需手动操作即可自动下载
下载成功后，自动进入串口监视器，可以看到芯片输出对应的信息并提示10S后重启

使用IDF 示例程序

以ESP32-S3-LCD-1.47-Demo为例
打开工程两种方式

软件内部打开

打开 VScode 软件，选择文件夹打开示例
选择)提供的 ESP-IDF 下的示例，点击选择文件(位于示例程序/Demo/ESP-IDF 路径下)

软件外部打开

正确选择工程目录，打开工程，否则会影响后续程序编译烧录

连接设备后，选择好COM口和型号，点击下方编译并烧录即可实现程序控制