板载资源​

引脚分布​

产品尺寸​

为了让用户能够快速了解产品的各个功能，我们提供了一系列的测试例程，方便客户了解各个接口的使用。除了 ESP32-S3-LCD-Driver-Board 主机和配套的线材之外，为了能够运行例程，需要准备的器件如下：

注意事项​

• GH1.25 锂电池座子只支持 单节 3.7 V 锂电池，勿使用多组电池包同时接入充放电，建议单节容量在 2000 mAh 以下。

⚠️ USB 下载注意事项（重要）​

板级包配置屏幕方法​

1. menuconfig 配置方法​

1. 参考 ESP-IDF 环境搭建教程 完成开发环境的配置。

   提示

   设置目标设备时，ESP-IDF 会自动配置相应的工具链和库，此过程可能需要一些时间，请耐心等待。更多详情请参阅 官方文档。

2. 点击  打开 ESP-IDF 终端，执行 idf.py menuconfig 命令进入配置界面，输入 / , 全局搜索 LCD screen type:

   

3. 选择 LCD screen type 进行屏幕类型选择：

   

4. 按 S 键保存配置并退出，然后点击 

2. SDK 配置方法​

1. 参考 ESP-IDF 环境搭建教程 完成开发环境的配置。

   提示

   设置目标设备时，ESP-IDF 会自动配置相应的工具链和库，此过程可能需要一些时间，请耐心等待。更多详情请参阅 官方文档。

2. 打开 SDK 终端 :

   

3. 全局搜索 LCD screen type , 在 Board Support Package 选择对应屏幕类型，点击保存后退出配置界面：

   

4. 最后点击 

固件下载​

示例程序位于 示例程序包 的 Firmware 目录中。

示例介绍​

• 固件使用 brookesia 组件，展示 APP 风格的各种应用程序，包含squareline、相册、绘画 等 APP

1.83inch Touch LCD Module APP示例展示​

3.5inch Capacitive Touch LCD APP示例展示​

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

• 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 离线整合包(.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 环境,无需手动配置。

示例程序​

ESP-IDF 示例程序位于 示例程序包 的 ESP-IDF 目录中。

01_easytest​

程序说明​

• 本示例演示简单显示颜色条测试

硬件连接​

• 将开发板接入电脑

代码分析​

运行效果​

02_lvgl_demo_v9​

程序说明​

• 本示例演示LVGL V9.3.0示例

硬件连接​

• 将开发板接入电脑

代码分析​

运行效果​

03_esp_bookesia​

程序说明​

• 本示例展示brookesia APP 例程

硬件连接​

• 将开发板接入电脑

代码分析​

运行效果​

1. 硬件资料​

开发板设计文件

• ESP32-S3-LCD-Driver-Board 原理图

2. 技术手册​

• ESP32-S3 芯片官方手册

  • 技术规格书：中文版 | 英文版
  • 技术参考手册：中文版 | 英文版

• 数据手册

  • ST7789V2 数据手册
  • ST7789T3 数据手册
  • ST7796S datasheet（英文）
  • CST816T 数据手册
  • CST816T 寄存器说明
  • FT6336U datasheet（英文）
  • CST328 数据手册

3. 示例程序​

• ESP32-S3-LCD-Driver-Board 示例程序（Gitee 仓库）

4. 软件​

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

5. 其他资料链接​

• 乐鑫组件库
• LVGL 在线图片转换工具
• LVGL 在线字体转换工具
• ESP-IDF

技术支持

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

手机：13434470212

邮箱：services04@spotpear.cn

QQ：202004841