配置开发环境​

1. 安装和配置 Arduino IDE​

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

2. 安装库​

要运行示例，需要安装对应的库。示例代码使用 GFX Library for Arduino 库驱动 ST7789 显示屏 ，并使用 Arduino_DriveBus 库驱动 CST816 触摸芯片。

可从 此链接 的 Arduino 目录中，下载 ESP32-C6-Touch-LCD-1.83 开发板的示例程序包。包内的 Arduino\libraries 目录已包含本教程所需的全部库文件。

安装步骤：

1. 下载 示例程序包。

2. 将其 Arduino\libraries 目录下的所有文件夹（Arduino_DriveBus、GFX_Library_for_Arduino 等）复制到 Arduino 的库文件夹中。

   信息

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

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

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

3. 其他提示​

ESP32-C6-Touch-LCD-1.83 需要选择及配置开发板。

1. ESP32-C6-Touch-LCD-1.83 需要选择ESP32C6 Dev Module。
2. 选择USB端口
3. ESP32-C6-Touch-LCD-1.83 使用 ESP32-C6 原生 USB 接口，而非 UART 转 USB。对于串口通信：

   • printf() 函数可直接使用；

   • 若要使用 Serial.println() 函数，需要额外配置：在 IDE 工具菜单中启用"USB CDC On Boot"选项，或在代码中声明 HWCDC 对象处理 USB 串口通信。

4. 选择16MB flash
5. 选择合适大小的分区表

示例程序​

Arduino 示例程序位于 示例程序包 的 Arduino/examples 目录中。

01_sd_test​

本示例展示如何使用SPI挂载TF卡，并测试读写文件

代码​

代码解释​

