产品参数​

接口说明​

产品尺寸​

本章节包含以下部分，请按需阅读：

• ESP-IDF 入门教程
• 配置 ESP-IDF 开发环境
• 示例程序

ESP-IDF 入门教程​

初次接触 ESP32 ESP-IDF 开发，想要快速上手？我们为您准备了一套通用的 入门教程。

• 第0节 认识 ESP32
• 第1节 搭建环境
• 第2节 运行实例
• 第3节 创建项目
• 第4节 使用组件
• 第5节 调试程序
• 第6节 FreeRTOS
• 第7节 驱动外设
• 第8节 Wi-Fi 编程
• 第9节 BLE 编程

请注意：该教程使用 ESP32-S3-Zero 作为教学示例，所有硬件代码均基于其引脚布局。在动手实践前，建议您对照手中的开发板引脚图，确认引脚配置无误。

配置 ESP-IDF 开发环境​

安装 ESP-IDF 开发环境​

1. 前往 ESP-IDF Installation Manager 下载 ESP-IDF 安装管理器。这是乐鑫最新推出的跨平台安装工具，下文将演示如何使用其离线安装功能。

   在页面中点击 Offline Installer 标签，然后在筛选栏中选择 Windows 操作系统和你需要的 ESP-IDF 版本（图示仅为参考，请以实际为准）。

   
   

   确认选择无误后，点击下载按钮。浏览器将自动同时下载两个文件：一个是 ESP-IDF 离线整合包(.zst)，另一个是 ESP-IDF 安装器(.exe)。

   
   

   请耐心等待两个文件下载完成。

2. 下载完成后，双击运行 ESP-IDF 安装器(eim-gui-windows-x64.exe)。

   启动后，可在右上角将界面语言切换为中文。

   
   

   安装工具会自动检测同一目录下是否存在离线整合包。点击 从存档安装。

   
   

   接下来，选择安装路径。建议使用默认路径；若需自定义，请确保路径中不包含中文或空格。确认无误后，点击 开始安装。

   
   

3. 当看到如下界面时，表示 ESP-IDF 已安装成功。

   
   

4. 建议同时安装驱动程序。点击 完成安装，然后点击 安装驱动程序。

   
   

安装 Visual Studio Code 与 ESP-IDF 扩展​

1. 下载并安装 Visual Studio Code。

2. 安装时建议勾选 通过 Code 打开操作添加到 Windows 资源管理器文件上下文菜单,以便快速打开项目文件夹。

3. 在 VS Code 中,点击侧边活动栏中的  扩展图标(或使用快捷键 Ctrl + Shift + X)打开 扩展 视图。

4. 在搜索框中输入 ESP-IDF,找到 ESP-IDF 扩展并点击安装。

   
   

5. 当 ESP-IDF 扩展版本 ≥ 2.0 时,扩展会自动检测并识别上述步骤中安装的 ESP-IDF 环境,无需手动配置。

示例程序​

01_ESP32S3_test​

程序说明​

• 本示例演示了如何基于 ESP32-S3 开发板驱动 1.54inch Touch LCD Module 触控液晶模组，既实现了颜色循环测试与触摸功能测试，又预留了基于 LVGL 图形库的图片显示能力，支持通过左滑、右滑手势完成图片切换操作。

硬件连接​

• 通过 GH1.25 12PIN 杜邦线将屏幕和开发板连接
• 将开发板接入电脑

代码分析​

• image_slider_init()：

  • 基于 LVGL v9.3.0 图形库实现左滑、右滑手势识别及图片切换，为用户提供流畅的图片浏览体验。

• app_main()：

  • 完成显示屏、触摸屏与 LVGL 图形库的初始化，实现颜色循环测试与触摸基础功能验证，为后续图形交互应用奠定运行基础。

运行效果​

• LCD 颜色循环测试：

  
  

• LCD 触摸测试：

  
  

• LVGL 图片切换测试：

  
  

本章节包含以下部分，请按需阅读：

