Arduino 开发
本章节介绍 ESP32-C5-MINI-KIT 的 Arduino 开发环境，以及 examples/Arduino/examples 中提供的示例程序。
配置开发环境
1. 安装 Arduino IDE 和 ESP32 开发板支持包
请参考 安装和配置 Arduino IDE 教程 下载安装 Arduino IDE 并添加 ESP32 支持。
安装 Arduino IDE 后，在“首选项 -> 附加开发板管理器网址”中添加 Espressif Arduino-ESP32 的开发板索引，并在“开发板管理器”安装支持 ESP32-C5 的 Arduino-ESP32 版本。安装完成后，在“工具 -> 开发板”中选择 ESP32C5 Dev Module。
使用 USB 连接开发板，在“工具 -> 端口”中选择对应串口。除特别说明外，本目录的示例均使用串口监视器，波特率设为 115200。
ESP32-C5 的 Arduino 支持依赖开发板包版本。若 IDE 中没有 ESP32-C5 开发板选项，请先升级 Espressif 的 Arduino-ESP32 开发板包，再编译示例。
2. 打开示例
每个示例目录中均有一个与目录同名的 .ino 主文件。使用 Arduino IDE 打开该 .ino 文件后即可编译、下载。
安装库
00_Board_Info、01_WS2812_RGB、02_WiFi_DualBand、03_UART_Loopback 仅依赖 Arduino-ESP32 开发板包自带的组件。
04_1.83inch_Touch_LCD_LVGL_GFX 需要下列图形库。本工程已在 examples/Arduino/libraries 中提供匹配版本，建议直接使用该目录中的库，避免 API 版本不一致。
| 库 | 版本 | 用途 | 安装方式 |
|---|---|---|---|
lvgl | 8.4.0 | 图形界面和触摸输入 | 将 libraries/lvgl 安装为 Arduino 库 |
GFX Library for Arduino | 1.6.5 | ST7789 显示屏驱动 | 将 libraries/GFX_Library_for_Arduino 安装为 Arduino 库 |
可在 Arduino IDE 中通过“项目 -> 加载库 -> 添加 .ZIP 库”安装库压缩包，或将上述两个目录复制到 Arduino Sketchbook 的 libraries 目录后重启 IDE。
触摸屏示例基于 LVGL 8.4.0 的显示和输入设备 API 编写，不能直接改用 LVGL 9。请同时使用工程内的 LVGL 8.4.0 和 Arduino_GFX 1.6.5。
示例程序
示例程序位于本目录。带有外部接口的示例需要连接相应设备或总线后再运行。
| 示例程序 | 说明 |
|---|---|
| 00_Board_Info | 通过串口输出 ESP32-C5 芯片、Flash、程序和内存信息。 |
| 01_WS2812_RGB | 控制板载 WS2812 RGB LED 依次显示红、绿、蓝、白和熄灭。 |
| 02_WiFi_DualBand | 扫描 Wi-Fi 网络，显示信道和频段，并可连接指定网络。 |
| 03_UART_Loopback | 使用 UART1 发送和接收数据，验证串口回环。 |
| 04_1.83inch_Touch_LCD_LVGL_GFX | 驱动板载 1.83 英寸触摸屏，完成颜色自检和触摸绘制。 |
00_Board_Info
程序在启动后打印芯片型号、芯片修订版本、CPU 频率、Flash 容量、已编译程序大小、剩余堆内存和基础 MAC 地址，随后保持运行。该示例无需额外硬件，是验证开发板连接、下载和串口配置的首选示例。
01_WS2812_RGB
板载 WS2812 RGB LED 的数据引脚为 GPIO27。程序通过 Arduino-ESP32 的 rgbLedWriteOrdered() 接口，将亮度设为 32，并每秒切换一次红、绿、蓝、白和熄灭状态；串口同步输出当前 RGB 值。
此示例不依赖第三方库。若 LED 颜色与预期不一致，可检查 COLOR_ORDER 是否需要与实际 LED 的颜色顺序匹配。
02_WiFi_DualBand
该示例将芯片设置为 STA 模式，扫描可用网络，并在串口中列出 RSSI、信道、安全状态和频段：信道 1 至 14 标记为 2.4 GHz，其他信道标记为 5 GHz。
如需测试联网，请先修改源码顶部的配置：
static const char *WIFI_SSID = "MySID";
static const char *WIFI_PASSWORD = "MyPassWord";
上传后，程序最多等待 20 秒连接指定 Wi-Fi，并打印 IP 地址、RSSI、信道和频段；连接断开时会重新扫描网络。
03_UART_Loopback
此示例使用 UART1 进行自回环测试，实际初始化配置如下：
| 信号 | GPIO | 参数 |
|---|---|---|
| UART1 TX | GPIO0 | 115200、8N1 |
| UART1 RX | GPIO1 | 115200、8N1 |
用导线将 GPIO0 与 GPIO1 相连后上传程序。程序每两秒通过 TX 发送一条递增计数消息，并在 RX 收到同一消息时打印 [RX Receive]。
04_1.83inch_Touch_LCD_LVGL_GFX
该示例使用 Arduino_GFX 驱动 240 x 284 的 1.83 英寸触摸 LCD，使用 LVGL 8.4.0 建立显示和触摸输入设备。触摸控制器为 CST816，显示控制器为ST7789。
| 功能 | 信号 | GPIO / 地址 |
|---|---|---|
| LCD 软件 SPI | SCLK / MOSI / CS / DC / RST / BL | 7 / 8 / 9 / 10 / 15 / 25 |
| 触摸 I2C | SDA / SCL | GPIO23 / GPIO24 |
| 触摸控制 | RST / INT | GPIO26 / GPIO5 |
| CST816 地址 | I2C | 0x15 |
启动时程序会闪烁背光、扫描 I2C 总线、依次显示红黄蓝绿白五种纯色，再初始化 LVGL。进入主界面后，可在白色画布上触摸绘制黑点。编译前应按 安装库中的版本安装 LVGL 和 Arduino_GFX。
常见问题
找不到 ESP32-C5 开发板
更新 Arduino-ESP32 开发板包，确认已选择支持 ESP32-C5 的版本；旧版开发板包不会显示 ESP32-C5 选项。
触摸屏示例无法编译
确认安装的是项目内 lvgl 8.4.0 和 GFX Library for Arduino 1.6.5，且没有被 Arduino Sketchbook 中的同名其他版本覆盖。
Wi-Fi 示例无法连接
确认已将 WIFI_SSID 和 WIFI_PASSWORD 修改为实际网络凭据，并确认网络允许 ESP32-C5 使用的频段。串口中的扫描结果可用于确认目标网络是否可见。