跳到主要内容

Arduino 开发

本章节包含以下部分,请按需阅读:

Arduino 入门教程​

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

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

配置开发环境​

1. 安装和配置 Arduino IDE​

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

2. 安装库​

  • 在安装 Arduino 库时,通常有两种方式可供选择:在线安装 和 离线安装。若库安装要求离线安装,则必须使用提供的库文件。
  • 对于大多数库,用户可以通过 Arduino 软件的在线库管理器轻松搜索并安装。然而,一些开源库或自定义库未被同步到 Arduino 库管理器中,因此无法通过在线搜索获取。在这种情况下,用户只能通过离线方式手动安装这些库。
  • 下载 ESP32-S3-Touch-AMOLED-1.75C 源码压缩包(GitHub)。包内的 examples/arduino/libraries 目录已包含本教程所需的全部库文件。国内下载来源参见 相关资料中的示例程序。
库或文件名称说明版本安装方式
GFX Library for Arduino包含 CO5300 显示驱动的图形库v1.6.4通过库管理器或手动安装
SensorLibCST9217 触摸控制器和 QMI8658 运动传感器驱动库v0.3.3通过库管理器或手动安装
XPowersLibAXP2101 驱动库v0.2.6通过库管理器或手动安装
lvgllvgl 显示显示框架v8.4.0通过库管理器或手动安装
board_config开发板引脚宏定义——手动安装
lv_conf.hLVGL 配置文件——手动安装
版本兼容性说明

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

安装步骤:

  1. 下载 ESP32-S3-Touch-AMOLED-1.75C 源码压缩包(GitHub)。

  2. 将 examples/arduino/libraries 目录下的所有文件夹(GFX_Library_for_Arduino、SensorLib、XPowersLib、lvgl 和 board_config)复制到 Arduino 的库文件夹中。将随附的 lv_conf.h 复制到同一目录,与 lvgl 文件夹并列。

    信息

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

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

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

3. Arduino 工程参数设置​

ESP32-S3-Touch-AMOLED-1.75C Arduino IDE 工程参数配置

示例程序​

Arduino 示例程序位于 ESP32-S3-Touch-AMOLED-1.75C 示例目录(GitHub) 的 examples/arduino/examples 目录中。

工程文件夹命名

Arduino 要求工程文件夹名称与主 .ino 文件名一致。例如,02_GFX_AsciiTable 文件夹内的主文件为 03_GFX_AsciiTable.ino。复制整个示例文件夹,将副本重命名为主 .ino 文件名(不含扩展名),并保留所有配套源码和头文件。

示例程序基础例程说明依赖库
01_HelloWorld展示了基本的图形库功能,也可以用于测试显示屏的基础性能以及随机文本显示效果GFX_Library_for_Arduino
02_GFX_AsciiTable根据屏幕尺寸,在显示屏上按行列打印 ASCII 字符GFX_Library_for_Arduino
03_LVGL_AXP2101_ADC_Data通过移植后的 XPowersLib 驱动 AXP2101 获取电源相关数据GFX_Library_for_Arduino、LVGL、XPowersLib
04_LVGL_QMI8658_uiLVGL 绘制加速度折线图GFX_Library_for_Arduino、LVGL、SensorLib
05_LVGL_WidgetsLVGL 演示GFX_Library_for_Arduino、LVGL、SensorLib
06_ES7210ES7210 驱动示例,拾取人声检测——
07_ES8311ES8311 驱动示例,播放简单的音频——

01_HelloWorld​

程序说明​

  • 本示例使用 Arduino GFX,在采用 CO5300 驱动的屏幕上以随机位置、字号和颜色显示文本。

硬件连接​

  • 将开发板接入电脑