• Arduino 入门教程
• 配置开发环境
• 示例程序

Arduino 入门教程​

初次接触 Arduino ESP32 开发，想要快速上手？我们为您准备了一套通用的 入门教程。

• 第0节 认识 ESP32
• 第1节 安装和配置 Arduino IDE
• 第2节 Arduino 基础知识
• 第3节 数字输出/输入
• 第4节 模拟输入
• 第5节 脉冲宽度调制 (PWM)
• 第6节 串行通信 (UART)
• 第7节 I2C 通信
• 第8节 SPI 通信
• 第9节 Wi-Fi 基础用法
• 第10节 网页服务器
• 第11节 蓝牙 (Bluetooth)
• 第12节 LVGL 图形界面开发
• 第13节 综合项目

请注意：该教程使用 ESP32-S3-Zero 作为教学示例，所有硬件代码均基于其引脚布局。在动手实践前，建议您对照手中的开发板引脚图，确认引脚配置无误。

配置开发环境​

1. 安装和配置 Arduino IDE​

请参考 安装和配置 Arduino IDE 教程 下载安装 Arduino IDE 并添加 ESP32 支持。

2. 安装库​

• 在安装 Arduino 库时，通常有两种方式可供选择：在线安装 和 离线安装。若库安装要求离线安装，则必须使用提供的库文件。
• 对于大多数库，用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而，一些开源库或自定义库未被同步到 Arduino 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。
• 可从 此链接 的 Arduino 目录中，下载 1.54inch Touch LCD Module 开发板的示例程序包。包内的 Arduino-uno\libraries 目录已包含本教程所需的全部库文件。

安装步骤：

1. 下载 示例程序包。

2. 将其 Arduino-uno\libraries 目录下的所有文件夹（GFX_Library_for_Arduino）复制到 Arduino 的库文件夹中。

   信息

   Arduino 库文件夹的路径通常是：c:\Users\<用户名>\Documents\Arduino\libraries。

   也可以在 Arduino IDE 中通过 文件 > 首选项，查看“项目文件夹位置”来定位。库文件夹就是此路径下的 libraries 文件夹。

3. 其他安装方式请参考：Arduino 库管理教程。

1.54inch Touch LCD Module 所需开发板安装说明

示例程序​

Arduino_Uno_test 示例程序位于 示例程序包 的 Arduino-uno 目录中。

01_Arduino_Uno_test​

程序说明​

• 本示例基于 GFX_Library_for_Arduino 驱动 ST7789 屏幕，实现文字显示、颜色循环测试及触摸测试功能。

硬件连接​

• 通过 GH1.25 12PIN 杜邦线将屏幕和开发板连接
• 将开发板接入电脑

代码分析​

• setup()：

  • 初始化串口、ST7789 显示屏（含背光）与 CST816D 触摸芯片；执行文字显示、颜色循环测试，验证显示基础功能。

• loop()：

  • 循环读取触摸坐标，串口打印并在触摸位置绘制红点，实现触摸可视化反馈（10ms 间隔保证实时性）。

• LCD_display_test()：

  • 屏幕依次填充红 / 绿 / 蓝 / 白四色（各 1 秒），验证显示屏色彩与全屏刷新功能。

运行效果​

• LCD 触摸测试：

1. 硬件资料​

• 1.54inch Touch LCD Module 原理图

2. 示例程序​

• 1.54inch Touch LCD Module Gitee 示例程序仓库
• 1.54inch Touch LCD Module Github 示例程序仓库

3. 软件​

• 汉字取模软件
• mage2Lcd 图片取模软件
• Flash_download_tool

4. 其他资料链接​

• LVGL 在线图片转换工具
• LVGL 在线字体转换工具
• ESP32 Arduino Core’s documentation
• arduino-esp32
• ESP-IDF

技术支持

周一-周五（9:30-6:30）周六（9:30-5:30）

手机：13434470212

邮箱：services04@spotpear.cn

QQ：202004841