跳到主要内容

ESP-IDF

本章节包含以下部分，请按需阅读：

ESP-IDF 入门教程​

初次接触 ESP32 ESP-IDF 开发，想要快速上手？我们为您准备了一套通用的 入门教程。

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

配置 ESP-IDF 开发环境​

信息

对于 ESP32-S3-Touch-LCD-1.54 开发板，需要使用 ESP-IDF V5.5.0 以上版本。

备注

以下内容以 Windows 系统为例，使用 VS Code + ESP-IDF 扩展 的方式进行开发。Mac/Linux 用户请参考 官方说明。

安装 ESP-IDF 开发环境​

  1. 前往 ESP-IDF Installation Manager 下载 ESP-IDF 安装管理器。这是乐鑫最新推出的跨平台安装工具，下文将演示如何使用其离线安装功能。

    在页面中点击 Offline Installer 标签，然后在筛选栏中选择 Windows 操作系统和你要安装的版本。

    下载 EIM 和整合包

    确认选择无误后，点击下载按钮。浏览器将自动同时下载两个文件：一个是 ESP-IDF 离线整合包(.zst)，另一个是 ESP-IDF 安装器(.exe)。

    下载 EIM 和整合包2

    请耐心等待两个文件下载完成。

  2. 下载完成后，双击运行 ESP-IDF 安装器(eim-gui-windows-x64.exe)。

    启动后，可在右上角将界面语言切换为中文。

    切换 EIM 语言

    安装工具会自动检测同一目录下是否存在离线整合包。点击 从存档安装。

    自动检测整合包

    接下来，选择安装路径。建议使用默认路径；若需自定义，请确保路径中不包含中文或空格。确认无误后，点击 开始安装。

    选择安装路径

  3. 当看到如下界面时，表示 ESP-IDF 已安装成功。

    安装成功

  4. 建议同时安装驱动程序。点击 完成安装，然后点击 安装驱动程序。

    用 ESP-IDF 安装管理器安装驱动

安装 Visual Studio Code 与 ESP-IDF 扩展​

  1. 下载并安装 Visual Studio Code。

  2. 安装时建议勾选 通过 Code 打开操作添加到 Windows 资源管理器文件上下文菜单,以便快速打开项目文件夹。

  3. 在 VS Code 中,点击侧边活动栏中的 扩展图标 扩展图标(或使用快捷键 Ctrl + Shift + X)打开 扩展 视图。

  4. 在搜索框中输入 ESP-IDF,找到 ESP-IDF 扩展并点击安装。

    在 VS Code 中搜索并安装 ESP-IDF 扩展

  5. 当 ESP-IDF 扩展版本 ≥ 2.0 时,扩展会自动检测并识别上述步骤中安装的 ESP-IDF 环境,无需手动配置。

示例程序​

ESP-IDF 示例程序位于 示例程序包 的 ESP-IDF 目录中。

01_factory​

本示例演示是 ESP32-S3-Touch-LCD-1.54 的综合示例，也是出厂默认烧录的示例。

硬件连接​

  • 将开发板接入电脑

运行效果​

ESP32-S3-Touch-LCD-1.54 ESP-IDF 示例 1 图 1
ESP32-S3-Touch-LCD-1.54 ESP-IDF 示例 1 图 2
ESP32-S3-Touch-LCD-1.54 ESP-IDF 示例 1 图 3
ESP32-S3-Touch-LCD-1.54 ESP-IDF 示例 1 图 3
  • 第一个页面显示红，绿，蓝三种颜色轮换
  • 第二个页面显示开发板信息
  • 第三个页面显示 IMU 读取到的数据
  • 第四个页面显示已连接 wifi 的 ip 地址（未连接，连接失败显示 0.0.0.0）和 搜索到的 wifi

具体操作​

  • 长按左键不松开，扬声器实时播放麦克风采集的声音。
  • 双击中键屏幕熄屏，再次双击屏幕恢复显示。
  • 使用电池供电时，长按中键开机，再次长按并松开关机
  • 单击左右键进行页面切换

02_button_example​

本示例演示如何使用 espressif/button 库读取按键的单击、双击和长按等状态，并通过串口打印。

硬件连接​

  • 将开发板接入电脑

代码解释​

  • 绑定回调函数 ：

      ret = iot_button_register_cb(boot_btn, BUTTON_PRESS_DOWN, NULL, button_event_cb, NULL);
      ret |= iot_button_register_cb(boot_btn, BUTTON_PRESS_UP, NULL, button_event_cb, NULL);
      ret |= iot_button_register_cb(boot_btn, BUTTON_PRESS_REPEAT, NULL, button_event_cb, NULL);
      ret |= iot_button_register_cb(boot_btn, BUTTON_PRESS_REPEAT_DONE, NULL, button_event_cb, NULL);
      ret |= iot_button_register_cb(boot_btn, BUTTON_SINGLE_CLICK, NULL, button_event_cb, NULL);
      ret |= iot_button_register_cb(boot_btn, BUTTON_DOUBLE_CLICK, NULL, button_event_cb, NULL);
      ret |= iot_button_register_cb(boot_btn, BUTTON_LONG_PRESS_START, NULL, button_event_cb, NULL);
      ret |= iot_button_register_cb(boot_btn, BUTTON_LONG_PRESS_HOLD, NULL, button_event_cb, NULL);
      ret |= iot_button_register_cb(boot_btn, BUTTON_LONG_PRESS_UP, NULL, button_event_cb, NULL);
      ret |= iot_button_register_cb(boot_btn, BUTTON_PRESS_END, NULL, button_event_cb, NULL);

