ESP32-S3-LCD-1.47

来自Waveshare Wiki
跳转至： 导航、 搜索
ESP32-S3-LCD-1.47
{{{name2}}}
{{{name3}}}
功能简介
特性 无特性，不解释
显示尺寸 1.47 英寸
分辨率 172×320
' 无特性，不解释
' 无特性，不解释
接口 I2C SPI

板载功能使用

内部硬件连接

LCD

LCD引脚 ESP32S3
MOSI GPIO45
SCLK GPIO40
LCD_CS GPIO42
LCD_DC GPIO41
LCD_RST GPIO39
LCD_BL GPIO48

RGB 灯珠

RGB 灯珠 ESP32S3
RGB_Control GPIO38

SD Card

SD Card ESP32S3
SD_CMD GPIO15
SD_SCK GPIO14
SD_D0 GPIO16
SD_D1 GPIO18
SD_D2 GPIO17
SD_D3 GPIO21

ESP-IDF下使用

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

使用VSCode插件开发

安装VSCode

  • 打开VSCode官网的下载页面，选择对应系统和系统位数进行下载

ESP32-S3 TO Environment 0.png

  • 运行安装包后，其余均可以默认安装，但这里为了后续的体验建议，建议在此处勾选框中的1、2、3项
    • 第一二项开启后，可以直接通过鼠标右键文件或者目录打开VSCode，可以提高后续的使用体验.
    • 第三项开启后，选择打开方式时，可以直接选择VSCode
ESP32-S3 TO Environment 1.png

安装Espressif IDF插件

  • 注：当前插件最新版本为V1.6.4，为体验一致，用户可以选择与我们一样的版本
  • 打开VSCode,使用快捷键 Shift+Ctrl+X ，进入插件管理器

ESP32-S3 TO Environment 2.png

  • 在搜索栏中，输入 Espressif IDF ，选择对应的插件点击 install即可

ESP32-S3 TO Environment 3.png

ESP32-S3 TO Environment 4.png

  • 使用快捷键 F1 ，输入
esp-idf: configure esp-idf extension

ESP32-S3 TO Environment 5.png

  • 选择express（此教程针对第一次安装的用户，故只讲述初次的通用安装教程）

ESP32-S3 TO Environment 6.png

  • 选择下载服务器，我们推荐国内用户使用Espressif作为你的下载服务器

ESP32-S3 TO Environment 7.png

  • 选择想要现在的ESP-IDF版本，我们选择最新的V5.1.1

ESP32-S3 TO Environment 8.png

  • 下面两个分别为ESP-IDF容器安装地址和ESP-IDF所需的工具安装地址，

ESP32-S3 TO Environment 9.png

  • 注意：如果之前有安装过ESP-IDF，或者失败过的，请务必彻底删除文件或者创建全新的无中文路径
  • 配置完成后，点击 install 进行下载

ESP32-S3 TO Environment 10.png

  • 进入下载页面，其会自动安装对应工具与环境，稍等片刻即可

ESP32-S3 TO Environment 11.png

  • 安装完成后，会进入以下界面，说明安装完成

ESP32-S3 TO Environment 12.png

ESP 例程使用教程

创建例程

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

ESP32-S3 TO Program 1.png

  • 选择你当前的IDF版本

ESP32-S3 TO Program 2.png

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

ESP32-S3 TO Program 3.png
选择放置例程的路径，要求无例程同名文件夹
ESP32-S3 TO Program 4.png

修改COM口

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

ESP32-S3 TO Program Add 1.png

  • 选择使用的工程或者例程

ESP32-S3 TO Program 6.png

  • 然后我们的COM口就修改好了

修改驱动对象

  • 此处显示的是使用的驱动对象，点击可以修改对应驱动对象
  • 选择使用的工程或者例程

ESP32-S3 TO Program 7.png

  • 点击后需要稍等片刻

ESP32-S3 TO Program 8.png

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

ESP32-S3 TO Program 9.png

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

ESP32-S3 TO Program 10.png

其余状态栏简介

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

ESP32-S3 TO Program 11.png

编译、烧录、串口监视

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

ESP32-S3 TO Program 12.png

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

ESP32-S3 TO Program 13.png

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

ESP32-S3 TO Program 14.png

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

ESP32-S3 TO Program 15.png

  • 因为板载自动下载电路，无需手动操作即可自动下载

ESP32-S3 TO Program 16.png

  • 下载成功后，自动进入串口监视器，可以看到芯片输出对应的信息并提示10S后重启

ESP32-S3 TO Program 17.png

IDF 示例程序

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

ESP32-S3-LCD-1.47 VScode example 1.png

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

ESP32-S3-LCD-1.47 VScode example 2.png

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

ESP32-S3-LCD-1.47 VScode example 3.png

Arduino 下使用

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

搭建环境

ESP32-Arduino-3.0.2 1.png

  • 安装完成后打开 Arduino IDE

ESP32-Arduino-3.0.2 2.png

  • 进入首选项

ESP32-Arduino-3.0.2 3.png

  • 添加 JSON 链接
https://espressif.github.io/arduino-esp32/package_esp32_index.json

ESP32-Arduino-3.0.2 4.png
ESP32-Arduino-3.0.2 5.png

  • 进入开发板管理器，搜索 esp32 ，在下方的 esp32 by Espressif Systems 中选择 3.0.2 版本并点击安装（若不能正常安装可使用手机热点尝试）

ESP32-Arduino-3.0.2 7.png
ESP32-Arduino-3.0.2 8.png

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

ESP32-Arduino-3.0.2 9.png

环境搭建失败处理步骤

  • 安装 3.0.2 版本失败

