配置开发环境

1. 安装和配置 Arduino IDE

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

2. 安装库

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

安装步骤：

1.下载 示例程序包。 2. 将其 Arduino\libraries 目录下的所有文件夹（GFX_Library_for_Arduino 、ESP32-audioI2S-master等）复制到 Arduino 的库文件夹中。

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

3. 其他提示

ESP32-Touch-LCD-3.5 Arduino 工程参数设置，需要选择ESP32 Dev Module。

示例程序

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

01_i2s_audio​

本示例演示ESP32-Touch-LCD-3.5读取SD卡的音频文件并使用喇叭播放，支持MP3、AAC、WAV等格式。

准备工作​

• 将SD卡插入电脑
• 在SD卡根目录新建文件夹 music
• 把本工程下data文件夹里面的1.mp3拷贝到SD卡的music文件夹里
• 将SD卡插入 ESP32-Touch-LCD-3.5

运行效果​

播放音频文件，屏幕无现象

代码​

代码解释​

• 初始化I2C外设，配置es8311解码器，同时使能功放管脚PA_CTRL：

  Wire.begin(I2C_SDA, I2C_SCL);
  TCA.begin();
  TCA.pinMode1(2,OUTPUT);
  TCA.write1(2, 1);
  
  es8311_codec_init();
  

• 初始化I2S外设，挂载TF卡，设置播放音量，播放路径为music/1.mp3的MP3文件：

  SPI.begin(SPI_SCK, SPI_MISO, SPI_MOSI, SD_CS);
  if (!SD.begin(SD_CS)) {
    esp_rom_printf("Card Mount Failed\n");
    while (1) {
    };
  }
  
  audio.setPinout(I2S_BCLK, I2S_LRC, I2S_DOUT);
  audio.setVolume(21);  // 0...21
  
  audio.connecttoFS(SD, "music/1.mp3");
  

02_axp2101_example​

本示例演示使用XPowers驱动AXP2101，并通过串口打印数据

运行效果​

代码​

代码解释​

• 初始化I2C外设，初始化AXP2101电池管理IC：

  bool result = power.begin(Wire, AXP2101_SLAVE_ADDRESS, i2c_sda, i2c_scl);
  
  if (result == false) {
    Serial.println("power is not online...");
    while (1) delay(50);
  }
  

03_button_example​

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

运行效果​

代码​

代码解释​

• 绑定按键事件回调函数 ：

  button1.attachClick(click1);
  button1.attachDoubleClick(doubleclick1);
  button1.attachLongPressStart(longPressStart1);
  button1.attachLongPressStop(longPressStop1);
  button1.attachDuringLongPress(longPress1);
  

04_es8311_example​

本示例演示使用ESP32-Touch-LCD-3.5驱动ES8311音频编解码器，实现音频录制及回放功能。。

运行效果​

• 屏幕无现象
• 按下ESP32-Touch-LCD-3.5的RST按键进入音频录制状态，5s后播放录制的内容。

代码​

代码解释​

• 初始化I2C,ES8311,I2S ：

  Wire.begin(I2C_SDA, I2C_SCL);
  es8311_codec_init();
  setupI2S();
  

• 音频录制5s，并播放录制的内容 ：

  wav_buffer = i2s.recordWAV(5, &wav_size);
  delay(1000);
  Serial.println("I2S playWAV");
  i2s.playWAV(wav_buffer, wav_size);
  

05_pcf85063_example​

本实例演示ESP32-Touch-LCD-3.5驱动PCF85063，时间和日期的设置与获取。

运行效果​

• 屏幕无现象
• 打开串口监视器

代码​

代码解释​

• 初始化 ：

    // Try to initialize the RTC module using I2C with specified SDA and SCL pins
    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);
        }
    }
  

• 设置时间、日期 ：

  rtc.setDateTime(year, month, day, hour, minute, second);
  

• 获取时间、日期 ：

  RTC_DateTime datetime = rtc.getDateTime();
  

06_tca9554_example​

本实例演示ESP32-Touch-LCD-3.5驱动TCA9554，对扩展IO的引脚进行读写操作。。

运行效果​

• 屏幕无现象
• 打开串口监视器

代码​

代码解释​

