ESP32-Touch-AMOLED-2.41-B

来自Waveshare Wiki
跳转至: 导航搜索
{{{name2}}}
{{{name3}}}
功能简介
特性 无特性,不解释
主控 ESP32-S3
' 无特性,不解释
' 无特性,不解释
' 无特性,不解释
接口 Type C USB

产品介绍

产品简介

ESP32-S3-Touch-AMOLED-2.41 是一款由微雪 (Waveshare) 设计的低成本、高性能、扩展性强的ESP32_GUI开发板。其支持 2.4GHz WiFi 和 BLE 5,集成大容量 Flash 和 PSRAM,板载RTC、IMU、 2.41 英寸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
  • 板载 2.41 英寸宽电容触摸屏,600 × 450 分辨率,16.7M 彩色
  • AMOLED屏显示使用 QSPI接口、触摸使用 I2C接口,支持 5 点触控、中断输出
  • 板载 RTC、IMU、SD卡座;引出I2C、UART总线,同时外露USB_N、USB_P;使之满足各种场合

资源简介

ESP32-S3-AMOLED-2.41-Ar-demo-10.jpg

接口介绍

需要更加详细请查阅原理图

ESP32-Touch-AMOLED-2.41 AMOLED SD_Card IMU RTC UART I2C KEY_IO GPIO
GPIO0 BOOT0
GPIO1 GPIO1
GPIO2 SD_CS GPIO2
GPIO3 TP_RST GPIO3
GPIO4 SD_SCLK GPIO4
GPIO5 SD_MOSI GPIO5
GPIO6 SD_MISO GPIO6
GPIO7 GPIO7
GPIO8 GPIO8
GPIO9 QSPI_CS
GPIO10 QSPI_CLK
GPIO11 QSPI_D0
GPIO12 QSPI_D1
GPIO13 QSPI_D2
GPIO14 QSPI_D3
GPIO15 Key_BAT
GPIO16 BAT_Control
GPIO17 BAT_ADC
GPIO18 GPIO18
GPIO19 USB_N
GPIO20 USB_P
GPIO21 AMOLED_RST
GPIO38 GPIO38
GPIO39 GPIO39
GPIO40 GPIO40
GPIO41 GPIO41
GPIO42 GPIO42
GPIO43 UART_TXD TXD
GPIO44 UART_RXD RXD
GPIO45 GPIO45
GPIO46 GPIO46
GPIO47 TP_SDA IMU_SDA RTC_SDA SDA SDA
GPIO48 TP_SCL IMU_SCL RTC_SCL SCL SCL
EN RESET
EXIO0 AMOLED_TE
EXIO1 AMOLED_EN
EXIO2 TP_INT
EXIO3 IMU_INT2
EXIO4 IMU_INT1 RTC_INT
EXIO5 EXIO5
EXIO6 EXIO6
EXIO7 EXIO7

产品尺寸

ESP32-S3-AMOLED-2.41-Ar-demo-16.jpgESP32-S3-AMOLED-2.41-Ar-demo-17.jpg

AMOLED参数

ESP32-S3-AMOLED-2.41-Ar-demo-18.jpg

使用说明

ESP32-S3-Touch-AMOLED-2.41 目前提供 Arduino IDEESP-IDF 两种开发工具和框架,提供了灵活的开发选择,你可以根据项目需求和个人习惯选择适合的开发工具。

开发工具介绍

Arduino-IDE-logo.jpg

Arduino IDE

Arduino IDE是一款便捷灵活、方便上手的开源电子原型平台。不需要太多基础,简单学习后,你也可以快速地进行开发。同时,Arduino 拥有庞大的全球用户社区,提供了海量的开源代码、项目示例和教程,还有丰富的库资源,封装了复杂功能,让开发者能快速实现各种功能。

ESP-IDF-logo.jpg

ESP-IDF

ESP-IDF,全称Espressif IDE,是乐鑫科技为 ESP系列芯片推出的专业开发框架。它使用C语言开发,包括编译器、调试器、烧录工具等,可在命令行下或使用集成开发环境(如 Visual Studio Code 配合 Espressif IDF 插件)进行开发,插件提供代码导航、项目管理、调试等功能。


这两种开发方式各有其优势,开发者可以根据自身需求和技能水平进行选择。Arduino 适合初学者和非专业人士,因其简单易学、上手快。而对于有专业背景或对性能要求较高的开发者,ESP-IDF 是更好的选择,它提供了更高级的开发工具和更强的控制能力,适用于复杂项目的开发。