• 初始化 SPI及挂载TF卡：

  #ifdef REASSIGN_PINS
    SPI.begin(sck, miso, mosi, cs);
    if (!SD.begin(cs)) {
  #else
    if (!SD.begin()) {
  #endif
      Serial.println("Card Mount Failed");
      return;
    }
    uint8_t cardType = SD.cardType();
  
    if (cardType == CARD_NONE) {
      Serial.println("No SD card attached");
      return;
    }
  
    Serial.print("SD Card Type: ");
    if (cardType == CARD_MMC) {
      Serial.println("MMC");
    } else if (cardType == CARD_SD) {
      Serial.println("SDSC");
    } else if (cardType == CARD_SDHC) {
      Serial.println("SDHC");
    } else {
      Serial.println("UNKNOWN");
    }
  
    uint64_t cardSize = SD.cardSize() / (1024 * 1024);
    Serial.printf("SD Card Size: %lluMB\n", cardSize);
  

• 测试文件读写 ：

  listDir(SD, "/", 0);
  createDir(SD, "/mydir");
  listDir(SD, "/", 0);
  removeDir(SD, "/mydir");
  listDir(SD, "/", 2);
  writeFile(SD, "/hello.txt", "Hello ");
  appendFile(SD, "/hello.txt", "World!\n");
  readFile(SD, "/hello.txt");
  deleteFile(SD, "/foo.txt");
  renameFile(SD, "/hello.txt", "/foo.txt");
  readFile(SD, "/foo.txt");
  testFileIO(SD, "/test.txt");
  Serial.printf("Total space: %lluMB\n", SD.totalBytes() / (1024 * 1024));
  Serial.printf("Used space: %lluMB\n", SD.usedBytes() / (1024 * 1024));
  

02_audio_out​

本示例演示如何使用 I2S播放音频，此例程屏幕无任何显示，烧录后会自动播放音频

代码​

代码解释​

• 初始化I2C,I2S等外设，并配置ES8311解码器 ：

    Serial.begin(115200);
    Wire.begin(I2C_SDA, I2C_SCL);
    es8311_codec_init();
  
    setupI2S();
    Serial.println("I2S Initialized");
    pinMode(PA_CTRL_PIN, OUTPUT);
    digitalWrite(PA_CTRL_PIN, HIGH);
  

03_axp2101_example​

本示例展示如何使用电源管理芯片，并打印出电池相关信息

代码

代码解释

• 初始化AXP2101 ：

  bool result = power.begin(Wire, AXP2101_SLAVE_ADDRESS, i2c_sda, i2c_scl);
  

04_qmi8658_example​

本示例打印了imu qmi8658的运行结果

代码

代码解释

• 初始化qmi8658 ：

  ret = qmi.begin(Wire, QMI8658_L_SLAVE_ADDRESS, SENSOR_SDA, SENSOR_SCL);
  

05_pcf85063_example​

本示例打印出RTC实时时钟pcf85063的值

代码

代码解释

• 初始化PCF85063 ：

    if (!rtc.begin(Wire, SENSOR_SDA, SENSOR_SCL)) {
        Serial.println("Failed to find PCF85063 - check your wiring!");
        // Enter an infinite loop to halt the program
        while (1) {
            delay(1000);
        }
    }
  

• 设置时间 ：

    uint16_t year = 2023;
    uint8_t month = 9;
    uint8_t day = 7;
    uint8_t hour = 11;
    uint8_t minute = 24;
    uint8_t second = 30;
  
    // Set the defined date and time on the RTC
    rtc.setDateTime(year, month, day, hour, minute, second);
  

06_gfx_helloworld

本示例驱动屏幕，并在屏幕上不断打印helloworld。

代码​

代码解释​

• 初始化SPI总线以及屏幕 ：

    Arduino_DataBus *bus = new Arduino_HWSPI(LCD_DC, LCD_CS, LCD_SCK, LCD_DIN);
    Arduino_GFX *gfx = new Arduino_ST7789(
    bus, LCD_RST, 0 /* rotation */, true /* IPS */,
    240 /* width */, 284 /* height */);
  

• 填充Hello World ：

    gfx->setCursor(random(gfx->width()), random(gfx->height()));
    gfx->setTextColor(random(0xffff), random(0xffff));
    gfx->setTextSize(random(6) /* x scale */, random(6) /* y scale */, random(2) /* pixel_margin */);
    gfx->println("Hello World!");
  

07_LVGL_Arduino

本示例使用Arduino_GFX_Library驱动ST7789屏幕，同时移植LVGL，以及触摸驱动

ESP-IDF 开发

配置开发环境

备注

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

1. 下载并安装 Visual Studio Code。

2. 在 VS Code 中，通过点击 VS Code 侧边活动栏中的  或使用快捷键（Ctrl+Shift+X）来打开 扩展 视图。然后，搜索 ESP-IDF 扩展并安装。

   

3. 安装扩展后，VS Code 左侧活动栏中会出现  图标，点击该图标可查看 ESP-IDF 扩展的基本命令列表，在 Advanced 中选择 配置 ESP-IDF 扩展。

   

4. 选择 Express 进入快速配置模式：

   

5. 根据需要修改以下选项。

   • 选择下载服务器：
     • Espressif：使用乐鑫中国服务器，下载速度更快。
     • Github：使用 GitHub 官方发布链接。
   • ESP-IDF 版本：通常根据开发板要求选择对应版本，如无特殊要求建议使用最新的正式版本。对于 ESP32-C6-Touch-LCD-1.83 ，建议 Espressif IDF 版本 ≥ v5.5.0。
   • ESP-IDF 容器安装地址：建议使用默认地址，或使用纯英文路径且路径中不包含空格。
   • ESP-IDF 所需的工具安装地址：建议使用默认地址，或使用纯英文路径且路径中不包含空格。

   

6. 点击 Install 开始安装。你将看到一个显示安装进度的页面，包括 ESP-IDF 下载、ESP-IDF 工具下载安装以及 Python 虚拟环境创建的进度状态。

   

7. 如果安装正确，你会看到所有设置已配置完成的提示，即可开始使用该扩展程序。

   

注意

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

示例程序

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

lvgl_brookesia_01​

本示例在使用lvgl 以及 brookesia组件构建APP风格的界面，可独立开发和安装各种应用程序。

i2s_es7210_rec_02​

本示例使用ES7210编码芯片进行录音测试，音频文件保存在TF卡根目录下

代码解释

• 初始化TF卡以及初始化ES7210芯片 ：

    /* Init I2C bus to configure ES7210 and I2S bus to receive audio data from ES7210 */
    i2s_chan_handle_t i2s_rx_chan = es7210_i2s_init();
    /* Create ES7210 device handle and configure codec parameters */
    es7210_codec_init();
    /* Mount SD card, the recorded audio file will be saved into it */
    sdmmc_card_t *sdmmc_card = mount_sdcard();
  

• 开始录音 ：

   esp_err_t err = record_wav(i2s_rx_chan);
  

mp3_play_03​

本示例使用ES8311播放TF中的MP3音频，音频名称需设置为1.MP3

代码解释

• 初始化TF卡以及初始化8311芯片，并初始化MP3播放库 ：

    sd_card_init();
    ESP_ERROR_CHECK(esp_board_init(16000, 1, 16));
    //esp_sdcard_init("/sdcard", 10);
    Audio_Play_Init();
  

• 播放MP3 ：

    Audio_Play_Music("file://sdcard/1.mp3");
  

lvgl_example_04​

本示例移植LVGL，并播放LVGL demo

代码解释

• 初始化I2C,lcd,触摸IC以及lvgl ：

    i2c_master_init();
  
    lcd_driver_init();
    touch_driver_init();
    lvgl_driver_init();
  

• 使用lvgl互斥锁加载lvgl 官方demo

    lvgl_port_lock(0);
    lv_demo_stress();
    lvgl_port_unlock();
  

AXP2101_05​

本示例驱动AXP2101，并打印电池相关信息

代码解释

• 初始化I2C以及AXP2101 ：

    ESP_ERROR_CHECK(i2c_init());
    ESP_LOGI(TAG, "I2C initialized successfully");
  
    ESP_ERROR_CHECK(pmu_init());
  

• 创建打印任务

   xTaskCreate(pmu_hander_task, "App/pwr", 4 * 1024, NULL, 10, NULL);
  

lvgl_image_06​

本示例使用lvgl显示图片，可以左右滑动手势切换图片

相关资料

1. 硬件资料

开发板设计文件

• 引脚图：ESP32-C6-Touch-LCD-1.83-details-5.jpg

• 原理图：ESP32-C6-Touch-LCD-1.83.pdf

• 2D 尺寸图：ESP32-C6-Touch-LCD-1.83-details-size.jpg

2. 技术手册

• ESP32-C6 芯片官方手册

  • 技术规格书：
    • 中文版
    • 英文版
  • 技术参考手册：
    • 中文版
    • 英文版

• 板载器件数据手册

  • QMI8658 数据手册
  • PCF85063A 数据手册
  • AXP2101 数据手册
  • ES8311 数据手册
  • ES8311 用户手册
  • ES7310 数据手册

3. 示例程序​

• 示例程序（ESP-IDF 和 Arduino）：ESP32-C6-Touch-LCD-1.83_Demo.zip
• github示例程序仓库：ESP32-C6-Touch-LCD-1.83_Demo