• 设置引脚模式 ：

  TCA.pinMode1(pin, OUTPUT);
  

• 设置引脚电平 ：

  TCA.write1(pin, LOW);
  

• 读取引脚电平 ：

  int val = TCA.read1(pin);
  

07_sd_card_test​

本示例演示使用 ESP32-Touch-LCD-3.5 测试SD卡的读写功能

硬件连接​

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

运行效果​

• 屏幕无现象
• 打开串口监视器

代码​

代码解释​

• 初始化 ：

  if(!SD_MMC.setPins(clk, cmd, d0)){
    Serial.println("Pin change failed!");
    return;
  }
  
  if (!SD_MMC.begin( "/sdcard", true)) {
    Serial.println("Card Mount Failed");
    return;
  }
  

08_gfx_helloworld​

本示例演示 ESP32-Touch-LCD-3.5 使用GFX_Library_for_Arduino库驱动屏幕并在屏幕上显示HelloWorld

运行效果​

代码​

代码解释​

• 配置屏幕接口以及屏幕的分辨率等：

  Arduino_DataBus *bus = new Arduino_ESP32SPI(27 /* DC */, 5 /* CS */, 18 /* SCK */, 23 /* MOSI */, 19 /* MISO */);
  
  Arduino_GFX *gfx = new Arduino_ST7796(bus, GFX_NOT_DEFINED  /* RST */, 0 /* rotation */, true /* IPS */);
  

09_lvgl_arduino_v8​