器件准备

  • ESP32-S3-Touch-AMOLED-2.41 x1
  • SD卡 x1
  • USB线 type A公口 转 Type C公口 x1

ESP32-S3-AMOLED-2.41-Ar-demo-19.png

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

Arduino开发

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

环境搭建

下载和安装 Arduino IDE

  • 点击访问Arduino官网,选择对应的系统和系统位数下载。
    ESP32-S3-AMOLED-1.91-Ar-software-01.png
  • 运行安装程序,全部默认安装即可。
环境设置是在 Windows 10 系统下进行,Linux和Mac用户可访问Arduino-esp32环境搭建参考

安装 Arduino-ESP32

  • ESP32相关主板在Arduino IDE使用,须先安装“esp32 by Espressif Systems”库。
  • 国内部分区域安装,一般推荐“离线安装”, 若离线安装失败,则使用“在线安装”。
  • 安装 Arduino-ESP32教程,详见:Arduino 板管理教程
  • ESP32-S3-Touch-AMOLED-2.41 开发板离线包,点击此处下载:esp32_package_3.0.7_arduino离线包
  • ESP32-S3-Touch-AMOLED-2.41 开发板安装说明
板名称 板安装要求 版本号要求
ESP32-S3-Touch-AMOLED-2.41 “离线”安装/“在线”安装 3.0.7

安装库

  • 在安装 Arduino 库时,通常有两种方式可供选择:在线安装离线安装若库安装要求离线安装,则必须使用提供的库文件
    对于大多数库,用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而,一些开源库或自定义库未被同步到 Arduino 库管理器中,因此无法通过在线搜索获取。在这种情况下,用户只能通过离线方式手动安装这些库。
  • 库安装教程,详见:Arduino 库管理教程
  • ESP32-S3-Touch-AMOLED-2.41 库文件存放于示例程序中,点击此处跳转:ESP32-S3-Touch-AMOLED-2.41示例程序
  • ESP32-S3-Touch-AMOLED-2.41 库文件安装说明
库名称 说明 版本 库安装要求
LVGL 图形库 v8.4.0 “离线”安装

运行第一个 Arduino 程序

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

新建工程

  • 运行Arduino IDE,选择 File -> New Sketch
    ESP32-S3-AMOLED-1.91-Ar-study-01.png
  • 输入代码:
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,点击保存

ESP32-S3-AMOLED-1.91-Ar-study-02.png

编译和烧录程序

  • 选择对应的开发板,以ESP32S3主板为例:

①. 点击选择下拉框选项“Select Other Board and Port”;
②. 搜索需要的开发板型号“esp32s3 dev module”并选择;
③. 选择COM口
④. 保存选择。
ESP32-S3-AMOLED-1.91-Ar-study-03.png

  • 部分开发板在指定版本号支持直接选择型号,以“waveshare esp32-s3-lcd-1.69”为例

ESP32-S3-AMOLED-1.91-Ar-study-07.png

  • 若ESP32S3主板只有USB口,须打开(Enable)USB CDC,如下图所示:

ESP32-S3-AMOLED-1.91-Ar-study-04.png

  • 编译并上传程序:

①. 编译程序;②. 编译并下载程序;③. 下载成功。
ESP32-S3-AMOLED-1.91-Ar-study-05.png

  • 打开串口监视窗口,程序每隔2秒会打印“Hello World!”,运行情况如下所示:

ESP32-S3-AMOLED-1.91-Ar-study-06.png

示例程序

  • ESP32-S3-Touch-AMOLED-2.41 示例程序
示例程序 基础例程说明 依赖库
ADC 读取系统当前的电压值 -
I2C_PCF85063 打印RTC芯片的实时时间 -
I2C_QMI8658 打印IMU发出来的原始数据 -
LVGL LVGL例程 LVGL
SD_Card 加载显示SD卡的信息 -
WIFI_STA 设置为STA模式,可接入WiFi获取IP地址 -
WIFI_AP 设置为AP模式,可获取接入设备的IP地址 -
EX_GPIO 使用扩展IO和内部IO -
Li_ION 使能锂电池 -
Arduino_Playablity 可玩性程序例程 -

Arduino 工程参数设置