ESP32-Arduino-3.0.2 Fail 1.png 

链接: https://pan.baidu.com/s/1ppl7ZU2NSTY_TfFzs1pDWA
提取码: 0755

ESP32-Arduino-3.0.2 Fail 2.png

  • 从资源管理器按路径 “c:\Users\Waveshare\AppData\Local\Arduino15\staging\packages” 进入（其中 Waveshare 为计算机用户名,需要开启显示隐藏文件）

ESP32-Arduino-3.0.2 Fail 3.png

  • 将上方下载的文件解压至 packages 文件夹下

ESP32-Arduino-3.0.2 Fail 4.png

  • 重新执行安装操作

ESP32-Arduino-3.0.2 7.png

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

ESP32-Arduino-3.0.2 9.png

方式1:直接使用Waveshare示例

修改项目文件夹路径

  • 进入首选项

ESP32-Arduino-Demo 1.png

  • 记录当前项目文件夹路径（ 记录这个路径 后面要用到！！！ 可以新建一个txt文件存放）

ESP32-Arduino-Demo 2.png

  • 将修改项目文件夹路径为 下载的 示例程序 路径（请注意，示例程序存放的路径不能包含中文）

ESP32-S3-LCD-1.47 Lib 3.png

方式2:移植到现有项目下使用

说明：项目文件夹区分的是我们安装的库文件的位置，在工程编译时会根据引用的头文件去项目文件夹路径下的 libraries 文件夹查找库文件，所以修改项目文件夹路径就是为了确定工程编译时查找库文件要去哪个位置查找，默认的项目文件夹路径为 c:\Users\Waveshare\Documents\Arduino(Waveshare 为电脑用户名)即库文件存放的是在c:\Users\Waveshare\Documents\Arduino\librarie。

恢复项目文件夹路径

  • 若有根据 方式1:直接使用Waveshare示例 操作过，则进行 恢复项目文件夹路径 ,否则忽略该小节内容
  • 进入首选项,将项目文件夹路径修改为原来的路径（在上面的修改项目文件夹路径中要求记录的原路径，这边原本是 c:\Users\Waveshare\Documents\Arduino，具体根据客户上面记录的）

ESP32-Arduino-Demo 1.png
ESP32-Arduino-Demo 2.png

安装库文件

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

ESP32-Arduino-Lib 1.png

  • 查看项目文件夹路径并进入文件夹

ESP32-Arduino-Lib Add 1.png ESP32-Arduino-Lib 2.png

  • 可以看到 libraries 文件夹（上面安装lvgl的目的就是为了生成项目文件夹下的 libraries 文件夹）

ESP32-Arduino-Lib 3.png

  • 进入 libraries 文件夹，删除刚才下载的 lvgl 库(若前面没有安装则忽略这一步)

ESP32-Arduino-Lib 4.png ESP32-Arduino-Lib 5.png

  • 打开示例程序下的 libraries 文件夹

ESP32-S3-LCD-1.47 Lib 6.png ESP32-S3-LCD-1.47 Lib 7.png

  • 将文件夹内的库文件，复制到项目文件夹下的 libraries 文件夹下

ESP32-S3-LCD-1.47 Lib 8.png ESP32-S3-LCD-1.47 Lib 9.png ESP32-S3-LCD-1.47 Lib 10.png

Arduino 示例程序

  • 打开 示例程序/Demo/Arduino 路径下的示例（双击 ino 后缀的文件即可打开）
  • 选择型号 ESP32S3 Dev Module 与端口

ESP32-S3-LCD-1.47 Demo 1.png

  • 设置板子参数

ESP32-S3-LCD-1.47 Demo 2.png

  • 编译并烧录示例

ESP32-S3-LCD-1.47 Demo 3.png

  • 烧录成功可观察到LVGL页面
  • 示例 LCD_Image 可实现以一定间隔时间依次显示SD卡下根目录的PNG文件，请注意，提供的PNG文件必须正常，不能直接修改后缀实现
  • 产品使用的ESP32在Arduino IDE上可玩性比较高，可以在已有程序框架下简单进行UI界面的修改即可实现酷炫操作，在一些开源平台上的资源也可以在小幅修改下直接使用。

擦除设备Flash

  • 解压软件资源包（Flash 调试软件）
  • 打开 flash_download_tool_3.9.5.exe软件，选择ESP32-S3及USB

ESP32-S3 TO Erase Flash 1.png

  • 选择UART的端口号，点击 START (不选择任何 bin 文件)

ESP32-S3 TO Erase Flash 2.png

  • 等待烧录完成，点击擦除

ESP32-S3 TO Erase Flash 3.png

  • 等待擦除完成

ESP32-S3 TO Erase Flash 4.png

资料

文档

原理图

ESP32-S3

LCD

程序

   示例程序


FAQ

问题：模块出现一直复位的情况，从设备管理器查看识别状况会一闪一闪的？

这种情况可能是由于 Flash 空白导致 USB 口不稳定，可长按BOOT按键，同时按下RESET，然后松开RESET，再松开BOOT按键，此时模块可进入下载模式烧录固件（程序）即可解决该情况。


问题：模块下载程序后，重新下载，有时会出现无法连接串口，或者烧录失败的情况？

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


技术支持

联系人：欧工
EMAIL：2355861365@qq.com
QQ：2355861365
微信：扫下方二维码添加
欧工企业微信联系二维码.png

说明：进行售后服务前，请准备好客户信息（定货单位、定货人等），以供验证
取自“https://www.waveshare.net/w/index.php?title=ESP32-S3-LCD-1.47&oldid=112569”