本示例演示了使用 ESP32-Touch-LCD-3.5 运行lvgl( v8.4.0）示例程序。

需要安装 lvgl v8.4.0 版本，如已安装其他版本，请重新安装。​

运行效果​

代码​

代码解释​

• setup() ：

  • 初始化屏幕以及LVGL；

• loop() ：

  • 调用 lv_timer_handler 让 LVGL 处理图形界面的任务；

10_lvgl_arduino_v9​

本示例演示了使用 ESP32-Touch-LCD-3.5 运行lvgl( v9.3.0）示例程序

需要安装 lvgl v9.3.0 版本，如已安装其他版本，请重新安装。​

运行效果​

代码​

代码解释​

• my_disp_flush() ：

  • 这个函数是 LVGL 显示驱动的刷新函数。它负责将 LVGL 的绘图缓冲区内容刷新到显示屏上；
  • 根据不同的颜色格式设置，调用 gfx 对象的相应函数来绘制位图到特定的区域；
  • 最后通知 LVGL 显示刷新已完成。

• loop() ：

  • 调用 lv_timer_handler 让 LVGL 处理图形界面的任务；
  • 通过 delay(5) 增加数据轮询的频率，以确保及时获取传感器数据并更新显示。

11_bt_music_receiver_arduino_i2s​

本示例演示了使用 ESP32-Touch-LCD-3.5 连接蓝牙播放音乐，屏幕显示歌曲信息。

设置 Partition Scheme 为 "Custom"​

• QQ音乐：设置->歌词->车载蓝牙歌词
• 网易云音乐：设置->通用->外部设备->外接设备蓝牙歌词

运行效果​

• 手机或平板连接蓝牙。（名称：ESP32-Touch-LCD-3.5）
• 屏幕上显示歌曲信息

ESP-IDF 开发

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-Touch-LCD-3.5 ，建议 Espressif IDF 版本 ≥ v5.4.1。
   • 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 目录中。

01_factory​

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

代码解释

• 初始化系统各种外设，加载LVGL显示demo

    esp_i2c_port_init(&i2c_bus_handle);
    esp_spi_port_init(LCD_BUFFER_SIZE);
    esp_sdcard_port_init();
    io_expander_init();
    esp_3inch5_display_port_init(&io_handle, &panel_handle, LCD_BUFFER_SIZE);
    esp_3inch5_touch_port_init(&touch_handle, i2c_bus_handle, EXAMPLE_LCD_H_RES, EXAMPLE_LCD_V_RES, EXAMPLE_DISPLAY_ROTATION);
    esp_axp2101_port_init(i2c_bus_handle);
    vTaskDelay(pdMS_TO_TICKS(200));
    esp_es8311_port_init(i2c_bus_handle);
    esp_pcf85063_port_init(i2c_bus_handle);
    esp_wifi_port_init("WSTEST", "waveshare0755");
    esp_3inch5_brightness_port_init();
    esp_3inch5_brightness_port_set(80);
    lv_port_init();
  

02_axp2101_example​

本示例演示了 ESP32-Touch-LCD-3.5 使用 XPowersLib 库驱动AXP2101，并通过串口打印电池信息

03_button_power_save​

本示例演示了 ESP32-Touch-LCD-3.5 使用 espressif/button 库驱动按键，并通过BOOT按键实现对睡眠模式的唤醒。

04_pcf85063_example​

本示例演示了 ESP32-Touch-LCD-3.5 使用 sensorlib 库驱动pcf85063，并通过串口打印其数据。

05_tca9554_example​

本示例演示了 ESP32-Touch-LCD-3.5 使用 espressif/esp_io_expander_tca9554 库驱动tca9554，可对扩展IO进行输入输出操作。

06_sd_card_test​

本示例演示了 ESP32-Touch-LCD-3.5 测试SD卡的读写功能

硬件连接​

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

代码解释​

• SPI初始化 ：

    spi_bus_config_t bus_cfg = {
        .mosi_io_num = PIN_NUM_MOSI,
        .miso_io_num = PIN_NUM_MISO,
        .sclk_io_num = PIN_NUM_CLK,
        .quadwp_io_num = -1,
        .quadhd_io_num = -1,
        .max_transfer_sz = 4000,
    };
  
    ret = spi_bus_initialize(host.slot, &bus_cfg, SDSPI_DEFAULT_DMA);
    if (ret != ESP_OK) {
        ESP_LOGE(TAG, "Failed to initialize bus.");
        return;
    }
  

• SD卡初始化，并挂载 ：

    sdspi_device_config_t slot_config = SDSPI_DEVICE_CONFIG_DEFAULT();
    slot_config.gpio_cs = PIN_NUM_CS;
    slot_config.host_id = host.slot;
  
    ESP_LOGI(TAG, "Mounting filesystem");
    ret = esp_vfs_fat_sdspi_mount(mount_point, &host, &slot_config, &mount_config, &card);
  

07_lvgl_example​

本示例演示了 ESP32-Touch-LCD-3.5 运行lvgl示例程序

代码解释​

• 初始化LCD,屏幕触摸以及LVGL ：

    app_i2c_init();
    app_io_expander_init();
  
    /* LCD HW initialization */
    ESP_ERROR_CHECK(app_lcd_init());
  
    /* Touch initialization */
    ESP_ERROR_CHECK(app_touch_init());
  
    /* LVGL initialization */
    ESP_ERROR_CHECK(app_lvgl_init());
  

08_lvgl_audio_play​

本示例使用lvgl实现MP3播放器，该例程扫描内存卡根目录下的MP3文件进行播放

硬件连接​

• 将Micro SD卡插入卡槽（SD卡需要格式化为FAT32，并放置MP3文件在根目录下）

代码解释​

• 初始化I2C I2S，以及播音codec

    app_i2c_init();
    app_io_expander_init();
    ESP_ERROR_CHECK(esp_board_init(16000, 2, 16));
  
• 初始化屏幕、内存卡以及播放器，并扫描内存卡的的MP3并保存到数组

    /* LCD HW initialization */
    ESP_ERROR_CHECK(app_lcd_init());
    esp_sdcard_init("/sdcard", 5);
    Audio_Play_Init();
    Search_mp3_Music();
  
• 初始化触摸以及LVGL,加载播放器界面

    /* Touch initialization */
    ESP_ERROR_CHECK(app_touch_init());
  
    /* LVGL initialization */
    ESP_ERROR_CHECK(app_lvgl_init());
  
    lvgl_port_lock(0);
  
    lv_app_music_init();
  
    lvgl_port_unlock();
  

09_lvgl_image​

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

相关资料

1. 硬件资料​

开发板设计文件

• 引脚图：ESP32-Touch-LCD-3.5-details-intro.jpg
• 原理图：ESP32-Touch-LCD-3.5_schematic.pdf
• 2D 尺寸图：ESP32-Touch-LCD-3.5-details-size.jpg

2. 技术手册

• ESP32 芯片官方手册

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