ESP32-S3-AMOLED-1.91-Ar-demo-01.png

ADC

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • adc_bsp_init(void) :初始化 ADC2,包括创建 ADC 单次触发单元并配置 ADC2 的通道 6。
  • adc_get_value(float *value,int *data) :读取 ADC2 通道 6 的值,并根据参考电压和分辨率计算出对应的电压值存储在传入的指针指向的位置,如果读取失败则存储 0
  • adc_example(void* parmeter):初始化 ADC2 后,创建一个ADC任务,该任务每隔 1 秒读取一次ADC的值,通过读取的ADC原始值计算出系统的电压。

【运行效果】


  • 程序编译下载完成,打开串口监控可以看到打印输出的ADC的值和电压,如下图所示:

ESP32-S3-AMOLED-2.41-Ar-demo-01.jpg

  • ADC采样值是1623左右,实际电压大于3.3V,是因为经过电池芯片的升压,若想具体分析,可以查看原理图

I2C_PCF85063

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • void PCF85063_example(void* parmeter) :创建一个RTC任务来实现RTC功能,每隔10秒读取一次RTC芯片的时钟,然后输出到终端。

【运行效果】


  • 打开串口监控,可以看到打印输出的RTC时间,如下图所示:

ESP32-S3-AMOLED-2.41-Ar-demo-03.jpg

  • 数据每隔 10 秒输出一次,若需修改或参考,可直接进入 pcf85063 源文件进行操作。

I2C_QMI8658

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • qmi8658c_example(void* parmeter) :该函数初始化 QMI8658 设备,在无限循环中读取并打印加速度计、陀螺仪数据和温度数据,每 1 秒执行一次,旋转板子的过程中陀螺仪数据随着旋转越快而越大,加速度计会根据当前的位置计算出对应的加速度。

【运行效果】


  • 打开串口监控,可以看到打印输出的IMU发出来的原始数据(欧拉角需要自己转换),如下图所示:

ESP32-S3-AMOLED-1.91-Ar-demo-04.png

  • 数据每隔 1 秒输出一次,若需修改或参考,可直接进入 qmi 源文件进行操作。

LVGL

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


针对 LVGL,lvgl_conf.h 是其配置文件,下面对一些常用内容进行说明。

/*Color depth: 1 (1 byte per pixel), 8 (RGB332), 16 (RGB565), 32 (ARGB8888)*/
#define LV_COLOR_DEPTH 16//Color depth, a macro definition that must be concerned with porting LVGL


#define LV_MEM_CUSTOM 0
#if LV_MEM_CUSTOM == 0
    /*Size of the memory available for `lv_mem_alloc()` in bytes (>= 2kB)*/
    #define LV_MEM_SIZE (48U * 1024U)          /*[bytes]*/

    /*Set an address for the memory pool instead of allocating it as a normal array. Can be in external SRAM too.*/
    #define LV_MEM_ADR 0     /*0: unused*/
    /*Instead of an address give a memory allocator that will be called to get a memory pool for LVGL. E.g. my_malloc*/
    #if LV_MEM_ADR == 0
        #undef LV_MEM_POOL_INCLUDE
        #undef LV_MEM_POOL_ALLOC
    #endif

#else       /*LV_MEM_CUSTOM*/
    #define LV_MEM_CUSTOM_INCLUDE <stdlib.h>   /*Header for the dynamic memory function*/
    #define LV_MEM_CUSTOM_ALLOC   malloc
    #define LV_MEM_CUSTOM_FREE    free
    #define LV_MEM_CUSTOM_REALLOC realloc
#endif     /*LV_MEM_CUSTOM*/
//The above section is mainly for LVGL memory allocation, 
//which defaults to lv_mem_alloc() versus lv_mem_free().

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

【代码修改】


  • 如果需要旋转90度显示,可以在setup()所在的源文件找到AMOLED_Rotate宏定义然后把Rotate_NONO改成Rotate_90
#define AMOLED_Rotate  Rotate_90

【运行效果】


LVGL例程对RAM和ROM要求比较高,所以必须要按照环境搭建的要求来配置程序烧录完成后,设备的运行效果如下:
ESP32-S3-AMOLED-1.91-Ar-demo-06.jpg

LVGL更多学习及使用可参考LVGL官方文档

SD_Card

