跳到主要内容

Arduino 开发

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

Arduino 入门教程​

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

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

配置开发环境​

1. 安装和配置 Arduino IDE​

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

2. 安装库​

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

LVGL 及其驱动库的版本之间存在较强的依赖关系。例如，为 LVGL v8 编写的驱动可能不兼容 LVGL v9。为确保示例能够稳定复现，推荐使用上表列出的特定版本。混合使用不同版本的库可能导致编译失败或运行时异常。

安装步骤：

  1. 下载 示例程序包。

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

    信息

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

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

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

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

板名称板安装要求版本号要求
ESP32 by Espressif Systems“离线”安装/“在线”安装≥3.0.5

示例程序​

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

01_Arduino_Uno_test​

程序说明​

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

硬件连接​

1.83inch Touch LCD ModuleArduino-Uno
VCC3.3V
GNDGND
LCD_DINGP11
LCD_CLKGP13
LCD_CSGP9
LCD_DCGP8
LCD_RSTGP7
LCD_BLGP6
TP_SDASDA
TP_SCLSCL
TP_RSTGP2
TP_INTGP3
  • 通过 GH1.25 12PIN 杜邦线将屏幕和开发板连接
  • 将开发板接入电脑

代码分析​

  • setup()：

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

  • loop()：

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

  • LCD_display_test()：

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

运行效果​

  • LCD 颜色循环测试：

  • LCD 触摸测试：

    1.83inch_Touch_LCD_Module 触摸测试