本产品是一款由微雪 (Waveshare) 设计的低成本,高性能的微控制器开发板。在较小的板型下,板载了 2 英寸 LCD 屏、锂电池充电芯片、六轴传感器 (三轴加速度计与三轴陀螺仪)、摄像头接口等外设,方便开发并嵌入应用到产品中。
参数名称 | 参数 |
接口 | USB Type-A |
主控芯片 | ESP32-S3 |
屏幕类型 | ISP |
屏幕控制芯片 | Display :ST7789T3 |
板载设备 | Micro SD |
ESP32-S3-LCD-2 目前提供 Arduino IDE 和 ESP-IDF 两种开发工具和框架,提供了灵活的开发选择,你可以根据项目需求和个人习惯选择适合的开发工具。
本章介绍 Arduino 环境搭建,包括 Arduino IDE、ESP32板管理、相关库的安装,程序编译下载及示例程序测试,帮助用户掌握开发板,便于二次开发。
文件
-> 偏好设置
https://espressif.github.io/arduino-esp32/package_esp32_index.json
①. 在侧边栏选择“BOARDS MANAGER”(板管理);
②. 在搜索框中输入要安装的板名称“ESP32”;
③. 在方框处选择 版本号;
④. 点击“INSTALL”(安装)。
板名称 | 板安装要求 | 版本号要求 |
---|---|---|
esp32 by Espressif Systems | “离线”安装/“在线”安装 | ≥3.0.0 |
File
->preferences
->Sketchbook location
下查看..\ESP32-S3-LCD-2-Demo\Arduino\libraries
库名称 | 说明 | 版本 | 库安装要求 |
---|---|---|---|
lvgl | 图形库 | v8.4.0 | “在线”安装(需要复制demos文件夹至src) |
GFX_Library_for_Arduino | LCD驱动库 | v1.5.0 | “在线”安装 |
FastIMU | IUM驱动库 | v1.2.6 | “在线”安装 |
示例程序 | 基础例程说明 | 依赖库 |
---|---|---|
01_factory | 综合测试程序 | lvgl、GFX_Library_for_Arduino、FastIMU |
02_gfx_helloworld | 屏幕上显示HelloWorld | GFX_Library_for_Arduino |
03_sd_card_test | 测试SD卡 | -- |
04_qmi8658_output | 串口打印QMI8658的数据 | FastIMU |
05_lvgl_qmi8658 | 使用lvgl库显示QMI8658的数据 | lvgl、FastIMU |
06_lvgl_battery | 使用lvgl库显示电池电压 | lvgl、GFX_Library_for_Arduino |
07_lvgl_brightness | 使用lvgl库控制和显示屏幕亮度 | lvgl、GFX_Library_for_Arduino |
08_lvgl_example | lvgl示例程序 | lvgl、GFX_Library_for_Arduino |
09_lvgl_camera | 使用lvgl库显示摄像头图像 | lvgl、GFX_Library_for_Arduino |
10_camera_web_server | 在网页上显示摄像头图像 | -- |
【程序说明】
本示例测试ESP32-S3-LCD-2板载模块的功能,屏幕上将显示各个模块的信息,用户可以通过触摸屏进行页面切换
【硬件连接】
【代码分析】
Serial.begin(115200); bsp_i2c_init(); //初始化 I2C 总线,通常用于连接传感器、显示器等外设 bsp_lv_port_init(); //初始化 LVGL 图形库的端口,这样可以将图形输出到显示设备(如 LCD) bsp_spi_init(); //初始化 SPI 总线,通常用于与传感器、外部存储、屏幕等设备通信
bsp_lv_port_run(); //运行与 LVGL 相关的驱动或循环,例如刷新显示等 if (lvgl_lock(-1)) { //锁定 LVGL 资源,确保在更新 UI 时不会与其他任务冲突 lvgl_ui_init(); //初始化 UI,可能包括布局、控件等设置 lvgl_unlock(); //解锁 LVGL,允许其他任务访问 LVGL }
app_qmi8658_init(); //初始化 QMI8658 传感器(如加速度计、陀螺仪等) app_system_init(); //进行系统级的初始化,例如时钟、内存、复位等 app_camera_init(); //初始化相机模块,准备好进行图像采集 app_wifi_init(sta_ssid, sta_pass); //初始化 Wi-Fi 模块,连接到指定的 Wi-Fi 网络
app_qmi8658_run(); //启动 QMI8658 传感器相关的任务,例如数据采集、处理等 app_system_run(); //启动系统任务,确保系统功能正常运行 app_camera_run(); //启动相机相关的任务,通常是获取图像数据并进行处理或传输 app_wifi_run(); //启动 Wi-Fi 相关任务,例如连接管理、数据传输等
【运行效果】
【程序说明】
本示例演示 ESP32-S3-LCD-2 使用GFX_Library_for_Arduino库驱动屏幕并在屏幕上显示HelloWorld
【硬件连接】
【代码分析】
Arduino_DataBus *bus = new Arduino_ESP32SPI( EXAMPLE_PIN_NUM_LCD_DC /* DC */, EXAMPLE_PIN_NUM_LCD_CS /* CS */, EXAMPLE_PIN_NUM_LCD_SCLK /* SCK */, EXAMPLE_PIN_NUM_LCD_MOSI /* MOSI */, EXAMPLE_PIN_NUM_LCD_MISO /* MISO */); /* More display class: https://github.com/moononournation/Arduino_GFX/wiki/Display-Class */ Arduino_GFX *gfx = new Arduino_ST7789( bus, EXAMPLE_PIN_NUM_LCD_RST /* RST */, EXAMPLE_LCD_ROTATION /* rotation */, true /* IPS */, EXAMPLE_LCD_H_RES /* width */, EXAMPLE_LCD_V_RES /* height */);
【程序说明】
本示例演示了如何使用 ESP32-S3-LCD-2 测试SD卡的读写功能
【硬件连接】
【代码分析】
SPI.begin(sck, miso, mosi, cs); if (!SD.begin(cs)) { Serial.println("Card Mount Failed"); return; }
【程序说明】
本示例演示了如何使用 ESP32-S3-LCD-2 获取QMI8658的数据并使用串口打印
【硬件连接】
【代码分析】
int err = IMU.init(calib, IMU_ADDRESS); if (err != 0) { Serial.print("Error initializing IMU: "); Serial.println(err); while (true) { ; } }
【运行效果】
【程序说明】
本示例演示使用 ESP32-S3-LCD-2 获取qmi8658的数据,并通过lvgl库将数据显示出来
【硬件连接】
【代码分析】
lvgl_qmi8658_ui_init(lv_scr_act());
【程序说明】
本示例演示了如何使用 ESP32-S3-LCD-2 使用lvgl库在屏幕上显示电池电压以及ADC的值
【硬件连接】
【代码分析】
lvgl_battery_ui_init(lv_scr_act());
【程序说明】
本示例演示了如何使用 ESP32-S3-LCD-2 使用lvgl库在屏幕上显示屏幕亮度,通过滑动条可以控制屏幕亮度
【硬件连接】
【代码分析】
lvgl_brightness_ui_init(lv_scr_act());
【程序说明】
本示例演示了使用 ESP32-S3-LCD-2 运行lvgl示例程序
【硬件连接】
【注意事项】
【代码分析】
lv_demo_widgets(); // lv_demo_benchmark(); // lv_demo_keypad_encoder(); // lv_demo_music(); // lv_demo_stress();
【程序说明】
本示例在 ESP32-S3-LCD-2 屏幕上使用 LVGL 库显示从摄像头获取的图像
【硬件连接】
【代码分析】
xTaskCreatePinnedToCore(camera_task, "camera_task_task", 1024 * 3, NULL, 1, NULL, 0);
camera_fb_t *pic; lv_img_dsc_t img_dsc; img_dsc.header.always_zero = 0; img_dsc.header.w = 480; img_dsc.header.h = 320; img_dsc.data_size = 320 * 480 * 2; img_dsc.header.cf = LV_IMG_CF_TRUE_COLOR; img_dsc.data = NULL; // lv_img_set_src(img_camera, &pic); while (1) { pic = esp_camera_fb_get(); if (NULL != pic) { img_dsc.data = pic->buf; if (lvgl_lock(-1)) { lv_img_set_src(img_camera, &img_dsc); lvgl_unlock(); } } esp_camera_fb_return(pic); vTaskDelay(pdMS_TO_TICKS(1)); }
【程序说明】
本示例演示了如何使用 ESP32-S3-LCD-2 驱动摄像头。在连接 WiFi 后,程序会创建一个网页服务器,用户只需在浏览器中输入设备的 IP 地址即可访问。网页上可以显示摄像头的图像,并支持分辨率、镜像等设置操作
【硬件连接】
【代码分析】
【运行效果】
本章介绍 ESP-IDF 环境搭建,包括 Visual Studio、Espressif IDF插件的安装,程序编译下载及示例程序测试,帮助用户掌握开发板,便于二次开发。
esp-idf: configure esp-idf extension
示例程序 | 基础例程说明 |
---|---|
sd_card_test | 测试SD卡 |
lvgl_example | 显示lvgl示例程序 |
lvgl_qmi8658 | 使用lvgl库显示qmi8658的数据 |
lvgl_camera | 使用lvgl库显示摄像头图像 |
lvgl_battery | 使用lvgl库显示电池电压 |
lvgl_brightness | 使用lvgl库控制和显示屏幕亮度 |
【程序说明】
本示例演示了如何使用 ESP32-S3-LCD-2 测试SD卡的读写功能。
【硬件连接】
【代码分析】
sdmmc_host_t host = SDSPI_HOST_DEFAULT(); 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; }
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);
【注意事项】
【程序说明】
本示例演示了使用 ESP32-S3-LCD-2 运行lvgl示例程序
【硬件连接】
【代码分析】
lv_init(); display_init(); lv_port_disp_init(); lvgl_tick_timer_init(EXAMPLE_LVGL_TICK_PERIOD_MS); bsp_brightness_init(); bsp_brightness_set_level(80);
lv_demo_widgets(); // lv_demo_benchmark(); // lv_demo_keypad_encoder(); // lv_demo_music(); // lv_demo_stress();
【程序说明】
本示例演示使用 ESP32-S3-LCD-2 获取qmi8658的数据,并通过lvgl库将数据显示出来
【硬件连接】
【代码分析】
lvgl_qmi8658_ui_init(lv_scr_act());
【程序说明】
本示例在 ESP32-S3-LCD-2 屏幕上使用 LVGL 库显示从摄像头获取的图像
【硬件连接】
【代码分析】
xTaskCreatePinnedToCore(camera_task, "camera_task_task", 1024 * 3, NULL, 1, NULL, 0);
camera_fb_t *pic; lv_img_dsc_t img_dsc; img_dsc.header.always_zero = 0; img_dsc.header.w = 480; img_dsc.header.h = 320; img_dsc.data_size = 320 * 480 * 2; img_dsc.header.cf = LV_IMG_CF_TRUE_COLOR; img_dsc.data = NULL; // lv_img_set_src(img_camera, &pic); while (1) { pic = esp_camera_fb_get(); if (NULL != pic) { img_dsc.data = pic->buf; if (lvgl_lock(-1)) { lv_img_set_src(img_camera, &img_dsc); lvgl_unlock(); } } esp_camera_fb_return(pic); vTaskDelay(pdMS_TO_TICKS(1)); }
【程序说明】
本示例演示了如何使用 ESP32-S3-LCD-2 使用lvgl库在屏幕上显示电池电压以及ADC的值
【硬件连接】
【代码分析】
lvgl_battery_ui_init(lv_scr_act());
【程序说明】
本示例演示了如何使用 ESP32-S3-LCD-2 使用lvgl库在屏幕上显示屏幕亮度,通过滑动条可以控制屏幕亮度
【硬件连接】
【代码分析】
lvgl_brightness_ui_init(lv_scr_act());
①通过设备管理器查看: 按下Windows + R键打开“运行”对话框; 输入devmgmt.msc并按回车键打开设备管理器; 展开“端口(COM和LPT)”部分,这里会列出所有的COM端口及其当前状态。
②使用命令提示符查看: 打开命令提示符(CMD); 输入mode命令,这将显示所有COM端口的状态信息。
③查看硬件连接: 如果你已经连接了外部设备到COM口,通常设备会占用一个端口号,可以通过查看连接的硬件来确定使用的是哪个端口。
①使用dmesg命令查看: 打开终端。
②使用ls命令查看: 输入ls /dev/ttyS*或ls /dev/ttyUSB*来列出所有的串口设备。
③使用setserial命令查看: 输入setserial -g /dev/ttyS*来查看所有串口设备的配置信息。
周一-周五(9:30-6:30)周六(9:30-5:30)
手机:13434470212
邮箱:services04@spotpear.cn
QQ:202004841