产品参数​

机械轴体​

液晶接口说明​

SPI 控制接口说明​

按键尺寸​

按键模组尺寸​

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

• 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_WoodenFish​

程序说明​

• 本示例演示了如何基于 ESP32-S3 开发板驱动 0.85inch ScreenKey Module ，既实现了颜色循环测试与按键功能测试，又预留了基于 LVGL 图形库的图片显示能力，支持通过单击、多击、长按动作完成敲木鱼动态效果。

硬件连接​

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

代码分析​

• app_main()：
  • 完成显示屏、按键与 LVGL 图形库的初始化，实现颜色循环测试与敲木鱼动态效果验证，为后续图形交互应用奠定运行基础。

运行效果​

• LCD 颜色循环测试：

  
  

• LVGL 敲木鱼效果：

  
  

02_phototest​

程序说明​

• 本示例演示了如何基于 ESP32-S3 开发板驱动 0.85inch ScreenKey Module ，实现了按键按下切换图片的功能

硬件连接​

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

代码分析​

• app_main()：

  • 完成显示屏、按键与 LVGL 图形库的初始化，实现通过按键切换图片的功能。

运行效果​

• LCD 颜色循环测试：

  
  

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

• 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 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。

安装步骤：

1. 下载 示例程序包。

   信息

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

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

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

0.85inch ScreenKey Module 所需开发板安装说明

硬件连接​

示例程序​

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

01_Arduino_Uno_test​

程序说明​

• 本示例实现上电自动屏幕自检，通过按键可循环切换 7 种显示效果（纯色、图片、中英文、图形绘制），完成 LCD 显示与按键交互功能演示：

硬件连接​

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

代码分析​

• setup()：

  • 完成硬件、LCD、画布初始化，执行开机显示自检，初始化按键。

• loop()：

  • 系统主循环，持续调用按键检测函数。

• CheckKeyPress()：

  • 按键消抖检测，按按键次数循环切换 7 种 LCD 显示界面。

运行效果​

• 上电自动屏幕自检，通过按键可循环切换 7 种显示效果（纯色、图片、中英文、图形绘制），完成 LCD 显示与按键交互功能演示：

1. 硬件资料​

• 原理图
• 液晶手册

2. 示例程序​

• 0.85inch ScreenKey Module Gitee 示例程序仓库
• 0.85inch ScreenKey Module Github 示例程序仓库

3. 软件​

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

4. 其他资料链接​

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