代码分析​

  • 显示初始化:

    if (!gfx->begin()) {
    Serial.println("gfx->begin() failed!");
    }
  • 清屏并显示文本:

    gfx->fillScreen(RGB565_BLACK);
    gfx->setCursor(10, 10);
    gfx->setTextColor(RGB565_RED);
    gfx->println("Hello World!");
  • 动图显示:

    gfx->setCursor(random(gfx->width()), random(gfx->height()));
    gfx->setTextColor(random(0xffff), random(0xffff));
    gfx->setTextSize(random(6), random(6), random(2));
    gfx->println("Hello World!");

运行效果​

02_GFX_AsciiTable​

程序说明​

  • 本示例使用 Arduino GFX 初始化 CO5300 显示屏,并根据屏幕尺寸按行列打印 ASCII 字符。

硬件连接​

  • 将开发板接入电脑

代码分析​

  • 数据总线和图形显示对象的创建

    • 这里创建了一个用于与显示屏通信的数据总线对象 bus,使用特定的引脚配置进行初始化。然后创建了一个图形显示对象 gfx,传入数据总线、复位引脚、旋转角度、显示屏的宽度、高度和面板偏移量等参数
    Arduino_DataBus *bus = new Arduino_ESP32QSPI(
    LCD_CS /* CS */, LCD_SCLK /* SCK */, LCD_SDIO0 /* SDIO0 */, LCD_SDIO1 /* SDIO1 */,
    LCD_SDIO2 /* SDIO2 */, LCD_SDIO3 /* SDIO3 */);

    Arduino_CO5300 *gfx = new Arduino_CO5300(
    bus, LCD_RESET /* RST */, 0 /* rotation */, LCD_WIDTH /* width */, LCD_HEIGHT /* height */, 6, 0, 0, 0);
  • 绘制行列编号和字符表

    • 首先设置文本颜色为绿色,在显示屏上逐个打印行号。然后设置文本颜色为蓝色,打印列号。接着使用循环逐个绘制字符,组成字符表,每个字符使用白色前景和黑色背景
    gfx->setTextColor(RGB565_GREEN);
    for (int x = 0; x < numRows; x++) {
    gfx->setCursor(10 + x * 8, 2);
    gfx->print(x, 16);
    }
    gfx->setTextColor(RGB565_BLUE);
    for (int y = 0; y < numCols; y++) {
    gfx->setCursor(2, 12 + y * 10);
    gfx->print(y, 16);
    }

    char c = 0;
    for (int y = 0; y < numRows; y++) {
    for (int x = 0; x < numCols; x++) {
    gfx->drawChar(10 + x * 8, 12 + y * 10, c++, RGB565_WHITE, RGB565_BLACK);
    }
    }

运行效果​

03_LVGL_AXP2101_ADC_Data​

程序说明​

  • 本示例使用 XPowersLib 读取 AXP2101 的电源和电池数据,并通过 LVGL 显示测量值。
Wi-Fi 配置

ssid_sta 默认为空,示例跳过 Wi-Fi 连接并继续初始化电源管理芯片和显示屏。需要连接网络时,在 ssid_sta 和 password_sta 中填写 2.4 GHz Wi-Fi 网络名称和密码;连接等待最多 10 秒,超时后继续运行。示例还会启动名为 ESP32-S3-Touch-AMOLED-1.75C-AP 的无线接入点,使用前应修改 ssid_ap 和 password_ap。

硬件连接​

  • 将开发板接入电脑

代码分析​

  • 启用电源测量:

    void adcOn() {
    power.enableTemperatureMeasure();
    power.enableBattDetection();
    power.enableVbusVoltageMeasure();
    power.enableBattVoltageMeasure();
    power.enableSystemVoltageMeasure();
    }
  • 主循环读取电源测量值和充电状态,并更新 LVGL 标签。检测到电池时显示电量百分比。

运行效果​

04_LVGL_QMI8658_ui​

程序说明​

  • 本示例读取 QMI8658 IMU 的加速度数据,并在 LVGL 图表中绘制曲线。

硬件连接​

  • 将开发板接入电脑

