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. 安装 ESP32 开发板
- ESP32 相关主板在 Arduino IDE 使用,须先安装“esp32 by Espressif Systems”库。
- 根据板安装要求进行安装,一般推荐“在线安装”, 若在线安装失败,则使用“离线安装”。
- 安装教程,详见:Arduino 板管理教程
- esp32 by Espressif Systems 开发板离线软件包,点击此处下载:esp32_package_3.0.2_arduino 离线包
信息
对于 ESP32-C6-LCD-1.47 开发板,需要使用 esp32 by Espressif Systems V3.0.0 以上版本。
3. 安装库
-
在安装 Arduino 库时,通常有两种方式可供选择:在线安装 和 离线安装。若库安装要求离线安装,则必须使用提供的库文件。
-
对于大多数库,用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而,一些开源库或自定义库未被同步到 Arduino 库管理器中,因此无法通过在线搜索获取。在这种情况下,用户只能通过离线方式手动安装这些库。
-
库安装教程,详见:Arduino 库管理教程
库或文件名称 说明 版本 安装方式 LVGL 图形库 v8.3.10 "离线"安装 PNGdec 解码 PNG 图像格式 v1.0.2 "离线"安装
版本兼容性说明
LVGL 及其驱动库的版本之间存在较强的依赖关系。例如,为 LVGL v8 编写的驱动可能不兼容 LVGL v9。为确保示例能够稳定复现,推荐使用上表列出的特定版本。混合使用不同版本的库可能导致编译失败或运行时异常。
示例程序
Arduino 工程参数设置

LVGL_Arduino
程序说明
- 本示例演示了板载各个设备的功能,LCD 页面显示 SD Card,Flash Size,Wireless scan 参数
硬件连接
-
将开发板接入电脑
-
将 SD 卡装入开发板

代码分析
- setup
Flash_test():测试并打印设备的闪存大小信息LCD_Init():初始化显示屏Lvgl_Init():初始化 LVGL 图形库SD_Init():初始化 SD 卡Lvgl_Example1():调用特定的 LVGL 示例函数Wireless_Test2():进行无线通信的测试函数调用
- loop
Timer_Loop():处理定时器相关任务的函数
运行效果
LCD_Image
SD 卡准备
-
将 waveshare 所提供的图片示例加入到 SD 卡中,也可加入自己的图片(像素≤172×320)


硬件连接
-
将包含示例图片的 SD 卡装入到设备中
-
将开发板接入电脑

代码分析
void Display_Image(const char* directory, const char* fileExtension, uint16_t ID)- 首先,调用
Search_Image(directory, fileExtension)在给定目录中搜索具有指定扩展名的图像文件,并统计找到的图像数量存于全局变量Image_CNT中 - 若 Image_CNT 不为零,即找到了图像。根据目录是否为根目录构建图像文件的完整路径,将其转换为 C 风格字符串后打印用于调试,最后调用
Show_Image函数显示图像 - 若未找到图像(
Image_CNT为零),打印错误消息指出在给定目录中未找到具有指定扩展名的文件
- 首先,调用
运行效果
