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
对于 ESP32-S3-Touch-AMOLED-1.43C 开发板，Arduino IDE 需要安装 arduino-esp32 v3.3.0 以上版本。
请参考 安装和配置 Arduino IDE 教程 下载安装 Arduino IDE 并添加 ESP32 支持。
2. 安装库
- 在安装 Arduino 库时，通常有两种方式可供选择：在线安装 和 离线安装。若库安装要求离线安装，则必须使用提供的库文件。
- 对于大多数库，用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而，一些开源库或自定义库未被同步到 Arduino 库管理器中，因此无法通过在线搜索获取。在这种情况下，用户只能通过离线方式手动安装这些库。
- 可从 该处 下载 ESP32-S3-Touch-AMOLED-1.43C 开发板的示例程序包。包内的 Arduino\libraries 目录已包含本教程所需的全部库文件。
| 库或文件名称 | 说明 | 版本 | 安装方式 |
|---|---|---|---|
| LVGL | 图形库 | v8.3.11/v9.5.0 | "离线安装" |
LVGL 及其驱动库的版本之间存在较强的依赖关系。例如，为 LVGL v8 编写的驱动可能不兼容 LVGL v9。为确保示例能够稳定复现，推荐使用上表列出的特定版本。混合使用不同版本的库可能导致编译失败或运行时异常。
3. Arduino 工程参数设置
示例程序
Arduino 示例程序位于 示例程序包 的 Arduino/examples 目录中。
| 示例程序 | 基础例程说明 | 依赖库 |
|---|---|---|
| 01_ADC_Test | 获取锂电池的电压值 | - |
| 02_WIFI_AP | 设置为 AP 模式，可获取接入设备的 IP 地址 | - |
| 03_WIFI_STA | 设置为 STA 模式，可接入 WiFi 获取 IP 地址 | - |
| 04_Audio_Test | 扬声器播放麦克风录到的声音 | LVGL V9.5.0 |
| 05_LVGL_V8_Test | LVGLV8 例程 | LVGL V8.3.11 |
| 06_LVGL_V9_Test | LVGLV9 例程 | LVGL V9.5.0 |
| 07_FactoryProgram | 综合示例 | LVGL V9.5.0 |
01_ADC_Test
【程序说明】
- 通过 GPIO 连接的模拟量电压经过 ADC 转换成数字量，然后通过计算得到实际的锂电池电压，并打印到终端。
【硬件连接】
- 使用 USB 线把板子接入电脑
【代码分析】
printf("adc-example run\n"); //终端输出信息
bsp_batt_init(); //初始化 adc 通道
bsp_batt_get_voltage(); //获取电池电压
bsp_batt_get_status(); //获取电池充电状态
【运行效果】
-
程序编译下载完成，打开串口监控可以看到打印输出锂电池的电压以及充电信息，如下图所示：
02_WIFI_AP
【程序说明】
- 该示例可将开发板设置为热点，允许手机或其他处于 STA 模式的设备连接到开发板。
【硬件连接】
- 使用 USB 线把板子接入电脑
【代码分析】
-
在
02_WIFI_AP.ino文件找到ssid和password，然后手机或其他处于 STA 模式的设备即可使用该 ssid 和 password 连接到开发板。const char *ssid = "ESP32_AP";const char *password = "12345678";
【运行效果】
-
烧录完程序，打开串口终端，如果设备连接热点成功之后，会输出该设备的 MAC 地址，如图：
03_WIFI_STA
【程序说明】
- 该示例可将开发板配置为 STA 设备，以连接路由器，从而接入系统网络。
【硬件连接】
- 使用 USB 线把板子接入电脑
【代码分析】
-
在
03_WIFI_STA.ino文件找到ssid和password，然后将其修改为当前环境中可用路由器的 SSID 和 Password。const char *ssid = "you_ssid";const char *password = "you_password";
【运行效果】
-
烧录完程序，打开串口终端，如果设备连接成功热点之后，会输出所获取的 IP 地址，如图：
04_Audio_Test
【程序说明】
- 演示如何获取麦克风数据，播放音乐等功能。
【硬件连接】
- 使用 USB 线把板子接入电脑
【代码分析】
bsp_broolesia_display_init(); //屏幕初始化
speaker = bsp_audio_codec_speaker_init(); //获取播放句柄
microphone = bsp_audio_codec_microphone_init();//获取录音句柄
boot_button_ = new Button(BUTTON_0_GPIO_PIN);//实例化按键
InitializeButtons();//按键回调初始化
ESP_ERROR_CHECK(esp_codec_dev_open(speaker, &fs));//打开播放
ESP_ERROR_CHECK(esp_codec_dev_open(microphone, &fs)); //打开录音
ESP_ERROR_CHECK(esp_codec_dev_set_out_vol(speaker, 100));//设置播放声音大小
ESP_ERROR_CHECK(esp_codec_dev_set_in_gain(microphone,35));//设置录音增益大小
【运行效果】
-
程序烧录完成后，屏幕显示如图：
提示- 单击 BOOT 按键，可以录音 3 秒，录音结束之后自动播放录音
- 双击 BOOT 按键，可以播放一段音乐，长按 BOOT 按键可打断播放
05_LVGL_V8_Test
【程序说明】
- 通过移植 LVGL V8，在屏幕上实现一些多功能的 GUI 界面。
【硬件连接】
- 使用 USB 线把板子接入电脑
【代码分析】
#define BACKLIGHT_EN 1 //宏定义,使能开启背光测试,默认打开
bsp_broolesia_display_init();//初始化屏幕以及LVGL
if(bsp_display_lock(-1) == ESP_OK) { //等待锁
lv_demo_widgets(); //LVGL 默认 UI
bsp_display_unlock(); //释放锁
}
【运行效果】
-
程序烧录完成后，设备的运行效果如下：
06_LVGL_V9_Test
【程序说明】
- 通过移植 LVGL V9，在屏幕上实现一些多功能的 GUI 界面。
【硬件连接】
- 使用 USB 线把板子接入电脑
【代码分析】
#define BACKLIGHT_EN 1 //宏定义,使能开启背光测试,默认打开
bsp_broolesia_display_init();//初始化屏幕以及LVGL
if(bsp_display_lock(-1) == ESP_OK) { //等待锁
lv_demo_widgets(); //LVGL 默认 UI
bsp_display_unlock(); //释放锁
}
【运行效果】
-
程序烧录完成后，设备的运行效果如下：