【硬件连接】


  • 板子装上SD卡(必须先插入容量小于64G的SD卡),使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • 可以根据用户选择来实现SD卡的通信协议,在sd_card_bsp.cpp源文件下找到宏定义SD_Read_Mode,宏定义默认使用SDMMC通信协议,可以修改为SDSPI
#define SD_Read_Mode USER_SPI

【运行效果】


  • 点击串口监控设备,可以看到输出的SD卡的信息,practical_size是SD卡的实际容量,如下图所示:

ESP32-S3-AMOLED-1.91-Ar-demo-07.png

想了解更多关于Arduino ESP32库关于SD卡相关的使用?可访问:Arduino ESP32 库 SD 使用

WIFI_STA

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码修改】


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

【代码分析】


  • wifi_init(void) :该函数用于初始化 ESP32 的 Wi-Fi 连接。它将 ESP32 设置为 Wi-Fi 站点模式,尝试连接到指定的 Wi-Fi 网络(通过ssidpassword)。如果连接成功,打印本地 IP 地址;如果在一定时间内(20 * 500 毫秒)未能连接成功,则打印连接失败信息。同时,函数还可以设置自动连接和自动重连功能。

【运行效果】


  • 芯片处于STA模式下成功连接WIFI,并且点击串口监控设备,可以看到获取到的IP地址。

ESP32-S3-AMOLED-1.91-Ar-demo-09.png

WIFI_AP

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • 该代码在 ESP32 上初始化串口通信,然后创建一个名为 “bsp_esp_demo”、密码为 “waveshare” 的 WiFi 接入点,程序运行时无其他持续操作在循环中执行。
const char* ssid     = "bsp_esp_demo";
const char* password = "waveshare"; 

WiFi.softAP(ssid,password);

【运行效果】


  • 使用手机或其它设备连接WIFI,WiFi名称为 “bsp_esp_demo”、密码为 “waveshare”

ESP32-S3-AMOLED-1.91-Ar-demo-11.jpg


EX_GPIO

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • I2C_master_Init():初始化I2C,I2C是外部扩展IO的通信协议
  • esp32_gpio_init():初始化GPIO,把GPIO1、EXIO5设置为输出,GPIO2、EXIO6设置为输入
  • loop():这里是测试GPIO功能的逻辑,用户可以自行修改

【运行效果】


  • 需要使用两根线,把EXIO5和EXIO6连接在一起、GPIO2和GPIO1连接在一起,然后编译下载成功之后,打开串口监视器,如下图所示:

ESP32-S3-AMOLED-2.41-Ar-demo-04.jpg

  • 输出GPIO test passed.表示测试成功,输出GPIO test failed.表示失败

Li_ION

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • BAT_GPIO_Init():使用GPIO16控制锂电池的供电,负责初始化GPIO16
  • BAT_ON():使能锂电池对系统的供电
  • BAT_OFF():失能锂电池的对系统的供电

【运行效果】


  • 在软件上使能锂电池供电之后,接入锂电池,然后可以通过PWR按键实现锂电池的供电

Arduino_Playablity

  • 我们还提供一些具有可玩性的程序,供大家参考,不过需要注意一点,下面的例程均是基于ESP32_Arduino版本低于V3.0,环境搭建可以参考下面

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【运行效果】


ESP-IDF开发

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

环境搭建

下载和安装 Visual Studio

  • 打开VScode官网的下载页面,选择对应系统和系统位数进行下载
    ESP32-S3-AMOLED-1.91-VScode-01.png
  • 运行安装包后,其余均可以默认安装,但这里为了后续的体验建议,建议在此处勾选框中的1、2、3项
    ESP32-S3-AMOLED-1.91-VScode-02.png
    • 第一二项开启后,可以直接通过鼠标右键文件或者目录打开VSCode,可以提高后续的使用体验.
    • 第三项开启后,选择打开方式时,可以直接选择VSCode
环境设置是在 Windows 10 系统下进行,Linux和Mac用户可访问ESP-IDF环境搭建参考

安装Espressif IDF插件

  • 一般推荐“在线安装”, 若因网络因素无法在线安装,则使用“离线安装”。
  • 安装Espressif IDF插件教程,详见:安装Espressif IDF插件教程

运行第一个 ESP-IDF 程序

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

新建项目

ESP32-S3-AMOLED-1.91-study-01.png

ESP32-S3-AMOLED-1.91-study-02.png

创建例程

  • 使用快捷键 F1 ,输入esp-idf:show examples projects

