ESP-IDF 开发

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

配置开发环境
示例程序

配置开发环境

备注

以下环境设置适用于 Windows 10/11 系统，Mac/Linux 用户请参考 官方说明

下载并安装 Visual Studio Code。
在 VS Code 中，通过点击 VS Code 侧边活动栏中的或使用快捷键（Ctrl+Shift+X）来打开扩展视图。然后，搜索 ESP-IDF 扩展并安装。
安装扩展后，VS Code 左侧活动栏中会出现图标，点击该图标可查看 ESP-IDF 扩展的基本命令列表，在 Advanced 中选择 配置 ESP-IDF 扩展。
选择 Express 进入快速配置模式：
根据需要修改以下选项。
- 选择下载服务器：
  - Espressif：使用乐鑫中国服务器，下载速度更快。
  - Github：使用 GitHub 官方发布链接。
- ESP-IDF 版本：通常根据开发板要求选择对应版本，如无特殊要求建议使用最新的正式版本。对于 ESP32-C6-GEEK ，建议 Espressif IDF 版本 ≥ v5.3.1。
- ESP-IDF 容器安装地址：建议使用默认地址，或使用纯英文路径且路径中不包含空格。
- ESP-IDF 所需的工具安装地址：建议使用默认地址，或使用纯英文路径且路径中不包含空格。
点击 Install 开始安装。你将看到一个显示安装进度的页面，包括 ESP-IDF 下载、ESP-IDF 工具下载安装以及 Python 虚拟环境创建的进度状态。
如果安装正确，你会看到所有设置已配置完成的提示，即可开始使用该扩展程序。

注意

注意：如果 ESP-IDF 安装失败或需要重新安装，可以尝试删除 C:\Users\%Username%\esp 和 C:\Users\%Username%\.espressif 文件夹后重试。

示例程序

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

01_SD_Card

本示例演示了 ESP32-C6-GEEK 测试 SD 卡的读写功能

其余准备

将 Micro SD 卡插入卡槽（SD 卡需要格式化为 FAT32）

代码解释

使用 SDSPI 方式初始化 SD 卡：
```
  SD_card_Init();
```
测试 SD 卡读写功能：
```
 example_sdcard_task();
```

02_WIFI_AP

该示例可将开发板设置为热点，允许手机或其他处于 STA 模式的设备连接到开发板。

代码解释

在 softap_example_main.c 文件找到 SSID 和 PASSWORD，然后手机或其他处于 STA 模式的设备即可使用该 SSID 和 PASSWORD 连接到开发板。
```
  #define EXAMPLE_ESP_WIFI_SSID      "waveshare_esp32"
  #define EXAMPLE_ESP_WIFI_PASSWORD      "wav123456"
```

03_WIFI_STA

该示例可将开发板配置为 STA 设备，以连接路由器，从而接入系统网络。

代码解释

在 esp_wifi_bsp.c 文件找到 ssid 和 password，然后将其修改为当前环境中可用路由器的 SSID 和 Password。

  wifi_config_t wifi_config = {
      .sta = {
        .ssid = "PDCN",
        .password = "1234567890",
      },
  };

04_Button

该示例可将 boot 按键变成一个多功能按键，可进行单击、双击或者长按以执行不同的操作

代码解释

初始化 boot 按钮，绑定按钮事件函数：

  void button_init(void)
  {
      button_config_t btn_cfg = {0};
      button_gpio_config_t gpio_cfg = {
          .gpio_num = BOOT_BUTTON_NUM,
          .active_level = 0,
          .enable_power_save = true,
      };

      esp_err_t ret = iot_button_new_gpio_device(&btn_cfg, &gpio_cfg, &boot_btn);
      assert(ret == ESP_OK);
      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);
  }

05_lvgl_example

通过移植 LVGL，在屏幕上实现一些多功能的 GUI 界面。

代码解释

显示文字和 LVGL 版本信息：

  /* Task lock */
  lvgl_port_lock(0);

  lv_obj_t *label = lv_label_create(lv_scr_act());
  lv_snprintf(str, sizeof(str), "Hello LVGL \nVersion: V %d.%d.%d ", LVGL_VERSION_MAJOR, LVGL_VERSION_MINOR, LVGL_VERSION_PATCH);
  lv_label_set_text(label, str);
  lv_obj_align(label, LV_ALIGN_CENTER, 0, 0);

  /* Task unlock */
  lvgl_port_unlock();

配置开发环境​

示例程序​

01_SD_Card​

02_WIFI_AP​

03_WIFI_STA​

04_Button​

05_lvgl_example​

配置开发环境

示例程序

01_SD_Card

02_WIFI_AP

03_WIFI_STA

04_Button

05_lvgl_example