Arduino
本章节包含以下部分，请按需阅读：
Arduino 入门教程
初次接触 Arduino ESP32 开发，想要快速上手？我们为您准备了一套通用的 ESP32 入门教程。
- 第 1 节 认识 ESP32
- 第 2 节 安装和配置 Arduino IDE
- 第 3 节 Arduino 基础知识
- 第 4 节 数字输出/输入
- 第 5 节 模拟输入
- 第 6 节 脉冲宽度调制 (PWM)
- 第 7 节 串行通信 (UART)
- 第 8 节 I2C 通信
- 第 9 节 SPI 通信
- 第 10 节 Wi-Fi 基础用法
- 第 11 节 网页服务器
- 第 12 节 蓝牙 (Bluetooth)
- 第 13 节 LVGL 图形界面开发
请注意：该教程使用 ESP32-S3-Zero 作为教学示例，所有硬件代码均基于其引脚布局。在动手实践前，建议您对照手中的开发板引脚图，确认引脚配置无误。
配置开发环境
1. 安装和配置 Arduino IDE
请参考 安装和配置 Arduino IDE 教程 下载安装 Arduino IDE 并添加 ESP32 支持。
2. 安装库
可从 此链接 下载 ESP32-P4-Module-DEV-KIT 开发板的示例程序包。包内的 Arduino\libraries 目录已包含本教程所需的全部库文件。
| 库或文件名称 | 说明 | 版本 | 安装方式 |
|---|---|---|---|
| GFX_Library_for_Arduino | 适配 SH8601 的 GFX 图形化库 | v1.6.0 | 手动安装 |
| lvgl | LVGL 图形化库 | v9.3.0 | 建议手动安装 |
| displays | I2C 驱动、屏幕定义以及触摸驱动 | —— | 手动安装 |
| lv_conf.h | LVGL 配置文件 | —— | 手动安装 |
版本兼容性说明
LVGL 及其驱动库的版本之间存在较强的依赖关系。例如，为 LVGL v8 编写的驱动可能不兼容 LVGL v9。为确保示例能够稳定复现，推荐使用上表列出的特定版本。混合使用不同版本的库可能导致编译失败或运行时异常。
安装步骤：
-
解压已下载的 示例程序包。
-
将其
Arduino\libraries目录下的所有文件夹复制到 Arduino 的库文件夹中。信息Arduino 库文件夹的路径通常是：
c:\Users\<用户名>\Documents\Arduino\libraries。也可以在 Arduino IDE 中通过 文件 > 首选项，查看“项目文件夹位置”来定位。库文件夹就是此路径下的
libraries文件夹。 -
其他安装方式请参考：Arduino 库管理教程。
示例程序
Arduino 示例程序位于 示例程序包 的 Arduino/examples 目录中。
| 示例程序 | 基础例程说明 | 依赖库 |
|---|---|---|
| HelloWorld | 展示了基本的图形库功能，也可以用于测试显示屏的基础性能以及随机文本显示效果 | GFX_Library_for_Arduino , displays |
| Drawing_board | 触摸画点测试 | GFX_Library_for_Arduino，displays |
| AsciiTable | 根据屏幕尺寸，在显示屏上按行列打印 ASCII 字符 | GFX_Library_for_Arduino , displays |
| GFX_ESPWiFiAnalyzer | 在屏幕上绘制 WiFi 频段信号强度 | GFX_Library_for_Arduino , displays |
| LVGLV9_Arduino | LVGL 演示 | LVGL，GFX_Library_for_Arduino , displays |