ESP32-S3-AMOLED-1.91-study-03.png

  • 选择你当前的IDF版本

ESP32-S3-AMOLED-1.91-study-04.png

  • 以Hello world例程为例

①选择对应例程
②其readme会说明该例程适用于什么芯片(下文有介绍例程怎么使用与文件结构,这里略)
③点击创建例程
ESP32-S3-AMOLED-1.91-study-05.png

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

ESP32-S3-AMOLED-1.91-study-06.png

修改COM口

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

ESP32-S3-AMOLED-1.91-study-07.png

修改驱动对象

  • 选择我们需要驱动的对象,也就是我们的主芯片为ESP32S3

ESP32-S3-AMOLED-1.91-study-08.png

  • 选择openocd的路径,这里对我们没有影响,所以我们随便选择一个即可

ESP32-S3-AMOLED-1.91-study-09.png


其余状态栏简介

①.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,常被称作小火苗

ESP32-S3-AMOLED-1.91-study-10.png

编译、烧录、串口监视

  • 点击我们之前介绍的 编译,烧录,打开串口监视器按键

ESP32-S3-AMOLED-1.91-study-11.png

  • 编译可能需要较长时间才能完成,尤其是在第一次编译时

ESP32-S3-AMOLED-1.91-study-12.png

  • 在此过程中,ESP-IDF可能会占用大量CPU资源,因此可能会导致系统卡顿
  • 若是新工程首次烧录程序,将需要选择下载方式,选择 UART

ESP32-S3-AMOLED-1.91-study-13.png

  • 后续也可在 下载方式 处进行修改(点击即可弹出选项)

ESP32-S3-AMOLED-1.91-study-14.png

  • 因为板载自动下载电路,无需手动操作即可自动下载
  • 下载成功后,自动进入串口监视器,可以看到芯片输出对应的信息并提示10S后重启

ESP32-S3-AMOLED-1.91-study-15.png


使用IDF 示例程序

下文以使用“ESP32-S3-LCD-1.47-Demo”为例介绍工程的两种打开方式及使用的一般步骤、ESP-IDF工程项目详解,若使用其他工程,操作步骤类推。

软件内部打开

  • 打开 VScode 软件,选择文件夹打开示例

ESP32-S3-AMOLED-1.91-study-16.png

  • 选择提供的 ESP-IDF 下的示例,点击选择文件(位于 示例程序/Demo/ESP-IDF 路径下)

ESP32-S3-AMOLED-1.91-study-17.png


软件外部打开

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

ESP32-S3-AMOLED-1.91-study-18.png

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

ESP32-S3-AMOLED-1.91-study-19.png

ESP-IDF工程项目详解

  • 组件(Component):ESP-IDF中的组件是构建应用的基本模块,每个组件通常是相对独立的代码库或库,能实现特定的功能或服务,可以被应用程序或是其他组件重复使用,类似于Python开发中的库的定义。
    • 组件的引用:Python开发环境中引入库只需要“import 库名或路径”即可,而ESP-IDF基于C语言基础,引入库是通过CMakeLists.txt进行配置和定义的。
    • CmakeLists.txt的作用:ESP-IDF编译时编译工具CMake会首先通过读取工程目录的顶层CMakeLists.txt的内容来读取构建规则,识别需要编译的内容。当在CMakeLists.txt中引入了需要的组件、程序后,编译工具CMake会根据索引导入每个所需要编译的内容。编译过程如:

ESP32-P4 VSCode ESP-IDF GettingStart 240906 02.png

示例程序

  • ESP32-S3-Touch-AMOLED-2.41 示例程序
示例程序 基础例程说明 依赖库
ADC 读取系统当前的电压值 -
I2C_PCF85063 打印RTC芯片的实时时间 -
I2C_QMI8658 打印IMU发出来的原始数据 -
LVGL LVGL例程 LVGL
SD_Card 加载显示SD卡的信息 -
WIFI_STA 设置为STA模式,可接入WiFi获取IP地址 -
WIFI_AP 设置为AP模式,可获取接入设备的IP地址 -
EX_GPIO 使用扩展IO和内部IO -
Li_ION 使能锂电池 -
FactoryProgram 综合性工程 LVGL