运行效果​

  • 屏幕无现象
  • 打开串口调试工具，串口打印按钮信息
    ESP32-S3-Touch-LCD-1.54 ESP-IDF 示例 2 图 1

03_qmi8658_example​

本示例演示如何使用 sensorlib 库读取读取 qmi8658 的数据并打印

硬件连接​

  • 将开发板接入电脑

代码解释

  • 读取 qmi8658 的 Accelerometer、Gyroscope 以及 Timestamp 
      if (qmi.getDataReady())
    {
      if (qmi.getAccelerometer(acc.x, acc.y, acc.z))
      {
        printf("ACCEL--x:%5.2f y:%5.2f z:%5.2f  ", acc.x, acc.y, acc.z);
      }

      if (qmi.getGyroscope(gyr.x, gyr.y, gyr.z))
      {
        printf("GYRO--x:%5.2f y:%5.2f z:%5.2f  ", gyr.x, gyr.y, gyr.z);
      }
      printf("Temperature:%5.2f degrees C", qmi.getTemperature_C());
    }
    printf("Timestamp:%ld \r\n", qmi.getTimestamp());

运行效果​

  • 屏幕无现象
  • 打开串口调试工具，串口打印 qmi8658 的数据信息
    ESP32-S3-Touch-LCD-1.54 ESP-IDF 示例 3 图 1

04_sd_card_test​

本示例使用 ESP32-S3-Touch-LCD-1.54 对 SD 卡的读写功能进行测试。

硬件连接​

  • 将 SD 卡插入卡槽（SD 卡需要格式化为 FAT32）
  • 将开发板接入电脑

代码解释​

  • SD 卡初始化，并挂载：

      sdmmc_slot_config_t slot_config = SDMMC_SLOT_CONFIG_DEFAULT();
    #if EXAMPLE_IS_UHS1
        slot_config.flags |= SDMMC_SLOT_FLAG_UHS1;
    #endif

        // Set bus width to use:
    #ifdef CONFIG_EXAMPLE_SDMMC_BUS_WIDTH_4
        slot_config.width = 4;
    #else
        slot_config.width = 1;
    #endif

        // On chips where the GPIOs used for SD card can be configured, set them in
        // the slot_config structure:
    #ifdef CONFIG_SOC_SDMMC_USE_GPIO_MATRIX
        slot_config.clk = CONFIG_EXAMPLE_PIN_CLK;
        slot_config.cmd = CONFIG_EXAMPLE_PIN_CMD;
        slot_config.d0 = CONFIG_EXAMPLE_PIN_D0;
    #ifdef CONFIG_EXAMPLE_SDMMC_BUS_WIDTH_4
        slot_config.d1 = CONFIG_EXAMPLE_PIN_D1;
        slot_config.d2 = CONFIG_EXAMPLE_PIN_D2;
        slot_config.d3 = CONFIG_EXAMPLE_PIN_D3;
    #endif  // CONFIG_EXAMPLE_SDMMC_BUS_WIDTH_4
    #endif  // CONFIG_SOC_SDMMC_USE_GPIO_MATRIX

        // Enable internal pullups on enabled pins. The internal pullups
        // are insufficient however, please make sure 10k external pullups are
        // connected on the bus. This is for debug / example purpose only.
        slot_config.flags |= SDMMC_SLOT_FLAG_INTERNAL_PULLUP;

        ESP_LOGI(TAG, "Mounting filesystem");
        ret = esp_vfs_fat_sdmmc_mount(mount_point, &host, &slot_config, &mount_config, &card);

运行效果​

  • 屏幕无现象
  • 打开串口调试工具，串口打印 SD 卡信息
    ESP32-S3-LCD-0.85 ESP-IDF 示例 4 图 1

05_lvgl_example​

本示例演示了 ESP32-S3-Touch-LCD-1.54 运行 lvgl 示例程序（支持 lvgl v8 和 lvgl v9）

  • 默认使用的 LVGL 版本为 v9.3.0。如需更换版本，请修改 main/idf_component.yml 文件中的 LVGL 配置，例如将其改为 lvgl/lvgl:^8.4.0。
    ESP32-S3-LCD-0.85 ESP-IDF 示例 5 图 1

硬件连接​

  • 将开发板接入电脑

代码解释​

  • 初始化：

       /* LCD HW initialization */
      ESP_ERROR_CHECK(app_lcd_init());

      /* Touch initialization */
      app_touch_init();

      /* LVGL initialization */
      ESP_ERROR_CHECK(app_lvgl_init());

运行效果​