代码分析​

  • setup:负责初始化各种硬件设备和 LVGL 图形库环境

    • 串口初始化:Serial.begin(115200) 为串口调试做准备
    • 图形显示初始化:初始化图形显示设备 gfx,设置亮度,并打印 LVGL 和 Arduino 的版本信息。接着初始化 LVGL,包括注册打印回调函数用于调试,初始化显示驱动和输入设备驱动。创建并启动 LVGL 的定时器,最后创建一个标签并设置初始文本为 “Initializing...”
    • 创建图表:创建一个图表对象 chart,设置图表的类型、范围、数据点数量等属性,并为加速度的三个轴添加数据系列
    • 加速度传感器初始化:初始化加速度传感器 qmi,配置并启用加速度计
  • loop

    • lv_timer_handler():这是 LVGL 图形库中的一个重要函数,用于处理图形界面的各种定时器事件、动画更新、输入处理等任务。在每个循环中调用这个函数可以确保图形界面的流畅运行和及时响应交互操作
    • 读取加速度传感器数据:如果加速度传感器数据准备好,读取加速度数据并通过串口打印出来,同时更新图表显示加速度数据。同时读取陀螺仪数据并通过串口输出

运行效果​

05_LVGL_Widgets​

程序说明​

  • 本示例使用 CO5300 显示屏和 CST9217 触摸控制器运行 LVGL 音乐演示。

硬件连接​

  • 将开发板接入电脑

代码分析​

  • setup:负责初始化各种硬件设备和 LVGL 图形库环境
    • 串口初始化:USBSerial.begin(115200) 为串口调试做准备
    • I²C 总线初始化:Wire.begin(IIC_SDA, IIC_SCL); 初始化 I²C 总线,用于与其他 I²C 设备通信
    • 触摸控制器初始化:通过 TouchDrvCST92xx,在 I2C 地址 0x5A 初始化 CST9217。初始化失败时输出错误信息,并停留在延时循环中。
    • 图形显示初始化:初始化图形显示设备 gfx,设置亮度,并获取屏幕的宽度和高度。然后初始化 LVGL,包括注册打印回调函数用于调试,初始化显示驱动和输入设备驱动。创建并启动 LVGL 的定时器,创建一个标签并设置文本,最后调用 lv_demo_music() 运行 LVGL 音乐演示
  • loop
    • lv_timer_handler():这是 LVGL 图形库中的一个重要函数,用于处理图形界面的各种定时器事件、动画更新、输入处理等任务。在每个循环中调用这个函数可以确保图形界面的流畅运行和及时响应交互操作
    • delay(5):添加一个小的延迟,避免过度占用 CPU 资源

运行效果​

06_ES7210​

程序说明​

  • 本示例通过 I2S 和 ES7210 采集麦克风音频,并进行语音活动检测。

硬件连接​

  • 将开发板接入电脑

运行效果​

  • 设备采集音频,屏幕不显示内容。检测到语音活动时,串口监视器输出 Speech detected,波特率为 115200。

07_ES8311​

程序说明​

  • 本示例使用 ES8311 音频编解码器和 I2S 播放示例中随附的音频数据。

硬件连接​

  • 将开发板接入电脑

代码分析​

  • es8311_codec_init:初始化 ES8311 音频编解码器
    • 创建一个 ES8311 编解码器的句柄 es_handle
    • 配置 ES8311 的时钟参数,包括主时钟和采样时钟的频率、时钟极性等
    • 初始化编解码器,设置音频分辨率为 16 位
    • 配置采样频率
    • 配置麦克风相关参数,如关闭麦克风、设置音量和麦克风增益
  • setup:进行整体的初始化设置,包括串口、引脚、I2S 和 ES8311 编解码器
    • 初始化串口用于调试输出
    • 设置特定引脚为输出并置高
    • 配置 I2S 总线,设置引脚、工作模式、采样率、数据位宽、声道模式等
    • 初始化 I²C 总线
    • 调用 es8311_codec_init 函数初始化 ES8311 编解码器
    • 通过 I2S 总线播放一段预先定义的音频数据(canon_pcm)

运行效果​

  • 设备播放音频,屏幕不显示内容。