ADC

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • adc_bsp_init(void) :初始化 ADC2,包括创建 ADC 单次触发单元并配置 ADC2 的通道 6。
  • adc_get_value(float *value,int *data) :读取 ADC2 通道 6 的值,并根据参考电压和分辨率计算出对应的电压值存储在传入的指针指向的位置,如果读取失败则存储 0
  • adc_example(void* parmeter):初始化 ADC2 后,创建一个ADC任务,该任务每隔 1 秒读取一次ADC的值,通过读取的ADC原始值计算出系统的电压。

【运行效果】


  • 程序烧录完成后,打开监控设备可以看到,输出ADC的值和电压,如下图所示:

ESP32-S3-AMOLED-2.41-Ar-demo-05.jpg

  • 可以看到ADC采样值是1623左右,实际电压大于3.3V,是因为经过电池芯片的升压,想具体分析,可以查看原理图

I2C_PCF85063

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • void PCF85063_example(void* parmeter) :创建一个RTC任务来实现RTC功能,每隔10秒读取一次RTC芯片的时钟,然后输出到终端。

【运行效果】


  • 烧录完成之后打开监控设备,可以看到打印输出的RTC时间,如下图所示:

ESP32-S3-AMOLED-2.41-Ar-demo-06.jpg

  • 数据每隔 10 秒输出一次,若需修改或参考,可直接进入 pcf85063 源文件进行操作。

I2C_QMI8658

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • qmi8658c_example(void* parmeter) :该函数初始化 QMI8658 设备,在无限循环中读取并打印加速度计、陀螺仪数据和温度数据,每 1 秒执行一次。

【运行效果】


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

  • 点击串口监控设备,可以看到IMU发出来的原始数据(欧拉角需要自己转换),如下图所示:

ESP32-S3-AMOLED-2.41-Ar-demo-07.jpg

  • 可以看到,每隔1秒输出一次,如果需要修改或者参考,可以直接进去qmi源文件修改。

LVGL

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】

  • lv_demo_widgets():通过测试LVGL的demo来验证屏幕的性能

【代码修改】


  • 如果需要旋转90度显示,可以在main()所在的源文件找到AMOLED_Rotate宏定义然后把Rotate_NONO改成Rotate_90
#define AMOLED_Rotate  Rotate_90

【运行效果】


LVGL例程对RAM和ROM要求比较高,所以必须要按照环境搭建的要求来配置程序烧录完成后,设备的运行效果如下:
ESP32-S3-AMOLED-1.91-Ar-demo-06.jpg

LVGL更多学习及使用可参考LVGL官方文档

SD_Card

【硬件连接】


  • 板子装上SD卡(必须先插入容量小于64G的SD卡),使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • 可以根据用户选择来实现SD卡的通信协议,在sd_card_bsp.c源文件下找到宏定义SD_Read_Mode,宏定义默认使用SDMMC通信协议,可以修改为SDSPI
#define SD_Read_Mode USER_SPI

【运行效果】


  • 点击串口监控设备,可以看到输出的SD卡的信息,practical_size是SD卡的实际容量,如下图所示:

ESP32-S3-AMOLED-2.41-Ar-demo-08.jpg

想了解更多关于Arduino ESP32库关于SD卡相关的使用?可访问:Arduino ESP32 库 SD 使用

WIFI_STA

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • espwifi_Init(void) :此函数用于在 ESP32 上进行 WiFi 初始化。它依次初始化非易失性存储、TCP/IP 栈、创建默认事件循环和默认 WiFi 站点网络接口,使用默认配置初始化 WiFi,注册事件处理函数以处理 WiFi 和 IP 相关事件,设置 WiFi 连接参数并启动 WiFi。

【代码修改】


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

【运行效果】


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

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

ESP32-S3-AMOLED-1.91-demo-13.png

WIFI_AP

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • wifi_init_softap(void) :该函数用于初始化 ESP32 的 Wi-Fi 软接入点,包括设置网络接口、注册事件处理函数、配置软 AP 参数并启动软 AP。

【运行效果】


  • 芯片处于AP模式下,使用手机成功连接WIFI并且串口会打印连接设备的MACA地址以及分配给该设备的IP地址。

ESP32-S3-AMOLED-1.91-demo-22.png

EX_GPIO

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • I2C_master_Init():初始化I2C,I2C是外部扩展IO的通信协议
  • esp32_gpio_init():初始化GPIO,把GPIO1、EXIO5设置为输出,GPIO2、EXIO6设置为输入
  • example_GPIO_task():创建一个独立的任务测试GPIO功能,用户可以自行修改

【运行效果】


  • 需要使用两根线,把EXIO5和EXIO6连接在一起、GPIO2和GPIO1连接在一起,然后编译下载成功之后,打开串口监视器,如下图所示:

ESP32-S3-AMOLED-2.41-Ar-demo-09.jpg

  • 输出GPIO test passed.表示测试成功,输出GPIO test failed.表示失败

Li_ION

【硬件连接】


  • 使用USB线把板子接入电脑

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【代码分析】


  • BAT_GPIO_Init():使用GPIO16控制锂电池的供电,负责初始化GPIO16
  • BAT_ON():使能锂电池对系统的供电
  • BAT_OFF():失能锂电池的对系统的供电

【运行效果】


  • 在软件上使能锂电池供电之后,接入锂电池,然后可以通过PWR按键实现锂电池的供电

FactoryProgram

【硬件连接】


  • 使用USB线把板子接入电脑(如果是V1版本需要在ui_bsp目录下CMakeLists.txt注释CMake语句target_compile_definitions,默认开启)

ESP32-S3-AMOLED-2.41-Ar-demo-02.jpg

【运行效果】


  • 通过左右滑动进行切换页面,优先每隔1.5秒显示RGB颜色,可以通过这个观察屏幕有没有问题

ESP32-S3-AMOLED-2.41-Ar-demo-22.jpg

  • 显示完RGB之后,将会自动跳转到时钟界面

ESP32-S3-AMOLED-2.41-Ar-demo-26.jpg

  • 通过左滑动界面,可以看到该页面是一些板载硬件信息

ESP32-S3-AMOLED-2.41-Ar-demo-23.jpg

  • 再次左滑界面,可以看到该界面是功能界面

ESP32-S3-AMOLED-2.41-Ar-demo-24.jpg

  • 可以点击WIFI标志,进入到WIFI测试界面,然后点击Scan按钮进行扫描周围WIFI

ESP32-S3-AMOLED-2.41-Ar-demo-25.jpg

  • 点击exit返回上一界面然后点击BLE标志,进入到BLE测试界面,再点击Scan按钮进行扫描周围BLE

ESP32-S3-AMOLED-2.41-Ar-demo-27.jpg

资料

原理图

示例程序

数据手册

ESP32-S3

其他器件

软件工具

Arduino

VScode

其他资料链接

FAQ

  • 可长按BOOT按键,同时按下RESET,然后松开RESET,再松开BOOT按键,此时模块可进入下载模式,可解决大部分无法下载的问题。


  • 优先考虑网络问题,试着切换别得网络


  • 检查Arduino IDE -> Tools有没有正确配置


  • 修改LVGL显示缓存为整个屏幕大小
  • 在配置选项里面修改LV_IMG_CACHE_DEF_SIZE改到1000可以得到一定优化


  • 基本的中文可以显示,如果是生僻字显示不了
  • 可以把需要的生僻字通过转码软件转码,然后加入到工程字库里面


  • 首次编译很慢属于正常情况,耐心等待即可


  • 若开发板有复位键则按下复位键;若没有复位键,请重新上电


  • 部分AppData文件夹是默认隐藏的,可以设置为显示。
  • 英文系统:资源管理器->View->勾选“Hidden items”
  • 中文系统:文件资源管理器->查看->显示->勾选“隐藏的项目”


  • Windows系统:

①通过设备管理器查看: 按下Windows + R键打开“运行”对话框; 输入devmgmt.msc并按回车键打开设备管理器; 展开“端口(COM和LPT)”部分,这里会列出所有的COM端口及其当前状态。
②使用命令提示符查看: 打开命令提示符(CMD); 输入mode命令,这将显示所有COM端口的状态信息。
③查看硬件连接: 如果你已经连接了外部设备到COM口,通常设备会占用一个端口号,可以通过查看连接的硬件来确定使用的是哪个端口。

  • Linux系统:

①使用dmesg命令查看: 打开终端。
②使用ls命令查看: 输入ls /dev/ttyS*或ls /dev/ttyUSB*来列出所有的串口设备。
③使用setserial命令查看: 输入setserial -g /dev/ttyS*来查看所有串口设备的配置信息。



技术支持

  • 联系人:吴工
  • 邮箱:2880803592@qq.com
  • 微信:

Img 301.png